Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiorna Apigee Edge 4.51.00 o 4.52.00 o 4.52.01 a 4.52.02

Apigee supporta l'upgrade di Edge per il cloud privato direttamente dalla versione 4.51.00, 4.52.00 o 4.52.01 alla versione 4.52.02. In questa pagina viene descritto come eseguire questi upgrade.

Chi può eseguire l'aggiornamento

La persona che esegue l'aggiornamento deve essere la persona che ha installato inizialmente Edge o la persona che esegue l'operazione come root.

Dopo aver installato gli RPM perimetrali, chiunque può configurarli.

Quali componenti devi aggiornare

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

Aggiorna prerequisiti

Assicurati che siano soddisfatti i seguenti prerequisiti prima di eseguire l'upgrade di Apigee Edge:

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. Usa la procedura della versione attuale di Edge per eseguire il backup.
Ciò ti consente di avere un piano di backup, nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, vedi 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 Modificare la strategia di compattazione di Cassandra.

Quali passaggi speciali prendere in considerazione per l'upgrade

Per eseguire l'upgrade a Edge per il cloud privato 4.52.02, valuta la possibilità di eseguire passaggi specifici per l'upgrade di un software specifico. I passaggi necessari dipendono dalla versione corrente. Fai riferimento alla tabella seguente per i vari software che richiedono passaggi supplementari. Le sezioni successive di questa pagina forniscono discussioni dettagliate e i passaggi esatti per ciascun software.

Versione corrente	Software che richiedono passaggi speciali per l'aggiornamento alla versione 4.52.02
4.52.01	Cassandra
4.52.00	Cassandra, Zookeeper, Qpid
4.51.00	Cassandra, Zookeeper, Qpid, Postgres

Propagazione automatica delle impostazioni delle proprietà

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

Upgrade richiesto a Cassandra 3.11.16

Apigee Edge per Private Cloud 4.52.02 include un upgrade di Cassandra alla versione 3.11.16. Cassandra è un componente critico di Apigee e questo upgrade include anche aggiornamenti del software driver in vari componenti di runtime e gestione utilizzati per eseguire query e scrivere in Cassandra.

Poiché si tratta di un upgrade importante, sono state necessarie alcune modifiche al modello dei dati di Apigee in Cassandra per garantire prestazioni ottimali nelle versioni più recenti. Anche se queste modifiche sono minime, il processo di upgrade interrompe alcune API di gestione, che interessano sia la UI di Apigee sia il portale per gli sviluppatori. Il documento seguente specifica le API esatte che non funzioneranno e descrive i passaggi durante l'upgrade, quando inizia e termina l'interruzione. È importante sottolineare che non dovrebbero verificarsi interruzioni del traffico di runtime durante l'upgrade.

Rollback di alto livello

Applica gli upgrade di Cassandra un nodo alla volta. Non appena un nodo viene aggiornato, vengono applicate alcune modifiche allo schema che non è possibile eseguire direttamente il rollback. Leggi attentamente la sezione sul rollback, poiché è possibile utilizzare diverse tecniche a seconda di quanti cluster sono stati aggiornati.

Se devi eseguire il rollback dell'upgrade dopo l'upgrade dell'intero cluster Cassandra, l'unica opzione è ripristinare i backup. Preparati e acquisisci familiarità con il ripristino dei backup di Cassandra. Se puoi ripristinare gli snapshot a livello di VM più velocemente dei backup Apigee, utilizza gli snapshot delle VM per ripristinare uno stato precedente delle VM Cassandra.

Per maggiori dettagli, consulta la sezione Eseguire il rollback dell'aggiornamento di Cassandra 3.11.16.

Documentare le API nel portale per gli sviluppatori

Il portale per gli sviluppatori Apigee Drupal offre varie funzionalità per la documentazione delle API. Sebbene si consiglia di abbandonare il portale per gli sviluppatori basato su Drupal 7, se lo stai ancora utilizzando e stai utilizzando la funzionalità SmartDocs, il documento Utilizzo delle API SmartDocs si applica al tuo caso. Se usi versioni più recenti del portale per gli sviluppatori, durante questo upgrade non ci sarà alcun impatto sulla documentazione dell'API.

Quando esegui l'upgrade di Apigee alla versione 4.52.02, qualsiasi modello API creato utilizzando la funzionalità SmartDocs del portale per sviluppatori Drupal 7 non verrà migrato automaticamente alla versione più recente. Dovrai esportare manualmente ogni modello utilizzando il portale per gli sviluppatori e importarlo di nuovo al termine dell'upgrade.

Terminologia utilizzata nelle sezioni seguenti

Runtime:il runtime include la gestione del traffico proxy di runtime. Include tutte le operazioni eseguite dai router e dai processori di messaggi per elaborare in modo efficace una richiesta API runtime per i proxy esistenti. Tuttavia, non include l'implementazione di nuovi proxy o nuove revisioni dei proxy.

Gestione: la gestione include l'amministrazione del sistema Apigee Edge. Sono inclusi, a titolo esemplificativo, deployment, modifiche di app, prodotti, server di destinazione, archivi chiavi e così via. Tutte le API di gestione (e i relativi client come la UI di Apigee e il portale per gli sviluppatori) sono incluse in questo ambito.

In ogni passaggio riportato di seguito, lo stato del runtime e della gestione viene descritto man mano che procedi nelle varie fasi della procedura di upgrade. Tieni presente che non c'è alcun impatto sul traffico di runtime durante l'upgrade. Tuttavia, si è verificata un'interruzione di un piccolo sottoinsieme di API di gestione e di funzionalità del portale per gli sviluppatori.

Passaggio 0: stato di avvio

Cassandra in Apigee in esecuzione con versione 2.1.22.
Componenti di Edge per il cloud privato 4.52.02:

Server di gestione che comunica con Cassandra tramite un vecchio protocollo Thrift.
Server di runtime (processori di messaggi e router) che comunicano con Cassandra tramite un protocollo Thrift precedente.

Stato del runtime in questa fase	Stato della gestione in questa fase
Runtime completamente funzionale	Gestione completamente funzionale

Passaggio 1: preparati per l'upgrade

I passaggi seguenti si aggiungono ai file standard che in genere crei, come il file di configurazione standard di Apigee per abilitare gli upgrade dei componenti.

Cambia Cassandra per utilizzare LeveledCompactionStrategy.
Esegui il backup di Cassandra utilizzando Apigee.
Acquisisci snapshot VM dei nodi Cassandra (se possibile).
Crea un file di configurazione di upgrade di Cassandra su ciascun nodo Cassandra in /opt/apigee/apigee-cassandra/cass_upgrade.conf con il seguente contenuto:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
Se non è possibile creare il file in /opt/apigee/apigee-cassandra/cass_upgrade.conf, crea il file /opt/silent.conf con gli stessi contenuti su ciascun nodo Cassandra.
Attenzione:il programma di installazione di upgrade di Apigee cercherà il file nelle posizioni elencate sopra. Se il file non è presente in nessuna delle località elencate sopra, l'upgrade non andrà a buon fine e verrà visualizzato un messaggio simile al seguente:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
In questo caso, l'upgrade non riuscirà, ma il servizio Cassandra sul nodo probabilmente sarà in stato interrotto. Puoi avviare il servizio Cassandra come di consueto e riprovare l'upgrade inserendo il file di configurazione in una delle posizioni previste. Inoltre, se il file viene trovato, ma le configurazioni fornite non sono corrette (ad esempio, le credenziali di Cassandra non sono corrette), l'upgrade non andrà a buon fine e verrà restituito un errore come il seguente:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
In questo caso, allo stesso modo, avvia il servizio Cassandra se viene interrotto quando l'upgrade non va a buon fine e riprova a eseguirlo dopo aver corretto le configurazioni nel file.

Se usi la funzionalità SmartDocs del portale per sviluppatori Apigee Drupal 7, esporta ciascuno dei tuoi modelli scaricandoli in formato JSON dall'interfaccia utente del portale per gli sviluppatori. Questi modelli dovranno essere importati nuovamente in Apigee dopo l'aggiornamento dei server di gestione.
Assicurati che le porte 9160 e 9042 siano accessibili da tutti i componenti Edge per Private Cloud 4.52.02 ai nodi Cassandra, se non sono già presenti. Per maggiori informazioni, consulta la sezione Requisiti per le porte.

Passaggio 2: esegui l'upgrade di tutti i nodi Cassandra

Esegui l'upgrade di tutti i nodi Cassandra in tutte le regioni uno alla volta. Esegui i seguenti comandi su ciascun nodo:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Una volta aggiornato un nodo, esegui questo comando sul nodo per eseguire alcune convalide prima di procedere:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

Il valore riportato sopra restituirà un risultato del tipo:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Stato del runtime in questa fase	Stato della gestione in questa fase
Runtime completamente funzionale	Le prestazioni della seguente funzione di gestione sono ridotte dopo l'upgrade di Cassandra: API di gestione per creare prodotti API con ambiente API di gestione per aggiornare un prodotto API con l'ambiente API di gestione per eliminare un'organizzazione

Nota:se esegui l'upgrade da Edge Private Cloud 4.51.00 o 4.52.00, dovrai anche seguire dei passaggi aggiuntivi per eseguire l'upgrade di Zookeeper. Anche se Zookeeper e Cassandra possono essere collocati congiuntamente negli stessi nodi, è consigliabile eseguire l'upgrade separatamente da Zookeeper e Cassandra.

Puoi utilizzare il seguente comando su un nodo per eseguire l'upgrade di Zookeeper:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

Il seguente comando può essere utilizzato su un nodo per eseguire l'upgrade di Cassandra:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

Se esegui l'upgrade da Edge Private Cloud 4.52.01 a 4.52.02, Zookeeper è un aggiornamento minore e può essere eseguito insieme a Cassandra. Per eseguire l'upgrade sia di Cassandra che di Zookeeper tramite un singolo comando sui nodi in cui sono collocati, utilizza il comando seguente. Ti consigliamo di eseguire questa operazione solo se stai già eseguendo Zookeeper versione 3.8.3 in Private Cloud versione 4.52.01:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

Passaggio 3: esegui l'upgrade di tutti i nodi di gestione

Esegui l'upgrade di tutti i nodi di gestione in tutte le regioni uno alla volta:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Stato runtime	Stato gestione
Runtime completamente funzionale	Le prestazioni dell'API di gestione sono ridotte: La funzionalità SmartDocs del portale per sviluppatori di Drupal 7 non mostra dati

(Facoltativo) Passaggio 3a: importa gli SmartDocs esportati in precedenza

Una volta eseguito l'upgrade di tutti i server di gestione, puoi importare i modelli SmartDocs che hai esportato nel passaggio 1. Puoi anche decidere di eseguire questa operazione in un secondo momento.

Stato runtime	Stato gestione
Runtime completamente funzionale	Gestione completamente funzionale

Passaggio 4: esegui l'upgrade di tutti i nodi di runtime

Esegui l'upgrade di tutti i router e i nodi del processore di messaggi in tutte le regioni uno alla volta:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Stato runtime	Stato gestione
Runtime completamente funzionale	Gestione completamente funzionale

Passaggio 5: esegui l'upgrade di tutti i componenti Edge for Private Cloud 4.52.02 rimanenti

Esegui l'upgrade di tutti i nodi edge-qpid-server e edge-postgres-server rimanenti in tutte le regioni uno alla volta.

In questa fase, se esegui l'upgrade da versioni precedenti a Edge per il cloud privato 4.52.01 e stai seguendo passaggi aggiuntivi per l'upgrade di Qpid o Postgres, segui i rispettivi passaggi per eseguire l'upgrade.

Stato runtime	Stato gestione
Runtime completamente funzionale	Gestione completamente funzionale

Passaggio 6: passaggi successivi all'upgrade

Esegui il comando seguente su ciascun nodo Cassandra uno alla volta al termine dell'upgrade:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Esegui questo comando per eliminare le tabelle meno recenti inutilizzate dal cluster Cassandra. Finché non verrà eseguita, non potrai utilizzare alcune funzionalità di Cassandra (ad esempio, configurare una nuova autenticazione, i vecchi meccanismi di autenticazione continueranno a funzionare). Questo comando può essere eseguito solo su un nodo nel cluster:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Se non l'hai ancora fatto, completa il passaggio 3a.

Stato runtime	Stato gestione
Runtime completamente funzionale	Gestione completamente funzionale

Upgrade richiesto a Zookeeper 3.8.3

Anche se Edge per Private Cloud 4.52.02 non include un aggiornamento a Zookeeper, se esegui l'upgrade da versioni precedenti alla 4.52.01, devi seguire i passaggi per eseguire l'upgrade di Zookeeper.

Se esegui l'upgrade da Edge per il cloud privato versioni 4.51.00 o 4.52.00, fai riferimento ai passaggi descritti in Aggiornamento necessario a Zookeeper 3.8.3 per eseguire l'upgrade di Zookeeper.
Se stai eseguendo l'upgrade da Edge per il cloud privato versione 4.52.01, dovresti già utilizzare Zookeeper versione 3.8.3 e non devi seguire alcun passaggio speciale per l'upgrade di Zookeeper.

Upgrade richiesto a Postgres 14

Se esegui l'upgrade da Edge per il cloud privato da 4.51.00 a 4.52.02, devi seguire i passaggi per eseguire l'upgrade di Postgres, anche se Edge per Private Cloud 4.52.02 non include un upgrade di Postgres. L'aggiornamento da Edge per Private Cloud 4.51.00 a 4.52.02 richiede ulteriori passaggi di upgrade di Postgres. Consulta la sezione Upgrade obbligatorio a Postgres 14.
Se esegui l'upgrade da Edge per il cloud privato 4.52.00 o da 4.52.01 a 4.52.02, non sono necessari ulteriori passaggi di upgrade di Postgres.

Upgrade richiesto a Qpid J-Broker

Anche se Edge per il cloud privato 4.52.02 non include un upgrade a QPID, se esegui l'upgrade da versioni precedenti alla 4.52.01, devi seguire i passaggi per eseguire l'upgrade di QPID.

Se si esegue l'upgrade da Edge per Private Cloud 4.51.00 o 4.52.00 a 4.52.02, è necessario seguire ulteriori passaggi di upgrade di QPID. Consulta la sezione Upgrade Qpid se stai eseguendo l'upgrade dalla versione 4.51.00 o 4.52.00 alla 4.52.02.
Se si esegue l'upgrade da Edge per il cloud privato 4.52.01 a 4.52.02, dovresti già utilizzare l'ultima versione del broker Qpid e non sono necessari ulteriori passaggi di aggiornamento di QPID.

Nuova UI Edge

Questa sezione elenca le considerazioni relative alla UI Edge. Per maggiori informazioni, consulta La nuova UI perimetrale per il 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 per il cloud privato.

Tieni presente che la UI Edge richiede la disattivazione dell'autenticazione di base e l'utilizzo di un IdP come SAML o LDAP.

Per ulteriori informazioni, vedi Installare la nuova UI Edge.

Aggiorna la UI Edge

Per aggiornare il componente UI Edge, considera la versione di Edge per il cloud privato da cui esegui l'upgrade:

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

Aggiorna con Apigee mTLS

Per aggiornare Apigee mTLS , svolgi i seguenti passaggi:

Rollback di un aggiornamento in corso...

In caso di errore di un aggiornamento, puoi provare a risolvere il problema e a eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e continuarlo dal punto in cui era stato interrotto.

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

Informazioni sull'aggiornamento di 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, scrive il log nella directory /tmp sotto forma di file denominato update_username.log.

Se questa persona non ha accesso a /tmp, l'utilità update.sh non riesce.

Aggiornamento senza tempi di inattività

Un aggiornamento senza tempo di inattività, o aggiornamento in sequenza, consente di aggiornare l'installazione di Edge senza disattivare Edge.

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

La chiave per eseguire 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, quindi aggiungi di nuovo il router al bilanciatore del carico.

Aggiorna le macchine nell'ordine corretto per l'installazione come descritto Ordine di aggiornamento della macchina.
Al momento dell'aggiornamento dei router, seleziona un router qualsiasi e rendilo irraggiungibile, come descritto in Attivare/disattivare la connettività 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 gli altri router.
Continua l'aggiornamento per eventuali macchine rimanenti nell'installazione.

Prima e dopo l'aggiornamento, prendi in considerazione quanto segue:

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

Utilizza un file di configurazione invisibile

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

Aggiorna alla versione 4.52.02 su un nodo con una connessione a internet esterna

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

Se presente, disabilita tutti i job cron configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
Accedi al tuo nodo come root per installare gli RPM perimetrali.
NOTA: anche se l'installazione di RPM richiede l'accesso root, puoi eseguire la configurazione Edge senza 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
```
Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
Se esegui l'installazione su Oracle 7.x, esegui questo comando:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Se esegui l'installazione 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 stai utilizzando Edge 4.51.00:
1. Scarica il file Edge bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Installa l'utilità e le dipendenze Edge 4.52.02 apigee-service eseguendo questo comando:
```
sudo bash /tmp/bootstrap_4.52.02.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 Java 1.8 sia installato. In caso contrario, sarà il programma di installazione a installarlo per te.
  
  Utilizza l'opzione JAVA_FIX per specificare come gestire l'installazione di Java. JAVA_FIX assume i seguenti valori:
  - I: installa OpenJDK 1.8 (impostazione predefinita).
  - C: continua senza installare Java.
  - Q: Esci. Per questa opzione, devi installare Java personalmente.
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 eseguendo questo 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 sono:
    - cs: Cassandra
    - edge: tutti i componenti Edge tranne 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 l'accesso SSO)
    - ue: nuova UI Edge
    - ui: UI classica Edge
    - zk: Custode dello zoo
  - configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione 4.50.00 o 4.51.00.
  Puoi eseguire update.sh su tutti i componenti impostando component su "tutti", ma solo se disponi di un profilo di installazione Edge all-in-one (AIO). Ad esempio:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Riavvia il componente UI Edge su tutti i nodi che lo eseguono, se non lo hai già fatto:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback della versione 4.52.02.

Aggiornamento alla versione 4.52.02 da un repository locale

Se i nodi Edge sono protetti da un firewall o in altri modi non possono accedere al repository Apigee su internet, puoi eseguire l'aggiornamento da un repository locale, o mirroring, 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 su 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 ti fornisce il server web Nginx oppure puoi utilizzare il tuo.

Per eseguire l'aggiornamento da un repository 4.52.02 locale:

Crea un repository 4.52.02 locale come descritto in "Creare un repository Apigee locale" in Installare l'utilità apigee-setup Edge.
NOTA: se hai già un repository esistente, puoi aggiungere il repository 4.52.02 come descritto in "Aggiornare un repository Apigee locale" in Installare l'utilità Edge apigee-setup.
Per installare apigee-service da un file .tar:
1. Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.52.02.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, annulla il caricamento del file nella directory /tmp:
```
tar -xzf apigee-4.52.02.tar.gz
```
  Questo comando crea una nuova directory, denominata repos, nella directory contenente il file .tar. Ad esempio /tmp/repos.
4. Installa l'utilità e le dipendenze Edge apigee-service da /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Nota che in questo comando viene incluso il percorso della directory dei repository.
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 Installare l'utilità Edge apigee-setup.
2. Sul nodo remoto, scarica il file Edge bootstrap_4.52.02.sh in /tmp/bootstrap_4.52.02.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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à e le dipendenze Edge apigee-setup:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  Dove uName:pWord sono il nome utente e la password del repository.
Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Esegui l'utilità update sui tuoi nodi nell'ordine descritto in Ordine di aggiornamento della macchina:
```
/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 tranne 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 l'accesso SSO)
  - ue Nuova UI Edge
  - ui: UI classica Edge
  - zk: Custode dello zoo
- configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione 4.50.00 o 4.51.00.
  NOTA: il file di configurazione deve essere leggibile dall'utente "apigee". Per modificare il proprietario, utilizza il seguente comando:
```
chown apigee:apigee configFile
```
Puoi eseguire update.sh su tutti i componenti impostando component su "tutti", ma solo se disponi di un profilo di installazione Edge all-in-one (AIO). Ad esempio:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```

Riavvia i componenti UI su tutti i nodi che li eseguono, se non lo hai già fatto:

/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback della versione 4.52.02.

Ordine di aggiornamento della macchina

L'ordine con cui aggiorni le macchine in un'installazione Edge è importante:

Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare altri nodi.
Per qualsiasi macchina con più componenti Edge (server di gestione, processore di messaggi, router, server QPID, ma non server Postgres), utilizza l'opzione -c edge per aggiornarli tutti contemporaneamente.
Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nell'ordine specificato per le macchine.
Non esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornata quando specifichi l'opzione -c edge.

Upgrade autonomo con un nodo

Per eseguire l'upgrade di una configurazione autonoma con un nodo alla versione 4.52.02:

Aggiorna tutti i componenti:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

(Se hai installato apigee-adminapi) Aggiornamento dell'utilità apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

Upgrade autonomo a 2 nodi

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

Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.

Aggiorna Cassandra e ZooKeeper sulla macchina 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Aggiorna Postgres sulla macchina 2:

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

Aggiorna LDAP sulla macchina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aggiorna i componenti Edge sulle macchine 2 e 1:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Aggiorna Qpid sulla macchina 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna l'interfaccia utente sulla macchina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Se hai installato Apigee SSO) Aggiorna Apigee SSO 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 l'accesso SSO.

Riavvia il componente UI Edge sulla macchina 1:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade a 5 nodi

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

Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.

Aggiorna Cassandra e ZooKeeper sulla macchina 1, 2 e 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Aggiorna Postgres sulla macchina 4:

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

Aggiorna Postgres sulla macchina 5:

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

Aggiorna LDAP sulla macchina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aggiorna i componenti Edge sulla macchina 4, 5, 1, 2, 3:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Aggiorna Qpid sulla macchina 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna Qpid sulla macchina 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna la UI Edge:
- UI classica: se utilizzi l'interfaccia utente 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 interfaccia utente di 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
```
(Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Se hai installato Apigee SSO) Aggiorna Apigee SSO 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 l'accesso SSO.
Riavvia il componente UI:
- UI classica: se utilizzi la 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 interfaccia utente di 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 in cluster a 9 nodi

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

Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.

Aggiorna Cassandra e ZooKeeper sulla macchina 1, 2 e 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Aggiorna Postgres sulla macchina 8:

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

Aggiorna Postgres sulla macchina 9:

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

Aggiorna LDAP sulla macchina 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aggiorna i componenti Edge sulla macchina 6, 7, 8, 9, 1, 4 e 5 in questo ordine:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Aggiorna Qpid sulle macchine 6 e 7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna la nuova UI (ue) o quella classica (ui) sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Se hai installato Apigee SSO) Aggiorna Apigee SSO 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 l'accesso SSO.
Riavvia il componente UI:
- UI classica: se utilizzi la 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 interfaccia utente di 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 in cluster a 13 nodi

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

Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.

Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Aggiorna Postgres sulla macchina 8:

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

Aggiorna Postgres sulla macchina 9:

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

Aggiorna LDAP sulle macchine 4 e 5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

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

Aggiorna Qpid sulle macchine 12 e 13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna la nuova UI (ue) o quella classica (ui) sulle macchine 6 e 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulle macchine 6 e 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Se hai installato Apigee SSO) Aggiorna Apigee SSO 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 l'accesso SSO.
Riavvia il componente UI:
- Interfaccia utente classica: se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulle macchine 6 e 7, come illustrato nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Nuova interfaccia utente 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 in cluster a 12 nodi

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

Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.

Aggiorna Cassandra e ZooKeeper:

Nelle macchine 1, 2 e 3 nel data center 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Sulle macchine 7, 8 e 9 nel data center 2

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

Aggiorna Postgres:

Macchina 6 nel data center 1

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

Macchina 12 nel data center 2

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

Aggiorna LDAP:

Macchina 1 nel data center 1

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Macchina 7 nel data center 2

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Aggiorna i componenti di Edge:

Macchine 4, 5, 6, 1, 2, 3 nel data center 1

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Macchine 10, 11, 12, 7, 8, 9 nel data center 2

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Aggiorna qpidd:

Macchine 4, 5 nel data center 1

Aggiorna qpidd sulla macchina 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna qpidd sulla macchina 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Macchine 10, 11 nel data center 2

Aggiorna qpidd sulla macchina 10:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna qpidd sulla macchina 11:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Aggiorna la nuova UI (ue) o quella classica (ui):

Macchina 1 nel data center 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

Macchina 7 nel data center 2:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(Se hai installato apigee-adminapi) È stata aggiornata l'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
```
(Se hai installato Apigee SSO) Aggiorna Apigee SSO:
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
```
Riavvia il nuovo componente Edge UI (edge-management-ui) o la versione classica di Edge (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 disponi di una configurazione non standard, aggiorna i componenti Edge nel seguente ordine:

ZooKeeper
Cassandra
ps
LDAP
Edge, ovvero il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, server Edge Postgres, server di gestione, 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".
qpidd
UI Edge (classica o nuova)
apigee-adminapi
SSO Apigee

Al termine dell'aggiornamento, assicurati di riavviare il componente Edge UI su tutte le macchine che lo eseguono.