Atualize o Apigee Edge 4.17.05 ou 4.17.09 para 4.18.05

Edge para nuvem privada v4.18.05

Nesta seção, descrevemos como realizar os seguintes upgrades:

  • De 4.17.05 a 4.18.05
  • De 4.17.09 a 4.18.05

Quem pode executar a atualização

O usuário que está executando a atualização precisa ser o mesmo que instalou o Edge ou um usuário que está executando como raiz.

Depois que você instalar as RPMs do Edge, qualquer usuário poderá configurá-las.

Quais componentes você precisa atualizar

Todos os componentes do Edge precisam ser atualizados. O Edge não oferece suporte a uma configuração que contenha componentes de várias versões.

Manter a compatibilidade

Ao fazer upgrade do Apigee Edge para nuvem privada para a versão 4.18.05, você precisa garantir que a implementação resultante referencie apenas propriedades compatíveis nos arquivos de configuração.

Propriedade Local Descrição
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties Remova essa propriedade do arquivo router.properties. Para definir opções de repetição na versão 4.18.05, use as propriedades de configuração de host virtual.

Propagação automática de configurações de propriedade

Se você tiver definido alguma propriedade editando arquivos .properties em /opt/apigee/customer/application, esses valores serão retidos pela atualização.

Adição obrigatória do parâmetro de configuração SMTPMAILFROM

O Edge 4.17.05 adicionou um novo parâmetro obrigatório ao arquivo de configuração usado quando você ativa um servidor SMTP.

Upgrade obrigatório para o Postgres 9.6

Esta versão do Edge inclui um upgrade para o Postgres 9.6. Como parte desse upgrade, todos os dados do Postgres são migrados para o Postgres 9.6.

A maioria dos sistemas de produção de borda usa dois nós Postgres configurados para replicação mestre em espera. Durante o processo de atualização, enquanto os nós do Postgres estão inativos para atualização, os dados de análise ainda são gravados nos nós do Qpid. Depois que os nós do Postgres são atualizados e ficam on-line novamente, os dados de análise são enviados a eles.

A maneira como você executa a atualização do Postgres depende de como o armazenamento de dados foi configurado para os nós do Postgres:

  • Se você usar armazenamento de dados locais para os nós do Postgres, precisará instalar um novo nó de espera do Postgres durante o upgrade. Após a conclusão do upgrade, será possível desativar o novo nó de espera do Postgres.

    O nó de espera do Postgres adicional será necessário se você precisar reverter a atualização por qualquer motivo. Se você precisar reverter a atualização, o novo nó de espera do Postgres se tornará o nó mestre do Postgres após a reversão. Portanto, quando você instalar o novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de hardware de um servidor do Postgres, conforme definido nos Requisitos de instalação do Edge.

    Em uma instalação de um e dois nós do Edge, topologias usadas para prototipagem e testes, você tem apenas um nó do Postgres. É possível atualizar esses nós do Postgres diretamente, sem precisar criar um novo nó.

  • Se você usa armazenamento de rede para os nós do Postgres, conforme recomendado pela Apigee, não precisa instalar um novo nó do Postgres. Nos procedimentos abaixo, é possível pular as etapas que especificam a instalação e desativação de um novo nó de espera do Postgres.

    Antes de iniciar o processo de atualização, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Em seguida, se ocorrer um erro durante a atualização e você precisar realizar uma reversão, restaure o nó do Postgres desse snapshot.

Como instalar um novo nó de espera do Postgres

Este procedimento cria um servidor em espera do Postgres em um novo nó. Verifique se você instalou um novo servidor em espera do Postgres para a versão atual do Edge (4.17.05 ou 4.17.09), e não para a 4.18.05.

Para executar a instalação, use o mesmo arquivo de configuração usado para instalar a versão atual do Edge.

Para criar um novo nó de espera do Postgres:

  1. No mestre atual do Postgres, edite o arquivo /opt/apigee/customer/application/postgresql.properties para definir o token a seguir. Se esse arquivo não existir, crie-o:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    em que existing_slave_ip é o endereço IP do servidor em espera atual do Postgres e new_slave_ip é o endereço IP do novo nó de espera.

  2. Reinicie apigee-postgresql no mestre do Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifique se o novo nó de espera foi adicionado visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Você verá as seguintes linhas nesse arquivo:
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. Instale o novo servidor em espera do Postgres:
    1. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102
    2. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
    3. Faça o download do arquivo Edge bootstrap_4.17.0x.sh, em que x é 5 (para 4.17.05) ou 9 (para 4.17.09) para /tmp/bootstrap_4.17.0x.sh :
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Instale o utilitário e as dependências do Edge apigee-service:
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. Use apigee-service para instalar o utilitário apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Instale o Postgres:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. No novo nó de espera, execute o seguinte comando:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confirme se ele diz que é o de espera.

Como desativar um nó do Postgres

Depois que a atualização for concluída, desative o novo nó de espera:

  1. Verifique se o Postgres está sendo executado:
    /opt/apigee/apigee-service/bin/apigee-all status

    Inicie o Postgres, se ele não estiver em execução:

    /opt/apigee/apigee-service/bin/apigee-all start

  2. Consiga o UUID do novo nó de espera executando o seguinte comando cURL no novo nó de espera:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    É exibido o UUID do nó no final da saída, no formato:

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Pare o novo nó de espera executando o seguinte comando nele:
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. No nó mestre do Postgres, edite /opt/apigee/customer/application/postgresql.properties para remover o novo nó de espera de conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
  5. Reinicie o apigee-postgresql no mestre do Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Verifique se o novo nó de espera foi removido visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Apenas esta linha vai aparecer nesse arquivo:
    host replication apigee existing_slave_ip/32 trust
  7. Exclua o UUID do nó em espera do ZooKeeper fazendo a seguinte chamada da API de gerenciamento de borda no nó do servidor de gerenciamento:
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

Atualizar pré-requisitos

Verifique os seguintes pré-requisitos antes de fazer upgrade do Apigee Edge:

  • Fazer backup de todos os nós
    Antes da atualização, é recomendável fazer um backup completo de todos os nós por motivos de segurança. Use o procedimento da sua versão atual do Edge para fazer o backup.

    Isso permite que você tenha um plano de backup caso a atualização para uma nova versão não funcione corretamente. Para mais informações sobre backup, consulte Backup e restauração.

  • Verifique se o Edge está em execução
    Verifique se o Edge está funcionando durante o processo de atualização usando o comando:
    /opt/apigee/apigee-service/bin/apigee-all status

Como lidar com uma atualização com falha

Em caso de falha na atualização, tente corrigir o problema e execute update.sh novamente. Você pode executar a atualização várias vezes e ela continua de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte Reverter 4.18.05 para saber mais.

Como registrar informações de atualização

Por padrão, o utilitário update.sh grava informações de registro em:

/opt/apigee/var/log/apigee-setup/update.log

Se o usuário que executa o utilitário update.sh não tiver acesso a esse diretório, ele gravará o registro no diretório /tmp como um arquivo chamado update_username.log.

Se o usuário não tiver acesso ao /tmp, o utilitário update.sh falhará.

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite atualizar a instalação do Edge sem derrubar o Edge.

A atualização sem inatividade só é possível com uma configuração de cinco nós ou mais.

A chave para o upgrade sem inatividade é remover cada roteador, um de cada vez, do balanceador de carga. Em seguida, atualize o roteador e todos os outros componentes na mesma máquina que o roteador e, em seguida, adicione o roteador de volta ao balanceador de carga.

  1. Atualize as máquinas na ordem correta da instalação, conforme descrito em Ordem de atualização da máquina.
  2. Quando você precisar atualizar os roteadores, selecione um deles e torne-o inacessível, conforme descrito em Como ativar/desativar a acessibilidade do servidor (processador de mensagens/roteador).
  3. Atualize o roteador selecionado e todos os outros componentes de borda na mesma máquina que o roteador. Todas as configurações de borda mostram um roteador e um processador de mensagens no mesmo nó.
  4. Torne o roteador acessível novamente.
  5. Repita as etapas de 2 a 4 para os outros roteadores.
  6. Continue a atualização para as máquinas restantes na instalação.

Tome cuidado com o seguinte antes/depois da atualização:

  • No nó combinado do roteador e processador de mensagens:
    • Antes da atualização, faça o seguinte:
      1. Torne o roteador inacessível.
      2. Torne o processador de mensagens inacessível.
    • Depois da atualização, faça o seguinte:
      1. Torne o processador de mensagens acessível.
      2. Torne o roteador acessível.
  • No único nó do roteador:
    • Antes da atualização, torne o roteador inacessível.
    • Após a atualização, torne o roteador acessível.
  • Em um único nó do processador de mensagens:
    • Antes da atualização, torne o processador de mensagens inacessível.
    • Após a atualização, torne o processador de mensagens acessível.

Como usar um arquivo de configuração silencioso

É necessário transmitir um arquivo de configuração silencioso para o comando de atualização. O arquivo de configuração silenciosa precisa ser o mesmo que você usou para instalar o Edge 4.17.0x.

Atualização para a versão 4.18.05 em um nó com uma conexão de Internet externa

Use o procedimento a seguir para atualizar os componentes do Edge em um nó:

  1. Se você estiver usando atualmente a replicação mestre em espera do Postgres com armazenamento local, instale um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Em vez disso, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  2. Se estiver presente, desative todos os jobs CRON configurados para executar uma operação de reparo no Cassandra até que a atualização seja concluída.
  3. Faça login no nó como raiz para instalar as RPMs do Edge.
  4. Instale yum-utils e yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
  6. Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
    sudo yum-config-manager --enable ol7_optional_latest
  7. Se você estiver instalando na AWS, execute os seguintes comandos yum-configure-manager:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Faça o download do arquivo bootstrap_4.18.05.sh do Edge 4.18.05 para /tmp/bootstrap_4.18.05.sh:
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Instale o utilitário apigee-service e as dependências do Edge 4.18.05:
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado que o insira.

    Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, ele vai instalar o pacote para você. Use a opção JAVA_FIX para especificar como processar a instalação do Java. JAVA_FIX usa estes valores:

    • I = Instalar o OpenJDK 1.8 (padrão)
    • C = Continuar sem instalar o Java
    • Q = sair. Para essa opção, você precisa instalar o Java por conta própria.
  10. Use apigee-service para atualizar o utilitário apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Atualize o utilitário apigee-provision:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Execute o utilitário de atualização nos nós na ordem descrita em Ordem de atualização da máquina:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    O único requisito do arquivo de configuração é que ele precisa estar acessível ou legível pelo usuário "apigee".

    Use a opção -c para especificar o componente a ser atualizado. A lista de possíveis componentes inclui:

    • "cs" = Cassandra
    • "e" = ElasticSearch
    • "edge" =Todos os componentes do Edge, exceto a interface do Edge. O componente "edge" inclui o Servidor de gerenciamento, o processador de mensagens, o roteador, o servidor QPID e o servidor do Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = SSO no Edge
    • "ui" = interface do usuário do Edge
    • "zk" = tratador

    É possível executar update.sh em todos os componentes definindo component como "todos", mas somente se você tiver um perfil de instalação do Edge all-in-one (aio). Exemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Reinicie o componente de interface do Edge em todas as máquinas que o executam, se ainda não tiver feito isso:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
  16. Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito em Como desativar um nó do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Consulte Upgrade obrigatório para o Postgres 9.6 para mais informações.

Para reverter a atualização posteriormente, use o procedimento descrito em Reverter 4.18.05.

Atualização para 4.18.05 a partir de um repositório local

Se os nós do Edge estiverem protegidos por firewall ou, de alguma outra forma, estiverem proibidos de acessar o repositório da Apigee pela Internet, realize a atualização a partir de um repositório local, ou espelho, do repositório da Apigee.

Depois de criar um repositório local do Edge, você terá duas opções para atualizar o Edge a partir do repositório local:

  • Crie um arquivo .tar do repositório, copie-o em um nó e atualize o Edge a partir dele.
  • Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. A Apigee fornece o servidor da Web Nginx para você usar, mas também é possível usar seu próprio servidor da Web.

Para atualizar de um repositório 4.18.05 local:

  1. Se você estiver usando a replicação mestre em espera do Postgres, instale um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Em vez disso, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  2. Crie um repositório 4.18.05 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee Apigee.
  3. Para instalar o apigee-service em um arquivo .tar:
    1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz:
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
    3. No novo nó, descompacte o arquivo no diretório /tmp:
      tar -xzf apigee-4.18.05tar.gz

      Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo, /tmp/repos.

    4. Instale o utilitário apigee-service do Edge e as dependências de /tmp/repos:
      sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Observe que você incluiu o caminho para o diretório de repositórios nesse comando.

  4. Para instalar o serviço da Apigee usando o servidor da Web Nginx:
    1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o servidor da Web Nginx" em Instalar o utilitário apigee-setup do Edge.
    2. No nó remoto, faça o download do arquivo bootstrap_4.18.05.sh do Edge para /tmp/bootstrap_4.18.05.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

      Em que uName:pWord é o nome de usuário e a senha que você definiu anteriormente para o repositório, e remoteRepo é o endereço IP ou nome DNS do nó do repositório.

    3. No nó remoto, instale o utilitário apigee-service e as dependências do Edge:
      sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Em que uName:pWord é o nome de usuário e a senha do repo.

  5. Use apigee-service para atualizar o utilitário apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  6. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Atualize o utilitário apigee-provision:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Execute o utilitário update nos nós na ordem descrita em Ordem de atualização da máquina:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    O único requisito do arquivo de configuração é que ele precise estar acessível ou legível para o usuário "apigee".

    Use a opção -c para especificar o componente a ser atualizado. A lista de possíveis componentes inclui:

    • "cs" = Cassandra
    • "e" = ElasticSearch
    • "edge" =Todos os componentes do Edge, exceto a interface do Edge. O componente "edge" inclui o Servidor de gerenciamento, o processador de mensagens, o roteador, o servidor QPID e o servidor do Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = SSO no Edge
    • "ui" = interface do usuário do Edge
    • "zk" = tratador

    É possível executar update.sh em todos os componentes definindo component como "todos", mas somente se você tiver um perfil de instalação do Edge all-in-one (aio). Exemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Reinicie o componente de interface do Edge em todas as máquinas que o executam, se ainda não tiver feito isso:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
  11. Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito em Como desativar um nó do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

Para reverter a atualização posteriormente, use o procedimento descrito em Reverter 4.18.05.

Ordem de atualização da máquina

A ordem de atualização das máquinas em uma instalação do Edge é importante. As considerações mais importantes para uma atualização são:

  • É preciso atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar os outros.
  • Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, mas não servidor Postgres), use a opção "-c borda" para atualizar todos ao mesmo tempo.
  • Se uma etapa especificar que ela precisa ser executada em várias máquinas, execute-a na ordem especificada.
  • Não há uma etapa separada para atualizar a monetização. Ela é atualizada quando você especifica a opção "-c borda".

Instalação autônoma de um nó

  1. Atualize o Cassandra e o ZooKeeper:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualizar Qpid:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualizar LDAP:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Interrompa os servidores Postgres, Qpid e PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Atualize o postgresql:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Atualize o banco de dados do Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. Atualize os componentes do Edge restantes:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Atualizar interface do Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (Se você instalou o SSO do Edge) Atualize o SSO do Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.

  10. Reinicie o componente de IU do Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Instalação autônoma de dois nós

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.

  1. Atualize o Cassandra e o ZooKeeper na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualize o Qpid na máquina 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualize o LDAP na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Atualize os componentes do Edge na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Atualize a IU na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Se você instalou o SSO do Edge) Atualize o SSO do Edge na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.

  7. Atualize o postgresql na máquina 2:
    1. Interrompa os servidores Postgres, Qpid e postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Atualize o postgresql:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Atualize o banco de dados do Postgres:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Atualize os componentes do Edge na máquina 2:
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Reinicie o componente de IU do Edge na máquina 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Instalação de cinco nós

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Em vez disso, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  2. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid nas máquinas 4 e 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge nas máquinas 1, 2, 3:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a IU na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o SSO do Edge) Atualize o SSO do Edge na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.

  8. Atualize as máquinas 4 e 5:
    1. Interrompa os servidores Postgres e Qpid na máquina 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Interrompa os servidores Postgres, Qpid e postgresql na máquina 5:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Se instalado, interrompa o servidor Postgres e o postgresql no novo nó de espera adicionado para reversão:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Atualize o postgresql nas máquinas 4:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Atualize o banco de dados do Postgres na máquina 4 (somente mestre do Postgres):
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Atualize o postgresql nas máquinas 5:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicie os servidores Postgres e Qpid nas máquinas 4 e 5:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 5:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. Verifique o status da replicação emitindo os seguintes scripts nos dois servidores. O sistema precisa mostrar resultados idênticos nos dois servidores para garantir uma replicação bem-sucedida:
      • Na máquina 4, o nó mestre, execute:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Confirme se ele indica que é o mestre.

      • Na máquina 5, o nó de espera:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Confirme se ele diz que é o de espera.

  9. Atualize os componentes do Edge nas máquinas 4 e 5:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Desative o novo nó de espera conforme descrito em Como desativar um nó do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  11. Reinicie o componente de IU do Edge na máquina 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Instalação em cluster de nove nós

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Em vez disso, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  2. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid nas máquinas 6 e 7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge nas máquinas 6, 7, 1, 4 e 5 nesta ordem:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a IU na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o SSO do Edge) Atualize o SSO do Edge na máquina 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.

  8. Atualize as máquinas 8 e 9:
    1. Interrompa o servidor Postgres na máquina 8:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Pare o servidor Qpid nas máquinas 6 e 7:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se instalado, interrompa o servidor Postgres e o postgresql no novo nó de espera adicionado para reversão:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualize o postgresql nas máquinas 8:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o banco de dados do Postgres na máquina 8 (somente mestre do Postgres):
      /-->
      opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Atualize o postgresql nas máquinas 9:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicie o servidor Postgres nas máquinas 8 e 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Inicie o servidor do servidor Qpid nas máquinas 6 e 7:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 9:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Verifique o status da replicação emitindo os seguintes scripts nos dois servidores. O sistema precisa mostrar resultados idênticos nos dois servidores para garantir uma replicação bem-sucedida:
      • Na máquina 8, o nó mestre, execute:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Confirme se ele indica que é o mestre.

      • Na máquina 9, o nó de espera:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Confirme se ele diz que é o de espera.

  9. Atualize os componentes do Edge nas máquinas 8 e 9:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Desative o novo nó de espera conforme descrito em Como desativar um nó do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  11. Reinicie o componente de IU do Edge na máquina 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Instalação em cluster de 13 nós

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Em vez disso, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  2. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid nas máquinas 12 e 13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP nas máquinas 4 e 5:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge nas máquinas 12, 13, 6, 7, 10 e 11 nesta ordem:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a IU nas máquinas 6 e 7:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o SSO do Edge) Atualize o SSO do Edge nas máquinas 6 e 7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.

  8. Atualize as máquinas 8 e 9:
    1. Interrompa o servidor Postgres na máquina 8:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Pare o servidor Qpid nas máquinas 12 e 13:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se instalado, interrompa o servidor Postgres e o postgresql no novo nó de espera adicionado para reversão:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualize o postgresql nas máquinas 8:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o banco de dados do Postgres na máquina 8 (somente mestre do Postgres):
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Atualize o postgresql nas máquinas 9:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicie o servidor Postgres nas máquinas 8 e 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Inicie o servidor do servidor Qpid nas máquinas 12 e 13:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 9:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Verifique o status da replicação emitindo os seguintes scripts nos dois servidores. O sistema precisa mostrar resultados idênticos nos dois servidores para garantir uma replicação bem-sucedida:
      • Na máquina 8, o nó mestre, execute:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Confirme se ele indica que é o mestre.

      • Na máquina 9, o nó de espera:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Confirme se ele diz que é o de espera.

  9. Atualize os componentes do Edge nas máquinas 8 e 9:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Desative o novo nó de espera conforme descrito em Como desativar um nó do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Para saber mais, consulte Upgrade obrigatório para o Postgres 9.6.

  11. Reinicie o componente de IU do Edge nas máquinas 6 e 7:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Instalação em cluster de 12 nós

Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Em vez disso, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Consulte Upgrade obrigatório para o Postgres 9.6 para mais informações.

  2. Atualize o Cassandra e o ZooKeeper:
    1. Nas máquinas 1, 2 e 3 no data center 1:
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Nas máquinas 7, 8 e 9 no data center 2
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o qpidd:
    1. Máquinas 4, 5 no data center 1
      1. Atualize o qpidd na máquina 4:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Repita a etapa 1 na máquina 5.
    2. Máquinas 10, 11 no data center 2
      1. Atualize qpidd na máquina 10:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Repita a etapa 1 na máquina 11.
  4. Atualize o LDAP:
    1. Máquinas 1 no data center 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquinas 7 no data center 2
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge:
    1. Máquinas 4, 5, 1, 2, 3 no data center 1
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 7, 8, 9 no data center 2
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a interface:
    1. Máquina 1 no Data center 1:
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Máquina 7 no data center 2:
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o SSO do Edge) Atualize o SSO do Edge:
    1. Máquina 1 no Data center 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Máquina 7 no data center 2:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.

  8. Atualize a máquina 6 no data center 1 e 12 no data center 2:
    1. Interrompa o servidor Postgres na máquina 6:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 12:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Pare o servidor Qpid nas máquinas 4, 5, 10 e 11:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se instalado, interrompa o servidor Postgres e o postgresql no novo nó de espera adicionado para reversão:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualize o postgresql nas máquinas 6:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o banco de dados do Postgres na máquina 6 (somente mestre do Postgres):
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Atualize o postgresql nas máquinas 12:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicie o servidor Postgres nas máquinas 6 e 12:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 4, 5, 10 e 11:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 12:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Verifique o status da replicação emitindo os seguintes scripts nos dois servidores. O sistema precisa exibir resultados idênticos nos dois servidores para garantir uma replicação bem-sucedida:

      Na máquina 6, o nó mestre, execute:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Confirme se ele indica que é o mestre.

      Na máquina 12, o nó de espera:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confirme se ele diz que é o de espera.

  9. Atualize os componentes do Edge nas máquinas 6 e 12:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Desative o novo nó de espera conforme descrito em Como desativar um nó do Postgres.

    Se você estiver usando armazenamento em rede, não vai precisar instalar o novo nó. Consulte Upgrade obrigatório para o Postgres 9.6 para mais informações.

  11. Reinicie o componente de IU do Edge nas máquinas 1 e 7:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Para uma instalação não padrão

Se você tiver uma instalação não padrão, atualize os componentes do Edge na seguinte ordem:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, que significa o perfil "-c borda" em todos os nós na ordem: nós com servidor Qpid, servidor Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
  6. interface do Edge
  7. SSO de borda

Depois de concluir a atualização, reinicie o componente da interface do Edge em todas as máquinas que o executam.