Atualização do Apigee Edge para 4.16.09

Edge para nuvem privada v. 4.16.09

Quais versões do Edge podem ser atualizadas para a 4.16.09

É possível atualizar o Apigee Edge versão 4.16.01.0x e 4.16.05.x para 4.16.09.

Se você tiver uma versão do Edge anterior à 4.16.01, primeiro migre para a versão 4.16.01.x e depois atualize para a versão 4.16.09.

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.

Upgrade necessário para o Java JDK versão 8

Esta versão do Edge requer a instalação da versão 8 do Java JDK em todos os nós de processamento de borda. Você pode instalar o Oracle JDK 8 ou o OpenJDK 8. Se o Java JDK 8 ainda não estiver instalado, o script de atualização poderá instalá-lo para você.

Como parte da atualização para o Java 8, algumas criptografias TLS não estão mais disponíveis no Oracle JDK 8. Para ver a lista completa, consulte a seção "Pacotes de criptografia padrão desativados" em http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Fazer downgrade do Zookeeper se estiver atualizando da versão 4.16.01.

A versão do Zookeeper RPM no Edge para a nuvem privada 4.16.01 é apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Nas versões subsequentes do Edge, a versão do Zookeeper foi alterada de volta para apigee-zookeeper-3.4.5-0.0.94x. Isso impede que o yum faça upgrade do Zookeeper para uma versão posterior da 4.16.01. A maneira de corrigir essa situação é executar o yum downgrade apigee-zookeeper antes de atualizar o Zookeeper.

Verifique a versão do Zookeeper usando o seguinte comando:

> rpm -qa |grep apigee-zookeeper

Se esse comando retornar a versão do Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Em seguida, faça o downgrade.

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 mantidos pela atualização.

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 alternativo 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:

    > /<inst_root>/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 Processo de reversão 4.16.09 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 denominado update_username.log.

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

Upgrade obrigatório para o Postgres 9.4

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

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.

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ê instala 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.

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.16.01 ou 4.16.05), e não para a 4.16.09.

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. Na instância mestre atual do Postgres, edite o arquivo /opt/apigee/customer/application/postgresql.properties para definir o token a seguir. Se o arquivo não existir, crie-o:

    conf_pg_hba_replication.connection=host replicação apigee existing_slave_ip/32 trust\ \nreplicação do host apigee existing_slave_ip/32 trust

    em que existing_slave_ip é o novo endereço IP do servidor em espera atual é o novo endereço IP do servidor Postgres_ip atual.
  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ó de espera foi adicionado visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf na instância mestre. O arquivo vai mostrar estas linhas:
    replicação do host apigee existing_slave_ip/32 trust
    replicação do host 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:

      # Endereço IP do mestre atual:
      PG_MASTER=192.168.56.103
      # Endereço IP do novo nó de espera
      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.16.05.sh para /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      faça o download do arquivo Edge.4.4/tmp/bootstrap_4.16.05.sh
    4. Instale o utilitário e as dependências do serviço Apigee Edge:
      > sudo bash /tmp/bootstrap_4.16.05.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 que o nó está em 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á em execução:
    > /opt/apigee/apigee-service/bin/apigee-all

    Se o Postgres não estiver em execução, inicie-o:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Acesse 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

    Você vai ver o UUID do nó no final da saída, "UID15" UID4-type:

  3. Pare o novo nó de espera executando este comando no novo nó de espera:
    > /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 /opt/apigee/customer/application/postgresql.properties:
    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 na instância mestre. Apenas esta linha vai aparecer no arquivo:
    replicação do host da Apigee existing_slave_ip/32 trust
  7. Exclua o UUID do nó de 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>

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 para a instalação, conforme descrito abaixo 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 usado para instalar o Edge 4.16.01 ou 4.16.05.

Procedimento de atualização para a versão 4.16.09 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, instale um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
  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.
    Observação: embora a instalação da RPM exija acesso raiz, é possível executar a configuração do Edge sem acesso raiz.
  4. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
  5. Faça o download do arquivo Edge 4.16.09 bootstrap_4.16.09.sh para /tmp/bootstrap_4.16.09.sh:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. Instale o utilitário e as dependências apigee-service do Edge 4.16.09:
    > sudo bash /tmp/bootstrap_4.16.09.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 o 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 lidar com a instalação do Java. JAVA_FIX assume os seguintes valores:

    I = Instalar 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.
  7. Use apigee-service para atualizar o utilitário apigee-setup:
    1. Se tiver instalado a versão 4.16.01 fazendo upgrade do Edge versão 4.15.07.0x, será preciso instalar o utilitário apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Este comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setupbin.

      Se você já instalou o utilitário apigee-setup, atualize-o:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização
    2. Se tiver instalado a versão 4.16.01 diretamente, ou seja, se o upgrade não tiver sido feito da 4.15.07.0x, será preciso atualizar o utilitário de configuração da Apigee:
      > > /opt/apigee/apigee-service/bin/apigee-service atualização da apigee-setup


      atualize para apigee-service instalado o apigee-service instalado o apigee-service
    3. Se a versão 4.16.05 for instalada diretamente ou por atualização, você vai precisar atualizar o utilitário apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização

      Esta atualização para apigee-service instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin (em inglês).
  8. Dependendo da sua versão atual do Edge, você precisa instalar ou atualizar o utilitário apigee-validate no servidor de gerenciamento.
    1. Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no servidor de gerenciamento:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update (em inglês):
    2. Se você estiver usando o Edge 4.16.01: instale o utilitário apigee-validate no Servidor de gerenciamento:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install


      Observação: se você instalou o utilitário apigee-validate em um Message Processor no gerenciador de mensagens no servidor de gerenciamento:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install


      Observação: se você instalou o utilitário apigee-validate em um Message Processor, em um Message Processor, o comando apigee-validate/bin.
    3. Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido para o utilitário apigee-validate. Na versão 4.16.01 Edge, o arquivo de configuração usado por apigee-validate exigiu as seguintes propriedades:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      Nesta versão, o arquivo de configuração exige apenas a propriedade APIGEE_ADMINPW. É possível remover as outras duas propriedades do arquivo.
  9. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision:
  10. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina" abaixo:
    > /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 componentes inclui:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Todos os componentes do Edge, exceto Edge UI: Management Server, Message Processor, update, QPID Server, Message Processor, update, QPID Server, Postgres Server,





  11. Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descrito em Testar a instalação.
  12. Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito acima em Como desativar um nó do Postgres.

Para reverter a atualização posteriormente, use o procedimento descrito em 4.16.09 Processo de reversão.

Procedimento de atualização para a versão 4.16.09 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.16.09 local:

  1. Se você estiver usando atualmente a replicação mestre em espera do Postgres, instale um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
  2. Crie um repositório 4.16.09 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee Apigee.
    Observação: se você já tiver um repositório 4.16.01 ou 4.16.05, poderá adicionar o 4.16.09 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee do Edge.
  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.16.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service pacote apigee-mirror
    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ó, remova o arquivo para o diretório /tmp:
      > tar -xzf apigee-4.16.09.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 de /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Você inclui o caminho para o diretório de repositórios neste 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 de configuração da Apigee Apigee.
    2. No nó remoto, faça o download do arquivo Edge bootstrap_4.16.09.sh de nome de usuário do Edge para /tmp/bootstrap_4.16.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh Reposh8, que é o nome de usuário e o banco remoto

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

      em que o nome de usuário e senha
      são remoteRepo.
  5. Use apigee-service para atualizar o utilitário apigee-setup:
    1. Se tiver instalado a versão 4.16.01 fazendo upgrade do Edge versão 4.15.07.0x, será preciso instalar o utilitário apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Este comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setupbin.

      Se você já instalou o utilitário apigee-setup, atualize-o:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização
    2. Se tiver instalado a versão 4.16.01 diretamente, ou seja, se o upgrade da versão 4.15.07.0x não for feita, será preciso atualizar o utilitário de configuração da Apigee:
      > /opt/apigee/apigee-service/bin/apigee-service update


      atualização da 4.15.07.0x.
    3. Se a versão 4.16.05 for instalada diretamente ou por atualização, você vai precisar atualizar o utilitário apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização

      Esta atualização para apigee-service instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
  6. Dependendo da sua versão atual do Edge, você precisa instalar ou atualizar o utilitário apigee-validate no servidor de gerenciamento.
    1. Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no servidor de gerenciamento:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update (em inglês):
    2. Se estiver usando o Edge 4.16.01: instale o utilitário apigee-validate no Servidor de gerenciamento:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Observação: se você instalou o utilitário apigee-validate em um gerenciador de mensagens,


    3. Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido para o utilitário apigee-validate. Na versão 4.16.01 Edge, o arquivo de configuração usado por apigee-validate exigiu as seguintes propriedades:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      Nesta versão, o arquivo de configuração exige apenas a propriedade APIGEE_ADMINPW. É possível remover as outras duas propriedades do arquivo.
  7. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision:
  8. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina" abaixo:
    > /opt/apigee/apigee-setup/bin/update.sh -c attribute -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 componentes inclui:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Todos os componentes do Edge, exceto Edge UI: Management Server, Message Processor, update, QPID Server, Postgres UI,





  9. Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descrito em Testar a instalação.
  10. Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito acima em Como desativar um nó do Postgres.

Para reverter a atualização posteriormente, use o procedimento descrito em 4.16.09 Processo de reversão.

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".

Para uma instalação autônoma de um host

  1. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper:
    > downgrade do yum apigee-zookeeper
  2. Atualize o Cassandra e o ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualizar LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Pare os servidores Postgres, Qpid e PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
    > /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service stop apigee-postgresql
  6. Atualize o postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Atualize o banco de dados Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Atualize os componentes do Edge restantes:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Atualizar a interface do Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação autônoma de dois hosts

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

  1. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper na máquina 1:
    > downgrade da yum apigee-zookeeper
  2. Atualize o Cassandra e o ZooKeeper na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o qpidd na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualizar o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Atualizar a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Atualize o postgresql na máquina 2:
    1. Para os servidores Postgres, Qpid e postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service stop apigee-apigee
    2. Atualize o postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Atualize o banco de dados Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Atualize os componentes do Edge nas máquinas 2 e 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  8. Atualize os componentes do Edge na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Para uma instalação em cluster com 5 hosts

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 acima em Como instalar um novo nó de espera do Postgres.
  2. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
    > downgrade de yum apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Atualize o qpidd nas máquinas 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Atualizar o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes do Edge na máquina 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Atualizar a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Atualize as máquinas 4 e 5:
    1. Pare os servidores Postgres e Qpid na máquina 4:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server parada
      > /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server stop
    2. Para os servidores Postgres, Qpid e postgresql na máquina 5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee-service stop/bin/apigee-apigee
    3. Pare o servidor Postgres e o postgresql no novo nó de espera que você adicionou para reversão:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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 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-serviceedge-qpid-server start
      (em inglês)
    8. Para configurar o Postgres como um nó de espera, execute 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 a replicação:

      Na máquina 4, o nó mestre, execute:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Verifique se o nó é mestre.

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

      Confirme que o nó está em 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. Certifique-se de desativar o novo nó de espera usando o procedimento acima em Como desativar um nó do Postgres.

Para uma instalação em cluster com nove hosts

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 acima em Como instalar um novo nó de espera do Postgres.
  2. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
    > yum downgrade do apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Atualize o qpidd nas máquinas 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Atualizar o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  7. Atualizar a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Atualize as máquinas 8 e 9:
    1. Pare o servidor Postgres na máquina 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Pare o servidor Postgres e o postgresql na máquina 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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. Pare o servidor Postgres e o postgresql no novo nó de espera que você adicionou para reversão:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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 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-serviceedge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 6 e 7:
      > /opt/apigee/apigee-service/bin/apigee-serviceedge-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 em ambos os 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

      Valide que o nó é o mestre.

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

      Confirme que o nó está em 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. Certifique-se de desativar o novo nó de espera usando o procedimento acima em Como desativar um nó do Postgres.

Para uma instalação em cluster de 13 hosts

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 acima em Como instalar um novo nó de espera do Postgres.
  2. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
    > yum downgrade do apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Atualize o qpidd nas máquinas 12 e 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 6, 7, 10 e 11 nesta ordem:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Atualize a IU na máquina 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Atualize as máquinas 8 e 9:
    1. Pare o servidor Postgres na máquina 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Pare o servidor Postgres e o postgresql na máquina 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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-serviceedge-qpid-server stop
    4. Pare o servidor Postgres e o postgresql no novo nó de espera que você adicionou para reversão:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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 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-serviceedge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 12 e 13:
      > /opt/apigee/apigee-service/bin/apigee-serviceedge-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 em ambos os 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

      Valide que o nó é o mestre.

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

      Confirme que o nó está em 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. Certifique-se de desativar o novo nó de espera usando o procedimento acima em Como desativar um nó do Postgres.

Para uma instalação em cluster de 12 hosts

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 acima em Como instalar um novo nó de espera do Postgres.
  2. Atualize o Cassandra e o ZooKeeper:
    1. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3 no Data center 1:
      > yum para fazer downgrade do apigee-zookeeper
    2. Nas máquinas 1, 2 e 3 no data center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 7, 8 e 9 no Data Center 2:
      > yum downgrade do apigee-zookeeper
    4. 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
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Máquinas 10, 11 no Data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP:
    1. Máquina 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. Atualize a máquina 6 no data center 1 e 12 no data center 2:
    1. Pare o servidor Postgres na máquina 6:
      > /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server stop
    2. Pare o servidor Postgres e postgresql na máquina 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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. Pare o servidor Postgres e o postgresql no novo nó de espera que você adicionou para reversão:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server parada
      > /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 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-serviceedge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 4, 5, 10 e 11:
      > /opt/apigee/apigee-service/bin/apigee-serviceedge-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 mostrar 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

      Valide se o nó for o mestre.

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

      Confirme que o nó está em espera.
  8. Atualize os componentes do Edge nas máquinas 6 e 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Certifique-se de desativar o novo nó de espera usando o procedimento acima em Como desativar um nó do Postgres.

Para uma instalação do BaaS da API com sete hosts

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

  1. Atualize o Cassandra nas máquinas 5, 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Atualize o ElasticSearch e a API BaaS Stack na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. Atualize o portal BaaS da API na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Para uma instalação de API BaaS com 10 hosts

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

  1. Atualize o Cassandra na máquina 8, 9 e 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Atualize o ElasticSearch nas máquinas 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Atualize a pilha BaaS da API nas máquinas 4, 5 e 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Atualize o portal BaaS da API na máquina 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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
  4. LDAP
  5. Edge, ou seja, o perfil "-c borda" em todos os nós na ordem: nós com o servidor Qpid, mas não o servidor Postgres, o servidor de gerenciamento, o processador de mensagens e o roteador.
    Observação: se o nó tiver o servidor Qpid e o servidor Postgres instalados, execute a etapa de perfil "-c Edge" como parte da etapa 8.
  6. interface do Edge
  7. postgresql no mestre do Postgres, incluindo atualização.
  8. postgresql no modo de espera do Postgres.
  9. Edge, ou seja, o perfil "-c Edge" em todos os nós Qpid e Postgres combinados ou em qualquer nó autônomo do Postgres.