Esegui il rollback di Apigee Edge 4.19.06

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

Puoi eseguire il rollback di Edge 4.19.06 alle seguenti versioni delle release con funzionalità:

  • Versione 4.19.01
  • Versione 4.18.05
  • Versione 4.18.01

Esistono due scenari in cui potresti voler eseguire un rollback:

  1. Esegui il rollback a una release di funzionalità precedente. Ad esempio da 4.19.06 a 4.18.05.
  2. 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 la procedura di rilascio di Apigee Edge.

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 il 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 (Elaboratore 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.

Esegui il rollback a una release di funzionalità precedente

Per eseguire il rollback a una release di funzionalità precedente, svolgi i seguenti passaggi 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.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.18.01, scarica bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  2. Interrompi il componente di cui eseguire il rollback:
    1. Per eseguire il rollback di qualsiasi componente con codice comune sul nodo, devi arrestarli 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, arresta solo quel componente: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. 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
  4. Disinstalla il componente da ripristinare sul nodo:
    1. Per eseguire il rollback di uno dei componenti con codice comune sul nodo, devi disinstallarli tutti disinstallando il gruppo di componenti edge-gateway, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway 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 di Edge Router, 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.19.06 di apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Installa la versione 4.19.01, 4.18.05 o 4.18.01 dell'utilità apigee-service e le rispettive dipendenze. Nell'esempio riportato di seguito viene installata la versione 4.18.01 del apigee-service: 
    sudo bash /tmp/bootstrap_4.18.01.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.

Eseguire 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 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 è il componente e la versione di aggiornamento da installare. Ad esempio:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-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 comp

    Ad esempio:

    yum --showduplicates list edge-ui
  2. 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 quando lo installi, non la versione.

  3. Ripeti questa procedura per ciascun nodo che ospita il componente di cui stai eseguendo il rollback.