Apigee supporta l'upgrade di Edge for Private Cloud direttamente dalla versione 4.52.02 alla versione 4.53.00. Questa pagina descrive come eseguire questi upgrade.
Per una panoramica dei percorsi di upgrade compatibili, consulta la matrice di compatibilità degli upgrade per le release di Edge for Private Cloud.
Chi può eseguire l'aggiornamento
La persona che esegue l'aggiornamento deve essere la stessa che ha installato originariamente Edge o una persona che esegue l'accesso come root.
Dopo aver installato gli RPM di Edge, chiunque può configurarli.
Quali componenti devi aggiornare
Devi aggiornare tutti i componenti di Edge. Edge non supporta una configurazione che contiene componenti di più versioni.
Aggiorna i prerequisiti
Prima di eseguire l'upgrade di Apigee Edge, assicurati che siano soddisfatti i seguenti prerequisiti:
- Esegui il backup di tutti i nodi
Prima di eseguire l'aggiornamento, ti consigliamo di eseguire un backup completo di tutti i nodi per motivi di sicurezza. Per eseguire il backup, utilizza la procedura per la tua versione attuale di Edge.In questo modo, avrai un piano di backup nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, vedi Backup e ripristino.
- Assicurati che Edge sia in esecuzione
Assicurati che Edge sia in esecuzione durante il processo di aggiornamento utilizzando il comando:/opt/apigee/apigee-service/bin/apigee-all status
- Verifica i prerequisiti di Cassandra
Se in precedenza hai eseguito l'upgrade da una versione precedente di Edge for Private Cloud alla versione 4.52.02 e ora prevedi di eseguire l'upgrade alla versione 4.53.00, assicurati di aver completato i passaggi post-upgrade richiesti per Cassandra. Questi passaggi sono descritti nella documentazione di upgrade alla versione 4.52.02 e sono menzionati anche nella sezione Prerequisiti per l'upgrade di Cassandra. Se non hai la certezza che questi passaggi siano stati completati durante l'upgrade precedente, completali di nuovo prima di procedere con l'upgrade alla versione 4.53.00.
- Configurazione di chiavi e certificati IDP in Edge for Private Cloud 4.53.00
In Edge for Private Cloud 4.53.00, le chiavi e i certificati IDP utilizzati nel componente
apigee-sso
vengono ora configurati tramite un keystore. Dovrai esportare la chiave e il certificato che hai utilizzato in precedenza in un keystore. Segui i passaggi descritti nella sezione Passaggi per l'aggiornamento di Apigee SSO dalle versioni precedenti per i passaggi dettagliati prima di aggiornare il componente SSO. - Requisiti di Python
Assicurati che su tutti i nodi, inclusi quelli Cassandra, sia installato Python 3 prima di tentare l'upgrade.
Propagazione automatica delle impostazioni della proprietà
Se hai impostato delle proprietà modificando i file .properties
in /opt/apigee/customer/application
, questi valori vengono conservati dall'aggiornamento.
Upgrade di Nginx 1.26 in Edge-Router
L'upgrade a Edge for Private Cloud 4.53.00 dalle versioni precedenti non esegue automaticamente l'upgrade del software Nginx all'ultima versione (1.26.x). Questo per evitare effetti collaterali di runtime accidentali a seguito delle modifiche documentate in Modifiche di Nginx 1.26 in Apigee Edge 4.53.00. Puoi eseguire manualmente l'upgrade di Nginx dalla versione 1.20.x alla 1.26.x dopo la verifica negli ambienti di livello inferiore. Per eseguire l'upgrade manualmente:
Assicurati che sul nodo edge-router sia installato il software 4.53.00 più recente
/opt/apigee/apigee-service/bin/apigee-service edge-router version
Controllare e verificare la versione di Nginx attualmente in esecuzione
/opt/nginx/sbin/nginx -V
Se utilizzi una versione precedente di Nginx, puoi seguire i passaggi riportati di seguito per eseguire l'upgrade di Nginx alla versione 1.26.X sul nodo del router.
Arresta il processo del router edge sul nodo del router
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
Esegui l'upgrade del software nginx sul nodo del router
dnf update apigee-nginx
Verifica che la versione di Nginx sia stata aggiornata
/opt/nginx/sbin/nginx -V
Avviare il processo del router sul nodo
/opt/apigee/apigee-service/bin/apigee-service edge-router start
Ripeti la procedura su ogni nodo del router, uno alla volta.
Aggiornamento obbligatorio a Cassandra 4.0.13
Apigee Edge for Private Cloud 4.53.00 include un upgrade di Cassandra alla versione 4.0.13.
Upgrade e rollback
- L'upgrade da Cassandra 3.11.X a Cassandra 4.0.X è un processo semplice. Cassandra 4.0.X, rilasciato con Edge for Private Cloud 4.53.00, è compatibile con i componenti di runtime e di gestione di Private Cloud 4.52.02.
- Il rollback diretto in loco da Cassandra 4.0.X a 3.11.X non è possibile. Il rollback utilizzando le repliche o i backup è una procedura complessa e potrebbe comportare tempi di inattività e/o perdita di dati. La risoluzione dei problemi e l'upgrade a Cassandra 4.0.X sono preferibili al rollback.
- È importante acquisire familiarità con le procedure di rollback prima di tentare l'upgrade. Considerare le sfumature del rollback durante l'upgrade è fondamentale per garantire la disponibilità di percorsi di rollback appropriati.
Singolo data center
L'upgrade di Cassandra dalla versione 3.11.X alla 4.0.X all'interno di un singolo data center è semplice, ma il rollback è complesso e potrebbe comportare tempi di inattività e perdita di dati. Per i carichi di lavoro di produzione, è consigliabile aggiungere un nuovo data center con almeno nodi Cassandra disponibili nel nuovo data center prima di avviare l'upgrade. In questo modo, potrai eseguire il rollback di Cassandra senza incorrere in perdite di dati o interruzioni del traffico API. Questo data center aggiuntivo può essere ritirato una volta terminato l'upgrade o raggiunto il punto di controllo 2.
Se l'aggiunta di un nuovo data center non è fattibile, ma è comunque necessaria la funzionalità di rollback, i backup saranno necessari per il ripristino di Cassandra 3.11.X. Tuttavia, questo metodo comporta probabilmente tempi di inattività e perdita di dati.
Più data center
L'utilizzo di più data center con Edge per il cloud privato 4.52.02 offre maggiore flessibilità per i rollback durante l'upgrade a Edge per il cloud privato 4.53.00.
- I rollback dipendono dalla presenza di almeno un data center che esegue la versione precedente di Cassandra (3.11.X).
- Se l'intero cluster Cassandra viene aggiornato alla versione 4.0.X, non devi eseguire il rollback alla versione 3.11.X di Cassandra. Devi continuare a utilizzare la versione più recente di Cassandra con gli altri componenti di Private Cloud 4.53.00 o 4.52.02.
Metodologia di upgrade consigliata
- Esegui l'upgrade di un data center Cassandra alla volta:inizia eseguendo l'upgrade dei nodi Cassandra singolarmente all'interno di un singolo data center. Completa gli upgrade di tutti i nodi Cassandra in un data center prima di procedere con il successivo.
- Metti in pausa e convalida:dopo l'upgrade di un data center, metti in pausa per assicurarti che il cluster Private Cloud, in particolare il data center di cui è stato eseguito l'upgrade, funzioni correttamente.
- Ricorda:puoi eseguire il rollback alla versione precedente di Cassandra solo se almeno un data center esegue ancora la versione precedente.
- Sensibile al tempo:anche se puoi mettere in pausa per un breve periodo (consigliamo qualche ora) per convalidare la funzionalità, non puoi rimanere in uno stato di versione mista a tempo indeterminato. Ciò è dovuto al fatto che un cluster Cassandra non uniforme (con nodi su versioni diverse) presenta limitazioni operative.
- Test approfonditi:Apigee consiglia vivamente di eseguire test completi di prestazioni e funzionalità prima di eseguire l'upgrade del data center successivo. Una volta eseguito l'upgrade di tutti i data center, il rollback alla versione precedente è impossibile.
Rollback come procedura a due checkpoint
- Checkpoint 1:lo stato iniziale, con tutti i componenti alla versione 4.52.02. Il rollback completo è possibile finché almeno un data center Cassandra rimane nella versione precedente.
- Checkpoint 2: dopo l'aggiornamento di tutti i nodi Cassandra in tutti i data center. Puoi eseguire il rollback a questo stato, ma non puoi ripristinare il checkpoint 1.
Esempio
Considera un cluster a due data center:
- Stato iniziale:i nodi Cassandra in entrambi i DC sono alla versione 3.11.X. Tutti gli altri nodi utilizzano Edge for Private Cloud versione 4.52.02. Supponi tre nodi Cassandra per DC.
- Upgrade DC-1: esegui l'upgrade dei tre nodi Cassandra in DC-1 uno alla volta.
- Metti in pausa e convalida:metti in pausa per assicurarti che il cluster, in particolare DC-1, funzioni correttamente (controlla prestazioni e funzionalità). Puoi eseguire il rollback allo stato iniziale utilizzando i nodi Cassandra in DC-2. Ricorda che questa pausa deve essere temporanea a causa delle limitazioni di un cluster Cassandra con versioni miste.
- Upgrade DC-2: esegui l'upgrade dei tre nodi Cassandra rimanenti in DC-2. Questo diventa il nuovo checkpoint di rollback.
- Esegui l'upgrade di altri componenti:esegui l'upgrade dei nodi di gestione, runtime e analisi come di consueto in tutti i data center, un nodo e un data center alla volta. Se si verificano problemi, puoi eseguire il rollback allo stato del passaggio 4.
Prerequisiti per l'upgrade di Cassandra
Devi eseguire Cassandra 3.11.16 con Edge per Private Cloud 4.52.02 e assicurarti che:- L'intero cluster è operativo e completamente funzionante con Cassandra 3.11.16.
- La strategia di compattazione è impostata su
LeveledCompactionStrategy
(un prerequisito per l'upgrade alla versione 4.52.02). - Assicurati che tutti i passaggi riportati di seguito siano stati completati nell'ambito dell'upgrade iniziale di Cassandra 3.11 in Edge per Private Cloud 4.52.02:
- Il comando
post_upgrade
deve essere stato eseguito su ogni nodo Cassandra durante l'upgrade precedente. - Il comando
drop_old_tables
deve essere stato eseguito sull'intero cluster Cassandra durante l'upgrade precedente.
- Il comando
Se non hai la certezza che i passaggi precedenti siano stati completati, puoi eseguirli di nuovo in tutta sicurezza. Assicurati che questi passaggi vengano eseguiti su Cassandra 3.11 mentre utilizzi ancora Edge per Private Cloud 4.52.02, prima di tentare l'upgrade alla versione 4.53.00:
- Esegui questo comando
post_upgrade
su ogni nodo Cassandra uno alla volta:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
- Esegui questo comando per eliminare le tabelle inutilizzate precedenti dal cluster Cassandra. Questo comando deve essere eseguito solo su un nodo del cluster:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
Passaggio 1: preparati all'upgrade
I passaggi riportati di seguito si aggiungono ai file standard che in genere crei, ad esempio il file di configurazione standard di Apigee per l'attivazione degli upgrade dei componenti.
- Esegui il backup di Cassandra utilizzando Apigee.
- Acquisisci snapshot VM dei nodi Cassandra (se fattibile).
- Assicurati che la porta 9042 sia accessibile da tutti i componenti di Edge per il cloud privato, inclusi Management Server, Message Processor, Router, Qpid e Postgres, ai nodi Cassandra, se non è già configurata. Per ulteriori informazioni, consulta i requisiti relativi alle porte.
Passaggio 2: esegui l'upgrade di tutti i nodi Cassandra
Tutti i nodi Cassandra devono essere aggiornati uno alla volta in ogni data center, un data center alla volta. Tra gli upgrade dei nodi all'interno di un data center, attendi alcuni minuti per assicurarti che un nodo aggiornato sia stato avviato completamente e si sia unito al cluster prima di procedere con l'upgrade di un altro nodo nello stesso data center.
Dopo aver eseguito l'upgrade di tutti i nodi Cassandra all'interno di un data center, attendi un po' di tempo (da 30 minuti a qualche ora) prima di procedere con i nodi nel data center successivo. Durante questo periodo, esamina attentamente il data center aggiornato e assicurati che le metriche funzionali e di rendimento del cluster Apigee siano intatte. Questo passaggio è fondamentale per garantire la stabilità del data center in cui Cassandra è stato aggiornato alla versione 4.0.X, mentre il resto dei componenti Apigee rimane alla versione 4.52.02.
-
Per eseguire l'upgrade di un nodo Cassandra, esegui questo comando:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
Una volta aggiornato un nodo, esegui questo comando sul nodo per eseguire alcune convalide prima di procedere:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
-
L'output sarà simile a questo:
Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] Metadata is verified
-
Esegui questo comando
post_upgrade
sul nodo Cassandra:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
-
Esegui i seguenti comandi nodetool per ricostruire gli indici sul nodo Cassandra:
Se utilizzi la monetizzazione, esegui anche i seguenti comandi di ricompilazione degli indici relativi agli spazi delle chiavi di monetizzazione:/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
Passaggio 3: esegui l'upgrade di tutti i nodi di gestione
Esegui l'upgrade di tutti i nodi di gestione in tutte le regioni uno alla volta:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Passaggio 4: esegui l'upgrade di tutti i nodi Runtime
Esegui l'upgrade di tutti i nodi Router e Message Processor in tutte le regioni uno alla volta:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Passaggio 5: esegui l'upgrade di tutti i componenti Edge for Private Cloud 4.53.00 rimanenti
Esegui l'upgrade di tutti i nodi edge-qpid-server
e edge-postgres-server
rimanenti in tutte le regioni uno alla volta.
Passaggi per aggiornare Apigee SSO dalle versioni precedenti
In Edge for Private Cloud 4.53.00, le chiavi e i certificati IDP utilizzati nel componente apigee-sso
vengono ora configurati tramite un keystore. Dovrai esportare la chiave e il certificato utilizzati in precedenza in un keystore, configurarlo e poi procedere con l'aggiornamento SSO come di consueto.
-
Identifica la chiave e il certificato esistenti utilizzati per configurare l'IdP:
-
Recupera il certificato cercando il valore di SSO_SAML_SERVICE_PROVIDER_CERTIFICATE nel file di configurazione dell'installazione SSO o eseguendo una query sul componente
apigee-sso
per conf_login_service_provider_certificate.Utilizza il seguente comando sul nodo SSO per eseguire query su
apigee-sso
per il percorso del certificato IDP. Nell'output, cerca il valore nell'ultima riga.apigee-service apigee-sso configure -search conf_login_service_provider_certificate
-
Recupera la chiave cercando il valore di SSO_SAML_SERVICE_PROVIDER_KEY nel file di configurazione dell'installazione SSO o eseguendo una query sul componente
apigee-sso
per conf_login_service_provider_key.Utilizza il seguente comando sul nodo SSO per eseguire query su
apigee-sso
per il percorso della chiave IDP. Nell'output, cerca il valore nell'ultima riga.apigee-service apigee-sso configure -search conf_login_service_provider_key
-
-
Esporta la chiave e il certificato in un keystore:
-
Esporta la chiave e il certificato in un keystore PKCS12:
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
Parametri:
certificate_path
: il percorso del file del certificato recuperato nel passaggio 1.a.key_path
: percorso del file della chiave privata recuperato nel passaggio 1.b.keystore_path
: il percorso del keystore appena creato contenente il certificato e la chiave privata.alias
: Alias utilizzato per la coppia di chiave e certificato all'interno dell'archivio chiavi.
Per ulteriori dettagli, consulta la documentazione di OpenSSL.
-
(Facoltativo) Esporta la chiave e il certificato da PKCS12 a un keystore JKS:
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
Parametri:
PKCS12_keystore_path
: percorso del keystore PKCS12 creato nel passaggio 2.a, contenente il certificato e la chiave.destination_keystore_path
: percorso del nuovo keystore JKS in cui verranno esportati il certificato e la chiave.alias
: alias utilizzato per la coppia di chiave e certificato all'interno dell'archivio chiavi JKS.
Per ulteriori dettagli, consulta la documentazione di keytool.
-
Esporta la chiave e il certificato in un keystore PKCS12:
- Cambia il proprietario del file keystore di output in "apigee":
sudo chown apigee:apigee <keystore_file>
-
Aggiungi le seguenti proprietà nel file di configurazione di Apigee SSO e aggiornale con il percorso del file keystore, la password, il tipo di keystore e l'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
-
Aggiorna il software Apigee SSO sul nodo SSO come di consueto utilizzando il seguente comando:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
Nuova UI di Edge
Questa sezione elenca le considerazioni relative all'interfaccia utente perimetrale. Per maggiori informazioni, consulta La nuova UI Edge per Private Cloud.
Installare l'interfaccia utente Edge
Dopo aver completato l'installazione iniziale, Apigee consiglia di installare l'interfaccia utente Edge, che è un'interfaccia utente avanzata per sviluppatori e amministratori di Apigee Edge for Private Cloud.
Tieni presente che la UI di Edge richiede la disattivazione dell'autenticazione di base e l'utilizzo di un IDP come SAML o LDAP.
Per saperne di più, consulta Installare la nuova UI Edge.
Aggiornamento con Apigee mTLS
Per aggiornare Apigee mTLS , segui questi passaggi:
Eseguire il rollback di un aggiornamento
In caso di errore di aggiornamento, puoi provare a correggere il problema ed eseguire
di nuovo update.sh
. Puoi eseguire l'aggiornamento più volte e questo continua da dove era stato interrotto.
Se l'errore richiede di eseguire il rollback dell'aggiornamento alla versione precedente, consulta Eseguire il rollback della versione 4.53.00 per istruzioni dettagliate.
Informazioni sull'aggiornamento del logging
Per impostazione predefinita, l'utilità update.sh
scrive le informazioni di log in:
/opt/apigee/var/log/apigee-setup/update.log
Se la persona che esegue l'utilità update.sh
non ha accesso a
questa directory, scrive il log nella directory /tmp
come file denominato
update_username.log
.
Se la persona non ha accesso a /tmp
, l'utilità update.sh
non funziona.
Aggiornamento senza tempi di inattività
Un aggiornamento senza tempi di inattività, o aggiornamento in sequenza, ti consente di aggiornare l'installazione di Edge senza interrompere il funzionamento di Edge.
L'aggiornamento senza tempi di inattività è possibile solo con una configurazione a 5 nodi o più.
La chiave per l'upgrade senza tempi di inattività è rimuovere ogni router, uno alla volta, dal bilanciatore del carico. Quindi aggiorna il router e gli altri componenti sulla stessa macchina del router e poi aggiungi di nuovo il router al bilanciatore del carico.
- Aggiorna le macchine nell'ordine corretto per l'installazione, come descritto in Ordine di aggiornamento delle macchine.
- Quando è il momento di aggiornare i router, seleziona un router qualsiasi e rendilo irraggiungibile, come descritto in Attivazione/Disattivazione dell'accessibilità del server (Message Processor/Router).
- Aggiorna il router selezionato e tutti gli altri componenti Edge sulla stessa macchina del router. Tutte le configurazioni Edge mostrano un router e un processore di messaggi sullo stesso nodo.
- Rendi di nuovo raggiungibile il router.
- Ripeti i passaggi da 2 a 4 per i router rimanenti.
- Continua l'aggiornamento per le macchine rimanenti nell'installazione.
Prima e dopo l'aggiornamento, occupati di quanto segue:
- Sul nodo combinato Router e Message Processor:
- Prima dell'aggiornamento, esegui le seguenti operazioni:
- Rendi irraggiungibile il router.
- Rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, esegui le seguenti operazioni:
- Rendi raggiungibile il processore di messaggi.
- Rendi raggiungibile il router.
- Prima dell'aggiornamento, esegui le seguenti operazioni:
- Sui singoli nodi del router:
- Prima dell'aggiornamento, rendi il router irraggiungibile.
- Dopo l'aggiornamento, rendi raggiungibile il router.
- Sui singoli nodi Message Processor:
- Prima dell'aggiornamento, rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.
Utilizzare un file di configurazione invisibile
Devi trasmettere un file di configurazione non interattivo al comando di aggiornamento. Il file di configurazione silenziosa deve essere lo stesso che hai utilizzato per installare Edge for Private Cloud 4.52.02.
Aggiornamento alla versione 4.53.00 su un nodo con una connessione a internet esterna
Per aggiornare i componenti Edge su un nodo, segui questa procedura:
- Se presenti, disattiva tutti i job
cron
configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento. - Accedi al nodo come root per installare gli RPM Edge.
- Disattiva SELinux come descritto in Installare l'utilità apigee-setup di Edge.
- Se esegui l'installazione su AWS, esegui i seguenti
comandi
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 attualmente utilizzi Edge 4.52.02:
- Scarica il file
bootstrap_4.53.00.sh
di Edge in/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Installa l'utilità
apigee-service
Edge 4.53.00 e le dipendenze eseguendo il seguente comando:sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
dove uName:pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.
Per impostazione predefinita, il programma di installazione verifica che sia installato Java 1.8. In caso contrario, il programma di installazione lo installa per te.
Utilizza l'opzione
JAVA_FIX
per specificare come gestire l'installazione di Java.JAVA_FIX
accetta i seguenti valori:I
: installa OpenJDK 1.8 (impostazione predefinita).C
: continua senza installare Java.Q
: Esci. Per questa opzione, devi installare Java autonomamente.
- Utilizza
apigee-service
per aggiornare l'utilitàapigee-setup
, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Aggiorna l'utilità
apigee-validate
sul server di gestione, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Aggiorna l'utilità
apigee-provision
sul server di gestione, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Esegui l'utilità
update
sui nodi eseguendo questo comando:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Esegui questa operazione nell'ordine descritto in Ordine di aggiornamento della macchina.
Dove:
- component è il componente Edge da aggiornare. I valori possibili includono:
cs
: Cassandraedge
: Tutti i componenti Edge, tranne la UI Edge: Management Server, Message Processor, Router, QPID Server, Postgres Serverldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO (se hai installato SSO)ue
: nuova UI di Edgeui
: UI di Edge classicazk
: Zookeeper
- configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione della versione 4.52.02.
Puoi eseguire
update.sh
su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione all-in-one (AIO) di Edge. Ad esempio:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component è il componente Edge da aggiornare. I valori possibili includono:
- Riavvia i componenti dell'interfaccia utente Edge su tutti i nodi che li eseguono, se non l'hai già fatto:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Testa l'aggiornamento eseguendo l'utilità
apigee-validate
sul server di gestione, come descritto in Testa l'installazione.
- Scarica il file
Se in seguito decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback della versione 4.53.00.
Aggiornamento alla versione 4.53.00 da un repository locale
Se i nodi Edge si trovano dietro un firewall o è loro vietato in altro modo l'accesso al repository Apigee su internet, puoi eseguire l'aggiornamento da un repository locale o da un mirror del repository Apigee.
Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:
- Crea un file .tar del repository, copialo in un nodo e poi aggiorna Edge dal file .tar.
- Installa un server web sul nodo con il repository locale in modo che gli altri nodi possano accedervi. Apigee fornisce il server web Nginx da utilizzare oppure puoi utilizzare il tuo server web.
Per eseguire l'aggiornamento da un repository locale 4.53.00:
- Crea un repository locale 4.53.00 come descritto in "Crea un repository Apigee locale" in Installa l'utilità apigee-setup di Edge.
- Per installare apigee-service da un file .tar:
- Sul nodo con il repository locale, utilizza il seguente comando per creare il pacchetto del repository locale
in un unico file .tar denominato
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella
directory
/tmp
sul nuovo nodo. - Sul nuovo nodo, decomprimi il file nella directory
/tmp
:tar -xzf apigee-4.53.00.tar.gz
Questo comando crea una nuova directory denominata
repos
nella directory contenente il file .tar. Ad esempio/tmp/repos
. - Installa l'utilità e le dipendenze Edge
apigee-service
da/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Tieni presente che in questo comando includi il percorso della directory dei repository.
- Sul nodo con il repository locale, utilizza il seguente comando per creare il pacchetto del repository locale
in un unico file .tar denominato
- Per installare apigee-service utilizzando il server web Nginx:
- Configura il server web Nginx come descritto in "Installazione dal repository utilizzando il server web Nginx" in Installare l'utilità apigee-setup di Edge.
- Sul nodo remoto, scarica il file Edge
bootstrap_4.53.00.sh
in/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
dove uName:pWord sono il nome utente e la password impostati in precedenza per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.
- Sul nodo remoto, installa l'utilità e le dipendenze Edge
apigee-setup
:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
dove uName:pWord sono il nome utente e la password del repository.
- Utilizza
apigee-service
per aggiornare l'utilitàapigee-setup
, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Aggiorna l'utilità
apigee-validate
sul server di gestione, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Aggiorna l'utilità
apigee-provision
sul server di gestione, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Esegui l'utilità
update
sui nodi nell'ordine descritto in Ordine di aggiornamento della macchina:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Dove:
- component è il componente Edge da aggiornare. In genere, aggiorni i
seguenti componenti:
cs
: Cassandraedge
: Tutti i componenti Edge, tranne la UI Edge: Management Server, Message Processor, Router, QPID Server, Postgres Serverldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO (se hai installato SSO)ue
Nuova UI di Edgeui
: UI di Edge classicazk
: Zookeeper
- configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione della versione 4.50.00 o 4.51.00.
Puoi eseguire
update.sh
su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione all-in-one (AIO) di Edge. Ad esempio:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component è il componente Edge da aggiornare. In genere, aggiorni i
seguenti componenti:
- Se non l'hai ancora fatto, riavvia i componenti UI su tutti i nodi che li eseguono:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Testa l'aggiornamento eseguendo l'utilità
apigee-validate
sul server di gestione, come descritto in Testare l'installazione.
Se in seguito decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback della versione 4.53.00.
Ordine di aggiornamento della macchina
L'ordine in cui aggiorni le macchine in un'installazione Edge è importante:
- Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
- Per qualsiasi macchina con più componenti Edge (Management Server, Message Processor,
Router, QPID Server ma non Postgres Server), utilizza l'opzione
-c edge
per aggiornarli contemporaneamente. - Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nell'ordine specificato.
- Non esiste un passaggio separato per aggiornare la monetizzazione. Viene aggiornato quando specifichi l'opzione
-c edge
.
Upgrade autonomo a 1 nodo
Per eseguire l'upgrade di una configurazione standalone a 1 nodo alla versione 4.53.00:
- Aggiorna tutti i componenti:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Se hai installato
apigee-adminapi
) Aggiorna l'utilitàapigee-adminapi
:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Upgrade autonomo a 2 nodi
Aggiorna i seguenti componenti per un'installazione autonoma a 2 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri di nodi.
- Aggiorna Cassandra e ZooKeeper sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Postgres sulla macchina 2:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna LDAP sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulla macchina 2 e 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna Qpid sulla macchina 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna la UI sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Se hai installato
apigee-adminapi
) Aggiornamento dell'utilitàapigee-adminapi
sulla macchina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente Edge UI sul computer 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade di 5 nodi
Aggiorna i seguenti componenti per un'installazione a 5 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri di nodi.
- Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Postgres sulla macchina 4:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna Postgres sulla macchina 5:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna LDAP sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulle macchine 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna Qpid sulla macchina 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna Qpid sulla macchina 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna l'interfaccia utente di Edge:
- UI classica:se utilizzi la UI classica, aggiorna il componente
ui
sulla macchina 1, come mostrato nell'esempio seguente:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Nuova UI Edge: se hai installato la nuova UI Edge, aggiorna il componente
ue
sulla macchina appropriata (potrebbe non essere la macchina 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- UI classica:se utilizzi la UI classica, aggiorna il componente
- (Se hai installato
apigee-adminapi
) Aggiornamento dell'utilitàapigee-adminapi
sulla macchina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente UI:
- Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente
edge-ui
sul computer 1, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nuova UI Edge: se hai installato la nuova UI Edge, riavvia il componente
edge-management-ui
sulla macchina appropriata (potrebbe non essere la macchina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente
Upgrade cluster a 9 nodi
Aggiorna i seguenti componenti per un'installazione in cluster a 9 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri di nodi.
- Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Postgres sulla macchina 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna Postgres sulla macchina 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna LDAP sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulle macchine 6, 7, 8, 9, 1, 4 e 5 in questo ordine:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna Qpid sulle macchine 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna la nuova UI (
ue
) o la UI classica (ui
) sulla macchina 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se hai installato
apigee-adminapi
) Aggiorna l'utilitàapigee-adminapi
sul computer 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente UI:
- Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente
edge-ui
sul computer 1, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nuova UI Edge: se hai installato la nuova UI Edge, riavvia il componente
edge-management-ui
sulla macchina appropriata (potrebbe non essere la macchina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente
Upgrade cluster a 13 nodi
Aggiorna i seguenti componenti per un'installazione in cluster a 13 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri di nodi.
- Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Postgres sulla macchina 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna Postgres sulla macchina 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna LDAP sulle macchine 4 e 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulle macchine 12, 13, 8, 9, 6, 7, 10 e 11 in questo ordine:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna Qpid sulle macchine 12 e 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna la nuova UI (
ue
) o la UI classica (ui
) sulle macchine 6 e 7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se hai installato
apigee-adminapi
) È stato aggiornato l'utilitàapigee-adminapi
sui computer 6 e 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulle macchine 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente UI:
- Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente
edge-ui
sulle macchine 6 e 7, come mostrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nuova UI di Edge: se hai installato la nuova UI di Edge, riavvia il componente
edge-management-ui
sui computer 6 e 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente
Upgrade cluster a 12 nodi
Aggiorna i seguenti componenti per un'installazione in cluster a 12 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri di nodi.
- Aggiorna Cassandra e ZooKeeper:
- Sulle macchine 1, 2 e 3 nel data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Sulle macchine 7, 8 e 9 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Sulle macchine 1, 2 e 3 nel data center 1:
- Aggiorna Postgres:
- Macchina 6 nel data center 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Macchina 12 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Macchina 6 nel data center 1
- Aggiorna LDAP:
- Macchina 1 nel data center 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Macchina 7 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Macchina 1 nel data center 1
- Aggiorna i componenti di Edge:
- Macchine 4, 5, 6, 1, 2, 3 nel data center 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Macchine 10, 11, 12, 7, 8, 9 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Macchine 4, 5, 6, 1, 2, 3 nel data center 1
- Aggiorna qpidd:
- Macchine 4 e 5 nel data center 1
- Aggiornamento di
qpidd
sulla macchina 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiornamento di
qpidd
sulla macchina 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiornamento di
- Macchine 10, 11 nel data center 2
- Aggiornamento
qpidd
sulla macchina 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiornamento di
qpidd
sulla macchina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiornamento
- Macchine 4 e 5 nel data center 1
- Aggiorna la nuova UI (
ue
) o la UI classica (ui
):- Macchina 1 nel data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Macchina 7 nel data center 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Macchina 1 nel data center 1:
- (Se hai installato
apigee-adminapi
) È stato aggiornato l'utilitàapigee-adminapi
:- Macchina 1 nel data center 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Macchina 7 nel data center 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Macchina 1 nel data center 1:
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO:
- Macchina 1 nel data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Macchina 7 nel data center 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Macchina 1 nel data center 1:
- Riavvia il nuovo componente dell'interfaccia utente di Edge (
edge-management-ui
) o dell'interfaccia utente classica di Edge (edge-ui
) sulle macchine 1 e 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
Per una configurazione non standard
Se hai una configurazione non standard, aggiorna i componenti Edge nel seguente ordine:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge, ovvero il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, Edge Postgres Server, Management Server, Message Processor e Router.
- qpidd
- UI Edge (classica o nuova)
apigee-adminapi
- SSO Apigee
Al termine dell'aggiornamento, assicurati di riavviare il componente Edge UI su tutte le macchine che lo eseguono.