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 componente che ha causato l'errore e riprova a eseguire l'aggiornamento.

Puoi eseguire il rollback di Edge 4.19.06 alle seguenti versioni di Feature Release:

  • Versione 4.19.01
  • Versione 4.18.05
  • Versione 4.18.01
di Gemini Advanced.

Esistono due scenari in cui potresti voler eseguire un rollback:

  1. Esegui il rollback a una release delle funzionalità precedente. Ad esempio da 4.19.06 a 4.18.05.
  2. Esegui il rollback a una versione di aggiornamento precedente nello stesso di lancio. Ad esempio, da 4.19.01.02 a 4.19.01.01.

Per ulteriori informazioni, consulta la release Apigee Edge .

Chi può eseguire un rollback

L'utente che esegue un rollback deve essere lo stesso dell'utente che ha aggiornato originariamente Edge, oppure un eseguito come root.

Per impostazione predefinita, i componenti Edge vengono eseguiti come utente "apigee". In alcuni casi, è possibile che tu stia eseguendo Edge componenti come utenti diversi. Ad esempio, se il router deve accedere a porte con privilegi, come quelli inferiori a 1000, occorre eseguire il router come root o come utente con accesso a quelli porte. In alternativa, potresti eseguire un componente come un utente e un altro come un altro utente.

Componenti con codice comune

I seguenti componenti Edge condividono il codice comune. Di conseguenza, per eseguire il rollback 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 server di gestione, sul router e sul processore di messaggi sono installati al nodo, per eseguire il rollback di uno di questi devi eseguire il rollback di tutti e tre.

Esegui il rollback a una release precedente delle funzionalità

Per eseguire il rollback a una release di funzionalità precedente, procedi nel seguente modo su ogni nodo che ospita la componente:

  1. Scarica il file bootstrap.sh relativo alla versione che vuoi eseguire il rollback indietro:

    • 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 uno qualsiasi dei componenti con codice comune sulla nodo, devi arrestarli tutti, come mostra l'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 esegui il rollback della monetizzazione, disinstallala da tutti i server di gestione e da tutti i messaggi. Nodi processore:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Disinstalla il componente per eseguire il rollback sul nodo:
    1. Per eseguire il rollback di uno qualsiasi dei componenti con codice comune sulla nodo, devi disinstallarli tutti disinstallando il componente edge-gateway come illustrato 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 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 perimetrale, devi eliminare i contenuti /opt/nginx/conf.d oltre a disinstallare il file edge-gateway gruppo di componenti:
      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 di apigee-service e le sue dipendenze. Nell'esempio seguente viene installata la versione 4.18.01 dell'interfaccia 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 di Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.

    Se ricevi un messaggio di errore, assicurati di aver scaricato il file bootstrap.sh durante il 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 tuo di configurazione del deployment per la versione precedente.

  9. Se stai eseguendo il rollback di Qpid, esegui il flush di iptables:
    sudo iptables -F
  10. Ripeti questa 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 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. Per esempio:

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

    Se utilizzi il repository online Apigee, puoi determinare il componente disponibile utilizzando il comando seguente:

    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 quando lo installi devi specificare solo il nome del componente, non la versione.

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