Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiornamento Apigee Edge da 4.50.00 o da 4.51.00 a 4.52.00

Apigee supporta l'upgrade di Edge per il cloud privato dalla versione 4.50.00 o versione 4.51.00 direttamente Versione 4.52.00. In questa pagina viene descritto come eseguire entrambi gli upgrade.

Chi può eseguire l'aggiornamento

La persona che esegue l'aggiornamento deve essere la stessa che ha installato inizialmente Edge, oppure un una 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 da 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 motivi. 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 funzionino correttamente. Per ulteriori informazioni sul backup, vedi Backup e Ripristina.
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 compensazione di Cassandra sia LeveledCompactionStrategy
Assicurati che la strategia di compensazione di Cassandra sia impostata su LeveledCompactionStrategy, come descritto in Modifica il Strategia di compattazione di Cassandra.

Propagazione automatica delle impostazioni delle proprietà

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

Upgrade richiesto a Zookeeper 3.8.0

Questa versione di Edge per i cloud privati include un aggiornamento a Zookeeper 3.8.0. Nell'ambito di con l'aggiornamento, tutti i dati di Zookeeper verranno migrati a Zookeeper 3.8.0.

Prima di eseguire l'upgrade di Zookeeper, leggi attentamente Zookeeper guida alla manutenzione. La maggior parte dei sistemi di produzione Edge utilizza un cluster di nodi Zookeeper in più data center. Alcuni di questi nodi sono configurati come elettori che partecipano durante l'elezione dei leader di Zookeeper, mentre il resto è configurato come osservatore. Vedi Informazioni su leader, follower, elettori e osservatori per maggiori dettagli. I nodi degli elettori eleggono un leader dopo il quale i nodi degli elettori stessi diventano follower.

Durante il processo di aggiornamento, potrebbe verificarsi un ritardo temporaneo o un errore di scrittura in Zookeeper quando il nodo leader viene arrestato. Ciò potrebbe influire sulle operazioni di gestione che scrivono Zookeeper, ad esempio 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 sul runtime API di Apigee (a meno che queste API runtime richiamano le API di gestione) durante l'upgrade di Zookeeper seguendo la procedura descritta di seguito.

A livello generale, il processo di upgrade prevede l'esecuzione di un backup di ciascun nodo. Seguiti eseguendo l'upgrade di tutti gli osservatori e i follower e, infine, eseguendo l'upgrade del nodo leader.

Esegui un backup

Esegui un backup di tutti i nodi di Zookeeper per utilizzarli nel caso in cui sia necessario un rollback. Tieni presente che un rollback ripristinerà Zookeeper allo stato in cui è stato eseguito il backup. Nota: Qualsiasi deployment modifiche all'infrastruttura di Apigee dall'esecuzione del backup (le cui informazioni sono Zookeeper) andranno persi durante il ripristino.

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

Se utilizzi macchine virtuali e disponi della funzionalità, anche gli snapshot o i 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 la classe utilità nc per inviare dati a Zookeeper. Potresti usare utilità alternative per inviare dati a Zookeeper.

Se non è installato sul nodo ZooKeeper, installa nc:
```
  sudo yum install nc
```
Esegui il seguente comando nc sul nodo, dove 2181 è la porta di 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 osservatore, leader o follower (ovvero un elettore non leader) a seconda della configurazione del nodo. Nota: in un'installazione autonoma di Edge con un singolo nodo ZooKeeper, Mode sia impostata come autonoma.
Ripeti i passaggi 1 e 2 su ciascun nodo ZooKeeper.

Esegui l'upgrade di Zookeeper sui nodi osservatore e follower

Esegui l'upgrade di Zookeeper su ciascun nodo osservatore e follower nel seguente modo:

Scarica ed esegui il bootstrap di Edge per il cloud privato 4.52, come descritto in Esegui l'aggiornamento alla versione 4.52.00 su un nodo con una connessione a internet esterna. Il processo probabilmente variano a seconda che il nodo disponga di una connessione Internet esterna o stai 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 in questi nodi sono installati altri componenti (ad esempio Cassandra), potresti eseguire l'upgrade (ad esempio con il profilo cs,zk) oppure puoi eseguire l'upgrade degli altri componenti in un secondo momento. Apigee consiglia di eseguire prima l'upgrade di Zookeeper e di assicurarsi che il cluster funzioni correttamente prima di eseguire l'upgrade di altri componenti.
Ripeti i passaggi precedenti su ciascun nodo osservatore e follower di Zookeeper.

Chiude il leader

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

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

Tieni presente che durante l'evento, prima che venga eletto un nuovo leader, potrebbero verificarsi ritardi temporanei errori di scrittura in Zookeeper. Questo 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 dei processori di messaggi ecc.

Verifica che venga eletto il nuovo leader

Utilizzando i passaggi in Identifica leader, follower e osservatori precedente, verifica che sia stato eletto un nuovo leader follower, una volta interrotto il leader esistente. Tieni presente che il leader potrebbe essere stato eletto diverso rispetto all'attuale leader.

Upgrade leader

Segui gli stessi passaggi indicati in È stato eseguito l'upgrade di Zookeeper sui nodi osservatore e follower sopra.

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

Esegui il rollback

Nel caso in cui sia necessario un rollback:

Per prima cosa, esegui i passaggi di rollback su osservatori e follower.
Scarica ed esegui il bootstrap della versione a cui stai eseguendo il rollback, 4.50 o 4.51. Probabilmente il processo varierà a seconda che il nodo disponga o meno di una connessione a internet esterna o stai 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 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 un nodo leader nel cluster.

Ripristina backup

Fai riferimento a Ripristinare da un backup. Tieni presente che i backup di Zookeeper presi da versioni precedenti di Edge per Private Cloud come 4.50 e 4.51 dovrebbero essere compatibile con la versione di Zookeeper in Edge per Private Cloud 4.52.

Upgrade richiesto a Postgres 14

Questa release di Edge include un upgrade a Postgres 14. Nell'ambito di questo upgrade, Viene eseguita la migrazione dei dati Postgres in Postgres 14.

La maggior parte dei sistemi di produzione perimetrale utilizza due nodi Postgres configurati per la replica in standby del master. Durante il processo di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi restano nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono di nuovo online, i dati di analisi viene quindi eseguito il push ai nodi Postgres.

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

Se utilizzi l'archiviazione locale dei dati per i nodi Postgres, devi installare un nuovo nodo in standby Postgres per la durata dell'upgrade. Dopo il l'upgrade è stato completato, puoi ritirare il nuovo nodo standby Postgres.
Se devi eseguire il rollback dell'aggiornamento, è necessario un nodo in standby Postgres aggiuntivo per qualsiasi motivo. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo in standby Postgres diventa il nodo Postgres master dopo il rollback. Pertanto, quando installi nuovo nodo di standby Postgres, deve trovarsi su un nodo che soddisfa tutti i requisiti di un server Postgres, come definiti Requisiti di installazione.

In una configurazione a 1 e 2 nodi di Edge, le topologie utilizzate per la prototipazione e il test, hanno un solo nodo Postgres. Puoi aggiornare questi nodi Postgres direttamente senza dover per creare un nuovo nodo Postgres.
Se utilizzi lo spazio di archiviazione di rete per i nodi Postgres, consigliato da Apigee, non è necessario installare un nuovo nodo Postgres. Nella di seguito, puoi saltare i passaggi che specificano di installare e poi ritirare Nodo in standby Postgres.
Prima di iniziare il processo di aggiornamento, acquisisci uno snapshot di rete del datastore utilizzato Postgres. Se poi si verificano errori durante l'aggiornamento e sei costretto a eseguire un rollback, puoi ripristinare il nodo Postgres da questo snapshot.

Installazione di un nuovo Postgres nodo in standby

Questa procedura crea un server in standby Postgres su un nuovo nodo. Assicurati di installare un nuovo Server di standby Postgres per la tua 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 corrente di Edge.

Per creare un nuovo nodo in standby di Postgres:

Nel master Postgres attuale, modifica /opt/apigee/customer/application/postgresql.properties per impostare il seguente token. 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 dell'attuale Postgres server in standby e new_standby_ip è l'indirizzo IP del nuovo nodo in standby.

Riavvia apigee-postgresql nel master Postgres:

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

Verifica che il nuovo nodo in standby sia stato aggiunto visualizzando la /opt/apigee/apigee-postgresql/conf/pg_hba.conf file nel master. Dovresti vedere le seguenti righe del 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 che hai utilizzato per installare la versione corrente di Edge per specificare le seguenti:
```
# 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. Disabilita SELinux come descritto in Installa l'utilità apigee-setup Edge.
3. Se stai utilizzando Edge 4.51.00:
  1. Scarica il file Edge bootstrap_4.51.00.sh 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à e le dipendenze Edge apigee-service:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Se stai utilizzando Edge 4.50.00:
  1. Scarica il file Edge bootstrap_4.50.00.sh 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à e le dipendenze Edge apigee-service:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Usa 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 in 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: devi eseguire il seguente passaggio preliminare prima eseguendo un upgrade 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.

Passaggio preliminare

Prima di eseguire un upgrade in loco a Postgres, segui questi passaggi sia sulla host e standby, per aggiornare 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

di Gemini Advanced.

Esegui l'upgrade in loco

Per eseguire un upgrade in loco a Postgres 14:

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

Interrompi la modalità standby:
```
apigee-service apigee-postgresql stop
```
Aggiorna lo standby.
Nota:se questo passaggio restituisce un errore o non va a buon fine, puoi ignorarlo. update.sh tenterà per avviare il server standby con una configurazione errata. Postgres è stato eseguito l'upgrade alla versione 14, l'errore può essere ignorato.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Assicurati che la modalità standby sia interrotta:
```
apigee-service apigee-postgresql stop
```

Rimuovi la vecchia configurazione 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 da il file /opt/apigee/customer/application/postgresql.properties su entrambi l'host master e lo standby. Questa riga era aggiunto nel passaggio preliminare.

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

Ritiro di un nodo Postgres

Al termine dell'aggiornamento, dismetti il nuovo nodo in 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

Esegui il seguente comando curl sul nuovo nodo in standby per ottenere l'UUID nodo in 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 in standby eseguendo il comando seguente sul nuovo nodo in 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 in standby sia stato rimosso visualizzando la /opt/apigee/apigee-postgresql/conf/pg_hba.conf file nel master. Dovresti vedere solo la seguente riga del file:
```
host replication apigee existing_standby_ip/32 trust
```
Elimina l'UUID del nodo in standby da ZooKeeper eseguendo la seguente gestione perimetrale Chiamata API 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 importante upgrade di Postgres, le statistiche interne di Postgres sono state cancellate. Queste statistiche aiutano lo strumento di pianificazione delle query di Postgres a utilizzare gli indici e i percorsi più ottimali per l'esecuzione delle query.

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

Per risolvere questo problema, esegui ANALYZE su tutte le tabelle del database sul nodo Postgres master. In alternativa, puoi eseguire ANALYZE per alcune tabelle alla volta.

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

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, 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 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 della 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.00 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.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à e le dipendenze Edge 4.52.00 apigee-service 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 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.00.

Aggiornamento alla versione 4.52.00 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.00 locale:
1. Creare un repository 4.52.00 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.00 come descritto in "Aggiornare un repository Apigee locale" alle Installa l'utilità apigee-setup Edge.
2. 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.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 in nella directory /tmp sul nuovo nodo.
  3. Sul nuovo nodo, esegui il detar del 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à e le dipendenze Edge apigee-service da /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Nota che in questo comando viene incluso 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 "Eseguire l'installazione dal repository utilizzando webserver" alla pagina Installare Edge Utilità apigee-setup.
  2. Sul nodo remoto, scarica il file Edge bootstrap_4.52.00.sh su /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 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.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Dove uName:pWord sono il nome utente e la password del repository.
4. Usa apigee-service per aggiornare l'utilità apigee-setup, come nell'esempio seguente:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. 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
```
6. 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
```
7. 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 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
```
8. 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
```
9. 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.00.

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.
NOTA: dopo aver aggiornato il componente UI Edge, devi riavviare il servizio UI Edge, come descritto nelle istruzioni di installazione dell'aggiornamento.

Upgrade autonomo con un nodo

Per eseguire l'upgrade di una configurazione autonoma con un 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 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.
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 sul computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Aggiorna i componenti Edge sulle macchine 2 e 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Aggiorna l'interfaccia utente sulla macchina 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (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.
8. 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.
1. Aggiorna Cassandra e ZooKeeper sulla macchina 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 sul computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Aggiorna i componenti di Edge sulla macchina 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. 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
```
7. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (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.
9. 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.
1. Aggiorna Cassandra e ZooKeeper sulla macchina 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 sul computer 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. 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
```
7. Aggiorna la nuova UI (ue) o quella 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 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.
10. 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.
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 sui computer 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 quella classica (ui) su macchine 6 e 07:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (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
```
9. (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.
10. 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.
1. Aggiorna Cassandra e ZooKeeper:
  1. Nelle 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 sul computer 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
    2. Aggiorna qpidd sul computer 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 di Edge:
  1. Macchine 4, 5, 6, 1, 2, 3 in Data Center 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Macchine 10, 11, 12, 7, 8, 9 in data center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Aggiorna la nuova UI (ue) o quella 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 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
```
9. 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:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. 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.
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 in esecuzione li annotino.