Nesta seção, descrevemos como fazer upgrade do Apigee Edge 4.19.06 ou 4.50.00 para 4.51.00.
Quem pode executar a atualização
A pessoa que está executando a atualização precisa ser a mesma que instalou o Edge originalmente ou uma pessoa que está executando como raiz.
Depois que você instalar as RPMs do Edge, qualquer pessoa 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.
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 retidos pela atualização.
Upgrade obrigatório para o Postgres 10.17
Esta versão do Edge inclui um upgrade para o Postgres 10.17. Como parte desse upgrade, todos os dados do Postgres são migrados para o Postgres 10.17.
A maioria dos sistemas de produção de borda usa dois nós Postgres configurados para replicação mestre em espera. Durante o processo de atualização, enquanto os nós do Postgres estão inativos para atualização, os dados de análise ainda são gravados nos nós do Qpid. Depois que os nós do Postgres são atualizados e ficam on-line novamente, os dados de análise são enviados a eles.
A maneira como você executa a atualização do Postgres depende de como o armazenamento de dados foi configurado para os nós do Postgres:
- Se você usar armazenamento de dados locais para os nós do Postgres, precisará instalar um novo nó de espera do Postgres durante o upgrade. Após a conclusão do upgrade, será possível desativar o novo nó de espera do Postgres.
O nó de espera do Postgres adicional será necessário se você precisar reverter a atualização por qualquer motivo. Se você precisar reverter a atualização, o novo nó de espera do Postgres se tornará o nó mestre do Postgres após a reversão. Portanto, quando você instalar o novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de hardware de um servidor do Postgres, conforme definido nos Requisitos de instalação do Edge.
Em uma configuração de um e dois nós do Edge, topologias usadas para prototipagem e testes, você tem apenas um nó do Postgres. É possível atualizar esses nós do Postgres diretamente, sem precisar criar um novo nó.
- Se você usa armazenamento de rede para os nós do Postgres, conforme
recomendado pela Apigee, não precisa instalar um novo nó do Postgres. Nos procedimentos abaixo, é possível pular as etapas que especificam a instalação e desativação de um novo nó de espera do Postgres.
Antes de iniciar o processo de atualização, tire um snapshot da rede do armazenamento de dados usado pelo Postgres. Em seguida, se ocorrer um erro durante a atualização e você precisar realizar uma reversão, restaure o nó do Postgres desse snapshot.
Como instalar um novo nó de espera do Postgres
Este procedimento cria um servidor em espera do Postgres em um novo nó. Verifique se você instalou um novo servidor em espera do Postgres para a versão atual do Edge (4.19.06 ou 4.50.00), e não para a 4.51.00.
Para executar a instalação, use o mesmo arquivo de configuração usado para instalar a versão atual do Edge.
Para criar um novo nó de espera do Postgres:
- 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_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
em que existing_standby_ip é o endereço IP do servidor em espera atual do Postgres e new_standby_ip é o endereço IP do novo nó de espera.
- Reinicie
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
no mestre. Você verá as seguintes linhas nesse arquivo:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Instale o novo servidor em espera do Postgres:
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar
o seguinte:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
- Siga um destes procedimentos, dependendo da versão do Edge a partir da qual você está fazendo upgrade:
- Se você estiver fazendo upgrade do Edge 4.19.06,
faça o download do arquivo bootstrap_4.19.06.sh do Edge para
/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
Em seguida, instale o utilitário
apigee-service
do Edge e as dependências:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- Se você estiver fazendo upgrade do Edge 4.50.00,
faça o download do arquivo bootstrap_4.50.00.sh do Edge para
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
Em seguida, instale o utilitário
apigee-service
do Edge e as dependências:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- Se você estiver fazendo upgrade do Edge 4.19.06,
faça o download do arquivo bootstrap_4.19.06.sh do Edge para
- Use
apigee-service
para instalar o utilitárioapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Instale o Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- No novo nó de espera, execute o seguinte comando:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Confirme se ele diz que é o de espera.
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar
o seguinte:
Como fazer um upgrade do Postgres no local
Para fazer um upgrade no local para o Postgres 10.17, siga estas etapas:
- Fazer upgrade do postgres no host mestre
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Execute o comando de configuração no host mestre:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- Execute o comando de configuração no host mestre:
apigee-service apigee-postgresql configure
- Reinicie o host mestre:
apigee-service apigee-postgresql restart
- Configure-o como mestre:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- Verifique se o host mestre foi iniciado:
apigee-service apigee-postgresql wait_for_ready
- Parar o modo de espera:
apigee-service apigee-postgresql stop
- Fazer upgrade do modo de espera.
Observação:se esta etapa falhar ou falhar, você pode ignorar.
update.sh
tentará iniciar o servidor em espera com uma configuração incorreta. Se a instalação do Postgres for atualizada para a versão 10.17, o erro poderá ser ignorado./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Verifique se o modo de espera está interrompido:
apigee-service apigee-postgresql stop
- Remova a configuração antiga de espera:
rm -rf /opt/apigee/data/apigee-postgresql/
- Configure a replicação no servidor em espera:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
Após concluir este procedimento, o modo de espera será iniciado.
Como desativar um nó do Postgres
Depois que a atualização for concluída, desative o novo nó de espera:
- Verifique se o Postgres está sendo executado:
/opt/apigee/apigee-service/bin/apigee-all status
Inicie o Postgres, se ele não estiver em execução:
/opt/apigee/apigee-service/bin/apigee-all start
- Consiga o UUID do novo nó de espera executando o seguinte comando
curl
no novo nó de espera:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
É exibido o UUID do nó no final da saída, no formato:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Pare o novo nó de espera executando o seguinte comando nele:
/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ó de espera deconf_pg_hba_replication.connection
:conf_pg_hba_replication.connection=host replication apigee existing_standby_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ó de espera foi removido visualizando o arquivo
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
no mestre. Apenas esta linha vai aparecer nesse arquivo:host replication apigee existing_standby_ip/32 trust
- Exclua o UUID do nó em espera do ZooKeeper fazendo a seguinte chamada da API de gerenciamento de borda
no nó do servidor de gerenciamento:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
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, recomendamos que você faça 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
Verifique se o Edge está funcionando durante o processo de atualização usando o comando:/opt/apigee/apigee-service/bin/apigee-all status
Nova interface do Edge
Nesta seção, listamos considerações sobre a IU do Edge. Para mais informações, consulte A nova IU do Edge para nuvem privada.
Instalar a interface do Edge
Depois de concluir a instalação inicial, a Apigee recomenda instalar a interface do Edge, que é uma interface de usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada.
Observe que a interface do usuário do Edge exige que você desative a autenticação básica e use um IdP, como SAML ou LDAP.
Para saber mais, consulte Instalar a nova interface do Edge.
Atualizar a interface do Edge
Para atualizar o componente de interface do Edge, considere a versão do Edge para a nuvem privada de que você está fazendo upgrade:
- De 4.19.06 ou 4.50.00 a 4.51.00 (com a nova IU do Edge já instalada): use as
instruções de upgrade nesta seção para o
componente
edge-management-ui
.
Atualizar com o mTLS da Apigee
Para atualizar o mTLS da Apigee , siga estas etapas:
Como reverter uma atualização
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 Reverter 4.51.00 para ver instruções detalhadas.
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 a pessoa 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 a pessoa não tiver acesso ao /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.
- Atualize as máquinas na ordem correta da instalação, conforme descrito Ordem de atualização da máquina.
- 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).
- 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ó.
- Torne o roteador acessível novamente.
- Repita as etapas de 2 a 4 para os outros roteadores.
- Continue a atualização para as máquinas restantes na instalação.
Tome as medidas a seguir antes e depois da atualização:
- No nó combinado do roteador e processador de mensagens:
- Antes da atualização, faça o seguinte:
- Torne o roteador inacessível.
- Torne o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
- Torne o processador de mensagens acessível.
- Torne o roteador acessível.
- Antes da atualização, faça o seguinte:
- Em nós únicos do roteador:
- Antes da atualização, deixe o roteador inacessível.
- Após a atualização, torne o roteador acessível.
- Em nós do processador de mensagens único:
- Antes da atualização, torne o processador de mensagens inacessível.
- Após a atualização, torne o processador de mensagens acessível.
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.19.06 ou 4.50.00.
Atualize para a versão 4.51.00 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 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. - Faça login no nó como raiz para instalar as RPMs do Edge.
- Instale o
yum-utils
e oyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
- Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
sudo yum-config-manager --enable ol7_optional_latest
- Se você estiver instalando na AWS, execute os seguintes comandos
yum-configure-manager
:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Faça o download do arquivo
bootstrap_4.51.00.sh
do Edge 4.51.00 para/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Instale o utilitário
apigee-service
e as dependências do Edge 4.51.00 executando o seguinte comando:sudo bash /tmp/bootstrap_4.51.00.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 pWord, será solicitado que o insira.
Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Se você não fizer isso, o instalador o instalará para você.
Use a opção
JAVA_FIX
para especificar como lidar com a instalação do Java.JAVA_FIX
usa estes valores:I
: instala o OpenJDK 1.8 (padrão).C
: continua sem instalar o Java.Q
: sair. Para esta opção, você precisa instalar o Java por conta própria.
- Use
apigee-service
para atualizar o utilitárioapigee-setup
, como o exemplo a seguir mostra:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Atualize o utilitário
apigee-validate
no servidor de gerenciamento, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Atualize o utilitário
apigee-provision
no servidor de gerenciamento, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Execute o seguinte comando para executar o utilitário
update
nos nós:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Faça isso na ordem descrita em Ordem de atualização da máquina.
Em que:
- component é o componente de borda a ser atualizado. Os valores possíveis incluem:
cs
: Cassandraedge
: todos os componentes do Edge, exceto os Edge UI: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID e servidor Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpidd.sso
: SSO da Apigee (se você tiver instalado o SSO)ue
: nova interface do Edgeui
: interface clássica do Edgezk
: guardião do zoológico
- configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.19.06 ou 4.50.00.
É possível executar
update.sh
em todos os componentes definindo component como "todos", mas somente se você tiver um perfil de instalação do Edge all-in-one (AIO). Exemplo:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component é o componente de borda a ser atualizado. Os valores possíveis incluem:
- Reinicie o componente de IU do Edge em todos os nós que o executam, caso ainda não tenha feito isso:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Teste a atualização executando o utilitário
apigee-validate
no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se mais tarde você decidir reverter a atualização, use o procedimento descrito em Reverter 4.51.00.
Atualização para a versão 4.51.00 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, ou você pode usar seu próprio servidor da Web.
Para atualizar de um repositório 4.51.00 local:
- Crie um repositório 4.51.00 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee Apigee.
- Para instalar o apigee-service em um arquivo .tar:
- 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.51.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 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ó. - No novo nó, descompacte o arquivo para o diretório
/tmp
:tar -xzf apigee-4.51.00.tar.gz
Esse comando cria um novo diretório, chamado
repos
, no diretório que contém o arquivo .tar. Por exemplo,/tmp/repos
. - Instale o utilitário
apigee-service
do Edge e as dependências do/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observe que você incluiu o caminho para o diretório de repositórios nesse comando.
- No nó com o repositório local, use o seguinte comando para empacotar o repositório local
em um único arquivo .tar chamado
- Para instalar o serviço da Apigee usando o servidor da Web NGINX:
- 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 Apigee Apigee.
- No nó remoto, faça o download do arquivo
bootstrap_4.51.00.sh
do Edge para/tmp/bootstrap_4.51.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
Em que uName:pWord é o nome de usuário e a senha que você definiu anteriormente para o repositório, e remoteRepo é o endereço IP ou nome DNS do nó do repositório.
- No nó remoto, instale o utilitário
apigee-setup
e as dependências do Edge:sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Em que uName:pWord é o nome de usuário e a senha do repo.
- Use
apigee-service
para atualizar o utilitárioapigee-setup
, como o exemplo a seguir mostra:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Atualize o utilitário
apigee-validate
no servidor de gerenciamento, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Atualize o utilitário
apigee-provision
no servidor de gerenciamento, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Execute o utilitário
update
nos nós na ordem descrita em Ordem de atualização da máquina:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Em que:
- component é o componente de borda a ser atualizado. Geralmente, os seguintes componentes são atualizados:
cs
: Cassandraedge
: todos os componentes do Edge, exceto os Edge UI: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID e servidor Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpidd.sso
: SSO da Apigee (se você tiver instalado o SSO)ue
nova interface do Edgeui
: interface clássica do Edgezk
: guardião do zoológico
- configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.19.06 ou 4.50.00.
É possível executar
update.sh
em todos os componentes definindo component como "todos", mas somente se você tiver um perfil de instalação do Edge all-in-one (AIO). Exemplo:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component é o componente de borda a ser atualizado. Geralmente, os seguintes componentes são atualizados:
- Reinicie os componentes da interface em todos os nós que o executam, caso ainda não tenha feito isso:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Teste a atualização executando o utilitário
apigee-validate
no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se mais tarde você decidir reverter a atualização, use o procedimento descrito em Reverter 4.51.00.
Ordem de atualização da máquina
A ordem de atualização das máquinas em uma instalação do Edge é importante:
- É 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 edge
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 edge
.
Upgrade independente de um nó
Para fazer upgrade de uma configuração autônoma de um nó para a versão 4.51.00:
- Atualizar todos os componentes:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- Se você instalou o
apigee-adminapi
, o utilitárioapigee-adminapi
foi atualizado:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Upgrade independente de dois nós
Atualize os componentes a seguir para uma instalação autônoma de dois nós:
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.
- Atualize o Cassandra e o ZooKeeper na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Atualize o Qpid e o Postgres na máquina 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -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 nas máquinas 2 e 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize a IU na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Se você instalou o
apigee-adminapi
) O utilitárioapigee-adminapi
foi atualizado na máquina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.
- Reinicie o componente de IU do Edge na máquina 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade de cinco nós
Atualize os componentes a seguir para uma instalação de cinco nós:
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.
- 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 Qpid e o Postgres na máquina 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Atualize o Qpid e o Postgres na máquina 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -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 nas máquinas 4, 5, 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize a IU do Edge:
- IU clássica: se você estiver usando a IU clássica, atualize o
componente
ui
na máquina 1, conforme o exemplo a seguir:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Nova interface do Edge:se você instalou a nova interface do Edge, atualize o
componente
ue
na máquina apropriada (pode não ser a máquina 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- IU clássica: se você estiver usando a IU clássica, atualize o
componente
- (Se você instalou o
apigee-adminapi
) O utilitárioapigee-adminapi
foi atualizado na máquina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.
- Reinicie o componente de IU:
- IU clássica: se você estiver usando a IU clássica, reinicie o
componente
edge-ui
na máquina 1, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o
componente
edge-management-ui
na máquina apropriada (pode não ser a máquina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- IU clássica: se você estiver usando a IU clássica, reinicie o
componente
Upgrade em cluster com nove nós
Atualize os componentes a seguir para uma instalação em cluster de nove nós:
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.
- 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 Qpid nas máquinas 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize o Postgres na máquina 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Atualize o Postgres na máquina 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -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 nas máquinas 6, 7, 8, 9, 1, 4 e 5 nesta ordem:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize a nova interface (
ue
) ou a clássica (ui
) na máquina 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se você instalou o
apigee-adminapi
) Atualize o utilitárioapigee-adminapi
na máquina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.
- Reinicie o componente de IU:
- IU clássica: se você estiver usando a IU clássica, reinicie o
componente
edge-ui
na máquina 1, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o
componente
edge-management-ui
na máquina apropriada (pode não ser a máquina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- IU clássica: se você estiver usando a IU clássica, reinicie o
componente
Upgrade em cluster de 13 nós
Atualize os componentes a seguir para uma instalação em cluster de 13 nós:
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.
- 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 Qpid nas máquinas 12 e 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize o Postgres na máquina 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Atualize o Postgres na máquina 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -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, 8, 9, 6, 7, 10 e 11 nesta ordem:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize a nova IU (
ue
) ou a IU clássica (ui
) nas máquinas 6 e 7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se você instalou o
apigee-adminapi
) O utilitárioapigee-adminapi
foi atualizado nas máquinas 6 e 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee nas máquinas 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.
- Reinicie o componente de IU:
- IU clássica:se você estiver usando a IU clássica, reinicie o
componente
edge-ui
nas máquinas 6 e 7, conforme o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nova interface do Edge:se você instalou a nova interface do Edge, reinicie o componente
edge-management-ui
nas máquinas 6 e 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- IU clássica:se você estiver usando a IU clássica, reinicie o
componente
Upgrade em cluster de 12 nós
Atualize os componentes a seguir para uma instalação em cluster de 12 nós:
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nós.
- Atualize o Cassandra e o ZooKeeper:
- Nas máquinas 1, 2 e 3 no data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Nas máquinas 7, 8 e 9 no data center 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Nas máquinas 1, 2 e 3 no data center 1:
- Atualize o qpidd:
- Máquinas 4, 5 no data center 1
- Atualize o
qpidd
na máquina 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize o
qpidd
na máquina 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize o
- Máquinas 10, 11 no data center 2
- Atualize
qpidd
na máquina 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize
qpidd
na máquina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize
- Máquinas 4, 5 no data center 1
- Atualize o Postgres:
- Máquina 6 no Data center 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Máquina 12 no Data center 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Máquina 6 no Data center 1
- Atualize o LDAP:
- Máquina 1 no Data center 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Máquina 7 no Data Center 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Máquina 1 no Data center 1
- Atualize os componentes do Edge:
- Máquinas 4, 5, 6, 1, 2, 3 no data center 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 10, 11, 12, 7, 8, 9 no data center 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 4, 5, 6, 1, 2, 3 no data center 1
- Atualize a nova IU (
ue
) ou a clássica (ui
):- Máquina 1 no Data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Máquina 7 no data center 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Máquina 1 no Data center 1:
- Se você instalou o
apigee-adminapi
, o utilitárioapigee-adminapi
foi atualizado:- Máquina 1 no Data center 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Máquina 7 no data center 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Máquina 1 no Data center 1:
- (Se você instalou o SSO da Apigee) Atualize o SSO da Apigee:
- Máquina 1 no Data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Máquina 7 no data center 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Em que sso_config_file é o arquivo de configuração criado quando você instalou o SSO.
- Máquina 1 no Data center 1:
- Reinicie a nova interface do Edge (
edge-management-ui
) ou o componente da interface clássica do Edge (edge-ui
) nas máquinas 1 e 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
Para uma configuração não padrão
Se você tiver uma configuração não padrão, atualize os componentes do Edge na seguinte ordem:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, que significa o perfil "-c borda" em todos os nós na ordem: nós com servidor Qpid, servidor Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
- interface do Edge (clássica ou nova)
apigee-adminapi
- SSO da Apigee
Depois de concluir a atualização, reinicie o componente da interface do Edge em todas as máquinas que o executam.