Aggiornare Apigee Edge 4.52.02 alla versione 4.53.00
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.
La persona che esegue l'aggiornamento deve essere la stessa che ha installato Edge inizialmente o una persona che esegue l'aggiornamento come utente 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, verifica i seguenti prerequisiti:
Esegui il backup di tutti i nodi
Per motivi di sicurezza, ti consigliamo di eseguire un backup completo di tutti i nodi prima di eseguire l'aggiornamento. Utilizza la procedura per la versione corrente di Edge per eseguire il backup.
In questo modo avrai un piano di riserva nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, consulta 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 relativa all'upgrade alla versione 4.52.02 nella sezione Passaggi successivi all'upgrade. Se non sai con certezza se questi passaggi sono stati completati durante l'upgrade precedente, completali di nuovo prima di procedere con l'upgrade alla versione 4.53.00.
Requisiti di Python
Prima di tentare l'upgrade, assicurati che su tutti i nodi, inclusi i nodi Cassandra, sia installato Python 3.
Propagazione automatica delle impostazioni della proprietà
Se hai impostato proprietà modificando i file .properties in /opt/apigee/customer/application, questi valori vengono mantenuti dall'aggiornamento.
Upgrade 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, rilasciata con Edge for Private Cloud 4.53.00, è compatibile con i componenti di runtime e gestione di Private Cloud 4.52.02.
Non è possibile eseguire il rollback diretto in situ da Cassandra 4.0.X a 3.11.X. Il rollback utilizzando repliche o backup è una procedura complessa e potrebbe comportare tempi di riposo e/o perdita di dati. È preferibile risolvere i problemi e eseguire l'upgrade a Cassandra 4.0.X rispetto al rollback.
È importante acquisire familiarità con le procedure di rollback prima di tentare l'upgrade. È fondamentale considerare le sfumature del rollback durante l'upgrade per assicurarsi che siano disponibili percorsi di rollback appropriati.
Data center singolo
L'upgrade di Cassandra da 3.11.X a 4.0.X all'interno di un singolo data center è semplice, ma il rollback è complesso e potrebbe comportare tempi di riposo e perdita di dati. Per i carichi di lavoro di produzione, ti consigliamo vivamente di 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 dell'API. Questo data center aggiuntivo può essere dismesso al termine dell'upgrade o al raggiungimento del Checkpoint 2.
Se l'aggiunta di un nuovo data center non è fattibile, ma è comunque richiesta la funzionalità di rollback, saranno necessari i backup per ripristinare Cassandra 3.11.X. Tuttavia, questo metodo è probabile che comporti sia tempi di riposo sia perdita di dati.
Più data center
L'utilizzo di più data center con Edge for Private Cloud 4.52.02 offre una maggiore flessibilità per i rollback durante l'upgrade a Edge for Private Cloud 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 sottoposto ad upgrade alla versione 4.0.X, non devi eseguire il rollback a Cassandra 3.11.X. 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 aggiornando i nodi Cassandra singolarmente all'interno di un singolo data center. Completa gli upgrade di tutti i nodi Cassandra in un data center prima di passare al 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 sottoposto ad upgrade, funzioni correttamente.
Ricorda: puoi eseguire il rollback alla versione Cassandra precedente solo se hai almeno un data center che esegue ancora la versione precedente.
Contenuti urgenti: anche se puoi mettere in pausa per un breve periodo (si consigliano alcune ore) per convalidare la funzionalità, non puoi rimanere in uno stato di versione mista a tempo indeterminato. Questo perché un cluster Cassandra non uniforme (con nodi su versioni diverse) presenta limitazioni operative.
Test accurati:Apigee consiglia vivamente di eseguire test completi delle prestazioni e della funzionalità prima di eseguire l'upgrade del prossimo data center. Una volta eseguito l'upgrade di tutti i data center, non è possibile eseguire il rollback alla versione precedente.
Rollback come processo con due checkpoint
Controllo 1:lo stato iniziale, con tutti i componenti nella versione 4.52.02. Il rollback completo è possibile purché almeno un data center Cassandra rimanga nella versione precedente.
Punto di controllo 2:dopo l'aggiornamento di tutti i nodi Cassandra in tutti i data center. Puoi eseguire il rollback a questo stato, ma non puoi tornare al punto di controllo 1.
Esempio
Considera un cluster di due data center (DC):
Stato iniziale: i nodi Cassandra in entrambe le DC sono nella versione 3.11.X. Tutti gli altri nodi sono su Edge for Private Cloud versione 4.52.02. Supponiamo tre nodi Cassandra per DC.
Esegui l'upgrade di 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. Tieni presente che questa interruzione deve essere temporanea a causa delle limitazioni di un cluster Cassandra con versioni miste.
Esegui l'upgrade di DC-2:esegui l'upgrade dei tre nodi Cassandra rimanenti in DC-2. Questo diventa il nuovo punto di controllo del rollback.
Esegui l'upgrade di altri componenti:esegui l'upgrade dei nodi di gestione, di runtime e di analisi come di consueto in tutti i data center, un nodo e un data center alla volta. In caso di problemi, puoi eseguire il rollback allo stato del passaggio 4.
Prerequisiti per l'upgrade di Cassandra
Devi eseguire Cassandra 3.11.16 con Edge for Private Cloud 4.52.02 e assicurarti di quanto segue:
L'intero cluster è operativo e completamente funzionale con Cassandra 3.11.16.
La strategia di compattazione è impostata su LeveledCompactionStrategy (un prerequisito per l'upgrade alla versione 4.52.02).
Tutti i passaggi post-upgrade dall'upgrade iniziale a Cassandra 3.11.16 nell'ambito dell'upgrade a 4.52.02 sono stati completati. In caso contrario, esegui di nuovo questi passaggi. Questo vale solo se hai eseguito l'upgrade alla versione 4.52.02 di Private Cloud da una versione precedente.
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 abilitare gli upgrade dei componenti.
Esegui il backup di Cassandra utilizzando Apigee.
Acquisisci istantanee VM dei nodi Cassandra (se possibile).
Assicurati che la porta 9042 sia accessibile da tutti i componenti di Edge for Private Cloud, inclusi Management Server, Message Processor, Router, Qpid e Postgres, ai nodi Cassandra, se non è già configurata. Per ulteriori informazioni, consulta i requisiti delle 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. Tra un upgrade dei nodi all'interno di un data center e l'altro, attendi qualche minuto 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 del data center successivo. Durante questo periodo, esamina attentamente il data center aggiornato e assicurati che le metriche di funzionalità e rendimento del cluster Apigee siano intatte. Questo passaggio è fondamentale per garantire la stabilità del data center in cui è stato eseguito l'upgrade di Cassandra alla versione 4.0.X, mentre il resto dei componenti Apigee rimane nella versione 4.52.02.
Per eseguire l'upgrade di un nodo Cassandra, esegui il seguente comando:
Dopo aver completato l'installazione iniziale, Apigee consiglia di installare l'interfaccia utente di Edge,
un'interfaccia utente avanzata per sviluppatori e amministratori di Apigee Edge for Private Cloud.
Tieni presente che l'interfaccia utente di Edge richiede di disattivare l'autenticazione di base e di utilizzare un IDP come SAML o LDAP.
In caso di errore di aggiornamento, puoi provare a correggere il problema, quindi eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà da dove si era interrotto l'ultima volta.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-11-23 UTC."],[],[]]
