Se si verifica un errore durante un aggiornamento a Edge 4.50.00, puoi eseguire il rollback del componente che ha causato l'errore e quindi riprovare a eseguire l'aggiornamento.
Puoi eseguire il rollback di Edge 4.50.00 alle seguenti versioni di Feature Release:
- Versione 4.19.06
- Versione 4.19.01
- Versione 4.18.05
Esistono due scenari in cui potresti voler eseguire un rollback:
- Esegui il rollback a una release di funzionalità precedente. Ad esempio da 4.50.00 a 4.18.05.
- Esegui il rollback a una versione di aggiornamento precedente nella stessa release. Ad esempio, da 4.19.01.02 a 4.19.01.01.
Per ulteriori informazioni, consulta il processo di rilascio di Apigee Edge.
Chi può eseguire un rollback
L'utente che esegue un rollback dovrebbe essere lo stesso dell'utente che ha originariamente aggiornato Edge o di un utente in esecuzione come root.
Per impostazione predefinita, i componenti Edge vengono eseguiti con l'utente "apigee". In alcuni casi, potresti eseguire i componenti Edge come utenti diversi. Ad esempio, se il router deve accedere alle porte con privilegi, come quelle inferiori a 1000, devi eseguirlo come utente root o come utente con accesso a queste porte. In alternativa, puoi eseguire un componente come un utente e un altro come un altro utente.
Componenti con codice comune
I seguenti componenti di Edge condividono il codice comune. Pertanto, per eseguire il rollback di uno qualsiasi di questi componenti su un nodo, devi eseguire il rollback di tutti i componenti che si trovano su quel nodo.
edge-management-server
(server di gestione)edge-message-processor
(elaboratore di messaggi)edge-router
(router)edge-postgres-server
(server Postgres)edge-qpid-server
(server Qpid)
Ad esempio, se sul nodo sono installati il server di gestione, il router e il processore di messaggi, per eseguirne il rollback devi eseguire il rollback di tutti e tre.
Rollback a una release di funzionalità precedente
Per eseguire il rollback a una release di funzionalità precedente, procedi nel seguente modo su ciascun nodo che ospita il componente:
-
Scarica il file
bootstrap.sh
della versione in cui vuoi eseguire il rollback:- Per eseguire il rollback alla versione 4.19.06, scarica
bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
- Per eseguire il rollback alla versione 4.19.01, scarica
bootstrap_4.19.01.sh
:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Per eseguire il rollback alla versione 4.18.05, scarica
bootstrap_4.18.05.sh
:curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- Per eseguire il rollback alla versione 4.19.06, scarica
- Interrompi il componente per eseguire il rollback:
- Per eseguire il rollback di uno qualsiasi dei componenti con codice comune sul nodo, devi arrestarli tutti, come illustrato 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
- Per eseguire il rollback di qualsiasi componente di altro sul nodo, interrompi soltanto quel componente:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Per eseguire il rollback di uno qualsiasi dei componenti con codice comune sul nodo, devi arrestarli tutti, come illustrato nell'esempio seguente:
- Se stai eseguendo il rollback della monetizzazione, disinstallala da tutti i nodi del server di gestione e del processore di messaggi:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- Disinstalla il componente per eseguire il rollback sul nodo:
- Per eseguire il rollback di uno dei componenti con codice comune sul nodo, devi disinstallarli tutti disinstallando il gruppo di componenti
edge-gateway
, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- Per eseguire il rollback di qualsiasi altro componente sul nodo, disinstalla solo quel componente, come illustrato nell'esempio seguente:
/opt/apigee/apigee-service/bin/apigee-service component uninstall
Dove component è il nome del componente.
- Per eseguire il rollback del router Edge, devi eliminare i contenuti del file
/opt/nginx/conf.d
oltre a disinstallare il gruppo di componentiedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- Per eseguire il rollback di uno dei componenti con codice comune sul nodo, devi disinstallarli tutti disinstallando il gruppo di componenti
- Disinstalla la versione 4.50.00 di
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- Installa la versione 4.19.01 o 4.18.05 dell'utilità
apigee-service
e delle sue dipendenze. Nell'esempio seguente viene installata la versione 4.18.05 diapigee-service
:sudo bash /tmp/bootstrap_4.18.05.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 visualizzi un messaggio di errore, assicurati di aver scaricato il file
bootstrap.sh
nel passaggio 1. - Installa
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.
- Se stai eseguendo il rollback di Qpid, svuota iptables:
sudo iptables -F
- Ripeti la procedura per ciascun nodo che ospita il componente di cui stai eseguendo il rollback.
Esegui il rollback a una versione di aggiornamento precedente
Per eseguire il rollback di un componente a una versione specifica di una release, procedi nel seguente modo su ciascun nodo che ospita il componente:
- Scarica la versione specifica del componente:
/opt/apigee/apigee-service/bin/apigee-service component_version install
Dove component_version è il componente e la versione dell'aggiornamento da installare. Ad esempio:
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install
Se utilizzi il repository online Apigee, puoi determinare le versioni disponibili dei componenti utilizzando il seguente comando:
yum --showduplicates list comp
Ad esempio:
yum --showduplicates list edge-ui
- Utilizza
apigee-setup
per installare il componente:/opt/apigee/apigee-setup/bin/setup.sh -p comp -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, non la versione, al momento dell'installazione.
- Ripeti la procedura per ciascun nodo che ospita il componente di cui stai eseguendo il rollback.