A Apigee é compatível com o upgrade do Edge para nuvem privada diretamente da versão 4.52.02 para a versão 4.53.00. Nesta página, descrevemos como realizar esses upgrades.
Para uma visão geral dos caminhos de upgrade compatíveis, consulte a matriz de compatibilidade de upgrade para versões do Edge para nuvem privada.
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.Isso permite que você tenha um plano de backup, caso a atualização para uma nova versão não funcione corretamente. Para mais informações sobre backup, consulte Backup e restauração.
- Verifique se o Edge está em execução
Verifique se o Edge está em execução durante o processo de atualização usando o comando:/opt/apigee/apigee-service/bin/apigee-all status
- Verificar os pré-requisitos do Cassandra
Se você fez upgrade de uma versão mais antiga do Edge para nuvem privada para a versão 4.52.02 e agora planeja fazer upgrade para a versão 4.53.00, verifique se concluiu as etapas pós-upgrade necessárias para o Cassandra. Essas etapas estão descritas na documentação de upgrade da versão 4.52.02 e também são mencionadas em Pré-requisitos para upgrade do Cassandra. Se você não tiver certeza se essas etapas foram concluídas durante o upgrade anterior, conclua-as novamente antes de prosseguir com o upgrade para a versão 4.53.00.
- Como configurar chaves e certificados de IDP no Edge para nuvem privada 4.53.00
No Edge para nuvem privada 4.53.00, as chaves e os certificados do IDP usados no componente
apigee-ssoagora são configurados por um keystore. Será necessário exportar a chave e o certificado usados anteriormente para um keystore. Siga as etapas na seção Etapas para atualizar o SSO da Apigee de versões mais antigas para ver as etapas detalhadas antes de atualizar o componente de SSO. - Requisitos do Python
Verifique se todos os nós, incluindo os do Cassandra, têm o Python 3 instalado antes de tentar fazer o upgrade.
Propagação automática das configurações de propriedade
Se você tiver definido propriedades editando arquivos .properties em /opt/apigee/customer/application, esses valores serão mantidos pela atualização.
Upgrade do Nginx 1.26 no Edge-Router
O upgrade para o Edge para nuvem privada 4.53.00 de versões anteriores não atualiza automaticamente o software Nginx para a versão mais recente (1.26.x). Isso evita efeitos colaterais acidentais no ambiente de execução como resultado das mudanças documentadas em Mudanças do Nginx 1.26 na Apigee Edge 4.53.00. É possível fazer upgrade manual do Nginx da versão 1.20.x para a 1.26.x após a verificação em ambientes inferiores. Para fazer upgrade manualmente:
Verifique se o nó do roteador de borda tem o software 4.53.00 mais recente
/opt/apigee/apigee-service/bin/apigee-service edge-router version
Verifique a versão do Nginx que você está executando no momento
/opt/nginx/sbin/nginx -V
Se você estiver usando uma versão mais antiga do Nginx, siga as etapas abaixo para fazer upgrade do Nginx para a versão 1.26.X no nó do roteador.
Interromper o processo edge-router no nó do roteador
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
Fazer upgrade do software nginx no nó do roteador
dnf update apigee-nginx-1.26.3
Verifique se a versão do Nginx foi atualizada
/opt/nginx/sbin/nginx -V
Iniciar o processo do roteador no nó
/opt/apigee/apigee-service/bin/apigee-service edge-router start
Repita o processo em cada nó do roteador, um de cada vez.
Upgrade obrigatório para o Cassandra 4.0.13
A Apigee Edge para nuvem privada 4.53.00 inclui um upgrade do Cassandra para a versão 4.0.13.
Upgrades e reversão
- O upgrade do Cassandra 3.11.X para o Cassandra 4.0.X é um processo simples. O Cassandra 4.0.X, lançado com o Edge para nuvem privada 4.53.00, é compatível com os componentes de ambiente de execução e gerenciamento da nuvem privada 4.52.02.
- Não é possível fazer uma reversão direta do Cassandra 4.0.X para o 3.11.X. A reversão usando réplicas ou backups é um procedimento complexo e pode envolver inatividade e/ou perda de dados. É preferível resolver problemas e fazer upgrade para o Cassandra 4.0.X do que reverter.
- É importante se familiarizar com os procedimentos de reversão antes de tentar fazer o upgrade. Considerar as nuances da reversão durante o upgrade é fundamental para garantir que os caminhos de reversão adequados estejam disponíveis.
Data center único
O upgrade do Cassandra da versão 3.11.X para a 4.0.X em um único data center é simples, mas a reversão é complexa e pode resultar em inatividade e perda de dados. Para cargas de trabalho de produção, é altamente recomendável adicionar um novo data center com pelo menos nós do Cassandra disponíveis no novo data center antes de iniciar o upgrade. Isso vai permitir a reversão do Cassandra sem perda de dados ou interrupção do tráfego da API. Esse data center extra pode ser desativado quando o upgrade for concluído ou o Checkpoint 2 for alcançado.
Se não for possível adicionar um novo data center, mas a capacidade de reversão ainda for desejada, os backups serão necessários para restaurar o Cassandra 3.11.X. No entanto, esse método provavelmente envolve inatividade e perda de dados.
Vários data centers
Operar vários data centers com o Edge para nuvem privada 4.52.02 oferece mais flexibilidade para reversões durante o upgrade para o Edge para nuvem privada 4.53.00.
- As reversões dependem de pelo menos um data center que execute a versão mais antiga do Cassandra (3.11.X).
- Se todo o cluster do Cassandra for atualizado para a versão 4.0.X, não será possível reverter para a versão 3.11.X. Você precisa continuar usando a versão mais recente do Cassandra com os outros componentes do nuvem privada 4.53.00 ou 4.52.02.
Metodologia de upgrade recomendada
- Faça upgrade de um data center do Cassandra por vez: comece fazendo upgrade dos nós do Cassandra individualmente em um único data center. Conclua os upgrades de todos os nós do Cassandra em um data center antes de prosseguir para o próximo.
- Pausar e validar: depois de fazer upgrade de um data center, pause para garantir que o cluster da nuvem privada, especialmente o data center atualizado, esteja funcionando corretamente.
- Lembrete: só é possível reverter para a versão anterior do Cassandra se você tiver pelo menos um data center ainda executando a versão mais antiga.
- Sensível ao tempo: embora seja possível pausar por um curto período (recomendamos algumas horas) para validar a funcionalidade, não é possível permanecer em um estado de versão mista indefinidamente. Isso ocorre porque um cluster não uniforme do Cassandra (com nós em versões diferentes) tem limitações operacionais.
- Testes completos: a Apigee recomenda que você faça testes abrangentes de desempenho e funcionalidade antes de fazer upgrade do próximo data center. Depois que todos os data centers forem atualizados, não será possível reverter para a versão anterior.
Reversão como um processo de dois checkpoints
- Checkpoint 1: o estado inicial, com todos os componentes na versão 4.52.02. A reversão completa é possível desde que pelo menos um data center do Cassandra permaneça na versão mais antiga.
- Ponto de verificação 2: depois que todos os nós do Cassandra em todos os data centers forem atualizados. É possível reverter para esse estado, mas não para o Checkpoint 1.
Exemplo
Considere um cluster de dois data centers (DC):
- Estado inicial: os nós do Cassandra nos dois DCs estão na versão 3.11.X. Todos os outros nós estão no Edge para nuvem privada versão 4.52.02. Suponha que haja três nós do Cassandra por DC.
- Faça upgrade do DC-1: faça upgrade dos três nós do Cassandra no DC-1, um por um.
- Pausar e validar: pause para garantir que o cluster, principalmente o DC-1, esteja funcionando corretamente (verifique o desempenho e a funcionalidade). É possível reverter para o estado inicial usando os nós do Cassandra no DC-2. Lembre-se de que essa pausa precisa ser temporária devido às limitações de um cluster do Cassandra de versão mista.
- Fazer upgrade do DC-2: faça upgrade dos três nós restantes do Cassandra no DC-2. Esse será seu novo checkpoint de reversão.
- Faça upgrade de outros componentes: faça upgrade dos nós de gerenciamento, ambiente de execução e análise como de costume em todos os data centers, um nó e um data center por vez. Se houver problemas, será possível reverter para o estado da etapa 4.
Pré-requisitos para o upgrade do Cassandra
Você precisa executar o Cassandra 3.11.16 com o Edge para nuvem privada 4.52.02 e garantir o seguinte:- O cluster inteiro está operacional e totalmente funcional com o Cassandra 3.11.16.
- A estratégia de compactação está definida como
LeveledCompactionStrategy(um pré-requisito para o upgrade para a versão 4.52.02). - Verifique se todas as etapas abaixo foram concluídas como parte do upgrade inicial do Cassandra 3.11 no Edge para nuvem privada da versão 4.52.02:
- O comando
post_upgradedeveria ter sido executado em cada nó do Cassandra durante o upgrade anterior. - O comando
drop_old_tablesprecisa ter sido executado em todo o cluster do Cassandra durante o upgrade anterior.
- O comando
Se você não tiver certeza se as etapas anteriores foram concluídas, execute-as novamente. Verifique se essas etapas são executadas no Cassandra 3.11 enquanto você ainda está no Edge para nuvem privada 4.52.02, antes de tentar fazer upgrade para a versão 4.53.00:
- Execute o seguinte comando
post_upgradeem cada nó do Cassandra, um por um:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
- Execute o comando a seguir para remover tabelas antigas não utilizadas do cluster do Cassandra. Esse comando só deve ser executado em um nó do cluster:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
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.
- Faça backup do Cassandra usando a Apigee.
- Crie snapshots de VM dos nós do Cassandra (se possível).
- Verifique se a porta 9042 está acessível em todos os componentes do Edge para nuvem privada, incluindo o servidor de gerenciamento, o processador de mensagens, o roteador, o Qpid e o Postgres, para os nós do Cassandra, se ainda não estiver configurada. Consulte os requisitos de porta para mais informações.
Etapa 2: fazer upgrade de todos os nós do Cassandra
Todos os nós do Cassandra precisam ser atualizados um por um em cada data center, um data center por vez. Entre os upgrades de nós em um data center, aguarde alguns minutos para garantir que um nó atualizado tenha sido totalmente iniciado e ingressado no cluster antes de continuar com o upgrade de outro nó no mesmo data center.
Depois de fazer upgrade de todos os nós do Cassandra em um data center, aguarde um tempo (de 30 minutos a algumas horas) antes de prosseguir com os nós no próximo data center. Durante esse período, analise minuciosamente o data center que foi atualizado e verifique se as métricas de função e performance do cluster da Apigee estão intactas. Essa etapa é crucial para garantir a estabilidade do data center em que o Cassandra foi atualizado para a versão 4.0.X, enquanto o restante dos componentes da Apigee permanece na versão 4.52.02.
-
Para fazer upgrade de um nó do Cassandra, execute o seguinte comando:
/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:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
-
O resultado será algo como:
Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] Metadata is verified
-
Execute o seguinte comando
post_upgradeno nó do Cassandra:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
-
Execute os seguintes comandos nodetool para recriar índices no nó do Cassandra:
Se você estiver usando a monetização, execute também os seguintes comandos de recriação de índices relacionados aos keyspaces de monetização:/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx
Etapa 3: fazer upgrade de todos os nós de gerenciamento
Faça upgrade de todos os nós de gerenciamento em todas as regiões, um por um:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Etapa 4: fazer upgrade de todos os nós do ambiente de execução
Faça upgrade de todos os nós de roteadores e processadores de mensagens em todas as regiões, um por um:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Etapa 5: fazer upgrade de todos os componentes restantes do Edge para nuvem privada 4.53.00
Faça upgrade de todos os nós edge-qpid-server e edge-postgres-server restantes em todas as regiões, um por um.
Etapas para atualizar o SSO da Apigee de versões mais antigas
No Edge para nuvem privada 4.53.00, as chaves e os certificados do IDP usados no componente apigee-sso agora são configurados por um keystore. Você precisará exportar a chave e o certificado usados anteriormente para um keystore, configurá-lo e, em seguida, prosseguir com a atualização do SSO como de costume.
-
Identifique a chave e o certificado usados para configurar o IDP:
-
Recupere o certificado procurando o valor de SSO_SAML_SERVICE_PROVIDER_CERTIFICATE no arquivo de configuração da instalação do SSO ou consultando o componente
apigee-ssopara conf_login_service_provider_certificate.Use o comando a seguir no nó de SSO para consultar
apigee-ssosobre o caminho do certificado do IDP. Na saída, procure o valor na última linha.apigee-service apigee-sso configure -search conf_login_service_provider_certificate
-
Recupere a chave fazendo a pesquisa rápida do valor de SSO_SAML_SERVICE_PROVIDER_KEY no arquivo de configuração de instalação do SSO ou consultando o componente
apigee-ssopara conf_login_service_provider_key.Use o comando a seguir no nó de SSO para consultar
apigee-ssosobre o caminho da chave do IDP. Na saída, procure o valor na última linha.apigee-service apigee-sso configure -search conf_login_service_provider_key
-
-
Exporte a chave e o certificado para um keystore:
-
Exporte a chave e o certificado para um keystore PKCS12:
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
Parâmetros:
certificate_path: caminho para o arquivo de certificado recuperado na Etapa 1.a.key_path: caminho para o arquivo de chave privada recuperado na Etapa 1.b.keystore_path: caminho para o keystore recém-criado que contém o certificado e a chave privada.alias: alias usado para o par de chave e certificado no keystore.
Consulte a documentação do OpenSSL para mais detalhes.
-
(Opcional) Exporte a chave e o certificado do PKCS12 para um keystore JKS:
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
Parâmetros:
PKCS12_keystore_path: caminho para o keystore PKCS12 criado na Etapa 2.a, que contém o certificado e a chave.destination_keystore_path: caminho para o novo keystore JKS em que o certificado e a chave serão exportados.alias: alias usado para o par de chave e certificado no keystore JKS.
Consulte a documentação da keytool para mais detalhes.
-
Exporte a chave e o certificado para um keystore PKCS12:
- Mude o proprietário do arquivo de keystore de saída para o usuário "apigee":
sudo chown apigee:apigee <keystore_file>
-
Adicione as seguintes propriedades no arquivo de configuração de SSO da Apigee e atualize-as com o caminho do arquivo do keystore, a senha, o tipo de keystore e o alias:
# Path to the keystore file SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks # Keystore password SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123 # Password for accessing the keystore # Keystore type SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS # Type of keystore, e.g., JKS, PKCS12 # Alias within keystore that stores the key and certificate SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
-
Atualize o software de SSO da Apigee no nó de SSO como de costume usando o seguinte comando:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
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 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.53.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 a pessoa não tiver acesso a /tmp, o utilitário update.sh
vai falhar.
Atualização sem inatividade
Uma atualização sem inatividade, ou atualização gradual, permite 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 por vez, do balanceador de carga. Em seguida, atualize o roteador e todos os outros componentes na mesma máquina que o roteador e adicione o roteador de volta ao balanceador de carga.
- 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 usado para instalar o Edge para nuvem privada 4.52.02.
Atualizar para a versão 4.53.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 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.
- Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
- 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.52.02:
- Faça o download do arquivo
bootstrap_4.53.00.shdo Edge para/tmp/bootstrap_4.53.00.sh:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instale o utilitário
apigee-servicedo Edge 4.53.00 e as dependências executando o seguinte comando:sudo bash /tmp/bootstrap_4.53.00.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.52.02.
É 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.53.00.
Atualizar para 4.53.00 de um repositório local
Se os nós do Edge estiverem protegidos por um firewall ou, de alguma outra forma, proibidos de acessar o repositório da Apigee pela Internet, será possível realizar a atualização em um repositório local ou espelho do repositório da Apigee.
Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge no repositório local:
- Crie um arquivo .tar do repositório, copie o arquivo .tar para um nó e atualize o Edge usando o arquivo .tar.
- Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. 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.53.00:
- Crie um repositório local 4.53.00, 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.53.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
/tmpno novo nó. - No novo nó, descompacte o arquivo no diretório
/tmp:tar -xzf apigee-4.53.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 Edge
apigee-servicee as dependências de/tmp/repos:sudo bash /tmp/repos/bootstrap_4.53.00.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.53.00.shdo Edge para/tmp/bootstrap_4.53.00.sh:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.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.53.00.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.53.00.
Ordem de atualização da máquina
A ordem em que você atualiza as máquinas em uma instalação do Edge é importante:
- É necessário atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar qualquer outro nó.
- Para qualquer máquina com vários componentes do Edge (servidor de gerenciamento, processador de mensagens,
roteador, servidor QPID, mas não servidor Postgres), use a opção
-c edgepara atualizar todos ao mesmo tempo. - Se uma etapa especificar que deve ser realizada em várias máquinas, faça isso na ordem especificada.
- Não há uma etapa separada para atualizar a Monetização. Ele é atualizado quando você especifica a
opção
-c edge.
Upgrade separado de 1 nó
Para fazer upgrade de uma configuração independente de um nó para a versão 4.53.00:
- Atualize todos os componentes:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Se você instalou o
apigee-adminapi) Atualize 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 Cassandra e o ZooKeeper na máquina 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,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 os componentes do Edge nas máquinas 2 e 1:
/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 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 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 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 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 em 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 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 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, 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 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 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, 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 em 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 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 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
- Atualizar 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 o qpidd:
- Máquinas 4 e 5 no data center 1
- Atualize
qpiddna máquina 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize
qpiddna máquina 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize
- Máquinas 10 e 11 no Data Center 2
- Atualize
qpiddna máquina 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize o
qpiddna máquina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Atualize
- Máquinas 4 e 5 no data center 1
- Atualize a nova interface (
ue) ou a interface 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) Atualizamos o utilitárioapigee-adminapi:- 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 que você criou quando instalou o SSO.
- Máquina 1 no data center 1:
- Reinicie o componente da nova interface do Edge (
edge-management-ui) ou 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
- ps
- LDAP
- Edge, ou seja, o perfil "-c edge" em todos os nós na ordem: nós com servidor Qpid, servidor Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
- qpidd
- 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.