Atualização do Apigee Edge 4.16.01/4.16.05 para 4.18.01

Edge para nuvem privada v4.18.01

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

É possível atualizar o Apigee Edge versão 4.16.01.0x e 4.16.05.x para 4.18.01 usando este procedimento.

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

  • É possível migrar o Apigee Edge versão 4.15.07 para 4.16.01.
  • Se você tiver uma versão do Edge anterior à 4.15.07, primeiro será necessário migrar para a versão 4.15.07 e depois para a versão 4.16.01.
    • Se você estiver migrando do Edge versão 4.14.04 ou posterior: migre diretamente para a versão 4.15.07.
    • Se você estiver migrando da versão 4.14.01 do Edge: primeiro, migre para a versão 4.14.04 e, em seguida, migre para a versão 4.15.07.

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.

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:

    > /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 4.18.01 Processo de reversão 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 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.

Necessário para ativar o repositório EPEL

Ative os Pacotes extras para o Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge. O comando usado depende da sua versão do RedHat/CentOS:

  • Para RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Para RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

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. Se você estiver atualizando a partir da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração ao ativar o servidor SMTP.

A API BaaS versão 4.17.09 também adicionou compatibilidade com a propriedade SMTPMAILFROM. Ao atualizar o BaaS da API, você precisa definir SMTPMAILFROM no arquivo de configuração.

Esse parâmetro tem o formato:

SMTPMAILFROM="My Company <myco@company.com>"

Obrigatório se estiver atualizando ao usar autenticação externa

É possível integrar um serviço de diretório externo a uma instalação de nuvem privada do Apigee Edge. Esse recurso foi projetado para funcionar com qualquer serviço de diretório compatível com LDAP, como o Active Directory, o OpenLDAP e outros. Uma solução LDAP externa permite que os administradores do sistema gerenciem as credenciais do usuário em um serviço centralizado de gerenciamento de diretórios, externo a sistemas como o Apigee Edge que as utilizam.

Consulte Configuração de autenticação externa para saber mais.

Quando a autenticação externa está ativada, a maioria dos clientes usa o campo de nome da conta do SAM do Active Directory como nome de usuário para autenticação, em vez de um endereço de e-mail usado pelo servidor OpenLDAP de borda.

Se você fez a integração com um serviço de diretório externo, adicione a seguinte linha ao arquivo de configuração ao atualizar o Edge para a versão 4.18.01:

IS_EXTERNAL_AUTH="true"

Essa linha configura o Edge para aceitar um nome de conta, em vez de um endereço de e-mail, como o nome de usuário.

Atualização necessária para o Qpid 1.35

Esta versão contém uma atualização necessária para o Qpid 1.35. Como parte da atualização de um nó Qpid, é necessário:

  • Evite temporariamente que os roteadores e os processadores de mensagens gravem no nó Qpid bloqueando a porta 5672 no nó Qpid. Você pode usar o seguinte comando para bloquear essa porta no nó Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  • Aguarde até que a fila do Qpid esvazie as mensagens para garantir que o nó Qpid tenha processado todas as mensagens antes da atualização. Use o comando a seguir para garantir que a fila de mensagens do Qpid esteja vazia:
    > qpid-stat -q
  • Atualizar o nó Qpid.
  • Desbloqueie a porta 5672 no nó Qpid para permitir o acesso de roteadores e processadores de mensagens. Use o comando a seguir para desbloquear essa porta:
    > sudo iptables -F

    Se estiver usando iptables para outras regras, utilize a opção -D para reverter a alteração específica:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Esse processo é descrito abaixo para cada topologia de borda.

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.

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ê 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 Postgres, conforme definido nos Requisitos de instalação de borda.

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 versão 4.18.01.

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 apigee-service do Edge e as dependências:
      > 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.18.01 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. 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. Ative o repositório EPEL conforme descrito acima.
  7. Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
    > sudo yum-config-manager --enable ol7_optional_latest
  8. 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
  9. Faça o download do arquivo Edge 4.18.01 bootstrap_4.18.01.sh para /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Instale o utilitário e as dependências apigee-service do Edge 4.18.01:
    > sudo bash /tmp/bootstrap_4.18.01.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.
  11. 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


      O comando instala o utilitário update.sh em /opt/apigee-setup/bin (em inglês).

      Se você já instalou o utilitário apigee-setup, atualize-o:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup
    2. Se tiver instalado a versão 4.16.01 diretamente, ou seja, se o upgrade da 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 apigee-setup atualização


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

      Esta atualização do apigee-service instala o utilitário update.sh em /opt/apigee/apigee-setup/bin (em inglês).
  12. 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.
  13. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision:
  14. 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, Postgres UI,





  15. Teste a atualização executando o utilitário de validação da Apigee 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 acima em Como desativar um nó do Postgres.

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

Procedimento de atualização de um repositório local para a versão 4.18.01.

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.01 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.18.01 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.18.01 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.18.01.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.18.01.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 Edge apigee-service e as dependências de /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.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 bootstrap_4.18.01.sh do Edge do nome de usuário /tmp/bootstrap_4.18.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01,

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


      , em que remoteRepo, está apigeeuser=uName.
  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


      O comando instala o utilitário update.sh em /opt/apigee-setup/bin (em inglês).

      Se você já instalou o utilitário apigee-setup, atualize-o:
      > /opt/apigee/apigee-service/bin/apigee-service update apigee-setup
    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 apigee-setup atualização


      atualize o utilitário apigee-service apigee/setup.
    3. Se você tiver instalado a versão 4.16.05 diretamente ou por atualização, será necessário atualizar o utilitário apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização

      Esta atualização para o apigee-service instala o utilitário update.sh em /opt/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.18.01 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. Defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Se estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper:
    > downgrade do yum apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Defina a seguinte regra de iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. Verifique a fila de mensagens do Qpid:
    > qpid-stat -q

    Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
  6. Atualizar qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Limpar iptables:
    > sudo iptables -F
  8. Atualizar LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 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
  10. Atualize o postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Atualize o banco de dados Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. Atualize os componentes do Edge restantes:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  13. 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ó.

  1. Defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Se estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper na máquina 1:
    > downgrade yum apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Configure a seguinte regra iptables na máquina 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. Verifique a fila de mensagens do Qpid na máquina 2:
    > qpid-stat -q

    Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
  6. Atualize o qpidd na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Limpe iptables na máquina 2:
    > sudo iptables -F
  8. Atualizar o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Atualize os componentes do Edge na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Atualizar a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. 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 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ó.

  1. Defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
  3. Se 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
  4. 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
  5. Configure a seguinte regra iptables na máquina 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Verifique a fila de mensagens do Qpid na máquina 4:
    > qpid-stat -q

    Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
  7. Atualize o qpidd na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Limpe iptables na máquina 4:
    > sudo iptables -F
  9. Repita as etapas 5 a 8 na máquina 5.
  10. Atualizar o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Atualize os componentes do Edge na máquina 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. Atualizar a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. 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.
  14. Atualize os componentes do Edge nas máquinas 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. 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ó.

  1. Defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
  3. Se estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper no macine 1, 2 e 3:
    > downgrade do yum apigee-zookeeper
  4. 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
  5. Defina a seguinte regra de iptables na máquina 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Verifique a fila de mensagens do Qpid na máquina 6:
    > qpid-stat -q

    Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
  7. Atualize o qpidd na máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Limpe iptables na máquina 6:
    > sudo iptables -F
  9. Repita as etapas 5 a 8 na máquina 7.
  10. Atualizar o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. Atualizar a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. 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.
  14. Atualize os componentes do Edge nas máquinas 8 e 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. 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ó.

  1. Defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
  3. Se estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper no macine 1, 2 e 3:
    > downgrade do yum apigee-zookeeper
  4. 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
  5. Configure a seguinte regra iptables na máquina 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. Verifique a fila de mensagens do Qpid na máquina 12:
    > qpid-stat -q

    Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
  7. Atualize o qpidd na máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Limpe iptables na máquina 12:
    > sudo iptables -F
  9. Repita as etapas 5 a 8 na máquina 13.
  10. Atualize o LDAP nas máquinas 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. Atualize a IU na máquina 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. 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.
  14. Atualize os componentes do Edge nas máquinas 8 e 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. 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ó.

  1. Defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
  3. Atualize o Cassandra e o ZooKeeper:
    1. Se estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper no macine 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 estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper no Macine 7, 8 e 9 no Data Center 2:
      > yum para fazer 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
  4. Atualize o qpidd:
    1. Máquinas 4, 5 no data center 1
      1. Configure a seguinte regra iptables na máquina 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Verifique a fila de mensagens do Qpid na máquina 4:
        > qpid-stat -q

        Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
      3. Atualize o qpidd na máquina 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Limpe iptables na máquina 4:
        > sudo iptables -F
      5. Repita as etapas de 1 a 4 na máquina 5.
    2. Máquinas 10, 11 no data center 2
      1. Defina a seguinte regra de iptables na máquina 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Verifique a fila de mensagens do Qpid na máquina 10:
        > qpid-stat -q

        Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que todas as mensagens tenham sido processadas.
      3. Atualize o qpidd na máquina 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Limpe iptables na máquina 10:
        > sudo iptables -F
      5. Repita as etapas de 1 a 4 na máquina 11.
  5. 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
  6. 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
  7. 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
  8. 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.
  9. Atualize os componentes do Edge nas máquinas 6 e 12:
    > /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 do BaaS com 7 ou 10 hosts de API

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.