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 a versão 4.16.09.0x do Apigee Edge para a 4.17.01 usando este procedimento.

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

Quem pode fazer a atualização

O usuário que executa a atualização precisa ser o mesmo que instalou o Edge originalmente ou um usuário que executa como raiz.

Depois de instalar os RPMs do Edge, qualquer usuário pode configurá-los.

Quais componentes você precisa atualizar

É preciso atualizar todos os componentes do Edge. O Edge não é compatível com uma configuração que contenha componentes de várias versões.

Upgrade obrigatório para o Qpid 1.35

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

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

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

Esse processo é descrito em detalhes abaixo para cada topologia do Edge.

Obrigató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 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 houver atualização ao usar a autenticação externa

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

Consulte Configuração de autenticação externa para mais informações.

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

Se você tiver integrado um serviço do 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 das configurações de propriedade

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

Pré-requisitos de atualização

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

  • Fazer backup de todos os nós
    Antes de atualizar, é 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 realizar o backup.

    Isso permite que você tenha um plano de backup, caso a atualização para uma nova versão não funcione corretamente. Para mais informações sobre backup, consulte Backup e restauração.
  • Verifique se o Edge está em execução
    Verifique se o Edge está em execução durante o processo de atualização usando o comando:

    > /opt/apigee/apigee-service/bin/apigee-all status

Como lidar com uma falha na atualização

No caso de uma falha na atualização, tente corrigir o problema e execute update.sh novamente. É possível executar a atualização várias vezes, e ela vai continuar 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 mais informações.

Informações de atualização do Logging

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 chamado update_username.log.

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

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite que você atualize a instalação do Edge sem desativar o Edge.

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

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

  1. Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo em "Ordem de atualização da máquina".
  2. Quando for hora de atualizar os roteadores, selecione um roteador 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 do Edge na mesma máquina que o roteador. Todas as configurações do Edge 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 roteadores restantes.
  6. Continue a atualização para as máquinas restantes na instalação.

Cuide do seguinte antes/depois da atualização:

  • No nó combinado de roteador e processador de mensagens:
    • Antes da atualização, faça o seguinte:
      1. Torne o roteador inacessível.
      2. Tornar o processador de mensagens inacessível.
    • Após a atualização, faça o seguinte:
      1. Torne o processador de mensagens acessível.
      2. Torne o roteador acessível.
  • Em um ú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 silenciosa 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 para atualizar 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 houver, desative todos os cron jobs configurados para realizar uma operação de reparo no Cassandra até que a atualização seja concluída.
  2. Faça login no nó como raiz para instalar os RPMs do Edge.
    Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem acesso raiz.
  3. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup 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 apigee-service do Edge 4.17.01 e as dependências:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será necessário inseri-lo.

    Por padrão, o instalador verifica se o Java 1.8 está instalado. Se não tiver, ele será instalado para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa os seguintes valores:

    I = Instalar o 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 update
  8. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    O único requisito no arquivo de configuração é que ele precisa ser 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 possíveis inclui:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =todos os componentes do Edge, exceto a IU do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
    ui = IU do Edge
    all = atualiza todos os componentes na máquina (use apenas para um perfil de instalação do Edge aio ou um perfil de instalação do API BaaS asa)
    e = ElasticSearch
    b = pilha de API BaaS
    p = portal de API BaaS
    ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó
  11. Teste a atualização executando o utilitário apigee-validate 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 da versão 4.16.09.

Procedimento para atualizar para a versão 4.17.01 de um repositório local

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

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

  • Crie um arquivo .tar do repositório, copie o arquivo .tar para um nó e atualize o Edge usando o arquivo .tar.
  • Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. Nginx e até mesmo o servidor da Web Apache.

Para atualizar de um repositório local 4.17.01:

  1. Crie um repositório local 4.17.01, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
    Observação: se você já tiver um repositório 4.16.09, poderá adicionar o repositório 4.17.01 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
  2. Para instalar o apigee-service de 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.17.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
    3. No novo nó, descompacte o arquivo no 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

      Observe que você inclui o caminho para o diretório repos neste comando.
  3. Para instalar o apigee-service usando o servidor da Web Nginx:
    1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o servidor da Web Nginx" em Instalar o utilitário apigee-setup do Edge.
    2. No nó remoto, faça o download do arquivo bootstrap_4.17.01.sh do Edge para /tmp/bootstrap_4.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

      em que uName:pWord são o nome de usuário e a senha que você definiu acima para o repositório, e remoteRepo é o endereço IP ou o nome DNS do nó do repositório.
    3. No nó remoto, instale o utilitário apigee-service do Edge e as dependências:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      em que uName:pWord são o nome de usuário e a senha do repositório.
  4. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Atualize o utilitário apigee-validate no servidor de gerenciamento.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    O único requisito no arquivo de configuração é que ele precisa ser 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 possíveis inclui:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =todos os componentes do Edge, exceto a IU do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
    ui = IU do Edge
    all = atualiza todos os componentes na máquina (use apenas para um perfil de instalação do Edge aio ou um perfil de instalação do API BaaS asa)
    e = ElasticSearch
    b = pilha de API BaaS
    p = portal de API BaaS
    ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó
  8. Teste a atualização executando o utilitário apigee-validate 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 da versão 4.16.09.

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma instalação do Edge é importante. As considerações mais importantes para uma atualização são:

  • Atualize todos os nós do Cassandra e do ZooKeeper antes de atualizar qualquer outro nó.
  • Para qualquer máquina com vários componentes do Edge (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, mas não servidor Postgres), use a opção "-c edge" para atualizar todos ao mesmo tempo.
  • Se uma etapa especificar que deve ser realizada em várias máquinas, faça isso na ordem especificada.
  • Não há uma etapa separada para atualizar a Monetização. Ele é atualizado quando você especifica a opção "-c edge".
  • (Somente CentOS-6.x e RedHat-6.x) Em todos os nós do 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 independente de 1 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 ele tenha processado todas as mensagens.
  4. Atualize qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe as 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
  8. Atualize o LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Atualize os componentes restantes do Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Atualize a IU do Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação independente de dois hosts

Consulte Topologias de instalação para ver a lista de topologias do Edge 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. Defina a seguinte regra de 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 ele tenha processado todas as mensagens.
  4. Atualize o qpidd na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe as 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
  8. Atualize 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. Atualize a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação em cluster de 5 hosts

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

  1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Defina a seguinte regra de 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 ele tenha processado todas as mensagens.
  4. Atualize o qpidd na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe as iptables na máquina 4:
    > sudo iptables -F
  6. Repita as etapas de 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
  9. Repita as etapas 7 e 8 na máquina 5.
  10. Atualize 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 4, 5, 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Atualize a IU na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação em cluster de 9 hosts

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

  1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 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 ele tenha processado todas as mensagens.
  4. Atualize o qpidd na máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe as iptables na máquina 6:
    > sudo iptables -F
  6. Repita as etapas de 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
  9. Repita as etapas 7 e 8 na máquina 7.
  10. Atualize 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, nessa ordem:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Atualize 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 do Edge e números de nós.

  1. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Defina a seguinte regra de 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 ele tenha processado todas as mensagens.
  4. Atualize o qpidd na máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Limpe as iptables na máquina 12:
    > sudo iptables -F
  6. Repita as etapas de 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
  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, nessa ordem:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Atualize a IU nas máquinas 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 do Edge 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 e 5 no data center 1
      1. Defina a seguinte regra de 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 ele tenha processado todas as mensagens.
      3. Atualize o qpidd na máquina 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Limpe as iptables na máquina 4:
        > sudo iptables -F
      5. Repita as etapas de 1 a 4 na máquina 5.
    2. Máquinas 10 e 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 ele tenha processado todas as mensagens.
      3. Atualize o qpidd na máquina 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Limpe as 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
    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
  4. Atualize o LDAP:
    1. Máquinas 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. Atualizar 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 de API BaaS com sete hosts

Adicione 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, consulte Instalação da API BaaS.

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

Consulte Topologias de instalação para ver a lista de topologias do Edge 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 pilha de API BaaS nas máquinas 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Atualize o portal da API BaaS na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

Adicione 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, consulte Instalação da API BaaS.

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

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

  1. Atualize o Cassandra nas máquinas 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 da API BaaS nas máquinas 4, 5 e 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Atualize o portal da API BaaS 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 edge" 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 do perfil "-c edge".
  6. IU do Edge