Atualize o Apigee Edge 4.19.06 ou 4.50.00 para 4.51.00

Esta seção descreve como fazer upgrade da Apigee Edge 4.19.06 ou 4.50.00 para a 4.51.00.

Quem pode fazer a atualização

A pessoa que executa a atualização precisa ser a mesma que instalou o Edge originalmente ou uma pessoa que executa como raiz.

Depois de instalar os RPMs do Edge, qualquer pessoa pode fazer a configuração.

Quais componentes você precisa atualizar

É necessário atualizar todos os componentes do Edge. O Edge não oferece suporte a uma configuração que contenha componentes de várias versões.

Propagação automática das configurações da propriedade

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

Upgrade necessário para o Postgres 10.17

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

A maioria dos sistemas de produção do Edge usa dois nós do Postgres configurados para a replicação mestre-standby. 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 Qpid. Depois que os nós do Postgres são atualizados e voltam a ficar on-line, os dados de análise são enviados para eles.

A forma como você executa a atualização do Postgres depende de como você configurou o armazenamento de dados para seus nós do Postgres:

  • Se você usa armazenamento de dados local para seus nós do Postgres, instale um novo nó de reserva do Postgres durante o upgrade. Após a conclusão do upgrade, você pode desativação o novo nó de espera do Postgres.

    O nó de espera adicional do Postgres é 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 vai se tornar o nó mestre do Postgres após a reversão. Portanto, ao 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 configuração de um e dois nós do Edge, as topologias usadas para prototipagem e testes têm apenas um nó do Postgres. É possível atualizar esses nós do Postgres diretamente sem precisar criar um novo nó do Postgres.

  • Se você usa armazenamento de rede para seus nós do Postgres, conforme recomendado pela Apigee, não é necessário instalar um novo nó do Postgres. Nos procedimentos abaixo, você pode pular as etapas que especificam a instalação e, posteriormente, a desativação de um novo nó de espera do Postgres.

    Antes de iniciar o processo de atualização, tire um snapshot de rede do repositório de dados usado pelo Postgres. Em seguida, se ocorrerem erros durante a atualização e você for forçado a fazer um rollback, é possível restaurar o nó do Postgres usando esse snapshot.

Instalação de um novo nó de standby do Postgres

Este procedimento cria um servidor de reserva do Postgres em um novo nó. Instale um novo servidor de espera do Postgres para a versão atual do Edge (4.19.06 ou 4.50.00), não para a versão 4.51.00.

Para realizar 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 reserva do Postgres:

  1. No mestre do Postgres atual, 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_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Em que existing_standby_ip é o endereço IP do servidor de espera do Postgres atual e new_standby_ip é o endereço IP do novo nó de espera.

  2. Reinicie o apigee-postgresql no mestre do Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifique se o novo nó reserva foi adicionado acessando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Você vai encontrar as seguintes linhas nesse arquivo: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Instale o novo servidor de reserva 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 apigee-setup do Edge.
    3. Siga um destes procedimentos, dependendo da versão do Edge que você está atualizando:
      • Se você estiver fazendo upgrade do Edge 4.19.06, faça o download do arquivo bootstrap_4.19.06.sh do Edge para /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Em seguida, instale o utilitário apigee-service e as dependências do Edge: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Se você estiver fazendo upgrade do Edge 4.50.00, faça o download do arquivo bootstrap_4.50.00.sh do Edge para /tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Em seguida, instale o utilitário apigee-service e as dependências do Edge: 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    4. Use apigee-service para instalar o utilitário apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Instalar o Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. No novo nó de reserva, execute o seguinte comando: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Verifique se ele está em modo de espera.

Como fazer um upgrade no local do Postgres

Para fazer um upgrade no local para o Postgres 10.17, siga estas etapas:

  1. Faça upgrade do postgres no host mestre 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Execute o comando de configuração no host mestre: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Execute o comando de configuração no host mestre: 
    apigee-service apigee-postgresql configure
  4. Reinicie o host mestre: 
    apigee-service apigee-postgresql restart
  5. Configure como mestre: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Verifique se o host mestre foi iniciado: 
    apigee-service apigee-postgresql wait_for_ready
  7. Interromper a espera: 
    apigee-service apigee-postgresql stop
  8. Faça upgrade do modo de espera.

    Observação:se esta etapa apresentar erros, ela poderá ser ignorada. O update.sh vai tentar iniciar o servidor de espera com uma configuração incorreta. Desde que a instalação do Postgres seja atualizada para 10.17, o erro pode ser ignorado.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Verifique se o modo de espera foi interrompido: 
    apigee-service apigee-postgresql stop
  10. Remova a configuração de espera antiga: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Configure a replicação no servidor reserva: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Depois de concluir esse procedimento, a espera será iniciada.

Como descontinuar o uso de um nó do Postgres

Após a conclusão da atualização, desative o novo nó reserva:

  1. Verifique se o Postgres está em execução: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Se o Postgres não estiver em execução, inicie-o: 

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

  2. Para conferir o UUID do novo nó reserva, execute o comando curl a seguir no novo nó reserva: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    O UUID do nó vai aparecer no final da saída, no formato: 

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

  3. Pare o novo nó reserva executando o seguinte comando: 
    /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ó reserva de conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_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ó reserva foi removido acessando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Você vai encontrar apenas a seguinte linha nesse arquivo: 
    host replication apigee existing_standby_ip/32 trust
  7. Exclua o UUID do nó reserva do ZooKeeper fazendo a seguinte chamada de API de gerenciamento do Edge no nó do servidor de gerenciamento: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Atualizar pré-requisitos

Antes de fazer upgrade do Apigee Edge, siga os pré-requisitos abaixo:

  • Faça backup de todos os nós
    Antes de atualizar, recomendamos que você faça 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.

  • Confirmar que o Edge está em execução
    Use o comando para confirmar que o Edge está em execução durante o processo de atualização: 
    /opt/apigee/apigee-service/bin/apigee-all status

Nova interface do Edge

Esta seção lista considerações sobre a interface do Edge. Para mais informações, consulte A nova interface do Edge para nuvem privada.

Instalar a interface do Edge

Após a conclusão da instalação inicial, a Apigee recomenda instalar a interface do Edge, que é uma interface do usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada.

A interface do Edge exige que você desative a autenticação básica e use um IDP, como SAML ou LDAP.

Para mais informações, consulte Instalar a nova interface do Edge.

Atualizar a interface do Edge

Para atualizar o componente da interface do Edge, considere a versão do Edge para nuvem privada que você está atualizando:

Atualizar com o mTLS da Apigee

Para atualizar o Apigee mTLS , siga estas etapas:

Como reverter uma atualização

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 para a versão 4.51.00 para ver instruções detalhadas.

Informações de atualização de registro

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

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

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

Se a pessoa não tiver acesso a /tmp, o utilitário update.sh vai falhar.

Atualização sem inatividade

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

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

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

  1. Atualize as máquinas na ordem correta para sua instalação, conforme descrito em Ordem de atualização da máquina.
  2. Quando chegar a hora de atualizar os roteadores, selecione um e torne-o inacessível, conforme descrito em Ativar/desativar a acessibilidade do servidor (roteador/processador de mensagens).
  3. Atualiza o roteador selecionado e todos os outros componentes do Edge 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 2 a 4 para os roteadores restantes.
  6. Continue a atualização para as máquinas restantes na instalação.

Antes e depois da atualização, faça o seguinte:

Usar um arquivo de configuração silenciosa

É necessário transmitir um arquivo de configuração silenciosa para o comando de atualização. O arquivo de configuração silencioso precisa ser o mesmo usado para instalar o Edge 4.19.06 ou 4.50.00.

Atualizar para 4.51.00 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 houver, desative todos os jobs cron configurados para executar uma operação de reparo no Cassandra até que a atualização seja concluída.
  2. Faça login no nó como raiz para instalar os RPMs do Edge.
  3. Instale yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
  5. Se você estiver instalando no Oracle 7.x, execute o seguinte comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. 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
  7. Faça o download do arquivo bootstrap_4.51.00.sh do Edge 4.51.00 para /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Instale o utilitário apigee-service e as dependências do Edge 4.51.00 executando o seguinte comando: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    Por padrão, o instalador verifica se o Java 1.8 está instalado. Caso contrário, o instalador vai fazer isso por você.

    Use a opção JAVA_FIX para especificar como processar a instalação do Java. JAVA_FIX usa os seguintes valores:

    • I: instala o OpenJDK 1.8 (padrão).
    • C: continue sem instalar o Java.
    • Q: Sair. Para essa opção, você precisa instalar o Java.
  9. Use apigee-service para atualizar o utilitário apigee-setup, como mostra o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Atualize o utilitário apigee-validate no servidor de gerenciamento, conforme o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Atualize o utilitário apigee-provision no servidor de gerenciamento, conforme o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. Execute o utilitário update nos seus nós executando o seguinte comando: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Faça isso na ordem descrita em Ordem de atualização da máquina.

    Em que:

    • component é o componente do Edge a ser atualizado. Os valores possíveis incluem:
      • cs: Cassandra
      • edge: todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO da Apigee (se você instalou o SSO)
      • ue: nova interface do Edge
      • ui: interface clássica do Edge
      • zk: Zookeeper
    • configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação 4.19.06 ou 4.50.00.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. Reinicie o componente da interface do Edge em todos os nós que o executam, se ainda não tiver feito isso: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.

Se você decidir reverter a atualização mais tarde, use o procedimento descrito em Reverter a versão 4.51.00.

Atualizar para 4.51.00 usando um repositório local

Se os nós de borda estiverem atrás de um firewall ou de alguma outra forma não puderem acessar o repositório do Apigee pela Internet, será possível realizar a atualização em um repositório local ou espelho do repositório do Apigee.

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge no repositório local:

  • Crie um arquivo .tar do repositório, copie o arquivo .tar para um nó e atualize o Edge usando o arquivo .tar.
  • 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 ou você pode usar seu próprio servidor da Web.

Para atualizar de um repositório local 4.51.00:

  1. Crie um repositório local 4.51.00 conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup da Edge.
  2. Para instalar o apigee-service em um arquivo .tar:
    1. No nó com o repositório local, use o comando abaixo para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.51.00.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 para o diretório /tmp no novo nó.
    3. No novo nó, descompacte o arquivo para o diretório /tmp: 
      tar -xzf apigee-4.51.00.tar.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 do /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Observe que você inclui o caminho para o diretório de repositórios neste comando.

  3. Para instalar o apigee-service 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.51.00.sh do Edge para /tmp/bootstrap_4.51.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

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

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

      Onde uName:pWord são o nome de usuário e a senha do repositório.

  4. Use apigee-service para atualizar o utilitário apigee-setup, como mostra o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Atualize o utilitário apigee-validate no servidor de gerenciamento, conforme o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Atualize o utilitário apigee-provision no servidor de gerenciamento, conforme o exemplo abaixo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. 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

    Em que:

    • component é o componente do Edge a ser atualizado. Normalmente, você atualiza os seguintes componentes:
      • cs: Cassandra
      • edge: todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO da Apigee (se você instalou o SSO)
      • ue Nova interface do Edge
      • ui: interface clássica do Edge
      • zk: Zookeeper
    • configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.19.06 ou 4.50.00.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Reinicie os componentes da interface em todos os nós que os executam, se ainda não tiver feito isso: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.

Se você decidir reverter a atualização, use o procedimento descrito em Reverter a versão 4.51.00.

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma instalação de borda é importante:

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

Upgrade independente de 1 nó

Para fazer upgrade de uma configuração autônoma de 1 nó para a versão 4.51.00:

  1. Atualize todos os componentes: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Upgrade independente de dois nós

Atualize os seguintes componentes para uma instalação autônoma de dois nós:

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

  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 e o Postgres na máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -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 nas máquinas 2 e 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Atualize a interface na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Se você instalou o SSO do Apigee) Atualize o SSO do Apigee 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 que você criou ao instalar o SSO.

  8. Reinicie o componente da interface do Edge na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade de 5 nós

Atualize os seguintes componentes para uma instalação de cinco nós:

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

  1. 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
  2. Atualize o Qpid e o Postgres na máquina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Atualize o Qpid e o Postgres na máquina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -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 4, 5, 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a interface do Edge:
    • Interface clássica:se você estiver usando a interface clássica, atualize o componente ui na máquina 1, conforme mostrado no exemplo a seguir: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nova interface do Edge:se você instalou a nova interface do Edge, atualize o componente ue na máquina apropriada (pode não ser a máquina 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o SSO do Apigee) Atualize o SSO do Apigee 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 que você criou ao instalar o SSO.

  9. Reinicie o componente da interface:
    • Interface clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui na máquina 1, conforme mostrado no exemplo a seguir: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente edge-management-ui na máquina apropriada (pode não ser a máquina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade de cluster de 9 nós

Atualize os seguintes componentes para uma instalação em cluster de 9 nós:

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

  1. 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
  2. Atualização do Qpid nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualize o Postgres na máquina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Atualizar o Postgres na máquina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes de borda nas máquinas 6, 7, 8, 9, 1, 4 e 5 nesta ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize a nova interface (ue) ou a clássica (ui) na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Se você instalou o apigee-adminapi) Atualize o utilitário apigee-adminapi na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Se você instalou o SSO do Apigee) Atualize o SSO do Apigee 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 que você criou ao instalar o SSO.

  10. Reinicie o componente da interface:
    • Interface clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui na máquina 1, conforme mostrado no exemplo a seguir: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente edge-management-ui na máquina apropriada (pode não ser a máquina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade de cluster de 13 nós

Atualize os seguintes componentes para uma instalação em cluster de 13 nós:

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

  1. 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
  2. Atualização do Qpid nas máquinas 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualize o Postgres na máquina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Atualizar o Postgres na máquina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Atualize o LDAP nas máquinas 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes do Edge nas máquinas 12, 13, 8, 9, 6, 7, 10 e 11 nesta ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize a nova interface (ue) ou a clássica (ui) nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Se você instalou o apigee-adminapi) Atualizamos o utilitário apigee-adminapi nas máquinas 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Se você instalou o SSO do Apigee) Atualize o SSO do Apigee 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 que você criou ao instalar o SSO.

  10. Reinicie o componente da interface:
    • Interface clássica:se você estiver usando a interface clássica, reinicie o componente edge-ui nas máquinas 6 e 7, conforme mostrado no exemplo a seguir: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente edge-management-ui nas máquinas 6 e 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade de cluster de 12 nós

Atualize os seguintes componentes para uma instalação em cluster de 12 nós:

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

  1. 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
  2. Atualização do qpidd:
    1. Máquinas 4 e 5 no data center 1
      1. Atualizar qpidd na máquina 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Atualize qpidd na máquina 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Máquinas 10 e 11 no data center 2
      1. Atualize qpidd na máquina 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Atualize qpidd na máquina 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualizar o Postgres:
    1. Máquina 6 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Máquina 12 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Atualizar o LDAP:
    1. Máquina 1 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquina 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, 6, 1, 2 e 3 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 12, 7, 8 e 9 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a nova interface (ue) ou a clássica (ui):
    1. Máquina 1 no data center 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Máquina 7 no data center 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Se você instalou o apigee-adminapi) Atualizou o utilitário apigee-adminapi:
    1. Máquina 1 no data center 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Máquina 7 no data center 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o Apigee SSO) Atualize o Apigee SSO:
    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 que você criou ao instalar o SSO.

  9. Reinicie o componente da nova interface do Edge (edge-management-ui) ou da interface clássica do Edge (edge-ui) nas máquinas 1 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Para uma configuração não padrão

Se você tiver uma configuração não padrão, atualize os componentes do Edge nesta ordem:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. "Edge", ou seja, o perfil "-c edge" 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 (clássica ou nova)
  7. apigee-adminapi
  8. SSO da Apigee

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