Esta página foi traduzida pela API Cloud Translation.

Atualização do Apigee Edge para 4.16.09

Edge for Private Cloud v. 4.16.09

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

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

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

Quem pode 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 está executando como raiz.

Depois de instalar os RPMs do Edge, qualquer usuário pode fazer a configuração.

Upgrade obrigatório para o Java JDK versão 8

Esta versão do Edge exige a instalação do Java JDK versão 8 em todos os nós de processamento do Edge. É possível 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á fazer isso por você.

Como parte da atualização para o Java 8, algumas cifras TLS não estão mais disponíveis no Oracle JDK 8. Para conferir a lista completa, consulte a seção "Default Disabled Cipher Suites" em http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Fazendo downgrade do Zookeeper se atualizar da versão 4.16.01

A versão do RPM do Zookeeper no Edge para nuvem privada 4.16.01 é apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Nas versões posteriores 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 versões posteriores à 4.16.01. Para corrigir essa situação, execute yum downgrade apigee-zookeeper antes de atualizar o Zookeeper.

Para verificar a versão do Zookeeper, use 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 da propriedade

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

Atualizar pré-requisitos

Cumpra 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 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
Confira se o Edge está em execução durante o processo de atualização usando o comando:

> /<inst_root>/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 o update.sh novamente. É possível executar a atualização várias vezes e ela continuará de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte 4.16.09 Processo de reversão para saber mais.

Informações de atualização de registro

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.

Upgrade necessário para o Postgres 9.4

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

Durante o processo de atualização, enquanto os nós do Postgres estão inativos para atualização, os dados de análise ainda são gravados nos nós Qpid. Depois que os nós do Postgres são atualizados e voltam a ficar on-line, os dados de análise são enviados para eles.

O nó de reserva adicional do Postgres é 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, ao 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 do Postgres, conforme definido nos Requisitos de instalação do Edge.

Instalação de um novo nó de standby do Postgres

Este procedimento cria um servidor Postgres em espera em um novo nó. Instale um novo servidor de espera do Postgres para a versão atual do Edge (4.16.01 ou 4.16.05), não para a versão 4.16.09.

Para realizar 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 reserva do Postgres:

No mestre atual do Postgres, edite o arquivo /opt/apigee/customer/application/postgresql.properties para definir o token a seguir. Se esse arquivo não existir, crie-o:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

em que existing_slave_ip é o endereço IP do servidor de espera do Postgres atual e new_slave_ip é o endereço IP do novo nó de espera.
Reinicie o apigee-postgresql no mestre do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Verifique se o novo nó de espera foi adicionado visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf (em inglês) no mestre. As linhas a seguir devem aparecer nesse arquivo:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Instale o novo servidor de espera do Postgres:
1. Edite o arquivo de configuração usado para instalar a versão atual do Edge e especifique 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 Edge apigee-setup.
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
  
  Observação: se você fizer o download do Edge.4.4.
  
  Observação: se você fizer o download do Edge.4.4.
  Observação:
4. Instale o utilitário e as dependências do apigee-service do Edge:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Use o apigee-service para instalar o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Instalar o Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. No novo nó de reserva, execute o seguinte comando:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Verifique se ele informa que é o standby.

Como descontinuar um nó do Postgres

Após a conclusão da atualização, desative o novo nó de espera:

Verifique se o Postgres está em execução:
> /opt/apigee/apigee-service/bin/apigee-all status

Se o Postgres não estiver em execução, inicie-o:
> /opt/apigee/apigee-service/bin/apigee-all start
Para conferir o UUID do novo nó de reserva, execute o comando cURL a seguir no novo nó de reserva:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Confira o UUID do nó no final da saída, no formato:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Pare o novo nó reserva executando o seguinte comando:
> /opt/apigee/apigee-service/bin/apigee-all stop
No nó mestre do Postgres, edite /opt/apigee/customer/application/postgresql.properties para remover o novo nó reserva de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Reinicie o apigee-postgresql no mestre do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Verifique se o novo nó reserva foi removido acessando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. O arquivo precisa conter apenas a seguinte linha:
replicação do host da Apigee existing_slave_ip/32 trust
Exclua o UUID do nó reserva do ZooKeeper fazendo a seguinte chamada de API de gerenciamento do Edge 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 interromper o Edge.

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

A chave para a atualização sem inatividade é remover cada roteador, um de cada vez, do balanceador de carga. Em seguida, você atualiza o roteador e todos os outros componentes na mesma máquina que ele e, em seguida, adiciona o roteador novamente ao balanceador de carga.

Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo em "Ordem de atualização de máquinas".
Quando chegar a hora de atualizar os roteadores, selecione um e torne-o inacessível, conforme descrito em Ativar/desativar a acessibilidade do servidor (roteador/processador de mensagens).
Atualiza o roteador selecionado e todos os outros componentes do Edge na mesma máquina que o roteador. Todas as configurações de borda mostram um roteador e um processador de mensagens no mesmo nó.
Torne o roteador acessível novamente.
Repita as etapas 2 a 4 para os outros roteadores.
Continue a atualização para os computadores restantes na instalação.

Antes e depois da atualização, faça o seguinte:

No nó combinado de roteador e processador de mensagens:
- Antes da atualização: faça o seguinte:
  1. Tornar o roteador inacessível.
  2. Deixe o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
  1. Deixe o processador de mensagens acessível.
  2. Torne o roteador acessível.
No nó único do roteador:
- Antes da atualização, torne o roteador inacessível.
- Depois da atualização, torne o roteador acessível.
No nó único do processador de mensagens:
- Antes da atualização, torne o processador de mensagens inacessível.
- Depois da atualização, torne o processador de mensagens acessível.

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 silencioso precisa ser o mesmo usado para instalar o Edge 4.16.01 ou 4.16.05.

Procedimento para atualizar para a versão 4.16.09 em um nó com uma conexão de Internet externa

Use o procedimento a seguir para atualizar os componentes do Edge em um nó:

Se você estiver usando a replicação mestre-standby do Postgres, instale um novo nó de standby do Postgres, conforme descrito acima em Instalação de um novo nó de standby do Postgres.
Se houver, desative todos os jobs CRON configurados para realizar uma operação de reparo no Cassandra até que a atualização seja concluída.
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.
Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
Faça o download do arquivo bootstrap_4.16.09.sh do Edge 4.16.09 para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Instale o utilitário apigee-service e as dependências do Edge 4.16.09:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

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

Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Se você não fizer isso, ele o instalará para você. Use a opção JAVA_FIX para especificar como processar a instalação do Java. JAVA_FIX recebe 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.
Use apigee-service para atualizar o utilitário apigee-setup:
1. Se você instalou a versão 4.16.01 fazendo upgrade da versão 4.15.07.0x do Edge, instale o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Esse comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
  
  Se você já instalou o utilitário apigee-setup, atualize-o:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade da 4.15.07.0x, atualize o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Essa atualização do apigee-service instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
3. Se você instalou a versão 4.16.05 diretamente ou por atualização, atualize o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Essa atualização do apigee-service instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
Dependendo da sua versão atual do Edge, é necessário 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
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 nó do Message Processor ao instalar o 4.16.01, atualize-o usando o seguinte comando nesse nó:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  No entanto, a partir da versão 4.16.05 e mais recente, a Apigee recomenda que você instale e execute o utilitário apigee-validate no servidor de gerenciamento.
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 do Edge, o arquivo de configuração usado por apigee-validate exigia 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.
Atualize o utilitário apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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 interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
ui = interface 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)
e = ElasticSearch
b = pilha API BaaS
p = portal da API BaaS
ebp = ElasticSearch, pilha API BaaS e portal da API BaaS no mesmo nó
Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se você instalou um novo nó de reserva do Postgres, desative o nó conforme descrito acima em Como desativar um nó do Postgres.

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

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

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

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge do 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. A Apigee fornece o servidor da Web Nginx para você usar ou você pode usar seu próprio servidor da Web.

Para atualizar a partir de um repositório 4.16.09 local:

Se você estiver usando a replicação mestre-standby do Postgres, instale um novo nó de standby do Postgres, conforme descrito acima em Instalação de um novo nó de standby do Postgres.
Crie um repositório local 4.16.09 conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup da Edge.
Observação: se você já tiver um repositório 4.16.01 ou 4.16.05, adicione o 4.16.09 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
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.16.09.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 para o diretório /tmp no novo nó.
3. No novo nó, descompacte o arquivo no diretório /tmp:
  > tar -xzf apigee-4.16.09.tar.gz
  
  Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo, /tmp/repos.
4. Instale o utilitário apigee-service do Edge e as dependências em /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Inclua o caminho para o diretório repos neste comando.
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.16.09.sh do Edge para /tmp/bootstrap_4.16.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  
  em que uName:pWord são o nome de usuário e a senha definidos 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 e as dependências do apigee-service do Edge:
  > sudo bash /tmp/bootstrap_4.16.09.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.
Use apigee-service para atualizar o utilitário apigee-setup:
1. Se você instalou a versão 4.16.01 fazendo upgrade do Edge para a versão 4.15.07.0x, instale o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Esse comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin
  
  Se você já instalou o utilitário apigee-setup, atualize-o:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Se você instalou a versão 4.16.01 diretamente, ou seja, não fez um upgrade da versão 4.15.07.0x, atualize o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Esta atualização em update/apigee-setup instala o utilitário update/apigee-setup em update/apigee-setup
3. Se você instalou a versão 4.16.05 diretamente ou por atualização, atualize o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Essa atualização do apigee-service instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
Dependendo da sua versão atual do Edge, é necessário 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
3. Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido ao utilitário apigee-validate. Na versão 4.16.01 do Edge, o arquivo de configuração usado por apigee-validate exigia 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. Você pode remover as outras duas propriedades do arquivo.
Atualize o utilitário apigee-provision:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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 interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
ui = interface 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)
e = ElasticSearch
b = pilha API BaaS
p = portal da API BaaS
ebp = ElasticSearch, pilha API BaaS e portal da API BaaS no mesmo nó
Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
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 mais tarde, use o procedimento descrito em 4.16.09 Processo de reversão.

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:

É necessário atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar outros nós.
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 edge" para atualizar todos ao mesmo tempo.
Se uma etapa especificar que ela precisa ser realizada em várias máquinas, faça isso na ordem especificada da máquina.
Não há uma etapa separada para atualizar a monetização. Ele é atualizado quando você especifica a opção "-c edge".

Para uma instalação independente de 1 host

Se você estiver atualizando da versão 4.16.01, faça downgrade do Zookeeper:
> yum downgrade apigee-zookeeper
Atualize o Cassandra e o ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Atualização do qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Atualização do LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Pare o servidor Postgres, o servidor Qpid e o PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
Atualização do postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Atualize o banco de dados do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Atualize os componentes restantes do Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
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ó.

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

Para uma instalação de cluster de 5 hosts

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

Verifique se você instalou um novo nó de standby do Postgres, conforme descrito acima em Como instalar um novo nó de standby do Postgres.
Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper na máquina 1, 2 e 3:
> yum downgrade apigee-zookeeper
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
Atualize o qpidd nas máquinas 4 e 5:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Atualize o LDAP na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Atualize os componentes do Edge na máquina 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Atualize a interface na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Atualize as máquinas 4 e 5:
1. Pare o servidor Postgres e o servidor Qpid na máquina 4:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
2. Pare o servidor Postgres, o servidor Qpid e o postgresql na máquina 5:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Pare o servidor Postgres e o postgresql no novo nó de espera que você adicionou para fazer o rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /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 do 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. Iniciar o servidor Postgres e o servidor Qpid nas máquinas 4 e 5:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
8. Configure o Postgres como um nó reserva executando os comandos abaixo 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 scripts a seguir nos dois servidores. O sistema precisa exibir resultados idênticos nos dois servidores para garantir uma replicação bem-sucedida:
  
  Na máquina 4, o nó mestre, execute:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  Confirme se o nó mestre é o principal.
  
  Na máquina 5, o nó de reserva:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Verifique se ele indica que é o standby.
Atualize os componentes do Edge na máquina 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Desative o novo nó reserva usando o procedimento acima em Como desativar um nó do Postgres.

Para uma instalação em cluster de 9 hosts

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

Verifique se você instalou um novo nó de standby do Postgres, conforme descrito acima em Como instalar um novo nó de standby do Postgres.
Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
> yum downgrade apigee-zookeeper
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
Atualize o qpidd nas máquinas 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Atualize o LDAP na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Atualize os componentes do Edge na máquina 6, 7, 1, 4 e 5 nesta ordem:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Atualize a interface na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Atualize as máquinas 8 e 9:
1. Parar o servidor do Postgres na máquina 8:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Pare o servidor do Postgres e o postgresql na máquina 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /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. Interrompa o servidor Postgres e postgresql no novo nó de espera adicionado para reversão:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  > /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 do 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 do Postgres nas máquinas 8 e 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Inicie o servidor Qpid nas máquinas 6 e 7:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-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/p
  
  configFile
11. Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. O sistema precisa mostrar resultados idênticos nos dois 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
  
  Verifique se ele diz que é o mestre.
  
  Na máquina 9, o nó de espera:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Valide se o nó indica que ele é o de espera.
Atualize os componentes do Edge na máquina 8 e 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Desative o novo nó reserva 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 conferir a lista de topologias e números de nó do Edge.

Verifique se você instalou um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
> yum downgrade apigee-zookeeper
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
Atualize o qpidd na máquina 12 e 13:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Atualize o LDAP nas máquinas 4 e 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
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
Atualize a interface nas máquinas 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Atualize as máquinas 8 e 9:
1. Parar o servidor do Postgres na máquina 8:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Parar o servidor Postgres e o postgresql na máquina 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /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-service edge-qpid-server stop
4. Pare o servidor Postgres e o postgresql no novo nó de reserva que você adicionou para fazer o rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /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 do Postgres na máquina 8 (somente mestre do Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Atualize o postgresql em 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-service edge-postgres-server start
9. Inicie o servidor Qpid nas máquinas 12 e 13:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. Configure o Postgres como um nó reserva executando os comandos abaixo 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 scripts a seguir nos dois servidores. O sistema precisa mostrar resultados idênticos nos dois 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
  
  Verifique se ele diz que é o mestre.
  
  Na máquina 9, o nó de espera:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Valide se o nó indica que ele é o de espera.
Atualize os componentes do Edge na máquina 8 e 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Desative o novo nó reserva usando o procedimento acima em Como desativar um nó do Postgres.

Para uma instalação de cluster de 12 hosts

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

Verifique se você instalou um novo nó de standby do Postgres, conforme descrito acima em Como instalar um novo nó de standby do Postgres.
Atualize o Cassandra e o ZooKeeper:
1. Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3 no data center 1:
  > yum downgrade apigee-zookeeper
2. Nas máquinas 1, 2 e 3 no data center 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper na máquina 7, 8 e 9 no Data Center 2:
  > yum faça 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
Atualização do qpidd:
1. Máquinas 4 e 5 no data center 1
  > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
2. Máquinas 10 e 11 no data center 2
  > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
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
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 e 9 no data center 2
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Atualizar 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
Atualize a máquina 6 no data center 1 e a 12 no data center 2:
1. Pare o servidor Postgres na máquina 6:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. Pare o servidor Postgres e o postgresql na máquina 12:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Interromper 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 fazer o rollback:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /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 do Postgres na máquina 6 (somente mestre do Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Atualize o postgresql em máquinas 12:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Inicie o servidor do Postgres nas máquinas 6 e 12:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Inicie o servidor do servidor Qpid nas máquinas 4, 5, 10 e 11:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. Configure o Postgres como um nó reserva executando os comandos abaixo 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
  
  Verifique se ele diz que é o mestre.
  
  Na máquina 12, o nó de reserva:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Verifique se ele indica que é o standby.
Atualize os componentes do Edge nas máquinas 6 e 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Certifique-se de desativar o novo nó de espera usando o procedimento acima em Como desativar um nó do Postgres.

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

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

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

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

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

Atualize o Cassandra nas máquinas 8, 9 e 10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Atualize o ElasticSearch nas máquinas 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
Atualize a pilha API BaaS nas máquinas 4, 5 e 6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
Atualização do Portal do 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 nesta ordem:

ZooKeeper
Cassandra
qpidd
LDAP
"Edge", ou seja, o perfil "-c edge" em todos os nós na ordem: nós com 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 Postgres instalados, execute a etapa de perfil "-c edge" como parte da etapa 8.
Interface do Edge
postgresql no mestre do Postgres, incluindo upgrade.
postgresql no modo de espera do Postgres.
Edge, ou seja, o perfil "-c edge" em todos os nós combinados do Qpid e do Postgres ou em qualquer nó autônomo do Postgres.