Atualização do Apigee Edge 4.16.09 para 4.17.09

Edge para nuvem privada v. 4.17.09

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

É possível atualizar o Apigee Edge versão 4.16.09.0x para 4.17.09 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.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.

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/Oracle 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/Oracle 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.17.09:

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

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

Procedimento de atualização para a versão 4.17.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 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. Instale yum-utils e yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
  5. Ative o repositório EPEL conforme descrito acima.
  6. Se você estiver instalando na AWS, execute o seguinte comando yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Faça o download do arquivo Edge 4.17.09 bootstrap_4.17.09.sh para /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Instale o utilitário e as dependências apigee-service do Edge 4.17.09:
    > sudo bash /tmp/bootstrap_4.17.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.
  9. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização.
  10. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-validate (em inglês):
  11. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service update apigee-provision:
  12. 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,





  13. 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.17.09.

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

  1. Crie um repositório 4.17.09 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário de configuração do Edge apigee.
    Observação: se você já tiver um repositório 4.16.09, poderá adicionar o 4.17.09 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee Apigee.
  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.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.17.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.17.09.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.09.sh do Edge para o nome de usuário /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.bootstrap_4.17.09.br

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

      em que Word é o nome de usuário e senha, onde remoteRepo, apigeeuser=uName.
  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, Message Processor, update, QPID Server, Postgres Server,





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

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

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

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

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

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

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

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

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