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

Aggiornamento Apigee Edge da 4.50.00 o da 4.51.00 a 4.52.00

Apigee supporta l'upgrade di Edge for Private Cloud dalla versione 4.50.00 o dalla versione 4.51.00 direttamente alla versione 4.52.00. Questa pagina descrive come eseguire l'upgrade.

Chi può eseguire l'aggiornamento

La persona che esegue l'aggiornamento deve essere la stessa che ha installato Edge originariamente o una persona che esegue l'operazione come utente root.

Dopo aver installato gli RPM di Edge, chiunque può configurarli.

Quali componenti devi aggiornare

Devi aggiornare tutti i componenti Edge. Edge non supporta una configurazione che contiene componenti di più versioni.

Prerequisiti per l'aggiornamento

Prima di eseguire l'upgrade di Apigee Edge, assicurati di soddisfare i seguenti prerequisiti:

Esegui il backup di tutti i nodi
Prima di eseguire l'aggiornamento, ti consigliamo di eseguire un backup completo di tutti i nodi per motivi di sicurezza. Per eseguire il backup, utilizza la procedura per la tua versione attuale di Edge.
In questo modo, avrai un piano di riserva nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, consulta Backup e ripristino.
Assicurati che Edge sia in esecuzione
Assicurati che Edge sia attivo e in esecuzione durante il processo di aggiornamento utilizzando il comando:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Assicurati che la strategia di compattazione di Cassandra sia LeveledCompactionStrategy
Assicurati che la strategia di compattazione di Cassandra sia impostata su LeveledCompactionStrategy, come descritto in Modifica la strategia di compattazione di Cassandra.

Propagazione automatica delle impostazioni della proprietà

Se hai impostato delle proprietà modificando i file .properties in /opt/apigee/customer/application, questi valori vengono conservati dall'aggiornamento.

Upgrade obbligatorio a Zookeeper 3.8.0

Questa release di Edge for Private Cloud include un upgrade a Zookeeper 3.8.0. Nell'ambito di questo upgrade, verrà eseguita la migrazione di tutti i dati di ZooKeeper a ZooKeeper 3.8.0.

Prima di eseguire l'upgrade di ZooKeeper, leggi la guida alla manutenzione di ZooKeeper. La maggior parte dei sistemi di produzione Edge utilizza un cluster di nodi ZooKeeper distribuiti in più data center. Alcuni di questi nodi sono configurati come votanti che partecipano all'elezione del leader di Zookeeper, mentre gli altri sono configurati come osservatori. Per ulteriori dettagli, consulta Informazioni su leader, follower, votanti e osservatori. I nodi votanti eleggono un leader, dopodiché diventano follower.

Durante il processo di aggiornamento, potrebbe verificarsi un ritardo momentaneo o un errore di scrittura in ZooKeeper quando il nodo leader viene arrestato. Ciò potrebbe influire sulle operazioni di gestione che scrivono in Zookeeper, come l'operazione di deployment di un proxy e le modifiche all'infrastruttura Apigee, come l'aggiunta o la rimozione di un processore di messaggi e così via. Non dovrebbe esserci alcun impatto sulle API di runtime di Apigee (a meno che queste API di runtime non chiamino le API di gestione) durante l'upgrade di Zookeeper seguendo la procedura riportata di seguito.

In generale, il processo di upgrade prevede l'esecuzione di un backup di ogni nodo. Seguono l'upgrade di tutti gli osservatori e i follower e, infine, l'upgrade del nodo leader.

Esegui un backup

Esegui un backup di tutti i nodi di ZooKeeper da utilizzare nel caso in cui sia necessario un rollback. Tieni presente che un rollback ripristinerà ZooKeeper allo stato in cui si trovava al momento del backup. Nota: eventuali deployment o modifiche all'infrastruttura in Apigee apportate dopo l'esecuzione del backup (le cui informazioni sono archiviate in Zookeeper) andranno perse durante il ripristino.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Se utilizzi macchine virtuali e hai la possibilità, puoi anche eseguire snapshot o backup delle VM per il ripristino o il rollback (se necessario).

Identifica leader, follower e osservatori

Nota: i comandi di esempio riportati di seguito utilizzano l'utilità nc per inviare dati a ZooKeeper. Puoi anche utilizzare utilità alternative per inviare dati a ZooKeeper.

Se non è installato sul nodo ZooKeeper, installa nc:
```
  sudo yum install nc
```
Esegui questo comando nc sul nodo, dove 2181 è la porta ZooKeeper:
```
  echo stat | nc localhost 2181
```
Dovresti vedere un output simile al seguente:
```
  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
Nella riga Mode dell'output per i nodi, dovresti vedere observer, leader o follower (ovvero un voter che non è il leader) a seconda della configurazione del nodo. Nota: in un'installazione autonoma di Edge con un singolo nodo ZooKeeper, Mode è impostato su autonomo.
Ripeti i passaggi 1 e 2 su ogni nodo ZooKeeper.

Esegui l'upgrade di ZooKeeper sui nodi observer e follower

Esegui l'upgrade di ZooKeeper su ciascuno dei nodi osservatore e follower come segue:

Scarica ed esegui il bootstrap di Edge for Private Cloud 4.52, come descritto in Aggiorna alla versione 4.52.00 su un nodo con una connessione a internet esterna. La procedura probabilmente varierà a seconda che il nodo abbia una connessione a internet esterna o che tu stia eseguendo un'installazione offline.
Esegui l'upgrade del componente ZooKeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Nota: se su questi nodi sono installati altri componenti (come Cassandra), puoi eseguire l'upgrade anche di questi ora (come con il profilo cs,zk) o puoi eseguire l'upgrade degli altri componenti in un secondo momento. Apigee consiglia di eseguire prima l'upgrade solo di ZooKeeper e di assicurarsi che il cluster funzioni correttamente prima di eseguire l'upgrade di altri componenti.
Ripeti i passaggi precedenti su ciascuno dei nodi osservatore e follower di ZooKeeper.

Arresta il leader

Una volta eseguito l'upgrade di tutti i nodi osservatore e follower, arresta il leader. Sul nodo identificato come leader, esegui il comando seguente:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Tieni presente che durante questo evento, prima che venga eletto un nuovo leader, potrebbero verificarsi ritardi momentanei o errori di scrittura in ZooKeeper. Ciò potrebbe influire sulle operazioni che scrivono in ZooKeeper, come l'azione di deployment dei proxy o le modifiche all'infrastruttura Apigee, come l'aggiunta o la rimozione di processori di messaggi e così via.

Verifica che il nuovo leader sia stato eletto

Seguendo i passaggi descritti nella sezione Identifica leader, follower e osservatori riportata sopra, verifica che sia stato eletto un nuovo leader tra i follower, una volta arrestato il leader esistente. Tieni presente che il leader potrebbe essere stato eletto in un data center diverso da quello attuale.

Leader dell'upgrade

Segui gli stessi passaggi descritti in precedenza nella sezione Esegui l'upgrade di ZooKeeper sui nodi osservatore e follower.

Una volta eseguito l'upgrade anche del vecchio nodo leader, verifica l'integrità del cluster e assicurati che sia presente un nodo leader.

Esegui il rollback

Se è necessario un rollback:

Esegui prima i passaggi di rollback sugli osservatori e sui follower.
Scarica ed esegui il bootstrap della versione di cui stai eseguendo il rollback, ovvero 4.50 o 4.51. La procedura probabilmente varia a seconda che il nodo abbia una connessione a internet esterna o che tu stia seguendo l'installazione offline.

Arresta ZooKeeper se è in esecuzione sul nodo:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Disinstalla ZooKeeper esistente:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Installa ZooKeeper come di consueto:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Una volta eseguito il rollback di tutti i follower e gli osservatori, esegui il rollback del nodo leader seguendo i passaggi da 2 a 5 sul nodo leader.

Dopo aver eseguito il rollback di tutti i nodi, verifica l'integrità del cluster e assicurati che nel cluster sia presente un nodo leader.

Ripristina backup

Consulta Ripristina da un backup. Tieni presente che i backup di ZooKeeper eseguiti da versioni precedenti di Edge for Private Cloud, come 4.50 e 4.51, dovrebbero essere compatibili con la versione di ZooKeeper in Edge for Private Cloud 4.52.

Upgrade obbligatorio a Postgres 14

Questa release di Edge include un upgrade a Postgres 14. Nell'ambito di questo upgrade, tutti i dati Postgres vengono migrati a Postgres 14.

La maggior parte dei sistemi di produzione Edge utilizza due nodi Postgres configurati per la replica master-standby. Durante il processo di aggiornamento, mentre i nodi Postgres non sono attivi per l'aggiornamento, i dati di analisi vengono comunque scritti nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono tornati online, i dati di analisi vengono inviati ai nodi Postgres.

Il modo in cui esegui l'aggiornamento di Postgres dipende da come hai configurato l'archiviazione dei dati per i nodi Postgres:

Se utilizzi il datastore locale per i nodi Postgres, devi installare un nuovo nodo Postgres in standby per la durata dell'upgrade. Al termine dell'upgrade, puoi dismettere il nuovo nodo di standby Postgres.
Il nodo di standby Postgres aggiuntivo è necessario se devi eseguire il rollback dell'aggiornamento per qualsiasi motivo. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo standby Postgres diventa il nodo master Postgres dopo il rollback. Pertanto, quando installi il nuovo nodo standby Postgres, questo deve trovarsi su un nodo che soddisfi tutti i requisiti hardware di un server Postgres, come definito nei Requisiti di installazione di Edge.

In una configurazione di Edge a 1 nodo e 2 nodi, le topologie utilizzate per la prototipazione e i test, hai un solo nodo Postgres. Puoi aggiornare questi nodi Postgres direttamente senza doverne creare uno nuovo.
Se utilizzi lo spazio di archiviazione di rete per i nodi Postgres, come consigliato da Apigee, non devi installare un nuovo nodo Postgres. Nelle procedure riportate di seguito, puoi saltare i passaggi che specificano di installare e successivamente dismettere un nuovo nodo standby Postgres.
Prima di iniziare la procedura di aggiornamento, acquisisci uno snapshot di rete del datastore utilizzato da Postgres. In questo modo, se si verificano errori durante l'aggiornamento e devi eseguire un rollback, puoi ripristinare il nodo Postgres da quello snapshot.

Installazione di un nuovo nodo standby Postgres

Questa procedura crea un server di standby Postgres su un nuovo nodo. Assicurati di installare un nuovo server Postgres in standby per la versione esistente di Edge (4.50.00 o 4.51.00), non per la versione 4.52.00.

Per eseguire l'installazione, utilizza lo stesso file di configurazione che hai utilizzato per installare la versione attuale di Edge.

Per creare un nuovo nodo standby Postgres:

Nel master Postgres corrente, modifica il file /opt/apigee/customer/application/postgresql.properties per impostare il token seguente. Se il file non esiste, crealo:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Dove existing_standby_ip è l'indirizzo IP del server Postgres in standby attuale e new_standby_ip è l'indirizzo IP del nuovo nodo in standby.

Riavvia apigee-postgresql sul master Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Verifica che il nuovo nodo di standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Dovresti vedere le seguenti righe nel file:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Installa il nuovo server di standby Postgres:
1. Modifica il file di configurazione utilizzato per installare la versione attuale di Edge per specificare quanto segue:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
3. Se al momento utilizzi Edge 4.51.00:
  1. Scarica il file bootstrap_4.51.00.sh di Edge in /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Installa l'utilità Edge apigee-service e le dipendenze:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Se al momento utilizzi Edge 4.50.00:
  1. Scarica il file bootstrap_4.50.00.sh di Edge in /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Installa l'utilità Edge apigee-service e le dipendenze:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Utilizza apigee-service per installare l'utilità apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Installa Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Sul nuovo nodo standby, esegui questo comando:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Verifica che sia in standby.

Esecuzione di un upgrade in loco di Postgres

Nota: È necessario eseguire il seguente passaggio preliminare prima di effettuare un aggiornamento in loco di Postgres.

Nota: con Postgres 14, il parametro di configurazione Postgres wal_keep_segments non è più supportato. Se hai aggiunto o modificato questo parametro Postgres, devi rimuoverlo prima di eseguire l'upgrade di Postgres. Per farlo:

Apri il file $APIGEE_ROOT/customer/application/postgresql.properties.
Rimuovi la configurazione relativa a wal_keep_segments.
Riavvia Postgres.

Consulta la documentazione di Postgres per conoscere le proprietà alternative disponibili in Postgres 14, come wal_keep_size, che possono essere utilizzate al suo posto.

Passaggio preliminare

Prima di eseguire un upgrade in loco a Postgres, segui questi passaggi sia sull'host master che su quello in standby per aggiornare la proprietà max_locks_per_transaction su apigee-postgresql:

Se non è presente, crea il file /opt/apigee/customer/application/postgresql.properties.

Cambia la proprietà di questo file in apigee:

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Aggiungi la seguente proprietà al file:

conf/postgresql.conf+max_locks_per_transaction=30000

Configura apigee-postgresql:

apigee-service apigee-postgresql configure

Riavvia apigee-postgresql:

apigee-service apigee-postgresql restart

Esegui l'upgrade in loco

Per eseguire un upgrade in loco a Postgres 14, segui questi passaggi:

Esegui l'upgrade di Postgres sull'host master

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Esegui il comando di configurazione sull'host master:

apigee-service apigee-postgresql setup -f /opt/silent.conf

Esegui il comando di configurazione sull'host master:
```
apigee-service apigee-postgresql configure
```

Riavvia l'host master:

apigee-service apigee-postgresql restart

Configuralo come master:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Assicurati che l'host master sia stato avviato:

apigee-service apigee-postgresql wait_for_ready

Arresta la modalità standby:
```
apigee-service apigee-postgresql stop
```
Esegui l'upgrade della modalità standby.
Nota: se questo passaggio genera un errore o non va a buon fine, puoi ignorarlo. update.sh tenterà di avviare il server di standby con una configurazione errata. Se l'installazione di Postgres viene aggiornata alla versione 14, l'errore può essere ignorato.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Assicurati che lo standby sia interrotto:
```
apigee-service apigee-postgresql stop
```
Rimuovi la vecchia configurazione di standby:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

Configura la replica sul server in standby:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Rimuovi la riga conf/postgresql.conf+max_locks_per_transaction=30000 dal file /opt/apigee/customer/application/postgresql.properties sia sull'host master che su quello in standby. Questa riga è stata aggiunta nel passaggio preliminare.

Dopo aver completato questa procedura, lo standby verrà avviato correttamente.

Disattivazione di un nodo Postgres

Al termine dell'aggiornamento, dismetti il nuovo nodo di standby:

Assicurati che Postgres 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

Recupera l'UUID del nuovo nodo standby eseguendo il seguente comando curl sul nuovo nodo standby:
```
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"
```
Arresta il nuovo nodo standby eseguendo questo comando sul nuovo nodo standby:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Sul nodo master Postgres, modifica /opt/apigee/customer/application/postgresql.properties per rimuovere il nuovo nodo in standby da conf_pg_hba_replication.connection:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Riavvia apigee-postgresql sul master Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Verifica che il nuovo nodo di standby sia stato rimosso visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Dovresti vedere solo la seguente riga nel file:
```
host replication apigee existing_standby_ip/32 trust
```
Elimina l'UUID del nodo in standby da ZooKeeper effettuando la seguente chiamata API di gestione Edge sul nodo del server di gestione:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Passaggi successivi all'upgrade per Postgres

Dopo un upgrade principale di Postgres, le statistiche interne di Postgres vengono cancellate. Queste statistiche aiutano il piano di query di Postgres a utilizzare gli indici e i percorsi più ottimali per eseguire le query.

Postgres può ricostruire gradualmente le sue statistiche nel tempo man mano che le query vengono eseguite e quando viene eseguito il daemon autovacuum. Tuttavia, finché le statistiche non vengono ricostruite, le query potrebbero essere lente.

Per risolvere il problema, esegui ANALYZE su tutte le tabelle del database nel nodo Postgres principale. In alternativa, puoi eseguire ANALYZE per alcune tabelle alla volta.

NOTA: ANALYZE può richiedere molto tempo per l'esecuzione, ma richiede solo un blocco di lettura sulla tabella, consentendo ad altre operazioni su Postgres di continuare l'esecuzione mentre ANALYZE è in esecuzione.

Nuova UI di Edge

Questa sezione elenca le considerazioni relative alla UI di Edge. Per saperne di più, consulta La nuova UI di Edge per cloud privato.

Installa la UI Edge

Dopo aver completato l'installazione iniziale, Apigee consiglia di installare la UI Edge, un'interfaccia utente avanzata per sviluppatori e amministratori di Apigee Edge for Private Cloud.

Tieni presente che la UI Edge richiede di disattivare l'autenticazione di base e di utilizzare un IDP come SAML o LDAP.

Per saperne di più, consulta Installa la nuova UI di Edge.

Aggiorna la UI di Edge

Per aggiornare il componente UI di Edge, considera la versione di Edge for Private Cloud da cui stai eseguendo l'upgrade:

Dalla versione 4.51.00 alla 4.52.00 (con la nuova UI di Edge già installata): utilizza le istruzioni per l'upgrade in questa sezione per il componente edge-management-ui.

Esegui l'aggiornamento con Apigee mTLS

Per aggiornare Apigee mTLS , segui questi passaggi:

Rollback di un aggiornamento

In caso di errore di aggiornamento, puoi provare a correggere il problema e poi eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà dall'ultimo punto in cui è stato interrotto.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta Esegui il rollback della versione 4.52.00 per istruzioni dettagliate.

Informazioni sull'aggiornamento del logging

Per impostazione predefinita, l'utilità update.sh scrive le informazioni di log in:

/opt/apigee/var/log/apigee-setup/update.log

Se la persona che esegue l'utilità update.sh non ha accesso a questa directory, il log viene scritto nella directory /tmp come file denominato update_username.log.

Se la persona non ha accesso a /tmp, l'utilità update.sh non va a buon fine.

Aggiornamento senza tempi di inattività

Un aggiornamento senza tempi di inattività o un aggiornamento in sequenza ti consente di aggiornare l'installazione di Edge senza interrompere Edge.

L'aggiornamento senza tempi di inattività è possibile solo con una configurazione di almeno 5 nodi.

La chiave per l'upgrade senza tempi di inattività è rimuovere ogni router, uno alla volta, dal bilanciatore del carico. Quindi aggiorna il router e tutti gli altri componenti sulla stessa macchina del router, poi aggiungi nuovamente il router al bilanciatore del carico.

Aggiorna le macchine nell'ordine corretto per l'installazione, come descritto in Ordine di aggiornamento delle macchine.
Quando è il momento di aggiornare i router, seleziona un router e rendilo non raggiungibile, come descritto in Abilitazione/disabilitazione della raggiungibilità del server (processore di messaggi/router).
Aggiorna il router selezionato e tutti gli altri componenti Edge sulla stessa macchina del router. Tutte le configurazioni Edge mostrano un router e un processore di messaggi sullo stesso nodo.
Rendi nuovamente raggiungibile il router.
Ripeti i passaggi da 2 a 4 per i router rimanenti.
Continua l'aggiornamento per tutte le macchine rimanenti nell'installazione.

Prima e dopo l'aggiornamento, tieni presente quanto segue:

Sul nodo combinato di router e processore di messaggi:
- Prima dell'aggiornamento, esegui le seguenti operazioni:
  1. Rendi il router non raggiungibile.
  2. Rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, esegui le seguenti operazioni:
  1. Rendi raggiungibile il processore di messaggi.
  2. Rendi raggiungibile il router.
Su singoli nodi router:
- Prima dell'aggiornamento, rendi il router non raggiungibile.
- Dopo l'aggiornamento, rendi raggiungibile il router.
Su singoli nodi processore di messaggi:
- Prima dell'aggiornamento, rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.

Utilizza un file di configurazione invisibile all'utente

Devi passare un file di configurazione invisibile al comando di aggiornamento. Il file di configurazione silenziosa deve essere lo stesso utilizzato per installare Edge 4.50.00 o 4.51.00.

Esegui l'aggiornamento alla versione 4.52.00 su un nodo con una connessione a internet esterna

Utilizza la seguente procedura per aggiornare i componenti Edge su un nodo:

Se presenti, disattiva tutti i job cron configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
Accedi al nodo come root per installare gli RPM Edge.
NOTA: sebbene l'installazione di RPM richieda l'accesso root, puoi eseguire la configurazione di Edge senza l'accesso root.
Installa yum-utils e yum-plugin-priorities:
Nota: se il tuo sistema operativo è RHEL 8.0 - 8.6, salta questo passaggio.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
Se l'installazione avviene su Oracle 7.x, esegui questo comando:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Se l'installazione avviene su AWS, esegui questi comandi yum-configure-manager:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Se al momento utilizzi Edge 4.51.00:
1. Scarica il file Edge bootstrap_4.52.00.sh in /tmp/bootstrap_4.52.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Installa l'utilità Edge 4.52.00 apigee-service e le dipendenze eseguendo questo comando:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  Dove uName:pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.
  
  Per impostazione predefinita, il programma di installazione verifica che sia installato Java 1.8. In caso contrario, verrà installato dal programma di installazione.
  
  Utilizza l'opzione JAVA_FIX per specificare come gestire l'installazione di Java. JAVA_FIX accetta i seguenti valori:
  - I: installa OpenJDK 1.8 (predefinito).
  - C: continua senza installare Java.
  - Q: esci. Per questa opzione, devi installare Java autonomamente.
3. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Esegui l'utilità update sui tuoi nodi utilizzando il seguente comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Esegui questa operazione nell'ordine descritto in Ordine di aggiornamento della macchina.
  
  Dove:
  - component è il componente Edge da aggiornare. I valori possibili includono:
    - cs: Cassandra
    - edge: tutti i componenti Edge ad eccezione della UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO Apigee (se hai installato SSO)
    - ue: nuova UI di Edge
    - ui: UI Edge classica
    - zk: ZooKeeper
  - configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione della versione 4.50.00 o 4.51.00.
  Puoi eseguire update.sh su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione all-in-one (AIO) di Edge. Ad esempio:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Se non l'hai ancora fatto, riavvia i componenti della UI Edge su tutti i nodi che li eseguono:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.
Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Esegui il rollback della versione 4.52.00.

Esegui l'aggiornamento alla versione 4.52.00 da un repository locale

Se i nodi Edge si trovano dietro un firewall o se in qualche altro modo non possono accedere al repository Apigee tramite internet, puoi eseguire l'aggiornamento da un repository locale o da un mirror del repository Apigee.

Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:
- Crea un file .tar del repository, copia il file .tar in un nodo, quindi aggiorna Edge dal file .tar.
- Installa un server web sul nodo con il repository locale in modo che altri nodi possano accedervi. Apigee fornisce il server web Nginx, ma puoi anche utilizzare il tuo server web.
Per eseguire l'aggiornamento da un repository 4.52.00 locale:
1. Crea un repository 4.52.00 locale come descritto in "Crea un repository Apigee locale" in Installa l'utilità apigee-setup di Edge.
  NOTA: se hai già un repository esistente, puoi aggiungervi il repository 4.52.00 come descritto in "Aggiorna un repository Apigee locale" in Installa l'utilità apigee-setup di Edge.
2. Per installare apigee-service da un file .tar:
  1. Sul nodo con il repository locale, utilizza il seguente comando per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella directory /tmp sul nuovo nodo.
  3. Sul nuovo nodo, decomprimi il file nella directory /tmp:
```
tar -xzf apigee-4.52.00.tar.gz
```
    Questo comando crea una nuova directory, denominata repos, nella directory contenente il file .tar. Ad esempio /tmp/repos.
  4. Installa l'utilità Edge apigee-service e le dipendenze da /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Tieni presente che in questo comando includi il percorso della directory dei repository.
3. Per installare apigee-service utilizzando il server web Nginx:
  1. Configura il server web Nginx come descritto in "Installa dal repository utilizzando il server web Nginx" in Installa l'utilità apigee-setup di Edge.
  2. Sul nodo remoto, scarica il file Edge bootstrap_4.52.00.sh in /tmp/bootstrap_4.52.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
    Dove uName:pWord sono il nome utente e la password impostati in precedenza per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.
  3. Sul nodo remoto, installa l'utilità Edge apigee-setup e le dipendenze:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Dove uName:pWord sono il nome utente e la password del repository.
4. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Esegui l'utilità update sui nodi nell'ordine descritto in Ordine di aggiornamento delle macchine:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Dove:
  - component è il componente Edge da aggiornare. In genere, aggiorni i seguenti componenti:
    - cs: Cassandra
    - edge: tutti i componenti Edge ad eccezione della UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: SSO Apigee (se hai installato SSO)
    - ue Nuova UI Edge
    - ui: UI Edge classica
    - zk: ZooKeeper
  - configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione della versione 4.50.00 o 4.51.00.
    NOTA: il file di configurazione deve essere leggibile dall'utente "apigee". Per cambiare il proprietario, utilizza il seguente comando:
    chown apigee:apigee configFile
  Puoi eseguire update.sh su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione all-in-one (AIO) di Edge. Ad esempio:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Se non l'hai ancora fatto, riavvia i componenti della UI su tutti i nodi in cui è in esecuzione:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.
Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Esegui il rollback della versione 4.52.00.

Ordine di aggiornamento della macchina

L'ordine in cui aggiorni le macchine in un'installazione di Edge è importante:
- Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
- Per qualsiasi macchina con più componenti Edge (Management Server, processore di messaggi, Router, QPID Server, ma non Postgres Server), utilizza l'opzione -c edge per aggiornarli tutti contemporaneamente.
- Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nell'ordine delle macchine specificato.
- Non è previsto un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornato quando specifichi l'opzione -c edge.
NOTA: dopo aver aggiornato il componente Edge UI, devi riavviare il servizio Edge UI, come descritto nelle istruzioni di installazione dell'aggiornamento.

Upgrade autonomo di 1 nodo

Per eseguire l'upgrade di una configurazione autonoma a 1 nodo alla versione 4.52.00:
1. Aggiorna tutti i componenti:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Se hai installato apigee-adminapi) Aggiornamento dell'utilità apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Upgrade autonomo di 2 nodi

Aggiorna i seguenti componenti per un'installazione autonoma a 2 nodi:

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
1. Aggiorna Cassandra e ZooKeeper sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aggiorna Qpid e Postgres sulla macchina 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Aggiorna LDAP sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Aggiorna i componenti Edge sulla macchina 2 e 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Aggiorna la UI sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Se hai installato SSO Apigee) Aggiorna SSO Apigee sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
8. Riavvia il componente UI Edge sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Upgrade di 5 nodi

Aggiorna i seguenti componenti per un'installazione a 5 nodi:

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
1. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aggiorna Qpid e Postgres sulla macchina 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Aggiorna Qpid e Postgres sulla macchina 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Aggiorna LDAP sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aggiorna i componenti Edge sulle macchine 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aggiorna la UI di Edge:
  - UI classica: se utilizzi la UI classica, aggiorna il componente ui sulla macchina 1, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - Nuova UI Edge: se hai installato la nuova UI Edge, aggiorna il componente ue sulla macchina appropriata (potrebbe non essere la macchina 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Se hai installato SSO Apigee) Aggiorna SSO Apigee sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
9. Riavvia il componente UI:
  - UI classica: se utilizzi l'UI classica, riavvia il componente edge-ui sulla macchina 1, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nuova UI Edge: se hai installato la nuova UI Edge, riavvia il componente edge-management-ui sulla macchina appropriata (potrebbe non essere la macchina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade di un cluster di 9 nodi

Aggiorna i seguenti componenti per un'installazione in cluster con 9 nodi:

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
1. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aggiorna Qpid sulle macchine 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aggiorna Postgres sulla macchina 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aggiorna Postgres sulla macchina 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Aggiorna LDAP sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Aggiorna i componenti Edge sulle macchine 6, 7, 8, 9, 1, 4 e 5 in questo ordine:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Aggiorna la nuova UI (ue) o la UI classica (ui) sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Se hai installato SSO Apigee) Aggiorna SSO Apigee sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
10. Riavvia il componente UI:
  - UI classica: se utilizzi l'UI classica, riavvia il componente edge-ui sulla macchina 1, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nuova UI Edge: se hai installato la nuova UI Edge, riavvia il componente edge-management-ui sulla macchina appropriata (potrebbe non essere la macchina 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade di un cluster di 13 nodi

Aggiorna i seguenti componenti per un'installazione in cluster con 13 nodi:

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
1. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aggiorna Qpid sulle macchine 12 e 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Aggiorna Postgres sulla macchina 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aggiorna Postgres sulla macchina 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Aggiorna LDAP sulle macchine 4 e 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Aggiorna i componenti Edge sulle macchine 12, 13, 8, 9, 6, 7, 10 e 11 in questo ordine:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Aggiorna la nuova UI (ue) o la UI classica (ui) sulle macchine 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulle macchine 6 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Se hai installato SSO Apigee) Aggiorna SSO Apigee sulle macchine 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
10. Riavvia il componente UI:
  - UI classica: se utilizzi la UI classica, riavvia il componente edge-ui sulle macchine 6 e 7, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - Nuova UI Edge: se hai installato la nuova UI Edge, riavvia il componente edge-management-ui sulle macchine 6 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade di un cluster di 12 nodi

Aggiorna i seguenti componenti per un'installazione in cluster con 12 nodi:

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
1. Aggiorna Cassandra e ZooKeeper:
  1. Sulle macchine 1, 2 e 3 nel data center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  2. Sulle macchine 7, 8 e 9 nel data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Aggiorna qpidd:
  1. Macchine 4, 5 nel data center 1
    1. Aggiorna qpidd sulla macchina 4:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Aggiorna qpidd sulla macchina 5:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. Macchine 10, 11 nel data center 2
    1. Aggiorna qpidd sulla macchina 10:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Aggiorna qpidd sulla macchina 11:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
3. Aggiorna Postgres:
  1. Macchina 6 nel data center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Macchina 12 nel data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Aggiorna LDAP:
  1. Macchina 1 nel data center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Macchina 7 nel data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aggiorna i componenti Edge:
  1. Macchine 4, 5, 6, 1, 2, 3 nel data center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Macchine 10, 11, 12, 7, 8, 9 nel data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aggiorna la nuova UI (ue) o la UI classica (ui):
  1. Macchina 1 nel data center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Macchina 7 nel data center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Se hai installato apigee-adminapi) Aggiornamento dell'utilità apigee-adminapi:
  1. Macchina 1 nel data center 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Macchina 7 nel data center 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Se hai installato SSO Apigee) Aggiorna SSO Apigee:
  1. Macchina 1 nel data center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Macchina 7 nel data center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Riavvia il componente della nuova UI di Edge (edge-management-ui) o della UI di Edge classica (edge-ui) sulle macchine 1 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Per una configurazione non standard

Se hai una configurazione non standard, aggiorna i componenti Edge nel seguente ordine:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, ovvero il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, Edge Postgres Server, Management Server, processore di messaggi e Router.
  NOTA: se su un nodo sono installati sia il server Qpid sia il server Edge Postgres, esegui il passaggio del profilo "-c edge".
6. UI Edge (classica o nuova)
7. apigee-adminapi
8. SSO Apigee
Al termine dell'aggiornamento, assicurati di riavviare il componente Edge UI su tutte le macchine che lo eseguono.