Skip to main content
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Atualize o sistema operacional host e, em seguida, o Mediador ONTAP

Colaboradores

Para atualizar o sistema operacional do host para o ONTAP Mediator para uma versão posterior, você deve primeiro desinstalar o ONTAP Mediator.

Antes de começar

As melhores práticas para instalar o Red Hat Enterprise Linux ou Rocky Linux e os repositórios associados em seu sistema estão listados abaixo. Os sistemas instalados ou configurados de forma diferente podem exigir etapas adicionais.

  • Você deve instalar o Red Hat Enterprise Linux ou Rocky Linux de acordo com as melhores práticas da Red Hat. Devido ao suporte de fim de vida para versões CentOS 8.x, não são recomendadas versões compatíveis do CentOS 8.x.

  • Durante a instalação do serviço ONTAP Mediator no Red Hat Enterprise Linux ou Rocky Linux, o sistema deve ter acesso ao repositório apropriado para que o programa de instalação possa acessar e instalar todas as dependências de software necessárias.

  • Para que o instalador do yum encontre software dependente nos repositórios Red Hat Enterprise Linux, você deve ter registrado o sistema durante a instalação do Red Hat Enterprise Linux ou depois usando uma assinatura válida do Red Hat.

    Consulte a documentação da Red Hat para obter informações sobre o Red Hat Subscription Manager.

  • As seguintes portas devem ser não utilizadas e disponíveis para o Mediador:

    • 31784

    • 3260

  • Se estiver a utilizar uma firewall de terceiros: Consulte "Requisitos de firewall para o ONTAP Mediator"

  • Se o host Linux estiver em um local sem acesso à internet, você deve garantir que os pacotes necessários estejam disponíveis em um repositório local.

    Se você estiver usando o Link Aggregation Control Protocol (LACP) em um ambiente Linux, você deve configurar corretamente o kernel e certificar-se de que o sysctl net.ipv4.conf.all.arp_ignore está definido como "2".

O que você vai precisar

Os seguintes pacotes são exigidos pelo serviço Mediador ONTAP:

Todas as versões RHEL/CentOS

Pacotes adicionais para RHEL 8.x / Rocky Linux 8

Pacotes adicionais para RHEL 9.x / Rocky Linux 9

  • openssl

  • openssl-devel

  • kernel-devel (uname -r)

  • gcc

  • marca

  • libselinux-utils

  • patch

  • bzip2

  • perl-Data-Dumper

  • perl-ExtUtils-MakeMaker

  • efibootmgr

  • mokutil

  • python3 pip

  • elfutils-libelf-devel

  • policycoreutils-python-utils

  • redhat-lsb-core

  • python39

  • python39-nível

  • python3 pip

  • elfutils-libelf-devel

  • policycoreutils-python-utils

  • python3

  • python3-nível

O pacote de instalação Mediator é um arquivo tar compactado auto-extraível que inclui:

  • Um arquivo RPM contendo todas as dependências que não podem ser obtidas do repositório da versão suportada.

  • Um script de instalação.

Recomenda-se uma certificação SSL válida.

Sobre esta tarefa

Quando você atualiza o sistema operacional do host para o ONTAP Mediator para uma versão maior posterior (por exemplo, de 7.x para 8.x) usando a ferramenta leapp-upgrade, você deve desinstalar o ONTAP Mediator porque a ferramenta tenta detetar novas versões de quaisquer RPMs instalados nos repositórios que estão registrados no sistema.

Como um arquivo .rpm foi instalado como parte do instalador do ONTAP Mediator, ele está incluído nessa pesquisa. No entanto, como o arquivo .rpm foi descompactado como parte do instalador e não baixado de um repositório registrado, não é possível encontrar uma atualização. Neste caso, a ferramenta leapp-upgrade desinstala o pacote.

Para preservar os arquivos de log, que serão usados para triagem de casos de suporte, você deve fazer backup dos arquivos antes de fazer uma atualização do sistema operacional e restaurá-los após uma reinstalação do pacote do ONTAP Mediator. Como o Mediador ONTAP está sendo reinstalado, todos os clusters ONTAP que estão conetados a ele precisarão ser reconetados após a nova instalação.

Observação As etapas a seguir devem ser executadas em ordem. Imediatamente após reinstalar o ONTAP Mediator, você deve parar o serviço ONTAP_Mediator, substituir os arquivos de log e reiniciar o serviço. Isso garantirá que os logs não sejam perdidos.
Passos
  1. Faça uma cópia de segurança dos ficheiros de registo.

    [rootmediator-host ~]# tar -czf ontap_mediator_file_backup.tgz -C /opt/netapp/lib/ontap_mediator ./log ./ontap_mediator/server_config/ontap_mediator.user_config.yaml
    [rootmediator-host ~]# tar -tf ontap_mediator_file_backup.tgz
    ./log/
    ./log/ontap_mediator.log
    ./log/scstadmin.log
    ./log/ontap_mediator_stdout.log
    ./log/ontap_mediator_requests.log
    ./log/install_20230419134611.log
    ./log/scst.log
    ./log/ontap_mediator_syslog.log
    ./ontap_mediator/server_config/ontap_mediator.user_config.yaml
    [rootmediator-host ~]#
  2. Execute a atualização com a ferramenta leapp-upgrade.

    [rootmediator-host ~]# leapp preupgrade --target 8.4
      ..<snip upgrade checks>..
      ..<fix issues found>..
    [rootmediator-host ~]# leapp upgrade --target 8.4
      ..<snip upgrade>..
    [rootmediator-host ~]# cat /etc/os-release | head -2
    NAME="Red Hat Enterprise Linux"
    VERSION="8.4 (Ootpa)"
    [rootmediator-host ~]#
  3. Reinstale o Mediador ONTAP.

    Observação Execute o resto das etapas imediatamente após reinstalar o ONTAP Mediator para evitar a perda de arquivos de log.
    [rootmediator-host ~]# ontap-mediator-1.9.0/ontap-mediator-1.9.0
    
    ONTAP Mediator: Self Extracting Installer
    
      ..<snip installation>..
    [rootmediator-host ~]#
  4. Pare o serviço ONTAP_Mediator.

    [rootmediator-host ~]# systemctl stop ontap_mediator
    [rootmediator-host ~]#
  5. Substitua os arquivos de log.

    [rootmediator-host ~]# tar -xf ontap_mediator_log_backup.tgz -C /opt/netapp/lib/ontap_mediator
    [rootmediator-host ~]#
  6. Inicie o serviço ONTAP_Mediator.

    [rootmediator-host ~]# systemctl start ontap_mediator
    [rootmediator-host ~]#
  7. Reconecte todos os clusters do ONTAP ao mediador do ONTAP atualizado

    Procedimento para MetroCluster sobre IP
    siteA::> metrocluster configuration-settings mediator show
    Mediator IP     Port    Node                    Configuration Connection
                                                    Status        Status
    --------------- ------- ----------------------- ------------- -----------
    172.31.40.122
                    31784   siteA-node2             true          false
                            siteA-node1             true          false
                            siteB-node2             true          false
                            siteB-node2             true          false
    siteA::> metrocluster configuration-settings mediator remove
    Removing the mediator and disabling Automatic Unplanned Switchover. It may take a few minutes to complete.
    Please enter the username for the mediator: mediatoradmin
    Please enter the password for the mediator:
    Confirm the mediator password:
    Automatic Unplanned Switchover is disabled for all nodes...
    Removing mediator mailboxes...
    Successfully removed the mediator.
    
    siteA::> metrocluster configuration-settings mediator add -mediator-address 172.31.40.122
    Adding the mediator and enabling Automatic Unplanned Switchover. It may take a few minutes to complete.
    Please enter the username for the mediator: mediatoradmin
    Please enter the password for the mediator:
    Confirm the mediator password:
    Successfully added the mediator.
    
    siteA::> metrocluster configuration-settings mediator show
    Mediator IP     Port    Node                    Configuration Connection
                                                    Status        Status
    --------------- ------- ----------------------- ------------- -----------
    172.31.40.122
                    31784   siteA-node2             true          true
                            siteA-node1             true          true
                            siteB-node2             true          true
                            siteB-node2             true          true
    siteA::>
Procedimento para sincronização ativa do SnapMirror

Para a sincronização ativa do SnapMirror, se você instalou o certificado TLS fora do diretório /opt/NetApp, então você não precisará reinstalá-lo. Se você estava usando o certificado autoassinado gerado padrão ou colocou seu certificado personalizado no diretório /opt/NetApp, então você deve fazer o backup e restaurá-lo.

peer1::> snapmirror mediator show
Mediator Address Peer Cluster     Connection Status Quorum Status
---------------- ---------------- ----------------- -------------
172.31.49.237    peer2            unreachable       true

peer1::> snapmirror mediator remove -mediator-address 172.31.49.237 -peer-cluster peer2

Info: [Job 39] 'mediator remove' job queued

peer1::> job show -id 39
                            Owning
Job ID Name                 Vserver    Node           State
------ -------------------- ---------- -------------- ----------
39     mediator remove      peer1      peer1-node1    Success
     Description: Removing entry in mediator

peer1::> security certificate show -common-name ONTAPMediatorCA
Vserver    Serial Number   Certificate Name                       Type
---------- --------------- -------------------------------------- ------------
peer1
        4A790360081F41145E14C5D7CE721DC6C210007F
                        ONTAPMediatorCA                        server-ca
    Certificate Authority: ONTAP Mediator CA
        Expiration Date: Mon Apr 17 10:27:54 2073

peer1::> security certificate delete -common-name ONTAPMediatorCA *
1 entry was deleted.

 peer1::> security certificate install -type server-ca -vserver peer1

Please enter Certificate: Press <Enter> when done
  ..<snip ONTAP Mediator CA public key>..

You should keep a copy of the CA-signed digital certificate for future reference.

The installed certificate's CA and serial number for reference:
CA: ONTAP Mediator CA
serial: 44786524464C5113D5EC966779D3002135EA4254

The certificate's generated name for reference: ONTAPMediatorCA

peer2::> security certificate delete -common-name ONTAPMediatorCA *
1 entry was deleted.

peer2::> security certificate install -type server-ca -vserver peer2

 Please enter Certificate: Press <Enter> when done
..<snip ONTAP Mediator CA public key>..


You should keep a copy of the CA-signed digital certificate for future reference.

The installed certificate's CA and serial number for reference:
CA: ONTAP Mediator CA
serial: 44786524464C5113D5EC966779D3002135EA4254

The certificate's generated name for reference: ONTAPMediatorCA

peer1::> snapmirror mediator add -mediator-address 172.31.49.237 -peer-cluster peer2 -username mediatoradmin

Notice: Enter the mediator password.

Enter the password:
Enter the password again:

Info: [Job: 43] 'mediator add' job queued

peer1::> job show -id 43
                            Owning
Job ID Name                 Vserver    Node           State
------ -------------------- ---------- -------------- ----------
43     mediator add         peer1      peer1-node2    Success
    Description: Creating a mediator entry

peer1::> snapmirror mediator show
Mediator Address Peer Cluster     Connection Status Quorum Status
---------------- ---------------- ----------------- -------------
172.31.49.237    peer2            connected         true

peer1::>