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.

di Gemini Advanced. di Gemini Advanced. di Gemini Advanced.

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.

di Gemini Advanced.

Nota: lo strumento cassandra-cli non è più supportato in Cassandra 3.X e non è disponibile per l'uso.

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 dell'upgrade di Apigee cercherà il file nelle posizioni elencate sopra. Se il file non è presente in nessuna delle località elencate sopra, l'upgrade non riuscirà 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 viene trovato il file, ma le configurazioni fornite non sono corrette (ad esempio, le credenziali di Cassandra non sono corrette), l'upgrade non riuscirà e verrà generato un errore come il seguente:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
Analogamente, avvia il servizio Cassandra se viene arrestato 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, esegui un'esportazione di 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. Consulta Requisiti per le porte per ulteriori informazioni.

di Gemini Advanced.

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 codice 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.

di Gemini Advanced.

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 ulteriori informazioni, vedi 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 disabilitazione dell'autenticazione di base e l'utilizzo di un IDP, ad esempio 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 che stanno eseguendo l'upgrade da:

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

Aggiorna con Apigee mTLS

Per aggiornare Apigee mTLS , procedi nel seguente modo passaggi:

Rollback di un aggiornamento in corso...

In caso di errore di un aggiornamento, puoi provare a risolvere il problema e quindi eseguire update.sh di nuovo. Puoi eseguire l'aggiornamento più volte e continuerà a farlo da dove l'aveva interrotto.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta Esegui 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 quella directory, scrive il log nella directory /tmp come file denominato update_username.log.

Se la 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, ti consente di aggiornare l'installazione di Edge senza abbattendo 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 dal carico ogni router, uno alla volta. con il bilanciatore del carico di rete passthrough esterno regionale. 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 i computer nell'ordine corretto per l'installazione come descritto Ordine di aggiornamento della macchina.
Quando è il momento di aggiornare i router, selezionare un router qualsiasi e renderlo irraggiungibile, come descritta in Attivazione/disattivazione 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, procedi nel seguente modo:
  1. Rendi raggiungibile il processore di messaggi.
  2. Rendi il router raggiungibile.
Su nodi singoli del 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 dovrebbe essere lo stesso usato per installare Edge 4.50.00 o 4.51.00.

Aggiorna a 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, disattiva 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, è possibile eseguire la configurazione perimetrale senza accesso root.
Installa yum-utils e yum-plugin-priorities:
Nota: se il sistema operativo è RHEL 8.0-8.6, ignora questo passaggio.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Disabilita SELinux come descritto in Installare l'utilità apigee-setup di Edge.
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 questo comando: 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, che lo installa per te.
  
  Utilizza l'opzione JAVA_FIX per specificare come gestire 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. Usa apigee-service per aggiornare l'utilità apigee-setup, come nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Aggiorna l'utilità apigee-validate sul server di gestione nel seguente modo: un esempio mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Aggiorna l'utilità apigee-provision sul server di gestione nel seguente modo: un esempio mostra:
```
/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 nella sezione Ordine di macchine aggiornamento.
  
  Dove:
  - component è il componente Edge da aggiornare. I valori possibili sono:
    - cs: Cassandra
    - edge: tutti i componenti Edge tranne UI Edge: server di gestione, messaggio Processore, 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 utilizzavi in precedenza definisci il tuo perimetro durante l'installazione 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 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 in Gestione come descritto in Testare l'installazione.

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

Aggiornamento alla versione 4.52.02 da un repository locale

Se i nodi Edge sono protetti da un firewall o in qualche altro modo non possono accedere il repository Apigee su internet, quindi 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, copialo su un nodo, quindi aggiorna Edge .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 server web.

Per eseguire l'aggiornamento da un repository 4.52.02 locale:

Creare un repository 4.52.02 locale come descritto in "Creare un repository Apigee locale" alle Installa l'utilità apigee-setup Edge.
NOTA: se hai già un repository, può aggiungere il repository 4.52.02 come descritto in "Aggiornare un repository Apigee locale" alle Installa l'utilità apigee-setup Edge.
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 unico 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 in nella directory /tmp sul nuovo nodo.
3. Sul nuovo nodo, esegui il detar 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 "Eseguire l'installazione dal repository utilizzando server web" alla pagina Installare Edge Utilità apigee-setup.
2. Sul nodo remoto, scarica il file Edge bootstrap_4.52.02.sh su /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 che hai impostato in precedenza per dal repository, mentre remoteRepo è l'indirizzo IP o il nome DNS del nodo 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.
Usa apigee-service per aggiornare l'utilità apigee-setup, come nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Aggiorna l'utilità apigee-validate sul server di gestione nel seguente modo: un esempio mostra:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Aggiorna l'utilità apigee-provision sul server di gestione nel seguente modo: un esempio mostra:
```
/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: Apigee SSO (se hai installato l'accesso SSO)
  - ue Nuova UI Edge
  - ui: UI perimetrale classica
  - zk: Custode dello zoo
- configFile è lo stesso file di configurazione che utilizzavi in precedenza definire i componenti Edge durante l'installazione 4.50.00 o 4.51.00.
  NOTA: il file di configurazione deve essere leggibile dal "apigee" utente. 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 Edge all-in-one (AIO). Ad esempio:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
Riavvia i componenti dell'interfaccia utente 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 in Gestione come descritto in Testare l'installazione.

Se in un secondo momento decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Esegui il rollback 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 qualsiasi ad altri nodi.
Per qualsiasi macchina con più componenti Edge (server di gestione, processore di messaggi, router QPID, ma non server Postgres), utilizza l'opzione -c edge per aggiornare tutti contemporaneamente.
Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nella all'ordine della macchina specificato.
Non esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornata quando specifichi Opzione -c edge.

di Gemini Advanced.

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 sul computer 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 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 sul computer 1:

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

Aggiorna i componenti di 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:
- Interfaccia utente classica: se utilizzi quella classica, aggiorna il 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 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 installato l'accesso SSO.
Riavvia il componente UI:
- Interfaccia utente classica: se utilizzi quella classica, riavvia il 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 edge-management-ui sul computer appropriato (potrebbe non essere 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 sul computer 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 installato l'accesso SSO.
Riavvia il componente UI:
- Interfaccia utente classica: se utilizzi quella classica, riavvia il 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 edge-management-ui sul computer appropriato (potrebbe non essere 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 sui computer 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) su macchine 6 e 07:
```
/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 installato l'accesso SSO.
Riavvia il componente UI:
- Interfaccia utente classica: se utilizzi quella classica, riavvia il 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 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 in Data Center 1

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

Macchine 10, 11, 12, 7, 8, 9 in 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 sul computer 4:

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

Aggiorna qpidd sul computer 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) Aggiornamento dell'utilità apigee-adminapi:

Macchina 1 nel data center 1:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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 la nuova UI Edge (edge-management-ui) o la UI 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 "-c edge" profilo su tutti i nodi nell'ordine: nodi con server Qpid, Server Edge Postgres, server di gestione, processore di messaggi e router.
NOTA: se un nodo ha sia il server Qpid sia Edge Postgres Server installato, esegui "-c edge" del profilo.
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 in esecuzione li annotino.