Esegui il rollback di Apigee Edge 4.52.02

Se si verifica un errore durante un aggiornamento a Edge 4.52.02, puoi eseguire il rollback del componente che ha causato l'errore e riprovare a eseguire l'aggiornamento.

Puoi eseguire il rollback di Edge 4.52.02 a una delle seguenti versioni principali:

  • Versione 4.52.01
  • Versione 4.52.00
  • Versione 4.51.00

Il rollback di una versione comporta il rollback di tutti i componenti di cui potresti aver eseguito l'upgrade. Inoltre, a seconda della versione da cui hai iniziato, potresti dover considerare passaggi speciali prima di eseguire il rollback di determinati componenti software. La tabella seguente elenca i vari componenti software per i quali potrebbero essere necessari passaggi speciali durante il rollback:

Esegui il rollback alla versione Considerazione speciale per il software
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Esistono due scenari in cui potresti voler eseguire un rollback:

  1. Esegui il rollback a una release principale o secondaria precedente. Ad esempio, da 4.52.02 a 4.52.00.
  2. Esegui il rollback a una release con patch precedente nella stessa release. Ad esempio, da 4.52.00.02 a 4.52.00.01.

Per ulteriori informazioni, consulta la procedura di rilascio di Apigee Edge.

Ordine del rollback

Il rollback dei componenti deve seguire l'ordine inverso del loro upgrade, con l'eccezione che i server di gestione devono essere sottoposti a rollback dopo Cassandra. È necessario eseguire il rollback di Cassandra, dei componenti di runtime e del server di gestione utilizzando un approccio data center per data center (DC per DC), reindirizzando temporaneamente il traffico ai data center funzionanti.

Un ordine generale di rollback tipico per Private Cloud 4.52.02 sarà il seguente:

Data center singolo

Per la configurazione di un singolo data center, la procedura di rollback avrà un impatto significativo sul traffico di runtime e su alcune API di gestione.

  1. Esegui il rollback di Qpid e di altri componenti correlati all'analisi
  2. Esegui il rollback dei router e dei processori di messaggi
  3. Esegui il rollback di Cassandra
  4. Server di gestione del rollback
  5. Esegui il rollback di Postgres e Zookeeper

Più data center

In una configurazione multi-data center, i rollback devono seguire un approccio data center per data center (DC per DC) reindirizzando temporaneamente il traffico ai data center funzionanti. In questo modo, viene garantita la continuità del traffico, vengono evitati i tempi di inattività e viene attivato un processo di rollback controllato per Cassandra, Management Server e Runtime Nodes.

  1. Esegui il rollback di Qpid e di altri componenti correlati all'analisi in tutti i DC.
  2. Blocca il traffico nel primo data center e reindirizzalo ad altri DC.
  3. Esegui il rollback dei router e degli elaboratori di messaggi nel primo data center.
  4. Esegui il rollback di Cassandra nel primo data center.
  5. Server di gestione del rollback nel primo data center.
  6. Sblocca il traffico nel primo data center e segui i passaggi da 2 a 6 finché non viene eseguito il rollback di Runtime Nodes, Cassandra e Management Server nell'ultimo data center.
  7. Esegui il rollback di Postgres, Zookeeper e LDAP in tutti i DC.

Per fare un esempio, supponiamo che tu abbia eseguito l'upgrade dell'intero cluster Cassandra, di tutti i server di gestione e di alcuni elaboratori di messaggi di runtime (RMP) dalla versione 4.52.01 alla 4.52.02 e che tu debba eseguire un rollback. In questo caso, il rollback deve essere eseguito nel seguente modo:

  1. Bloccare il traffico verso il primo data center (data center) e instradare nuovamente il traffico verso gli altri DC attivi per garantire la continuità del servizio.
  2. Esegui il rollback di router e elaboratori di messaggi nel primo data center.
  3. Esegui il rollback di Cassandra nel primo data center ripristinando da un backup o uno snapshot della VM.
  4. Esegui il rollback del server di gestione nel primo data center.
  5. Sblocca il traffico verso il primo data center.
  6. Ripeti i passaggi da 1 a 5 per ogni data center rimanente finché non è stato eseguito il rollback di tutti i nodi di runtime, Cassandra e i server di gestione.

Chi può eseguire un rollback

L'utente che esegue il rollback deve essere lo stesso che ha aggiornato Edge inizialmente o un utente eseguito come utente root.

Per impostazione predefinita, i componenti Edge vengono eseguiti come utente "apigee". In alcuni casi, potresti eseguire i componenti di Edge come utenti diversi. Ad esempio, se il router deve accedere a porte privilegiate, come quelle inferiori a 1000, devi eseguire il router come utente root o come utente con accesso a queste porte. In alternativa, puoi eseguire un componente come un utente e un altro componente come un altro utente.

Componenti con codice comune

I seguenti componenti Edge condividono un codice comune. Pertanto, per eseguire il rollback di uno di questi componenti su un nodo, devi eseguire il rollback di tutti i componenti presenti sul nodo.

  • edge-management-server (server di gestione)
  • edge-message-processor (Processore di messaggi)
  • edge-router (router)
  • edge-postgres-server (Postgres Server)
  • edge-qpid-server (Qpid Server)

Ad esempio, se sul nodo sono installati il server di gestione, il router e l'elaboratore di messaggi, per eseguire il rollback di uno di questi componenti devi eseguire il rollback di tutti e tre.

Rollback di Cassandra

Quando viene eseguito un upgrade importante di Cassandra su un determinato nodo Cassandra, Cassandra modifica lo schema dei dati archiviati sul nodo, rendendo non fattibile un rollback diretto. Esistono due metodologie per eseguire il rollback. Utilizzerai una di queste metodologie in base allo stato dell'upgrade da cui esegui il rollback.

Metodologie per il rollback

Scenari di rollback

Edge for Private Cloud 4.52.02 include un upgrade in Cassandra e nel driver utilizzato dall'elaboratore dei messaggi e dal server di gestione per connettersi a Cassandra. Di conseguenza, gli upgrade e il rollback di questi tre componenti sono strettamente correlati. La tabella seguente elenca esempi generali di scenari di rollback per questi tre componenti specifici. Il rollback di altri componenti deve seguire la sezione Ordine del rollback.

Questa sezione illustra vari scenari di rollback e la metodologia consigliata da seguire, in base agli approcci descritti sopra.

Scenario Strategia di rollback
Data center singolo, alcuni nodi Cassandra di cui è stato eseguito l'upgrade Ripristino da backup
Data center singolo, upgrade di tutti i nodi Cassandra Ripristino da backup
Data center singolo, upgrade di tutti i nodi (Cassandra, server di gestione e nodi di runtime)
Più data center, alcuni/tutti i nodi Cassandra nel primo data center di cui è stato eseguito l'upgrade Eseguire la ricostruzione dal data center esistente
Più data center, tutti i nodi Cassandra, il server di gestione e i nodi di runtime nel primo data center di cui è stato eseguito l'upgrade

Questa operazione deve essere eseguita su un data center alla volta.
Più data center, alcuni/tutti i nodi Cassandra dell'ultimo data center sono sottoposti ad upgrade
  • Esegui il rollback dell'ultimo data center utilizzando il backup
  • Esegui il rollback dei restanti data center utilizzando il backup o la ricostruzione, un data center alla volta.
Più data center, tutti i nodi Cassandra, il server di gestione e i nodi di runtime di cui è stato eseguito l'upgrade in tutti i DC

Questa operazione deve essere eseguita un data center alla volta.

In genere, durante il rollback di Cassandra devi considerare quanto segue:

  1. Ripristino dei componenti di gestione o di runtime

    Se devi eseguire il rollback di componenti come Edge Management Server o Edge Message Processor a una versione precedente di Edge Private Cloud in qualsiasi data center (DC), assicurati di eseguire contemporaneamente il rollback anche di Cassandra in quel data center specifico. Questo è necessario per evitare errori di gestione e traffico di runtime.

  2. Eseguire il rollback utilizzando i backup

    I backup di Cassandra 3.11.x non sono compatibili con quelli di Cassandra 2.1.x. Per abilitare il rollback utilizzando il ripristino del backup, assicurati che i backup di Cassandra 2.1.x vengano eseguiti prima di eseguire l'upgrade.

  3. Isolare il data center per il rollback

    Per evitare tempi di riposo, assicurati che il traffico venga reindirizzato a data center completamente funzionanti e bloccato nel data center sottoposto a rollback.

Eseguire il rollback di Cassandra utilizzando la ricostruzione

Prerequisiti

  1. Gestisci un cluster Edge for Private Cloud 4.51.00 / 4.52.00 / 4.52.01 su più data center
  2. Stai eseguendo l'upgrade di Cassandra dalla versione 2.1.X alla versione 3.11.X e hai riscontrato problemi durante l'upgrade
  3. Nel cluster è presente almeno un data center completamente funzionale che utilizza ancora la versione precedente di Cassandra (Cassandra 2.1.X)

Passaggi di alto livello

  1. Scegli un data center (di cui è stato eseguito l'upgrade parziale o completo) di cui vuoi eseguire il rollback. Reindirizza tutto il traffico delle applicazioni da questo data center a un altro data center completamente funzionale.
  2. Se è stato eseguito l'upgrade del router e del Message Processor, esegui il rollback di tutti i nodi del router e del Message Processor nel data center, uno alla volta.
  3. Interrompi Cassandra su un nodo, disinstallalo e ripulisci tutti i dati associati.
  4. Installa il bootstrap della versione precedente e configura Cassandra versione 2.1.x sul nodo pulito.
  5. Ricostruisci il nodo dal data center funzionale esistente su cui è ancora in esecuzione Cassandra 2.1.x.
  6. Esegui i passaggi da 3 a 5 su ogni nodo Cassandra rimanente nel data center, un nodo alla volta.
  7. Esegui di nuovo la configurazione del server di gestione nel data center.
  8. Esegui test per convalidare il rollback. Una volta verificata, reindirizza il traffico delle applicazioni al data center ripristinato.
  9. Ripeti i passaggi precedenti per gli altri data center che richiedono un rollback, uno alla volta.

Passaggi dettagliati per cancellare e utilizzare i nodi esistenti nel cluster per ricostruire il nodo:

Inizia con il nodo di cui vuoi eseguire il rollback

  1. Prima di procedere con i passaggi successivi, assicurati che il traffico venga reindirizzato a data center completamente funzionanti.
  2. Se è stato eseguito l'upgrade del router e del Message Processor, esegui il rollback di tutti i nodi del router e del Message Processor alla versione precedente nel data center, uno alla volta.
  3. Interrompi Cassandra sul nodo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Disinstalla il software Cassandra dal nodo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Rimuovi la directory dei dati dal nodo: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Scarica ed esegui il bootstrap della versione precedente di Edge for Private Cloud a cui vuoi eseguire il rollback:

    Esempio: per eseguire il rollback alla versione 4.52.01

  7. Scarica il bootstrap di 4.52.01: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. Esegui il bootstrap di 4.52.01: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Installa il software Cassandra sul nodo: 
    apigee-service apigee-cassandra install
  10. Aggiungi la proprietà riportata di seguito al file /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh. 
    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

    Esempio: 

    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

  11. Configura Cassandra sul nodo: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  12. Dopo aver avviato Cassandra, rimuovi il CWC riportato sopra dal file seguente:/opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.
  13. Riavvia il nodo Cassandra 
    apigee-service apigee-cassandra restart
  14. Esegui la ricostruzione sul nodo specificando il nome del data center funzionale: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

    Esempio: 

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

  15. Ripeti i passaggi precedenti su ogni nodo di cui vuoi eseguire il rollback nel data center, uno alla volta.

Una volta eseguito il rollback e la ricostruzione di tutti i nodi Cassandra nel data center

  1. Esegui la configurazione di uno dei nodi del server di gestione nel data center di cui vuoi eseguire il rollback. Assicurati che il server di gestione provenga dalla versione di cui è stato eseguito il rollback. In caso contrario, esegui il rollback del server di gestione.

    2. Esegui il rollback del server di gestione alla versione precedente

  2. Arresta il server di gestione: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  3. Se utilizzi la monetizzazione, disinstallala anche: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Disinstalla edge-gateway e apigee-cassandra-client: 
    /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
     
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
  5. Scarica ed esegui il bootstrap della versione precedente. Ad esempio, per scaricare ed eseguire il bootstrap della versione 4.52.01: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
     
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    6. Configurazione del server di gestione

  6. Esegui la configurazione di un nodo del server di gestione: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
  7. Dopo aver completato i passaggi precedenti, reindirizza il traffico al data center di cui è stato eseguito il rollback.

Ottimizzazione dopo la ricostruzione

Nei passaggi precedenti, tutti i dati del nodo vengono trasmessi in streaming dal data center remoto durante la ricostruzione. Puoi ottimizzare questa procedura utilizzando una riparazione dopo che tutte le repliche sono state trasmesse in streaming al data center locale. In questo modo si evita lo streaming tra data center e l'operazione dovrebbe essere più rapida rispetto alla ricostruzione di tutti i nodi da un data center remoto.

Esempio: supponiamo che tu abbia sei nodi Cassandra nel data center locale. Per impostazione predefinita, il fattore di replica di Apigee è 3, quindi ogni nodo possiede il 50% dei dati. In questo caso, puoi ricostruire i nodi 1 e 4 seguendo la procedura descritta sopra. Per i nodi 2, 3, 5 e 6, segui i passaggi riportati di seguito per ripristinare il backup ed eseguire una riparazione.

  1. Segui la procedura fino ai passaggi precedenti come descritto per ricostruire le repliche nel data center locale.
  2. Per i nodi rimanenti, segui i passaggi riportati di seguito su ogni nodo rimanente.
  3. Ripristina il backup acquisito su questo nodo (nota: questo backup potrebbe contenere dati non aggiornati perché è stato eseguito prima dell'avvio dell'upgrade di Cassandra): 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

    Se hai uno snapshot della VM del nodo, puoi ripristinarlo anziché il backup di Cassandra.

  4. Dopo aver ripristinato il backup, avvia il servizio Cassandra sul nodo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  5. Esegui una riparazione sul nodo in modo che i dati più recenti possano essere trasmessi in streaming da un data center esistente: 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

    Esempio: 

    /opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

  6. Ripeti tutti i passaggi precedenti descritti nel passaggio 2 su ogni nodo da riparare

Esegui il rollback di Cassandra utilizzando il backup / lo snapshot della VM

Questa procedura è l'unica disponibile se hai eseguito l'upgrade dell'intero cluster Cassandra e vuoi eseguire il rollback. Inoltre, i backup di Apigee sono specifici per nodo. Non è possibile ripristinare un backup di un nodo in un altro. I backup di Cassandra includono informazioni sui metadati dei nodi (ad esempio indirizzo IP, posizione dell'anello e così via).

Prerequisiti

  1. Stai eseguendo l'upgrade di Cassandra da 2.1.X a 3.11.X nell'ultimo data center e hai riscontrato problemi durante l'upgrade.
  2. Disponi di backup per il nodo prima dell'upgrade di cui vuoi eseguire il rollback. Il backup è stato eseguito prima del tentativo di upgrade da 2.1.X a 3.11.X.

Passaggi di alto livello

  1. Scegli un data center (di cui è stato eseguito l'upgrade parziale o completo) per il rollback. Reindirizza tutto il traffico di runtime da questo data center a un altro data center completamente funzionale.
  2. Se è stato eseguito l'upgrade del router e del processore di messaggi, esegui il rollback di tutti i nodi del router e del processore di messaggi nel data center, uno alla volta
  3. Interrompi Cassandra su un nodo, disinstallalo e ripulisci tutti i dati associati.
  4. Installa il bootstrap della versione precedente e configura Cassandra versione 2.1.x sul nodo pulito.
  5. Interrompi il nodo Cassandra e ripulisci tutti i dati associati.
  6. Ripristina il nodo Cassandra dal backup eseguito prima dell'upgrade.
  7. Ripeti i passaggi da 3 a 6 per ciascuno dei nodi Cassandra rimanenti nel data center, un nodo alla volta.
  8. Esegui di nuovo la configurazione del server di gestione nel data center.
  9. Esegui test per convalidare il rollback. Una volta verificata, reindirizza il traffico di runtime al data center ripristinato.
  10. Ripeti i passaggi precedenti per gli altri data center che richiedono un rollback, uno alla volta.
  11. (Facoltativo) Esegui il comando di riparazione su tutti i nodi Cassandra in tutti i data center se esiste un'incongruenza tra i dati.

Procedura dettagliata per eseguire il rollback di Cassandra utilizzando i backup/lo snapshot della VM

Inizia con un nodo Cassandra nel cluster

  1. Prima di procedere con i passaggi successivi, assicurati che il traffico venga reindirizzato a data center completamente funzionanti.
  2. Se è stato eseguito l'upgrade del router e del gestore dei messaggi, esegui il rollback di tutti i nodi del router e del gestore dei messaggi alla versione precedente nel data center, uno alla volta.
  3. Interrompi Cassandra sul nodo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Disinstalla il software Cassandra dal nodo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Rimuovi la directory dei dati dal nodo: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Scarica ed esegui il bootstrap della versione precedente di Edge for Private Cloud a cui vuoi eseguire il rollback:

    Esempio: per eseguire il rollback alla versione 4.52.01

  7. Scarica il bootstrap di 4.52.01: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. Esegui il bootstrap di 4.52.01: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Configura Cassandra sul nodo: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  10. Interrompi Cassandra sul nodo: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  11. Elimina la directory dei dati sul nodo: 
    rm -rf /opt/apigee/data/apigee-cassandra/data
  12. Ripristina backup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
  13. Avvia il servizio Cassandra sul nodo 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  14. Ripeti i passaggi su ciascun nodo Cassandra uno alla volta.
  15. Esegui la configurazione di uno dei nodi del server di gestione nel data center di cui vuoi eseguire il rollback. Assicurati che il server di gestione provenga dalla versione di cui è stato eseguito il rollback. In caso contrario, esegui il rollback del server di gestione.
  16. Dopo aver completato i passaggi precedenti, reindirizza il traffico al data center di cui è stato eseguito il rollback.
  17. (Facoltativo) Esegui il comando di riparazione su tutti i nodi Cassandra in tutti i data center se esiste un'incongruenza tra i dati. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

Esegui il rollback dell'aggiornamento di Zookeeper 3.8.3

Se esegui il rollback alle versioni 4.52.00 o 4.51.00, dovrai seguire alcuni passaggi speciali prima di eseguire il rollback di Zookeeper. Questi passaggi sono elencati in Ripristino dei dati precedenti.

Se esegui il rollback alla versione 4.52.01, esegui il rollback di Zookeeper come faresti con qualsiasi software, come indicato nella sezione Eseguire il rollback a una release principale o secondaria precedente di seguito.

Rollback Qpid

Se esegui il rollback alle versioni 4.52.00 o 4.51.00, dovrai seguire alcuni passaggi speciali prima di eseguire il rollback di Qpid. Questi passaggi sono elencati in Ripristino dei dati precedenti.

Se esegui il rollback alla versione 4.52.01, esegui il rollback di Qpid come faresti con qualsiasi software come indicato in Eseguire il rollback a una release maggiore o minore precedente

Esegui il rollback dell'aggiornamento di Postgres 10.17

Se esegui il rollback alla versione 4.51.00, dovrai fare riferimento ad alcuni passaggi speciali prima di eseguire il rollback di Postgres. Questi passaggi sono elencati in Ripristino dei dati precedenti.

Se esegui il rollback alla versione 4.52.01 o 4.52.00, esegui il rollback di Postgres come faresti con qualsiasi software, come indicato nella sezione Eseguire il rollback a una release principale o secondaria precedente di seguito.

Esegui il rollback a una release maggiore o minore precedente

Per eseguire il rollback a una release maggiore o minore precedente, svolgi le seguenti operazioni su ogni nodo che ospita il componente:

  1. Scarica il file bootstrap.sh per la versione a cui vuoi eseguire il rollback:

    • Per eseguire il rollback alla versione 4.51.00, scarica bootstrap_4.51.00.sh
  2. Interrompi il componente di cui vuoi eseguire il rollback:
    1. Per eseguire il rollback di uno dei componenti con codice comune sul node, devi fermarli tutti, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Per eseguire il rollback di qualsiasi altro componente sul nodo, interrompi solo quel componente: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Se esegui il rollback della monetizzazione, disinstallala da tutti i nodi del server di gestione e del Message Processor: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Disinstalla il componente di cui vuoi eseguire il rollback sul nodo:
    1. Per eseguire il rollback di uno dei componenti con codice comune sul node, devi disinstallarli tutti disinstallando il gruppo di componenti edge-gateway e apigee-cassandra-client, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. Per eseguire il rollback di qualsiasi altro componente sul nodo, disinstalla solo quel componente, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      dove component è il nome del componente.

    3. Per eseguire il rollback del router Edge, devi eliminare i contenuti del file /opt/nginx/conf.d, oltre a disinstallare il gruppo di componenti edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. Disinstalla la versione 4.52.02 di apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Installa la versione 4.51.00 dell'utilità apigee-service e le relative dipendenze. Nell'esempio riportato di seguito viene installata la versione 4.51.00 di apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    dove uName e pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.

    Se ricevi un messaggio di errore, assicurati di aver scaricato il file bootstrap.sh nel passaggio 1.

  7. Installa apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Installa la versione precedente del componente: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    dove component è il componente da installare e configFile è il file di configurazione per la versione precedente.

  9. Se esegui il rollback di Qpid, svuota iptables: 
    sudo iptables -F
  10. Ripeti questa procedura per ogni nodo che ospita il componente di cui vuoi eseguire il rollback.

Esegui il rollback a una release di patch precedente

Per eseguire il rollback di un componente a una release di patch specifica, svolgi i seguenti passaggi su ogni nodo che ospita il componente:

  1. Scarica la versione specifica del componente: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Dove component_version è la release del componente e della patch da installare. Ad esempio:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

    Se utilizzi il repository online di Apigee, puoi determinare le versioni dei componenti disponibili utilizzando il seguente comando: 

    yum --showduplicates list component

    Ad esempio:

    yum --showduplicates list edge-ui
  2. Utilizza apigee-setup per installare il componente: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Ad esempio:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Tieni presente che devi specificare solo il nome del componente durante l'installazione, non la versione.

  3. Ripeti questa procedura per ogni nodo che ospita il componente di cui vuoi eseguire il rollback.

Esegui il rollback di mTLS

Per eseguire il rollback dell'aggiornamento mTLS, svolgi i seguenti passaggi su tutti gli host:

  1. Interrompi Apigee: 
    apigee-all stop
  2. Interrompi mTLS: 
    apigee-service apigee-mtls uninstall
  3. Reinstalla mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf