Atualização do Apigee Edge 4.16.09 para 4.17.01

Edge para nuvem privada v. 4.17.01

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

É possível atualizar o Apigee Edge versão 4.16.09.0x para 4.17.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.x e depois atualize para a versão 4.17.01.

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.

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.

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

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

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 Processo de reversão 4.17.01 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á.

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.17.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 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.
  2. 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.
  3. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
  4. Faça o download do arquivo bootstrap_4.17.01.sh do Edge 4.17.01 para /tmp/bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  5. Instale o utilitário e as dependências apigee-service do Edge 4.17.01:
    > sudo bash /tmp/bootstrap_4.17.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.
  6. (Somente CentOS-6.x e RedHat-6.x) Em todos os nós do Qpid, execute o seguinte comando para garantir o download da versão correta do Qpid:
    > yum install apigee-qpidd --disablerepo=epel
  7. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização.
  8. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-validate (em inglês):
  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.

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.17.01 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.17.01 local:

  1. Crie um repositório 4.17.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.09, poderá adicionar o 4.17.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.
  2. Para instalar o apigee-service em um arquivo .tar:
    1. No nó com o repositório local, use o comando a seguir para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.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.17.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 apigee-service do Edge e as dependências de /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Você inclui o caminho para o diretório de repositórios neste comando.
  3. 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.17.01.sh do Edge para o nome de usuário /tmp/bootstrap_4.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.remote1.nó

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

      em que a senha é remoteRepo.
  4. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização:
  5. Atualize o utilitário apigee-validate no servidor de gerenciamento.
    > /opt/apigee/apigee-service/bin/apigee-service atualização da apigee-validate
  6. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision:
  7. 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,





  8. Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descrito em Testar a instalação.

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

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".
  • (Somente CentOS-6.x e RedHat-6.x) Em todos os nós Qpid com uma conexão de Internet externa, verifique se você executou o seguinte comando para fazer o download da versão correta do Qpid, conforme mostrado acima:
    > yum install apigee-qpidd --disablerepo=epel

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

  1. Atualize o Cassandra e o ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Defina a seguinte regra de iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. 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.
  4. Atualizar qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpar iptables:
    > sudo iptables -F
  6. Atualize o postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Inicie o postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start (link em inglês)
  8. Atualizar LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Atualize os componentes do Edge restantes:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. 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. Atualize o Cassandra e o ZooKeeper na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Configure a seguinte regra iptables na máquina 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. 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.
  4. Atualize o qpidd na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe iptables na máquina 2:
    > sudo iptables -F
  6. Atualize o postgresql na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Inicie o postgresql na máquina 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start (em inglês)
  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 nas máquinas 2 e 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

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. 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
  2. Configure a seguinte regra iptables na máquina 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. 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.
  4. Atualize o qpidd na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe iptables na máquina 4:
    > sudo iptables -F
  6. Repita as etapas 2 a 5 na máquina 5.
  7. Atualize o postgresql na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Inicie o postgresql na máquina 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start (em inglês)
  9. Repita as etapas 7 e 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 4, 5, 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

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. 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
  2. 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
  3. 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.
  4. Atualize o qpidd na máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe iptables na máquina 6:
    > sudo iptables -F
  6. Repita as etapas 2 a 5 na máquina 7.
  7. Atualize o postgresql na máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Inicie o postgresql na máquina 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start (em inglês)
  9. Repita as etapas 7 e 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, 8, 9, 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

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. 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
  2. Configure a seguinte regra iptables na máquina 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. 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.
  4. Atualize o qpidd na máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe iptables na máquina 12:
    > sudo iptables -F
  6. Repita as etapas 2 a 5 na máquina 13.
  7. Atualize o postgresql na máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Inicie o postgresql na máquina 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start (em inglês)
  9. Repita as etapas 7 e 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, 8, 9, 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

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. Atualize o Cassandra e o ZooKeeper:
    1. Nas máquinas 1, 2 e 3 no data center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Nas máquinas 7, 8 e 9 no data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 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.
  3. Atualize o postgresql:
    1. Máquinas 6 no Data center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
      (em inglês)
    2. Máquinas 12 no data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
      (em inglês)
  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, 6, 1, 2, 3 no Data center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. Máquinas 10, 11, 12, 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

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

É preciso adicionar duas novas propriedades ao arquivo de configuração antes de executar o procedimento de upgrade:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Para ver um exemplo completo de arquivo de configuração, confira Instalação da API BaaS.

Você também precisa garantir que a porta 2551 esteja aberta em todos os nós da pilha para acesso a partir de todos os outros nós dela.

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

É preciso adicionar duas novas propriedades ao arquivo de configuração antes de executar o procedimento de upgrade:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Para ver um exemplo completo de arquivo de configuração, confira Instalação da API BaaS.

Você também precisa garantir que a porta 2551 esteja aberta em todos os nós da pilha para acesso a partir de todos os outros nós dela.

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, ps
  4. LDAP
  5. Edge, ou seja, o perfil "-c borda" em todos os nós na ordem: nós com servidor Qpid, servidor Postgres, servidor de gerenciamento, processador de mensagens e roteador.
    Observação: se o nó tiver o servidor Qpid e o servidor Postgres instalados, execute a etapa de perfil "-c Edge".
  6. interface do Edge