Esegui il rollback di Apigee Edge 4.52.00

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

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

• Versione 4.51.00

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 Da 4.52.00 a 4.51.00.
2. Esegui il rollback a una versione di aggiornamento precedente nello stesso di lancio. Ad esempio, da 4.52.00.02 a 4.52.00.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.51.00, scarica bootstrap_4.51.00.sh:

     curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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.52.00 di apigee-setup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

6. Installa la versione 4.51.00 dell'apigee-service e le sue dipendenze. Nell'esempio seguente viene installata la versione 4.51.00 dell' 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 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.51.05-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.

Esegui il rollback dell'aggiornamento di Postgres 10.17

Se hai eseguito l'upgrade alla versione 4.52.00 dalla versione 4.50.00 o 4.51.00, devi eseguire il rollback Aggiornamento di Postgres oltre ai componenti Edge.

Per eseguire il rollback dell'aggiornamento di Postgres durante l'aggiornamento di Postgres in una configurazione in standby master:

• Promuovi il nuovo nodo di standby in modo che diventi il master Postgres. Il nuovo master di Postgres sarà la stessa versione della precedente installazione di Edge.
• Configura il vecchio nodo in standby come nodo di standby del nuovo master. Il vecchio nodo in standby sarà la stessa versione della precedente installazione di Edge.
• Registra i nuovi nodi master e standby nei gruppi di analisi e consumer.

Al termine del rollback, il vecchio nodo master non sarà più necessario. Puoi e poi dismettere il vecchio nodo master.

1. Assicurati che il nuovo nodo Postgres in standby sia in esecuzione:

   /opt/apigee/apigee-service/bin/apigee-all status

   Se Postgres non è in esecuzione, avvialo:

   /opt/apigee/apigee-service/bin/apigee-all start

2. Assicurati che Postgres sia arrestato sul vecchio nodo master e sul vecchio nodo standby:

   /opt/apigee/apigee-service/bin/apigee-all status

   Se Postgres è in esecuzione, interrompilo:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

3. Se installato, avvia Qpid sul vecchio nodo di standby:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

4. Promuovi il nuovo nodo di standby come master Postgres:
   1. Promuovi il nuovo nodo in standby a nuovo master:

      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      Se richiesto, inserisci la password Postgres per 'apigee' dell'utente, che per impostazione predefinita "postgres".

   2. Modifica il file di configurazione che hai utilizzato per installare la versione corrente di Edge per specificare le seguenti:

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   3. Configura il nuovo master:
      

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile

5. Se hai già eseguito l'upgrade del vecchio nodo in standby alla versione più recente, devi prima eseguire il downgrade del software Apigee sul vecchio nodo in standby. Se hai ancora la versione precedente sulla vecchia versione nodo di standby, puoi saltare questo passaggio e continuare con il passaggio 6.
   1. Arresta Postgres sul vecchio nodo in standby:

      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop

   2. Disinstalla Postgres dal vecchio nodo di standby:

      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall

   3. Elimina la directory dei dati Postgres dal vecchio nodo di standby:

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   4. Scarica ed esegui il bootstrap della versione precedente (per la versione di Apigee che stai implementando) sul precedente nodo in standby. I passaggi esatti possono variare a seconda che utilizzi o meno l'installazione basata su internet o offline. L'esecuzione della versione precedente del bootstrap Apigee configurare i repository yum con i dati Apigee della versione precedente.
   5. Configura i componenti Postgres sul vecchio nodo standby:

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

   6. Controlla e verifica che i componenti Postgres sul vecchio nodo standby è stato eseguito il rollback alla versione precedente:

      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version

6. Ricrea il vecchio nodo in standby:
   1. Modifica il file di configurazione che hai utilizzato per installare la versione corrente di Edge per specificare le seguenti:

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   2. Rimuovi la directory dei dati sul vecchio nodo in standby:

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   3. Riconfigura il vecchio nodo in standby in modo che sia un nodo di standby del nuovo master:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. Assicurati che Postgres sia in esecuzione sul vecchio nodo in standby:

      /opt/apigee/apigee-service/bin/apigee-all status

      Se Postgres non è in esecuzione, avvialo:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

7. Verifica che il nuovo nodo in standby sia stato aggiunto visualizzando la /opt/apigee/apigee-postgresql/conf/pg_hba.conf nel nuovo master.
8. Visualizza le analisi attuali e le informazioni sul gruppo di consumatori eseguendo questo comando sul server di gestione:

   curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

   Questo comando restituisce il nome del gruppo di analisi nel campo name e la nome del gruppo di consumatori nel campo name in consumer-groups. Inoltre, restituisce gli UUID del master Postgres precedente e dei nodi di standby nella postgres-server e nel campo datastores. Dovresti vedere in questo formato:

   {
     "name" : "axgroup-001",
     "properties" : {
     },
     "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
     "uuids" : {
       "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "postgres-server" : [
         "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
       ]
     },
     "consumer-groups" : [ {
       "name" : "consumer-group-001",
       "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "datastores" :
         [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
         "properties" : {     }
       }
     ],
     "data-processors" : {
     }
   }

9. Ottieni l'indirizzo UUID del master precedente eseguendo questo comando curl sul il vecchio nodo master:

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   Dovresti vedere l'UUID del nodo alla fine dell'output, nel formato:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

10. Ripeti il passaggio precedente per ottenere gli indirizzi IP del vecchio nodo in standby e del nuovo principale.
11. Rimuovi i nodi master e standby precedenti dal gruppo di consumer:

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    Dove axgroup-001 e consumer-group-001 sono i nomi predefiniti dei analisi dei dati e gruppi di consumatori. masterUUID,standbyUUID sono nello stesso ordine apparso sopra quando hai visualizzato le analisi attuali e le informazioni sul gruppo di consumatori riportate sopra. Tu potrebbe essere necessario specificarli come standbyUUID,masterUUID.

    La proprietà datastores per consumer-groups ora dovrebbe essere vuoto.

12. Rimuovi i nodi master e standby precedenti dal gruppo di analisi:

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    La proprietà postgres-server in uuids ora dovrebbe essere vuota.

13. Registra nuovi nodi master e standby della PG con i gruppi di dati e consumer:
    

    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

14. Convalida il gruppo di analisi:

    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Dovresti vedere gli UUID dei nuovi nodi master e standby elencati nel gruppo di analisi. e il gruppo di consumatori.

15. Riavvia Edge Management Server:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

16. Riavvia tutti i server Qpid:

    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

17. Riavvia tutti i server Postgres:

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

18. Verifica lo stato della replica inviando i seguenti script su entrambi i server. Il sistema devono visualizzare risultati identici su entrambi i server per garantire una replica corretta:

    Nel nuovo master, esegui:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Verifica che si tratti dell'istanza principale. Sul vecchio nodo in standby:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Verifica che sia in standby.

19. Ripeti il passaggio precedente dopo aver effettuato diverse richieste API per assicurarti che i nodi siano in sincronizzazione.
20. Dismissione del vecchio master Postgres utilizzando la procedura in Disattivazione di un Nodo Postgres. .

    In alternativa, puoi disinstallare Qpid dal precedente master e installare Qpid sul nuovo nodo master. Dopo aver disinstallato Qpid, puoi dismettere il vecchio nodo master.

Esegui il rollback di mTLS

Per eseguire il rollback dell'aggiornamento mTLS, segui questi 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