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 in origine 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
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

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 verranno mantenuti dopo l'aggiornamento.

Esegui l'upgrade a Zookeeper 3.8.3

Edge for Private Cloud 4.52.02 non include un upgrade di Zookeeper. Tuttavia, se esegui l'upgrade da una versione precedente alla 4.52.01, devi seguire i passaggi per l'upgrade di Zookeeper descritti di seguito.

  • Se esegui l'upgrade da Edge for Private Cloud 4.51.00 o 4.52.00, consulta la sezione Upgrade obbligatorio 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.

Eseguire l'upgrade 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.

Eseguire l'upgrade 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 al suo avvio. Le API di gestione esatte che vengono generalmente interrotte sono elencate nelle sezioni pertinenti di seguito.

Inoltre, la procedura di upgrade causa interruzioni a un insieme più ampio di flussi proxy di runtime e API di gestione nel data center di cui viene eseguito l'upgrade. È fondamentale isolare il traffico di runtime e gestione dal data center di cui viene eseguito l'upgrade per ridurre al minimo queste interruzioni. Per ulteriori informazioni, leggi le sezioni relative a un singolo data center e a più data center di seguito.

Portale per gli sviluppatori - Documentazione delle API

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 di seguito

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.

Durante questo upgrade, il traffico di runtime e gestione è interessato nella regione o nel data center (DC) in cui viene eseguito l'aggiornamento. Indipendentemente dal data center in cui viene eseguito l'aggiornamento, alcune API di gestione sono interessate in tutti i data center. Questo impatto viene rilevato dopo ogni passaggio.

In ogni passaggio riportato di seguito, viene descritto lo stato di esecuzione e gestione man mano che avanzi nelle varie fasi della procedura di upgrade.

Strategie di upgrade

Più data center

L'upgrade deve essere eseguito un data center alla volta per garantire la continuità del traffico ed evitare tempi di inattività. Prima di eseguire l'upgrade di un DC, il traffico deve essere reindirizzato ad altri DC funzionanti.

Data center singolo

Per una configurazione di un singolo data center, la procedura di upgrade avrà un impatto significativo sul traffico di runtime e su alcune API di gestione. Per la configurazione di un singolo data center sono disponibili le seguenti opzioni.

  • Espandi il cluster Edge for Private Cloud in un data center temporaneo aggiungendo un data center accanto a quello esistente per gestire il traffico durante l'upgrade, quindi ritira uno dei data center al termine della procedura di upgrade.
  • Se non riesci a espandere il tuo sistema in un altro data center, preparati al tempo di riposo e pianifica l'upgrade durante i periodi di traffico ridotto per ridurre al minimo l'impatto sulle API di gestione e sul traffico di runtime.

Ti consigliamo di espandere il servizio in un altro data center per evitare ripercussioni sul traffico di runtime e sulle API di gestione. Durante l'upgrade, gli impatti sul data center di cui viene eseguito l'upgrade includono, a titolo esemplificativo:

  • API di runtime che aggiornano i token OAuth
  • API di runtime che utilizzano il criterio di entità di accesso
  • API di gestione che elencano le app per sviluppatori
  • API di gestione che elencano i prodotti

L'impatto descritto sopra si aggiunge alle API di gestione specifiche che rimarranno non funzionali su tutti i data center fino a quando non verrà eseguito l'upgrade di tutti i data center. Queste API di gestione sono elencate nei passaggi delle sezioni successive.

Rollback - alto livello

  • Impatto durante il rollback

    Il rollback da Cassandra 3.11.x a 2.1.x influisce sia sul traffico di runtime sia su quello di gestione all'interno del data center (DC) in cui viene eseguito il rollback. Inoltre, alcune API di gestione potrebbero subire interruzioni in tutti i data center, indipendentemente da quale DC è attualmente in fase di rollback.

  • Approccio di rollback dei contenuti digitali per data center

    Il rollback deve essere eseguito un data center alla volta per mantenere la continuità del servizio ed evitare i tempi di riposo. Prima di avviare il rollback in un data center specifico, assicurati che il traffico delle applicazioni venga reindirizzato a un altro data center completamente operativo.

  • Eseguire il rollback di un cluster di cui è stato eseguito un upgrade parziale

    Se almeno un data center rimane completamente operativo sulla versione precedente di Cassandra (2.1.22), è possibile eseguire il rollback di altri DC di cui è stato eseguito l'upgrade eseguendo una ricostruzione dal DC Cassandra 2.1.X completamente funzionale.

  • Rollback a livello di cluster

    Se è stato eseguito l'upgrade dell'intero cluster Cassandra ed è necessario eseguire il rollback, questo deve essere eseguito utilizzando i backup o gli snapshot della VM. Questo approccio è complesso e probabilmente comporterà un tempo di riposo temporaneo o la perdita di dati.

  • Considerazioni preliminari all'upgrade

    È importante acquisire familiarità con le procedure di rollback prima di tentare l'upgrade. È fondamentale prendere in considerazione le sfumature del rollback durante l'upgrade per assicurarsi che siano disponibili percorsi di rollback appropriati.

Eseguire il rollback dei cluster con un unico data center

L'upgrade di Cassandra dalla versione 2.1.x alla 3.11.x può influire in modo significativo sul traffico di runtime e su alcune API di gestione. Questi impatti si applicano anche durante il rollback e potrebbero comportare tempi di riposo o perdita di dati.

Per i carichi di lavoro di produzione, è vivamente consigliato di eseguire il provisioning di un nuovo data center prima dell'upgrade. Ciò consente un percorso di rollback più sicuro senza perdita di dati o interruzione del traffico API. Il data center aggiuntivo può essere dismesso al termine dell'upgrade.

Se l'aggiunta di un nuovo data center non è fattibile, ma è comunque richiesta la funzionalità di rollback, assicurati di eseguire backup affidabili prima dell'upgrade. È possibile ripristinare Cassandra 2.1.x dai backup, ma questo approccio potrebbe comportare un tempo di inattività del servizio e una potenziale perdita di dati.

Esegui il rollback dei cluster con più data center

Il rollback di più data center segue un approccio data center per data center (DC-by-DC). In questo approccio, il traffico dal data center di cui viene eseguito il rollback viene reindirizzato ad altri data center funzionanti, garantendo un processo di rollback controllato e isolato per Cassandra, Management Server e Runtime nodes per evitare interruzioni del traffico.

Per informazioni dettagliate, consulta la sezione Eseguire il rollback di Cassandra 3.11.16.

Passaggio 0: stato di inizio

  • È già stato eseguito l'upgrade dei componenti Zookeeper, Postgres e LDAP alle versioni 4.52.02. Edge per un cluster di cloud privato è stabile e funzionante. Se è necessario il rollback, verrà eseguito il rollback del cluster a questo stato.
  • Cassandra in Apigee in esecuzione con la versione 2.1.22.
  • Componenti edge:
    • 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 della 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 delle 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.
  5. 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.
  6. Assicurati che le porte 9160 e 9042 siano accessibili da tutti i componenti Edge ai nodi Cassandra, se non sono già presenti. Per ulteriori informazioni, consulta Requisiti delle porte.

Passaggio 2: reindirizza il traffico lontano dal primo data center

  1. Blocca il traffico di runtime e gestione in entrata dal primo data center.
  2. Reindirizza tutto il traffico di runtime e le API di gestione agli altri data center funzionanti.
  3. Verifica che il traffico di runtime e di gestione venga gestito correttamente dagli altri DC.

Passaggio 3: esegui l'upgrade di tutti i nodi Cassandra nel primo data center

  1. Esegui l'upgrade di tutti i nodi Cassandra nel data center uno alla volta. Esegui i seguenti comandi su ogni nodo uno alla volta: 
    /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
     Il codice riportato sopra restituirà 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
  3. Dopo aver completato l'upgrade, esegui il seguente comando post_upgrade su ciascun nodo Cassandra uno alla volta: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Stato del runtime in questa fase Stato della gestione in questa fase
  • Traffico di runtime bloccato nei data center di cui è in corso l'upgrade
  • Runtime completamente funzionale in altri data center

Passaggio 4: esegui l'upgrade di tutti i nodi di gestione nel primo data center

Esegui l'upgrade di tutti i nodi di gestione nel data center:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stato del runtime in questa fase Stato della gestione in questa fase
  • Traffico di runtime bloccato nei data center di cui è in corso l'upgrade
  • Runtime completamente funzionale

Passaggio 5: esegui l'upgrade di tutti i nodi di runtime nel primo data center

Esegui l'upgrade di tutti i nodi Router e Message Processor nel data center uno alla volta:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stato del runtime in questa fase Stato della gestione in questa fase
  • Traffico di runtime bloccato nei data center di cui è in corso l'upgrade
  • Runtime completamente funzionale in altri data center

Passaggio 6: reindirizza il traffico al primo data center

  • Dopo aver eseguito l'upgrade del primo data center con Cassandra, i componenti di runtime e il server di gestione, riattiva il traffico di runtime e gestione per il primo data center.
  • Assicurati che il traffico di runtime e gestione sia corretto nei DC.

Passaggio 7: esegui l'upgrade di altri data center

Ripeti i passaggi da 1 a 6 sui restanti data center, uno alla volta, reindirizzando il traffico lontano da questi data center, aggiornando il software Apigee e riattivando il traffico su questi data center.

Passaggio 8: esegui di nuovo il passaggio di upgrade in tutti i nodi di gestione

Esegui di nuovo il seguente comando di upgrade in tutti i nodi di gestione dei data center:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Passaggio 9: [Facoltativo] Importa gli smartdoc esportati in precedenza

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

Devi eseguire questa operazione solo se utilizzi il portale per sviluppatori basato su Drupal 7 e la funzionalità smartdocs.

Stato del runtime in questa fase Stato della gestione in questa fase
Runtime completamente funzionale Gestione completamente funzionale

Passaggio 10: elimina le tabelle non utilizzate

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

Passaggio 11: esegui l'upgrade di tutti gli altri componenti Edge e di altri componenti per Private Cloud 4.52.02

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, come indicato di seguito, devi eseguire ulteriori passaggi per l'upgrade di Qpid e Postgres, rispettivamente, ed eseguire l'upgrade dei componenti rimanenti come da questi passaggi.

Esegui l'upgrade 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 Qpidupgrade.

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.

Informazioni sugli aggiornamenti 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, il log viene scritto nella directory /tmp come file denominato update_username.log.

Se non hai accesso a /tmp, l'utilità update.sh non funziona.

Aggiornamento senza tempi di inattività

Un aggiornamento senza tempi di inattività o in sequenza ti consente di aggiornare l'installazione di Edge senza interrompere il servizio.

L'aggiornamento senza tempi di riposo è possibile solo con una configurazione di 5 nodi o più.

La chiave per l'upgrade senza tempi di riposo è rimuovere ogni router, uno alla volta, dal bilanciatore del carico. Aggiorna il router e tutti gli altri componenti sulla stessa macchina del router e aggiungi di nuovo il router al bilanciatore del carico.

  1. Aggiorna le macchine nell'ordine corretto per l'installazione, come descritto in Ordine di aggiornamento delle macchine.
  2. Quando è il momento di aggiornare i router, selezionane uno e impostalo come non raggiungibile, come descritto in Abilitazione/disattivazione della raggiungibilità del server (Message Processor/Router).
  3. Aggiorna il router selezionato e tutti gli altri componenti Edge sulla stessa macchina del router. Tutte le configurazioni Edge mostrano un router e un elaboratore di messaggi sullo stesso nodo.
  4. Rendi di nuovo raggiungibile il router.
  5. Ripeti i passaggi da 2 a 4 per gli altri router.
  6. Continua l'aggiornamento per le eventuali altre macchine dell'installazione.

Prima e dopo l'aggiornamento, tieni presente quanto segue:

Utilizzare un file di configurazione silenzioso

Devi passare un file di configurazione silenzioso al comando di aggiornamento. Il file di configurazione silenzioso dovrebbe essere lo stesso utilizzato per installare Edge 4.50.00 o 4.51.00.

Eseguire l'aggiornamento alla versione 4.52.02 su un nodo con una connessione a internet esterna

Per aggiornare i componenti Edge su un nodo, segui questa procedura:

  1. Se presenti, disattiva tutti i job cron configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
  2. Accedi al tuo nodo come utente root per installare gli RPM di Edge.
  3. Installa yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
  5. Se esegui l'installazione su Oracle 7.x, esegui il seguente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Se esegui l'installazione su AWS, esegui i seguenti comandiyum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  7. Se al momento utilizzi Edge 4.51.00:

    1. Scarica il file bootstrap_4.52.02.sh di Edge su /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Installa l'utilità e le dipendenze di Edge 4.52.02 apigee-service eseguendo il seguente comando: 
      sudo bash /tmp/bootstrap_4.52.02.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 installerà 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 (valore predefinito).
      • C: continua senza installare Java.
      • Q: esci. Per questa opzione, devi installare Java autonomamente.
    3. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Esegui l'utilità update sui tuoi nodi eseguendo il seguente comando: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Esegui questa operazione nell'ordine descritto in Ordine di aggiornamenti della macchina.

      Dove:

      • component è il componente Edge da aggiornare. I valori possibili includono:
        • cs: Cassandra
        • edge: tutti i componenti di Edge, ad eccezione dell'interfaccia utente di Edge: server di gestione, elaboratore di messaggi, router, server Qpid, server Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO Apigee (se hai installato SSO)
        • ue: nuova interfaccia utente di Edge
        • ui: interfaccia utente di Edge classica
        • zk: Zookeeper
      • configFile è lo stesso file di configurazione utilizzato per definire i componenti Edge durante l'installazione di 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 Edge all-in-one (AIO). Ad esempio:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Se non l'hai ancora fatto, riavvia i componenti dell'interfaccia utente di Edge su tutti i nodi su cui sono in esecuzione: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback alla versione 4.52.02.

Aggiornamento alla versione 4.52.02 da un repository locale

Se i tuoi nodi Edge sono protetti da un firewall o non hanno l'autorizzazione ad accedere al repository Apigee tramite internet, puoi eseguire l'aggiornamento da un repository locale o da un mirror del repository Apigee.#heading

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 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.52.02:

  1. Crea un repository locale 4.52.02 come descritto in "Creare un repository Apigee locale" in Installare l'utilità apigee-setup di Edge.
  2. Per installare apigee-service da un file .tar:
    1. Sul nodo con il repository locale, utilizza il seguente comando per impacchettare il repository locale in un unico file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella directory /tmp del nuovo nodo.
    3. Sul nuovo nodo, estrae il file nella directory /tmp: 
      tar -xzf apigee-4.52.02.tar.gz

      Questo comando crea una nuova directory denominata repos nella directory contenente il file .tar. Ad esempio /tmp/repos.

    4. Installa l'utilità apigee-service di Edge e le dipendenze da /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Tieni presente che in questo comando devi includere il percorso della directory dei repository.

  3. Per installare apigee-service utilizzando il server web Nginx:
    1. Configura il server web Nginx come descritto in "Installa dal repository utilizzando il server web Nginx" in Installa l'utilità Edge apigee-setup.
    2. Sul nodo remoto, scarica il file bootstrap_4.52.02.sh di Edge in /tmp/bootstrap_4.52.02.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      dove uName:pWord sono il nome utente e la password impostati in precedenza per il repo e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repo.

    3. Sul nodo remoto, installa l'utilità apigee-setup di Edge e le dipendenze: 
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      dove uName:pWord sono il nome utente e la password del repository.

  4. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. 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: Cassandra
      • edge: tutti i componenti di Edge, ad eccezione dell'interfaccia utente di Edge: server di gestione, elaboratore di messaggi, router, server Qpid, server Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO Apigee (se hai installato SSO)
      • ue Interfaccia utente del nuovo Edge
      • ui: interfaccia utente di Edge classica
      • zk: Zookeeper
    • configFile è lo stesso file di configurazione utilizzato per definire i componenti Edge durante l'installazione di 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 Edge all-in-one (AIO). Ad esempio:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Se non l'hai ancora fatto, riavvia i componenti dell'interfaccia utente su tutti i nodi su cui sono in esecuzione: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback alla versione 4.52.02.

Ordine di aggiornamento della macchina: upgrade da 4.51.00 (o) 4.52.00 (o) 4.52.01

L'ordine in cui aggiorni le macchine in un'installazione Edge è importante:

  • Devi aggiornare tutti i nodi ZooKeeper nei data center prima di eseguire l'upgrade di tutti gli altri componenti. Se esegui l'upgrade da Edge Private Cloud 4.51.00 o 4.52.00, dovrai anche seguire ulteriori passaggi per eseguire l'upgrade di ZooKeeper.
  • Devi aggiornare Postgresql in tutti i data center. Se esegui l'upgrade da Edge Private Cloud 4.51.00, dovrai anche seguire ulteriori passaggi per eseguire l'upgrade di postgres.
  • Devi aggiornare i nodi LDAP in tutti i data center.
  • Devi aggiornare tutti i nodi Cassandra, Management Server, Message Processor e Router, un data center alla volta, fino a quando non viene eseguito l'upgrade di tutti i data center.
  • Devi aggiornare i componenti edge-qpid-server e edge-postgres-server in tutti i data center.
  • Devi eseguire l'upgrade dei nodi Qpid in tutti i data center. Se esegui l'upgrade da Edge Private Cloud 4.51.00 o 4.52.00, dovrai anche seguire ulteriori passaggi per eseguire l'upgrade di Qpid.
  • Aggiorna l'interfaccia utente di Edge e la nuova interfaccia utente di Edge, i nodi SSO in tutti i data center.
  • Non è previsto 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 autonoma a 1 nodo alla versione 4.52.02:
  1. Aggiorna tutti i componenti: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Se hai installato apigee-adminapi) È stata aggiornata 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 di Edge e dei numeri di nodi.

  1. Aggiorna Zookeeper sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aggiorna Postgres sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna LDAP sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aggiorna Cassandra sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Aggiorna i componenti Edge sulle macchine 1 e 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna Qpid sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aggiorna la UI sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (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.

  10. Riavvia il componente dell'interfaccia utente di Edge sulla macchina 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 di Edge e dei numeri di nodi.

  1. Aggiorna ZooKeeper sulle macchine 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aggiorna Postgres sulla macchina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna Postgres sulla macchina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aggiorna LDAP sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna Cassandra sulle macchine 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aggiorna i componenti Edge sulle macchine 1, 2, 3, 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna Qpid sulla macchina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aggiorna Qpid sulla macchina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Aggiorna l'interfaccia utente di Edge:
    • Interfaccia utente classica:se utilizzi l'interfaccia utente 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 di Edge: se hai installato la nuova UI di 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
  10. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (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.

  12. Riavvia il componente dell'interfaccia utente:
    • Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulla macchina 1, 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 sulla macchina appropriata (potrebbe non essere la macchina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade di un cluster di 9 nodi

Aggiorna i seguenti componenti per un'installazione in cluster di 9 nodi:

Consulta Topologie di installazione per l'elenco delle topologie di Edge e dei numeri di nodi.

  1. Aggiorna ZooKeeper sulle macchine 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aggiorna Postgres sulla macchina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna Postgres sulla macchina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aggiorna LDAP sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna Cassandra sulle macchine 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aggiorna i componenti Edge sulle macchine 1, 4, 5, 6, 7, 8 e 9 nell'ordine indicato: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna Qpid sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. 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
  9. (Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (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.

  11. Riavvia il componente dell'interfaccia utente:
    • Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulla macchina 1, 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 sulla macchina appropriata (potrebbe non essere la macchina 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade di un cluster di 13 nodi

Aggiorna i seguenti componenti per un'installazione in cluster di 13 nodi:

Consulta Topologie di installazione per l'elenco delle topologie di Edge e dei numeri di nodi.

  1. Aggiorna ZooKeeper sulle macchine 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aggiorna Postgres sulla macchina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna Postgres sulla macchina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aggiorna LDAP sulle macchine 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna Cassandra sulle macchine 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aggiorna i componenti Edge sulle macchine 6, 7, 10, 11, 12, 13, 8 e 9 nell'ordine indicato: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna Qpid sulle macchine 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aggiorna la nuova interfaccia utente (ue) o quella classica (ui) sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulle macchine 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (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.

  11. Riavvia il componente dell'interfaccia utente:
    • 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 sulle macchine 6 e 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Upgrade di un cluster di 12 nodi

Aggiorna i seguenti componenti per un'installazione in cluster di 12 nodi:

Consulta Topologie di installazione per l'elenco delle topologie di Edge e dei numeri di nodi.

  1. Aggiorna ZooKeeper sulle macchine 1, 2, 3, 7, 8 e 9 in entrambi i DC:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Aggiorna Postgres sulle macchine 6,12 in entrambi i DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna LDAP sulle macchine 1 e 7 in entrambi i DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. Blocca il traffico nella DC-1 e assicurati che tutto il traffico venga reindirizzato all'altra DC-2

  5. Aggiorna Cassandra sulle macchine 1, 2 e 3 nel DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Aggiorna il server di gestione sulla macchina 1 nel DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna il router e il Message Processor sulle macchine 2 e 3 nel DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Sblocca il traffico nel DC-1 e convalida il DC-1, quindi procedi con il DC-2 bloccando il traffico nel DC-2 e reindirizzandolo al DC-1
  9. Aggiorna Cassandra sulle macchine 7, 8 e 9 in DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Aggiorna il server di gestione sulla macchina 7 nel DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Aggiorna il router e il Message Processor sulle macchine 8 e 9 nel DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Sblocca il traffico nel DC-2 e ora entrambi i DC gestiranno il traffico
  13. Esegui di nuovo il comando di aggiornamento in tutti i server di gestione nei DC sulle macchine 1 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Aggiorna edge-qpid-server ed edge-postgres-server sulle macchine 4, 5, 6, 10, 11 e 12 in entrambi i DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Aggiorna Qpid sulle macchine 4, 5, 10 e 11 in entrambi i DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Aggiorna la nuova interfaccia utente (ue) o quella classica (ui) in entrambe le DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (Se hai installato apigee-adminapi) Aggiorna apigee-adminapi in entrambe le DC: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (Se hai installato Apigee SSO) Aggiorna i nodi Apigee SSO in entrambi i DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Riavvia il componente della nuova interfaccia utente di Edge (edge-management-ui) o della versione classica dell'interfaccia utente di Edge (edge-ui) in entrambe le DC: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart