Aggiorna Apigee Edge 4.51.00 o 4.52.00 o 4.52.01 a 4.52.02

Apigee supporta l'upgrade di Edge for Private Cloud direttamente dalla versione 4.51.00, 4.52.00 o 4.52.01 alla versione 4.52.02. Questa pagina descrive come eseguire questi upgrade.

Chi può eseguire l'aggiornamento

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:

Quali passaggi speciali da considerare per l'upgrade

Per eseguire l'upgrade a Edge for Private Cloud 4.52.02, ti consigliamo di eseguire passaggi specifici per l'upgrade di determinati software. I passaggi necessari dipendono dalla versione corrente. Consulta la tabella seguente per i vari software che richiedono passaggi supplementari e segui le istruzioni dettagliate per ciascuno. Dopo aver completato le attività necessarie, torna alla procedura di upgrade principale per continuare la procedura di upgrade.

Versione corrente Software che richiede passaggi speciali per l'upgrade alla versione 4.52.02 Riferimento
4.52.01 Cassandra Modificare la strategia di compattazione di Cassandra
4.52.00 Cassandra, Zookeeper, Qpid Modificare la strategia di compattazione di Cassandra
4.51.00 Cassandra, Zookeeper, Qpid, Postgres Modificare la strategia di compattazione di Cassandra

Dopo aver eseguito i passaggi necessari in base alla tua versione, torna alla procedura di upgrade principale per continuare.

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 3.11.16

Apigee Edge for Private Cloud 4.52.02 include un upgrade di Cassandra alla versione 3.11.16. Cassandra è un componente fondamentale di Apigee e questo upgrade include anche aggiornamenti al software del driver in vari componenti di gestione e di runtime utilizzati per eseguire query e scrivere in Cassandra.

Poiché si tratta di un upgrade importante, sono state necessarie alcune modifiche al modello di dati di Apigee in Cassandra per garantire un rendimento ottimale nelle versioni più recenti. Sebbene queste modifiche siano minime, la procedura di upgrade interrompe alcune API di gestione, interessando sia l'interfaccia utente di Apigee sia il portale per gli sviluppatori. Il documento riportato di seguito specifica le API esatte che non funzioneranno e illustra i passaggi durante l'upgrade quando l'interruzione inizia e termina. È importante sottolineare che non dovrebbe verificarsi alcuna interruzione del traffico di runtime durante l'upgrade.

Rollback di alto livello

Applica gli upgrade di Cassandra un nodo alla volta. Non appena un nodo viene aggiornato, vengono applicate alcune modifiche allo schema che non possono essere annullate direttamente. Leggi attentamente la sezione sul rollback, poiché è possibile utilizzare tecniche diverse a seconda dell'entità dell'upgrade del cluster.

Se devi eseguire il rollback dell'upgrade dopo l'upgrade dell'intero cluster Cassandra, l'unica opzione è ripristinare i backup. Preparati a questo e acquisisci familiarità con il ripristino del backup di Cassandra. Se puoi ripristinare gli snapshot a livello di VM più velocemente dei backup di Apigee, utilizza gli snapshot VM per ripristinare le VM Cassandra a uno stato precedente.

Per maggiori dettagli, consulta la sezione Eseguire il rollback dell'aggiornamento di Cassandra 3.11.16.

Documentazione delle API nel portale per gli sviluppatori

Il portale per sviluppatori Drupal di Apigee offre varie funzionalità per la documentazione delle API. Sebbene sia consigliabile non utilizzare più il portale per sviluppatori basato su Drupal 7, se lo utilizzi ancora e ne usi la funzionalità SmartDocs, il documento Utilizzo delle API SmartDocs è rivolto a te. Se utilizzi versioni più recenti del portale per gli sviluppatori, la documentazione dell'API non sarà interessata da questo upgrade.

Quando esegui l'upgrade di Apigee alla versione 4.52.02, la migrazione a una versione più recente non verrà eseguita automaticamente per i modelli API creati utilizzando la funzionalità SmartDocs del portale per sviluppatori di Drupal 7. Dovrai esportare manualmente ogni modello utilizzando il portale per gli sviluppatori e importarli di nuovo al termine dell'upgrade.

Terminologia utilizzata nelle sezioni seguenti

Runtime: il runtime comprende la gestione del traffico proxy di runtime. Include tutte le operazioni eseguite dai router e dai processori di messaggi per elaborare in modo efficace una richiesta API di runtime per i proxy esistenti. Tuttavia, non include il deployment di nuovi proxy o nuove revisioni di proxy.

Gestione:include l'amministrazione del sistema Apigee Edge. Sono inclusi, a titolo esemplificativo, i deployment, le modifiche di app, prodotti, server di destinazione, keystore e così via. Tutte le API di gestione (e i relativi client, come l'interfaccia utente di Apigee e il portale per gli sviluppatori) sono incluse in questo ambito.

In ogni passaggio riportato di seguito, viene descritto lo stato di runtime e gestione man mano che avanzi nelle varie fasi della procedura di upgrade. Tieni presente che il traffico di runtime non è interessato durante l'upgrade. Tuttavia, si verificano interruzioni per un piccolo sottoinsieme di API di gestione e funzionalità del portale per gli sviluppatori.

Passaggio 0: stato di inizio

  1. Cassandra in Apigee in esecuzione con la versione 2.1.22.
  2. Componenti di Edge for Private Cloud 4.52.02:
    • Server di gestione che comunica con Cassandra tramite il protocollo Thrift precedente.
    • Server di runtime (Message Processors e Router) che comunicano con Cassandra tramite il protocollo Thrift precedente.
Stato del runtime in questa fase Stato di gestione in questa fase
Runtime completamente funzionale Gestione completamente funzionale

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.

  1. Modifica Cassandra in modo che utilizzi LeveledCompactionStrategy.
  2. Esegui il backup di Cassandra utilizzando Apigee.
  3. Acquisisci istantanee VM dei nodi Cassandra (se possibile).
  4. Crea un file di configurazione dell'upgrade di Cassandra su ogni nodo Cassandra in /opt/apigee/apigee-cassandra/cass_upgrade.conf con i seguenti contenuti: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Se non è possibile creare il file in /opt/apigee/apigee-cassandra/cass_upgrade.conf, crea il file /opt/silent.conf con gli stessi contenuti su ogni nodo Cassandra.
  • Se utilizzi la funzionalità SmartDocs del portale per gli sviluppatori Apigee Drupal 7, esporta ciascuno dei tuoi modelli scaricandolo in formato JSON dall'interfaccia utente del portale per gli sviluppatori. Questi modelli dovranno essere reimportati in Apigee dopo l'aggiornamento dei server di gestione.
  • Assicurati che le porte 9160 e 9042 siano accessibili da tutti i componenti di Edge for Private Cloud 4.52.02 ai nodi Cassandra, se non sono già presenti. Per ulteriori informazioni, consulta Requisiti delle porte.

Passaggio 2: esegui l'upgrade di tutti i nodi Cassandra

  1. Esegui l'upgrade di tutti i nodi Cassandra in tutte le regioni uno alla volta. Esegui i seguenti comandi su ogni nodo: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Dopo aver aggiornato un nodo, esegui il seguente comando sul nodo per eseguire alcune convalide prima di procedere: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Il codice riportato sopra produrrà un output simile al seguente: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Stato del runtime in questa fase Stato di gestione in questa fase
Runtime completamente funzionale La seguente funzione di gestione viene degradata dopo l'upgrade di Cassandra:

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
Stato del runtime Stato di gestione
Runtime completamente funzionale API di gestione in stato di degradamento:

Passaggio 3a: [facoltativo] importa gli SmartDoc esportati in precedenza

Una volta eseguito l'upgrade di tutti i server di gestione, puoi importare i modelli SmartDocs che hai esportato nel passaggio 1. Puoi decidere di farlo anche in un secondo momento.

Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

Passaggio 4: esegui l'upgrade di tutti i nodi di 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
Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

Passaggio 5: esegui l'upgrade di tutti i componenti Edge for Private Cloud 4.52.02 rimanenti

Esegui l'upgrade di tutti i nodi edge-qpid-server e edge-postgres-server rimanenti in tutte le regioni uno alla volta.

A questo punto, se stai eseguendo l'upgrade da versioni precedenti a Edge for Private Cloud 4.52.01 e stai seguendo passaggi aggiuntivi per l'upgrade di Qpid o Postgres, segui i rispettivi passaggi per l'upgrade.

Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

Passaggio 6: passaggi successivi all'upgrade

Dopo il completamento dell'upgrade, esegui il seguente comando su ciascun nodo Cassandra uno alla volta:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Esegui il seguente comando per eliminare le vecchie tabelle inutilizzate dal cluster Cassandra. Fino a quando non viene eseguito, non puoi utilizzare alcune funzionalità di Cassandra (ad esempio la configurazione di una nuova autenticazione; i vecchi meccanismi di autenticazione continueranno a funzionare). Questo comando può essere eseguito solo su un nodo del cluster:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Completa il passaggio 3a, se non l'hai ancora fatto.

Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

Upgrade richiesto a Zookeeper 3.8.3

Anche se Edge for Private Cloud 4.52.02 non include un upgrade a Zookeeper, se esegui l'upgrade da versioni precedenti alla 4.52.01, devi seguire i passaggi per eseguire l'upgrade di Zookeeper.

  • Se esegui l'upgrade da Edge for Private Cloud 4.51.00 o 4.52.00, consulta la sezione Upgrade richiesto a Zookeeper 3.8.3 per eseguire l'upgrade di Zookeeper.
  • Se esegui l'upgrade dalla versione 4.52.01 di Edge for Private Cloud, dovresti già utilizzare la versione 3.8.3 di Zookeeper e non devi seguire procedure speciali per l'upgrade di Zookeeper.

Upgrade obbligatorio a Postgres 14

  • Se esegui l'upgrade da Edge for Private Cloud 4.51.00 a 4.52.02, devi seguire i passaggi per l'upgrade di Postgres, anche se Edge for Private Cloud 4.52.02 non include un upgrade di Postgres. L'upgrade da Edge for Private Cloud 4.51.00 a 4.52.02 richiede ulteriori passaggi di upgrade di Postgres. Fai riferimento alla sezione Upgrade obbligatorio a Postgres 14.
  • Se esegui l'upgrade da Edge for Private Cloud 4.52.00 o 4.52.01 a 4.52.02, non sono necessari ulteriori passaggi di upgrade di Postgres.

Upgrade obbligatorio a Qpid J-Broker

Anche se Edge for Private Cloud 4.52.02 non include un upgrade a QPID, se esegui l'upgrade da versioni precedenti alla 4.52.01, devi seguire la procedura per l'upgrade di QPID.

  • Se stai eseguendo l'upgrade da Edge for Private Cloud 4.51.00 o 4.52.00 a 4.52.02, devi seguire ulteriori passaggi di upgrade di QPID. Consulta la sezione Eseguire l'upgrade di Qpid se stai eseguendo l'upgrade dalla versione 4.51.00 o 4.52.00 alla versione 4.52.02.
  • Se esegui l'upgrade da Edge for Private Cloud 4.52.01 a 4.52.02, dovresti già utilizzare la versione più recente di Qpid Broker e non sono necessari ulteriori passaggi di upgrade di QPID.

Interfaccia utente del nuovo Edge

Questa sezione elenca le considerazioni relative all'interfaccia utente di Edge. Per ulteriori informazioni, consulta La nuova UI di Edge per il cloud privato.

Installare l'interfaccia utente di Edge

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.

Per ulteriori informazioni, vedi Installare la nuova UI di Edge.

Aggiornare l'interfaccia utente di Edge

Per aggiornare il componente dell'interfaccia utente di Edge, prendi in considerazione la versione di Edge per il cloud privato da cui stai eseguendo l'upgrade:

Aggiornamento con mTLS di Apigee

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, quindi eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà da dove si era interrotto l'ultima volta.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta Eseguire il rollback alla versione 4.52.00 per istruzioni dettagliate.