Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

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 del componente che ha causato l'errore e riprovare l'aggiornamento.

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

Versione 4.51.00

Esistono due scenari in cui potresti voler eseguire un rollback:

Esegui il rollback a una release di funzionalità precedente. Ad esempio, dalla versione 4.52.00 alla versione 4.51.00.
Eseguire il rollback a una versione di aggiornamento precedente nella stessa release. Ad esempio, dalla versione 4.52.00.02 alla versione 4.52.00.01.

Per ulteriori informazioni, consulta il processo di rilascio di Apigee Edge.

Chi può eseguire un rollback

L'utente che esegue un rollback deve essere lo stesso che ha aggiornato Edge in origine o un utente che esegue l'operazione come root.

Per impostazione predefinita, i componenti Edge vengono eseguiti come utente "apigee". In alcuni casi, potresti eseguire i componenti Edge come utenti diversi. Ad esempio, se il router deve accedere a porte con privilegi, 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 su quel nodo.

edge-management-server (Server di gestione)
edge-message-processor (Processore 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 eseguire il rollback di uno di questi devi eseguire il rollback di tutti e tre.

Esegui il rollback a una release di funzionalità precedente

Per eseguire il rollback a una release delle funzionalità precedente, segui questi passaggi su ogni nodo che ospita il componente:

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

Arresta il componente di cui eseguire il rollback:

Per eseguire il rollback di uno dei componenti 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

Per eseguire il rollback di qualsiasi altro componente sul nodo, arresta solo quel componente:
- ```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

Se esegui 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:
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 del router perimetrale, 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 *
```

Disinstalla la versione 4.52.00 di apigee-setup:

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

Installa la versione 4.51.00 dell'utilità apigee-service e delle relative dipendenze. L'esempio seguente installa 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.

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 esegui il rollback di Qpid, svuota iptables:
```
sudo iptables -F
```
Ripeti questa procedura per ogni 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, segui questi passaggi su ogni 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 di aggiornamento 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 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, quando installi il componente, specifichi solo il nome, non la versione.
Ripeti questa procedura per ogni 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 dell'aggiornamento di Postgres oltre ai componenti Edge.

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

Promuovi il nuovo nodo di standby affinché diventi il master Postgres. Il nuovo master Postgres sarà della stessa versione della precedente installazione di Edge.
Configura il vecchio nodo in standby in modo che sia un nodo in standby del nuovo master. Il vecchio nodo in standby sarà della stessa versione della precedente installazione di Edge.
Registra i nuovi nodi master e standby con i gruppi di analisi e consumer.

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

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
```

Assicurati che Postgres sia arrestato sul nodo master precedente e sul nodo standby precedente:

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

Se Postgres è in esecuzione, arrestalo:

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

Se installato, avvia Qpid sul nodo in standby precedente:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Nota: in molte configurazioni, il vecchio nodo in standby ospiterà solo Postgres, ma non Qpid.
Promuovi il nuovo nodo in standby come master Postgres:
1. Promuovi il nuovo nodo standby in modo che diventi il nuovo master:
```
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
  Se richiesto, inserisci la password Postgres per l'utente "apigee", che per impostazione predefinita è "postgres".
2. Modifica il file di configurazione utilizzato per installare la versione attuale di Edge per specificare quanto segue:
```
# 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
```
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 sul vecchio nodo standby, puoi saltare questo passaggio e continuare con il passaggio 6.
1. Arresta Postgres sul nodo standby precedente:
```
apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
```
2. Disinstalla Postgres dal vecchio nodo in 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 di cui stai eseguendo il rollback) sul nodo di standby precedente. I passaggi esatti possono variare a seconda che tu stia utilizzando l'installazione basata su internet o offline. L'esecuzione del bootstrap di Apigee della versione precedente configurerà i repository yum con i dati di Apigee della versione precedente.
5. Configura i componenti Postgres sul vecchio nodo di standby:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Controlla e verifica che sia stato eseguito il rollback dei componenti Postgres sul vecchio nodo in standby alla versione precedente:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```
Ricostruisci il vecchio nodo di standby:
1. Modifica il file di configurazione utilizzato per installare la versione attuale di Edge per specificare quanto segue:
```
# 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 di dati sul vecchio nodo standby:
```
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
3. Riconfigura il nodo standby precedente in modo che sia un nodo 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 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
```
Verifica che il nuovo nodo di standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul nuovo master.

Visualizza le informazioni correnti su analisi e gruppi di consumer 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 il nome del gruppo di consumer nel campo name in consumer-groups. Restituisce anche gli UUID dei vecchi nodi master e standby di Postgres nel campo postgres-server e nel campo datastores. Dovresti vedere un output simile al seguente:

{
  "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" : {
  }
}

Recupera l'indirizzo UUID del vecchio master eseguendo il seguente comando curl sul nodo master precedente:
```
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"
```
Nota: il servizio edge-postgres-server deve essere in esecuzione. Se il server Postgres non è in esecuzione, puoi eseguire questo comando sul server di gestione per determinare l'UUID:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
L'output di questo comando elenca l'UUID per l'indirizzo IP di ogni nodo Postgres.
Ripeti il passaggio precedente per ottenere gli indirizzi IP del nodo standby precedente e del nuovo master.
Rimuovi i vecchi nodi master e standby 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 gruppi di analisi e consumer. masterUUID,standbyUUID sono nello stesso ordine in cui sono apparsi sopra quando hai visualizzato le informazioni attuali su analisi e gruppi di consumatori. Potresti doverli specificare come standbyUUID,masterUUID.

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

Rimuovi i vecchi nodi master e standby 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.

Registra i nuovi nodi master e standby di PG con i gruppi di analisi 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

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 nel gruppo di consumer.

Riavvia l'Edge Management Server:

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

Riavvia tutti i server Qpid:

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

Riavvia tutti i server Postgres:

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

Verifica lo stato della replica eseguendo i seguenti script su entrambi i server. Il sistema dovrebbe visualizzare risultati identici su entrambi i server per garantire una replica corretta:
Sul nuovo master, esegui:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Verifica che sia il master. Sul vecchio nodo di standby:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Verifica che sia in standby.
Ripeti il passaggio precedente dopo aver effettuato diverse richieste API per assicurarti che i nodi siano sincronizzati.
Dismettere il vecchio master Postgres utilizzando la procedura descritta in Dismettere un nodo Postgres.
Nota: se il vecchio nodo master eseguiva Qpid, puoi lasciare il server attivo per eseguire Qpid. Assicurati che sia in esecuzione. In caso contrario, avvialo:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
In alternativa, puoi disinstallare Qpid dal vecchio 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:

Arresta Apigee:
```
apigee-all stop
```
Interrompi mTLS:
```
apigee-service apigee-mtls uninstall
```

Reinstalla mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf