A Apigee oferece suporte ao upgrade do Edge para nuvem privada diretamente da versão 4.51.00, 4.52.00 ou 4.52.01 para a versão 4.52.02. Nesta página, descrevemos como realizar esses upgrades.
Quem pode fazer a atualização
A pessoa que executa a atualização precisa ser a mesma que instalou o Edge originalmente ou uma pessoa que executa como raiz.
Depois de instalar os RPMs do Edge, qualquer pessoa 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.
Pré-requisitos de atualização
Verifique os seguintes pré-requisitos antes de fazer upgrade da Apigee Edge:
- Fazer backup de todos os nós
Antes de atualizar, 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 realizar o backup.Assim, você tem 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
- Verifique se a estratégia de compactação do Cassandra é
LeveledCompactionStrategy
Dependendo da versão atual, faça as mudanças necessárias na estratégia de compactação do Cassandra. Siga as etapas abaixo e volte ao procedimento principal de upgrade:- Se você estiver fazendo upgrade da versão 4.51.00, consulte o documento sobre a estratégia de compactação do Cassandra para a v4.51.00.
- Se você estiver fazendo upgrade da versão 4.52.00, consulte o documento sobre a estratégia de compactação do Cassandra para a versão 4.52.00.
- Se você estiver fazendo upgrade da versão 4.52.01, consulte o documento sobre a estratégia de compactação do Cassandra para a versão 4.52.01.
Quais etapas especiais considerar para o upgrade
Para fazer upgrade para o Edge para nuvem privada 4.52.02, considere executar etapas específicas para fazer upgrade de determinados softwares. As etapas necessárias dependem da sua versão atual. Consulte a tabela abaixo para ver os vários softwares que exigem etapas complementares e siga as instruções detalhadas para cada um. Depois de concluir as tarefas necessárias, volte ao procedimento principal para continuar o processo de upgrade.
| Versão atual | Software que requer etapas especiais para upgrade para a versão 4.52.02 |
|---|---|
| 4.52.01 | Cassandra |
| 4.52.00 | Zookeeper, Cassandra, Qpid |
| 4.51.00 | Zookeeper, Postgres, Cassandra, Qpid |
Depois de realizar as etapas necessárias com base na sua versão, volte ao procedimento de upgrade principal para continuar.
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 após a atualização.
Fazer upgrade para o Zookeeper 3.8.3
O Edge para nuvem privada 4.52.02 não inclui um upgrade do Zookeeper. No entanto, se você estiver fazendo upgrade de uma versão anterior à 4.52.01, siga as etapas de upgrade do ZooKeeper descritas abaixo.
- Se você estiver fazendo upgrade das versões 4.51.00 ou 4.52.00 do Edge para nuvem privada, consulte as etapas em Upgrade obrigatório para o Zookeeper 3.8.3 para fazer upgrade do Zookeeper.
- Se você estiver fazendo upgrade do Edge para nuvem privada versão 4.52.01, já deverá estar usando o Zookeeper versão 3.8.3 e não precisará seguir nenhuma etapa especial para fazer upgrade do Zookeeper.
Fazer upgrade para o Postgres 14
- Se você estiver fazendo upgrade do Edge para nuvem privada 4.51.00 para 4.52.02, siga as etapas para fazer upgrade do Postgres, mesmo que o Edge para nuvem privada 4.52.02 não inclua um upgrade do Postgres. O upgrade do Edge para nuvem privada 4.51.00 para 4.52.02 requer outras etapas de upgrade do Postgres. Consulte a seção Upgrade obrigatório para o Postgres 14.
- Se você estiver fazendo upgrade do Edge para nuvem privada 4.52.00 ou 4.52.01 para 4.52.02, não será necessário seguir outras etapas de upgrade do Postgres.
Fazer upgrade para o Cassandra 3.11.16
A Apigee Edge para nuvem privada 4.52.02 inclui um upgrade do Cassandra para a versão 3.11.16. O Cassandra é um componente essencial da Apigee, e esse upgrade também inclui atualizações no software do driver em vários componentes de ambiente de execução e gerenciamento usados para consultar e gravar no Cassandra.
Como esse é um upgrade importante, algumas mudanças no modelo de dados da Apigee no Cassandra foram necessárias para garantir o desempenho ideal nas versões mais recentes. Embora essas mudanças sejam mínimas, o processo de upgrade interrompe algumas APIs de gerenciamento quando é iniciado. As APIs de gerenciamento exatas que geralmente são interrompidas estão listadas nas seções relevantes abaixo.
Além disso, o processo de upgrade causa interrupções em um conjunto maior de fluxos de proxy de ambiente de execução e APIs de gerenciamento no data center que está sendo atualizado. É fundamental isolar o tráfego de ambiente de execução e de gerenciamento do data center que está sendo atualizado para minimizar essa interrupção. Leia as seções sobre data center único e vários data centers abaixo para mais informações.
Portal do desenvolvedor: como documentar APIs
O portal do desenvolvedor do Drupal da Apigee oferece vários recursos para documentar suas APIs. Embora seja recomendável deixar de usar o portal do desenvolvedor baseado no Drupal 7, se você ainda o utiliza e usa o recurso SmartDocs, o documento Como usar as APIs do SmartDocs se aplica a você. Se você estiver usando versões mais recentes do portal do desenvolvedor, a documentação da API não será afetada durante esse upgrade.
Quando você faz upgrade da Apigee para a versão 4.52.02, os modelos de API criados com o recurso SmartDocs do portal do desenvolvedor do Drupal 7 não são migrados automaticamente para a versão mais recente. É preciso exportar manualmente cada modelo usando o portal do desenvolvedor e importá-lo novamente após concluir o upgrade.
Terminologia usada abaixo
Ambiente de execução: abrange o processamento do tráfego do proxy do ambiente de execução. Ele inclui todas as operações realizadas pelos roteadores e processadores de mensagens para processar de maneira eficaz uma solicitação de API de ambiente de execução para proxies atuais. No entanto, ela não inclui a implantação de novos proxies ou novas revisões de proxies.
Gerenciamento: inclui a administração do sistema da Apigee Edge. Isso inclui, entre outros, implantações, modificações de apps, produtos, servidores de destino, keystores etc. Todas as APIs de gerenciamento (e os clientes delas, como a interface da Apigee e o portal do desenvolvedor) estão incluídas nesse escopo.
Durante esse upgrade, o tráfego de ambiente de execução e gerenciamento é afetado na região ou no data center (DC) em que a atualização está sendo executada. Independentemente do data center que está sendo atualizado, há um impacto em determinadas APIs de gerenciamento em todos os data centers. Esse impacto é observado após cada etapa.
Em cada etapa abaixo, o estado do ambiente de execução e do gerenciamento é descrito conforme você avança pelas várias fases do procedimento de upgrade.
Estratégias de upgrade
Vários data centers
O upgrade precisa ser realizado em um data center por vez para garantir a continuidade do tráfego e evitar inatividade. Antes de fazer upgrade de um DC, o tráfego precisa ser redirecionado para outros DCs funcionais.
Data center único
Para uma configuração de data center único, o procedimento de upgrade vai ter um impacto significativo no tráfego do ambiente de execução e em determinadas APIs de gerenciamento. As opções a seguir estão disponíveis para uma configuração de data center único.
- Expanda o cluster do Edge para nuvem privada para um data center temporário adicionando um data center ao lado do atual para processar o tráfego durante o upgrade. Em seguida, desative um dos data centers após a conclusão do processo de upgrade.
- Se não for possível expandir para outro data center, prepare-se para o tempo de inatividade e programe o upgrade para períodos de baixo tráfego para minimizar o impacto nas APIs de gerenciamento e no tráfego do ambiente de execução.
É recomendável expandir para um data center adicional para evitar impactos no tráfego de ambiente de execução e nas APIs de gerenciamento. Durante o upgrade, os impactos no data center que está sendo atualizado incluem, mas não se limitam às seguintes áreas:
- APIs de ambiente de execução que atualizam tokens OAuth
- APIs de ambiente de execução que usam a política de entidade de acesso
- APIs de gerenciamento que listam apps de desenvolvedor
- APIs de gerenciamento que listam produtos
O impacto descrito acima é adicional às APIs de gerenciamento específicas que vão permanecer não funcionais em todos os data centers até que todos eles sejam atualizados. Essas APIs de gerenciamento estão listadas nas etapas das seções seguintes.
Reversão: alto nível
- Impacto durante a reversão
A reversão do Cassandra 3.11.x para 2.1.x afeta o tráfego de ambiente de execução e de gerenciamento no data center (DC) em que a reversão está sendo realizada. Além disso, algumas APIs de gerenciamento podem sofrer interrupções em todos os data centers, independentemente de qual DC está sendo revertido.
- Siga a abordagem de reversão DC por DC
A reversão precisa ser executada em um data center por vez para manter a continuidade do serviço e evitar o tempo de inatividade. Antes de iniciar a reversão em um DC específico, verifique se o tráfego do aplicativo foi redirecionado para outro data center totalmente operacional.
- Como reverter um cluster parcialmente atualizado
Se pelo menos um data center permanecer totalmente operacional na versão mais antiga do Cassandra (2.1.22), outros DCs atualizados poderão ser revertidos com uma recriação do DC do Cassandra 2.1.X totalmente funcional.
- Reversão em todo o cluster
Se todo o cluster do Cassandra tiver sido atualizado e a reversão for necessária, ela precisará ser realizada usando backups ou snapshots de VM. Essa abordagem é complexa e provavelmente vai causar inatividade temporária ou perda de dados.
- Considerações pré-upgrade
É importante que você se familiarize com os procedimentos de reversão antes de tentar fazer o upgrade. É fundamental que as nuances da reversão sejam consideradas durante o upgrade para garantir que os caminhos de reversão adequados estejam disponíveis.
Reverter clusters com um único data center
O upgrade do Cassandra da versão 2.1.x para a 3.11.x pode afetar significativamente o tráfego do ambiente de execução e algumas APIs de gerenciamento. Esses impactos também se aplicam durante a reversão e podem resultar em inatividade ou perda de dados.
Para cargas de trabalho de produção, é altamente recomendável provisionar um novo data center antes do upgrade. Isso permite um caminho de reversão mais seguro, sem perda de dados ou interrupção do tráfego da API. O data center extra pode ser desativado após a conclusão do upgrade.
Se não for possível adicionar um novo data center, mas a capacidade de reversão ainda for necessária, faça backups confiáveis antes do upgrade. É possível restaurar o Cassandra 2.1.x de backups, mas essa abordagem pode envolver inatividade do serviço e possível perda de dados.
Reverter clusters com vários data centers
A reversão de vários data centers segue uma abordagem de data center por data center (DC-by-DC). Nessa abordagem, o tráfego do data center que está sendo revertido é redirecionado para outros data centers funcionais, garantindo um processo de reversão controlado e isolado para os nós do Cassandra, do servidor de gerenciamento e do ambiente de execução, evitando interrupções no tráfego.
Consulte a seção Reverter a atualização do Cassandra 3.11.16 para mais detalhes.
Etapa 0: estado inicial
- Os componentes do Zookeeper, Postgres e LDAP já foram atualizados para as versões 4.52.02. O cluster do Edge para nuvem privada está estável e funcionando. Se a reversão for necessária, o cluster será revertido para esse estado.
- Cassandra na Apigee em execução com a versão 2.1.22.
- Componentes do Edge:
- O servidor de gerenciamento se comunica com o Cassandra usando o protocolo Thrift mais antigo.
- Servidores de ambiente de execução (processadores de mensagens e roteadores) se comunicando com o Cassandra pelo protocolo Thrift mais antigo.
| Estado do ambiente de execução nesta fase | Estado de gerenciamento nesta fase |
|---|---|
| Ambiente de execução totalmente funcional | Gerenciamento totalmente funcional |
Etapa 1: preparar para o upgrade
As etapas abaixo são adicionais aos arquivos padrão que você costuma criar, como o arquivo de configuração padrão da Apigee para ativar upgrades de componentes.
- Mude o Cassandra para usar LeveledCompactionStrategy.
- Fazer backup do Cassandra usando a Apigee.
- Crie snapshots de VM dos nós do Cassandra (se possível).
-
Crie um arquivo de configuração de upgrade do Cassandra em cada nó do Cassandra em
/opt/apigee/apigee-cassandra/cass_upgrade.confcom o seguinte conteúdo: Se não for possível criar o arquivo em# IP Address of node HOSTIP=10.0.0.1 # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication. CASS_USERNAME=<cassuser> # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication. CASS_PASSWORD=<casspass> # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped. CASS_PORT=9160 # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped. CASS_CQL_PORT=9042 # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped. # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly. CASS_TMP_DIR=/tmp/cass_upgrade_scripts/opt/apigee/apigee-cassandra/cass_upgrade.conf, crie o arquivo/opt/silent.confcom o mesmo conteúdo em cada nó do Cassandra. - Se você usa o recurso SmartDocs do portal do desenvolvedor do Apigee Drupal 7, exporte cada um dos seus modelos fazendo o download deles no formato JSON na interface do portal do desenvolvedor. Esses modelos precisarão ser importados de volta para a Apigee depois que os servidores de gerenciamento forem atualizados.
- Verifique se as portas 9160 e 9042 estão acessíveis de todos os componentes do Edge para os nós do Cassandra, se ainda não estiverem. Consulte Requisitos de porta para mais informações.
Etapa 2: redirecionar o tráfego do primeiro data center
- Bloqueie o tráfego de gerenciamento e de ambiente de execução recebido do primeiro data center.
- Redirecione todo o tráfego de ambiente de execução e as APIs de gerenciamento para os outros data centers funcionais.
- Verifique se o tráfego de ambiente de execução e de gerenciamento é processado corretamente pelos outros DCs.
Etapa 3: fazer upgrade de todos os nós do Cassandra no primeiro data center
-
Faça upgrade de todos os nós do Cassandra no data center, um por um. Execute os seguintes comandos em cada nó, um por um:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
Depois que um nó for atualizado, execute o seguinte comando nele para fazer algumas validações antes de continuar:
O resultado será algo como:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
- Execute o seguinte comando
post_upgradeem cada nó do Cassandra, um por um, após a conclusão do upgrade:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
| Estado do ambiente de execução nesta fase | Estado de gerenciamento nesta fase |
|---|---|
|
|
Etapa 4: fazer upgrade de todos os nós de gerenciamento no primeiro data center
Faça upgrade de todos os nós de gerenciamento no data center:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
| Estado do ambiente de execução nesta fase | Estado de gerenciamento nesta fase |
|---|---|
|
|
Etapa 5: fazer upgrade de todos os nós de ambiente de execução no primeiro data center
Faça upgrade de todos os nós de roteadores e processadores de mensagens no data center, um por um:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
| Estado do ambiente de execução nesta fase | Estado de gerenciamento nesta fase |
|---|---|
|
|
Etapa 6: redirecionar o tráfego de volta para o primeiro data center
- Depois que o primeiro data center for atualizado com o Cassandra, os componentes do ambiente de execução e o servidor de gerenciamento, reative o tráfego do ambiente de execução e de gerenciamento para o primeiro data center.
- Verifique se o tráfego de ambiente de execução e de gerenciamento é bem-sucedido em todos os DCs.
Etapa 7: fazer upgrade de outros data centers
Repita as etapas 1 a 6 nos data centers restantes, um de cada vez, redirecionando o tráfego para fora desses data centers, atualizando o software da Apigee e reativando o tráfego neles.
Etapa 8: executar novamente a etapa de upgrade em todos os nós de gerenciamento
Execute novamente o seguinte comando de upgrade em todos os nós de gerenciamento nos data centers:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Etapa 9: [opcional] Importar smartdocs que foram exportados anteriormente
Depois que todos os servidores de gerenciamento forem atualizados, importe os modelos de documentos inteligentes que você exportou na Etapa 1. Você pode fazer isso mais tarde.
Isso só é necessário se você usa o portal do desenvolvedor baseado no Drupal 7 e o recurso SmartDocs.
| Estado do ambiente de execução nesta fase | Estado de gerenciamento nesta fase |
|---|---|
| Ambiente de execução totalmente funcional | Gerenciamento totalmente funcional |
Etapa 10: descartar tabelas não usadas
Execute o comando a seguir para remover tabelas antigas não utilizadas do cluster do Cassandra. Até que isso seja executado, não será possível usar determinados recursos do Cassandra (como configurar uma nova autenticação, os mecanismos de autenticação antigos continuarão funcionando). Esse comando só pode ser executado em um nó do cluster.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
Etapa 11: fazer upgrade de todos os componentes restantes do Edge e de outros componentes para a nuvem privada 4.52.02
Faça upgrade de todos os nós edge-qpid-server e edge-postgres-server restantes em todas as regiões, um por um.
Nesta etapa, se você estiver fazendo upgrade de versões anteriores ao Edge para nuvem privada 4.52.01, conforme abaixo, siga as etapas adicionais para fazer upgrade do Qpid e do Postgres, respectivamente, e faça upgrade dos componentes restantes de acordo com estas etapas.
Fazer upgrade para o Qpid J-Broker
Embora o Edge para nuvem privada 4.52.02 não inclua um upgrade para o Qpid, se você estiver fazendo upgrade de versões anteriores à 4.52.01, siga as etapas para fazer upgrade do QPID.
- Se você estiver fazendo upgrade do Edge para nuvem privada 4.51.00 ou 4.52.00 para 4.52.02, siga as etapas adicionais de upgrade do Qpid. Consulte a seção Fazer upgrade do Qpid se você estiver fazendo upgrade da versão 4.51.00 ou 4.52.00 para a 4.52.02.
- Se você estiver fazendo upgrade do Edge para nuvem privada 4.52.01 para 4.52.02, já deverá estar usando a versão mais recente do Qpid Broker, e nenhuma outra etapa de upgrade do Qpid será necessária.
Nova interface do Edge
Nesta seção, listamos considerações sobre a interface do Edge. Para mais informações, consulte A nova interface do Edge para nuvem privada.
Instalar a IU do Edge
Depois de concluir a instalação inicial, a Apigee recomenda que você instale a interface do Edge, que é uma interface do usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada.
A interface do Edge exige que você desative a autenticação básica e use um IDP, como SAML ou LDAP.
Para mais informações, consulte Instalar a nova interface do Edge.
Atualizar a interface do Edge
Para atualizar o componente da interface do Edge, considere a versão do Edge para nuvem privada que você está atualizando:
- Da versão 4.51.00 para a 4.52.00 (com a nova IU da Edge já instalada): use as
instruções de upgrade nesta seção para o
componente
edge-management-ui.
Atualizar com mTLS da Apigee
Para atualizar a mTLS da Apigee, siga estas etapas:
Como reverter uma atualização
No caso de uma falha de 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 Reverter 4.52.00 para instruções detalhadas.
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 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 você não tiver acesso ao /tmp, o utilitário update.sh vai falhar.
Atualização sem inatividade
Uma atualização sem inatividade, ou atualização gradual, permite atualizar a instalação do Edge sem desativar 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 adicione o roteador de volta ao balanceador de carga.
- Atualize as máquinas na ordem correta para a instalação, conforme descrito em Ordem de atualização da máquina.
- Quando for hora de atualizar os roteadores, selecione qualquer roteador 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 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ó.
- Torne o roteador acessível novamente.
- Repita as etapas de 2 a 4 para os roteadores restantes.
- Continue a atualização para as máquinas 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:
- Tornar 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 de roteador únicos:
- Antes da atualização, torne o roteador inacessível.
- Após a atualização, torne o roteador acessível.
- Em nós únicos 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.
Usar um arquivo de configuração silenciosa
É 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 que você usou para instalar o Edge 4.50.00 ou 4.51.00.
Atualizar para 4.52.02 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 houver, desative todos os jobs
cronconfigurados 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.
- Instale
yum-utilseyum-plugin-priorities:sudo yum install yum-utils
sudo yum install yum-plugin-priorities - Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup 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 Se você estiver usando o Edge 4.51.00:
- Faça o download do arquivo
bootstrap_4.52.02.shdo Edge para/tmp/bootstrap_4.52.02.sh:curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
- Instale o utilitário
apigee-servicedo Edge 4.52.02 e as dependências executando o seguinte comando:sudo bash /tmp/bootstrap_4.52.02.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á solicitado que você o insira.
Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o instalador fará isso por você.
Use a opção
JAVA_FIXpara especificar como lidar com a instalação do Java.JAVA_FIXusa os seguintes valores:I: instala o OpenJDK 1.8 (padrão).C: continua sem instalar o Java.Q: sair. Para essa opção, você precisa instalar o Java por conta própria.
- Use
apigee-servicepara atualizar o utilitárioapigee-setup, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Atualize o utilitário
apigee-validateno servidor de gerenciamento, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Atualize o utilitário
apigee-provisionno servidor de gerenciamento, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Execute o utilitário
updatenos nós com o seguinte comando:/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 do Edge a ser atualizado. Os valores possíveis são os seguintes:
cs: Cassandraedge: todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor Qpid, servidor Postgresldap: OpenLDAPps: postgresqlqpid: qpiddsso: SSO da Apigee (se você instalou o SSO)ue: nova interface do Edgeui: interface clássica do Edgezk: Zookeeper
- configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.50.00 ou 4.51.00.
É possível executar
update.shem todos os componentes definindo component como "all", mas somente se você tiver um perfil de instalação completo (AIO) do Edge. Exemplo:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component é o componente do Edge a ser atualizado. Os valores possíveis são os seguintes:
- Reinicie os componentes da interface do Edge em todos os nós que os executam, se ainda não tiver feito isso:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Teste a atualização executando o utilitário
apigee-validateno servidor de gerenciamento, conforme descrito em Testar a instalação.
- Faça o download do arquivo
Se você decidir reverter a atualização, use o procedimento descrito em Reverter 4.52.02.
Atualizar para a versão 4.52.02 de um repositório local
Se os nós do Edge estiverem protegidos por um firewall ou não puderem acessar o repositório da Apigee pela Internet, faça a atualização em um repositório local ou espelho do repositório da Apigee.#heading
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. 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 local 4.52.02:
- Crie um repositório local 4.52.02, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
- Para instalar o apigee-service de 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.52.02.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
/tmpno novo nó. - No novo nó, descompacte o arquivo no diretório
/tmp:tar -xzf apigee-4.52.02.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 Edge
apigee-servicee as dependências de/tmp/repos:sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observe que você inclui 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 apigee-service 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 apigee-setup do Edge.
- No nó remoto, faça o download do arquivo
bootstrap_4.52.02.shdo Edge para/tmp/bootstrap_4.52.02.sh:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
Em que uName:pWord são o nome de usuário e a senha que você definiu anteriormente para o repositório, e remoteRepo é o endereço IP ou o nome DNS do nó do repositório.
- No nó remoto, instale o utilitário
apigee-setupdo Edge e as dependências:sudo bash /tmp/bootstrap_4.52.02.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-servicepara atualizar o utilitárioapigee-setup, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Atualize o utilitário
apigee-validateno servidor de gerenciamento, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Atualize o utilitário
apigee-provisionno servidor de gerenciamento, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Execute o utilitário
updatenos 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 do Edge a ser atualizado. Normalmente, você atualiza os
seguintes componentes:
cs: Cassandraedge: todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor Qpid, servidor Postgresldap: OpenLDAPps: postgresqlqpid: qpiddsso: SSO da Apigee (se você instalou o SSO)ueNova interface do Edgeui: interface clássica do Edgezk: Zookeeper
- configFile é o mesmo arquivo de configuração usado para definir os componentes do Edge durante a instalação da versão 4.50.00 ou 4.51.00.
É possível executar
update.shem todos os componentes definindo component como "all", mas somente se você tiver um perfil de instalação completo (AIO) do Edge. Exemplo:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component é o componente do Edge a ser atualizado. Normalmente, você atualiza os
seguintes componentes:
- Reinicie os componentes da interface em todos os nós que os executam, se ainda não tiver feito isso:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Teste a atualização executando o utilitário
apigee-validateno servidor de gerenciamento, conforme descrito em Testar a instalação.
Se você decidir reverter a atualização, use o procedimento descrito em Reverter 4.52.02.
Ordem de atualização da máquina: upgrade da versão 4.51.00 (ou) 4.52.00 (ou) 4.52.01
A ordem em que você atualiza as máquinas em uma instalação do Edge é importante:
- É necessário atualizar todos os nós do ZooKeeper em todos os data centers antes de atualizar os outros componentes. Se você estiver fazendo upgrade do Edge Private Cloud 4.51.00 (ou) 4.52.00, também precisará seguir as etapas adicionais para fazer upgrade do ZooKeeper.
- É necessário atualizar o Postgresql em todos os data centers. Se você estiver fazendo upgrade do Edge Private Cloud 4.51.00, também precisará seguir outras etapas para fazer upgrade do Postgres.
- É necessário atualizar os nós LDAP em todos os data centers.
- Atualize todos os nós do Cassandra, do servidor de gerenciamento, do processador de mensagens e do roteador, um data center por vez, até que todos os data centers sejam atualizados.
- É necessário atualizar os componentes
edge-qpid-servereedge-postgres-serverem todos os data centers. - É necessário fazer upgrade dos nós do Qpid em todos os data centers. Se você estiver fazendo upgrade do Edge para nuvem privada 4.51.00 (ou) 4.52.00, também precisará seguir outras etapas para fazer upgrade do Qpid.
- Atualize a IU do Edge e a nova IU do Edge, além dos nós de SSO em todos os data centers.
- Não há uma etapa separada para atualizar a Monetização. Ele é atualizado quando você especifica a opção -c edge.
Upgrade separado de 1 nó
Para fazer upgrade de uma configuração independente de 1 nó para a versão 4.52.02:- Atualize todos os componentes:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Se você instalou o
apigee-adminapi) Atualizou o utilitárioapigee-adminapi:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Upgrade separado de 2 nós
Atualize os seguintes componentes para uma instalação independente de dois nós:
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Atualize o ZooKeeper na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
- Atualize o Postgres na máquina 2:
/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 o Cassandra na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- Atualize os componentes do Edge nas máquinas 1 e 2:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o Qpid na Máquina 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize a interface na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Se você instalou o
apigee-adminapi) Atualizou o utilitárioapigee-adminapina 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 que você criou ao instalar o SSO.
- Reinicie o componente da interface do Edge na máquina 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade de 5 nós
Atualize os seguintes componentes para uma instalação de cinco nós:
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Atualize o ZooKeeper nas máquinas 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
- Atualize o Postgres na máquina 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Atualize o Postgres na máquina 5:
/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 o Cassandra nas máquinas 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- Atualize os componentes do Edge nas máquinas 1, 2, 3, 4 e 5:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o Qpid na máquina 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize o Qpid na máquina 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize a IU do Edge:
- Interface clássica: se você estiver usando a interface clássica, atualize o
componente
uina máquina 1, como mostra o exemplo a seguir:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Nova IU do Edge: se você instalou a nova IU do Edge, atualize o componente
uena máquina apropriada (pode não ser a máquina 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- Interface clássica: se você estiver usando a interface clássica, atualize o
componente
- (Se você instalou o
apigee-adminapi) Atualizou o utilitárioapigee-adminapina 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 que você criou ao instalar o SSO.
- Reinicie o componente da interface:
- IU clássica: se você estiver usando a IU clássica, reinicie o
componente
edge-uina máquina 1, como mostra 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-uina 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 de cluster de 9 nós
Atualize os seguintes componentes para uma instalação em cluster de nove nós:
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Atualize o ZooKeeper nas máquinas 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c zk -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 o Cassandra nas máquinas 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- Atualize os componentes do Edge nas máquinas 1, 4, 5, 6, 7, 8 e 9, nessa ordem:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o Qpid nas máquinas 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize a nova interface (
ue) ou a interface clássica (ui) na máquina 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se você instalou
apigee-adminapi) Atualize o utilitárioapigee-adminapina 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 que você criou ao instalar o SSO.
- Reinicie o componente da interface:
- IU clássica: se você estiver usando a IU clássica, reinicie o
componente
edge-uina máquina 1, como mostra 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-uina 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 de cluster de 13 nós
Atualize os seguintes componentes para uma instalação em cluster de 13 nós:
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Atualize o ZooKeeper nas máquinas 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c zk -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 o Cassandra nas máquinas 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- Atualize os componentes do Edge nas máquinas 6, 7, 10, 11, 12, 13, 8 e 9, nessa ordem:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o Qpid nas máquinas 12 e 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize a nova interface (
ue) ou a interface 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) Atualizou o utilitárioapigee-adminapinas 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 que você criou ao instalar o SSO.
- Reinicie o componente da interface:
- Interface clássica: se você estiver usando a interface clássica, reinicie o componente
edge-uinas máquinas 6 e 7, como mostra o exemplo a seguir:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nova IU do Edge: se você instalou a nova IU do Edge, reinicie o componente
edge-management-uinas máquinas 6 e 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Interface clássica: se você estiver usando a interface clássica, reinicie o componente
Upgrade de cluster de 12 nós
Atualize os seguintes componentes para uma instalação em cluster de 12 nós:
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
Atualize o ZooKeeper nas máquinas 1, 2, 3, 7, 8 e 9 em ambos os DCs:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
- Atualize o Postgres nas máquinas 6,12 em ambos os DCs:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Atualize o LDAP nas máquinas 1,7 em ambos os DCs:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Bloqueie o tráfego no DC-1 e verifique se todo o tráfego foi redirecionado para o DC-2.
- Atualize o Cassandra nas máquinas 1, 2 e 3 no DC-1:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- Atualize o servidor de gerenciamento na máquina 1 em DC-1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o roteador e o processador de mensagens nas máquinas 2 e 3 no DC-1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Desbloqueie o tráfego no DC-1, valide o DC-1 e prossiga com o DC-2 bloqueando o tráfego no DC-2 e redirecionando o tráfego para o DC-1.
- Atualize o Cassandra nas máquinas 7, 8 e 9 no DC-2:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- Atualize o servidor de gerenciamento na máquina 7 em DC-2:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o roteador e o processador de mensagens na máquina 8,9 no DC-2:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Desbloqueie o tráfego no DC-2. Agora, os dois DCs vão processar o tráfego.
- Execute novamente o comando de atualização em todos os servidores de gerenciamento nos DCs nas máquinas 1 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize edge-qpid-server e edge-postgres-server nas máquinas 4, 5, 6, 10, 11 e 12 em ambos os DCs:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Atualize o Qpid nas máquinas 4, 5, 10 e 11 em ambos os DCs:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize a nova interface (ue) ou a interface clássica (ui) nos dois DCs:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se você instalou a apigee-adminapi) Atualize a apigee-adminapi nos dois DCs:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se você instalou o SSO da Apigee) Atualize os nós do SSO da Apigee nos dois DCs:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
- Reinicie o componente da nova interface do Edge (edge-management-ui) ou da interface clássica do Edge (edge-ui) nos dois DCs:
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart