Aggiornamento Apigee Edge da 4.50.00 o da 4.51.00 a 4.52.00

Apigee supporta l'upgrade di Edge per Cloud privato dalla versione 4.50.00 o dalla versione 4.51.00 direttamente alla 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 in origine Edge o una persona che esegue l'aggiornamento come root.

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

Quali componenti devi aggiornare

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

Aggiorna prerequisiti

Assicurati dei prerequisiti seguenti prima di eseguire l'upgrade di Apigee Edge:

• Esegui il backup di tutti i nodi
  Prima dell'aggiornamento, ti consigliamo di eseguire un backup completo di tutti i nodi per motivi di sicurezza. Usa la procedura relativa alla versione corrente di Edge per eseguire il backup.

  In questo modo puoi avere un piano di backup nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per maggiori informazioni sul backup, consulta Backup e ripristino.

• Assicurati che Edge sia in esecuzione
  Assicurati che Edge sia in esecuzione durante il processo di aggiornamento utilizzando il comando:

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

• Assicurati che la strategia di compatibilità di Cassandra sia LeveledCompactionStrategy
  Assicurati che la strategia di compatibilità Cassandra sia impostata su LeveledCompactionStrategy, come descritto in Modificare la strategia di compattazione di Cassandra.

Propagazione automatica delle impostazioni delle proprietà

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

Upgrade richiesto a Zookeeper 3.8.0

Questa release di Edge per cloud privati include un aggiornamento a Zookeeper 3.8.0. Nell'ambito di questo upgrade, verrà eseguita la migrazione di tutti i dati di Zookeeper a Zookeeper 3.8.0.

Prima di eseguire l'upgrade di Zookeeper, leggi la guida alla manutenzione di Zookeeper. La maggior parte dei sistemi di produzione perimetrale utilizza un cluster di nodi Zookeeper distribuiti in più data center. Alcuni di questi nodi sono configurati come elettori che partecipano alle elezioni dei leader di Zookeeper, mentre gli altri sono configurati come osservatori. Per maggiori dettagli, consulta la sezione Informazioni su leader, follower, elettori e osservatori. I nodi elettori elettono un leader, dopodiché i nodi 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 in Zookeeper, ad esempio le operazioni di deployment di un proxy, e le modifiche all'infrastruttura Apigee come l'aggiunta o la rimozione di un processore di messaggi e così via. Non dovrebbe esserci alcun impatto sulle API di runtime di Apigee (a meno che queste API di runtime chiamino le API di gestione) durante l'upgrade di Zookeeper seguendo la procedura riportata di seguito.

A livello generale, il processo di upgrade prevede l'esecuzione di un backup di ogni nodo. A questo punto, viene eseguito l'upgrade di tutti gli osservatori e i follower e infine l'upgrade del nodo leader.

Esegui un backup

Esegui un backup di tutti i nodi di Zookeeper 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: eventuali modifiche ai deployment o all'infrastruttura in Apigee dopo l'esecuzione del backup (le cui informazioni sono archiviate in Zookeeper) andranno perse durante il ripristino.

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

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

Identifica leader, follower e osservatori

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

1. Se non è installato sul nodo ZooKeeper, installa nc:

     sudo yum install nc

2. Esegui questo 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 dei nodi, dovresti vedere un osservatore, un leader o un follower (ovvero un elettore che non è il leader) a seconda della configurazione del nodo. Nota: in un'installazione autonoma di Edge con un singolo nodo ZooKeeper, Mode è impostato su autonomo.

3. Ripeti i passaggi 1 e 2 su ciascun nodo ZooKeeper.

Aggiorna Zookeeper sui nodi osservatore e follower

Aggiorna Zookeeper su ciascuno dei nodi osservatore e follower come segue:

1. Scarica ed esegui il bootstrap di Edge per Private Cloud 4.52, come descritto nella sezione relativa all' aggiornamento alla versione 4.52.00 su un nodo con una connessione a internet esterna. Il processo probabilmente varierà a seconda che il nodo disponga di una connessione a internet esterna o che tu stia eseguendo un'installazione offline.
2. Aggiorna il componente Zookeeper:

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

   Nota: se in questi nodi sono installati altri componenti (come Cassandra), puoi eseguirne l'upgrade ora (come 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 assicurarti che il cluster funzioni correttamente prima di eseguire l'upgrade di altri componenti.
3. Ripeti i passaggi precedenti su ciascun nodo osservatore e follower di Zookeeper.

Arresta la variante principale

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

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

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

Verificare che venga eletto il nuovo leader

Utilizzando i passaggi descritti nella sezione Identificare il leader, i follower e gli osservatori in alto, verifica che, una volta fermo quello esistente, sia stato eletto un nuovo leader tra i follower. Tieni presente che il leader potrebbe essere stato eletto in un data center diverso rispetto all'attuale leader.

Esegui l'upgrade leader

Segui gli stessi passaggi descritti in Upgrade di Zookeeper sui nodi osservatore e follower qui sopra.

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

Esegui il rollback

Nel caso in cui sia necessario un rollback:

1. Esegui prima i passaggi di rollback su osservatori e follower.
2. Scarica ed esegui il bootstrap della versione a cui stai eseguendo il rollback: 4.50 o 4.51. Il processo probabilmente varierà a seconda che il nodo abbia una connessione a internet esterna o che tu stia eseguendo l'installazione offline.
3. Arresta Zookeeper se è in esecuzione sul nodo:

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

4. Disinstalla zookeeper esistente:

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

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

Ripristina backup

Vedi Ripristinare da un backup. Tieni presente che i backup di Zookeeper acquisiti da versioni precedenti di Edge per Cloud privato come 4.50 e 4.51 devono essere compatibili con la versione di Zookeeper in Edge per Cloud privato 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 di tutti i dati di Postgres a Postgres 14.

La maggior parte dei sistemi di produzione Edge 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 vengono comunque scritti nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono di nuovo online, i dati di analisi vengono inviati ai nodi Postgres.

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

• Se utilizzi l'archiviazione dati locale per i nodi Postgres, devi installare un nuovo nodo in standby Postgres per la durata dell'upgrade. Al termine dell'upgrade, puoi ritirare il nuovo nodo in standby Postgres.

  Il nodo standby Postgres aggiuntivo è necessario se per qualsiasi motivo devi eseguire il rollback dell'aggiornamento. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo standby Postgres diventa il nodo Postgres master dopo il rollback. Di conseguenza, quando installi il nuovo nodo in standby Postgres, questo deve trovarsi su un nodo che soddisfa tutti i requisiti hardware di un server Postgres, come definito nei requisiti di installazione Edge.

  In una configurazione a 1 e 2 nodi di Edge, topologie utilizzate per la prototipazione e il test, hai un solo nodo Postgres. Puoi aggiornare questi nodi Postgres direttamente senza dover creare un nuovo nodo Postgres.

• Se utilizzi lo spazio di archiviazione di rete per i nodi Postgres, come consigliato da Apigee, non è necessario installare un nuovo nodo Postgres. Nelle procedure seguenti, puoi saltare i passaggi che specificano di installare e ritirare in un secondo momento un nuovo nodo in standby Postgres.

  Prima di iniziare il processo di aggiornamento, acquisisci un'istantanea di rete del datastore utilizzato da Postgres. In seguito, se si verificano errori durante l'aggiornamento e devi eseguire un rollback, puoi ripristinare il nodo Postgres da quello snapshot.

Installazione di un nuovo nodo in standby Postgres

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

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

Per creare un nuovo nodo Postgres in standby:

1. Nel master Postgres attuale, modifica il file /opt/apigee/customer/application/postgresql.properties per impostare il token seguente. Se il file non esiste, crealo:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   Dove existing_standby_ip è l'indirizzo IP del server in standby Postgres attuale e new_standby_ip è l'indirizzo IP del nuovo nodo in standby.

2. Riavvia apigee-postgresql sul master Postgres:

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

3. Verifica che il nuovo nodo in standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Nel file dovresti vedere le seguenti righe:

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. Installa il nuovo server in standby Postgres:
   1. Modifica il file di configurazione che hai utilizzato per installare la versione attuale di Edge per specificare quanto segue:

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. Disabilita SELinux come descritto in Installare l'utilità apigee-setup di Edge.

   3. Se attualmente utilizzi 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 di Edge apigee-service:

         sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      Se attualmente utilizzi 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 di 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 si tratti di standby.

Esecuzione di un upgrade in loco di Postgres

Passaggio preliminare

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

1. Se non è presente, crea il file /opt/apigee/customer/application/postgresql.properties.
2. Cambia la proprietà di questo file in apigee:

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

3. Aggiungi la seguente proprietà al file:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. Configura apigee-postgresql:

   apigee-service apigee-postgresql configure

5. Riavvia apigee-postgresql:

   apigee-service apigee-postgresql restart

Esegui l'upgrade in loco

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

1. Esegui l'upgrade di Postgres sull'host master

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

2. Esegui il comando di configurazione sull'host master:

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

3. Esegui il comando di configurazione sull'host master:

   apigee-service apigee-postgresql configure

4. Riavvia l'host principale:

   apigee-service apigee-postgresql restart

5. Configuralo come master:

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

6. Assicurati che l'host master sia stato avviato:

   apigee-service apigee-postgresql wait_for_ready

7. Interrompi la modalità standby:

   apigee-service apigee-postgresql stop

8. Esegui l'upgrade della modalità standby.

   Nota:se questo passaggio presenta errori o errori, può essere ignorato. update.sh proverà ad avviare il server di standby con una configurazione errata. Se viene eseguito l'upgrade dell'installazione di Postgres alla versione 14, l'errore può essere ignorato.

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

9. Assicurati che lo standby sia arrestato:

   apigee-service apigee-postgresql stop

10. Rimuovi la configurazione standby precedente:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. Configura la replica sul server in standby:

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

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

Una volta completata la procedura, lo standby verrà avviato correttamente.

Ritiro di un nodo Postgres

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

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

2. Recupera l'UUID del nuovo nodo in standby eseguendo il comando curl sul nuovo 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"

3. Arresta il nuovo nodo in standby eseguendo questo comando sul nuovo nodo in standby:

   /opt/apigee/apigee-service/bin/apigee-all stop

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

5. Riavvia apigee-postgresql sul master Postgres:

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

6. Verifica che il nuovo nodo in standby sia stato rimosso visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Nel file dovresti vedere solo la seguente riga:

   host replication apigee existing_standby_ip/32 trust

7. Elimina l'UUID del nodo in standby da ZooKeeper effettuando la seguente chiamata API di gestione perimetrale sul nodo del server di gestione:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

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 l'UI Edge

Dopo aver completato l'installazione iniziale, Apigee consiglia di installare l'UI Edge, ovvero un'interfaccia utente avanzata per gli sviluppatori e gli amministratori di Apigee Edge per il cloud privato.

Tieni presente che l'interfaccia utente perimetrale richiede la disattivazione dell'autenticazione di base e l'utilizzo di un IdP, ad esempio SAML o LDAP.

Per maggiori informazioni, vedi Installare la nuova UI Edge.

Aggiorna l'UI Edge

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

• Dalla versione 4.51.00 alla versione 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.

Aggiornamento con Apigee mTLS

Per aggiornare Apigee mTLS , segui questi passaggi:

• Disinstalla Apigee mTLS.
• Reinstalla Apigee mTLS.

Rollback di un aggiornamento

In caso di errore di aggiornamento, puoi provare a risolvere il problema ed eseguire di nuovo update.sh. Puoi eseguire l'aggiornamento più volte per riprenderlo dal punto in cui è 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 del logging

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

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

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

Se l'utente non ha accesso a /tmp, l'utilità update.sh non funziona.

Aggiornamento senza tempi di inattività

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

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

La chiave per l'upgrade senza tempo di inattività è la rimozione di ciascun router, uno alla volta, dal bilanciatore del carico. Aggiorna quindi il router e tutti gli altri componenti sulla stessa macchina del router, quindi aggiungi di nuovo il router al bilanciatore del carico.

1. Aggiorna le macchine nell'ordine corretto per l'installazione come descritto nell'ordine di aggiornamento delle macchine.
2. Quando è il momento di aggiornare i router, selezionane uno qualsiasi e rendilo irraggiungibile, come descritto in Attivare/disattivare la connettività del server (processore/router).
3. 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.
4. Rendi il router di nuovo raggiungibile.
5. Ripeti i passaggi da 2 a 4 per i router rimanenti.
6. Continua l'aggiornamento per le eventuali macchine rimanenti nell'installazione.

Prima e dopo l'aggiornamento, esegui le seguenti operazioni:

• 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. Rendere raggiungibile il processore di messaggi.
    2. Rendi raggiungibile il router.
• Su singoli nodi del router:
  • Prima dell'aggiornamento, imposta il router non raggiungibile.
  • Dopo l'aggiornamento, rendi il router raggiungibile.
• Su singoli nodi del processore di messaggi:
  • Prima dell'aggiornamento, rendi il processore di messaggi non raggiungibile.
  • Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.

Utilizza un file di configurazione invisibile all'utente

Devi passare un file di configurazione invisibile al comando update. Il file di configurazione invisibile deve essere lo stesso che hai utilizzato 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 procedura seguente per aggiornare i componenti Edge su un nodo:

1. Se presente, disabilita tutti i job cron configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
2. Accedi al nodo come root per installare gli RPM Edge.
3. Installa yum-utils e yum-plugin-priorities:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. Disabilita SELinux come descritto in Installare l'utilità apigee-setup di Edge.
5. Se esegui l'installazione su Oracle 7.x, esegui questo comando:

   sudo yum-config-manager --enable ol7_optional_latest

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

7. Se attualmente utilizzi Edge 4.51.00:

   1. Scarica il file di 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 apigee-service per Edge 4.52.00 eseguendo questo comando:

      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      Dove uName:pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.

      Per impostazione predefinita, il programma di installazione verifica che sia installato Java 1.8. In caso contrario, verrà installato automaticamente dal programma di installazione.

      Utilizza l'opzione JAVA_FIX per specificare come gestire l'installazione Java. JAVA_FIX accetta i seguenti valori:

      • I: installa OpenJDK 1.8 (impostazione predefinita).
      • C: continua senza installare Java.
      • Q: esci. Per questa opzione, devi installare Java autonomamente.
   3. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come illustrato nell'esempio seguente:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. Aggiorna l'utilità apigee-validate sul server di gestione, come illustrato nell'esempio seguente:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. Aggiorna l'utilità apigee-provision sul server di gestione, come illustrato 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 includono:
        • cs: Cassandra
        • edge: tutti i componenti Edge tranne UI perimetrale: server di gestione, processore di messaggi, router, server QPID, server Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO Apigee (se hai installato SSO)
        • ue: nuova UI Edge
        • ui: interfaccia utente classica di Edge
        • zk: guardiano dello zoo
      • configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione della versione 4.50.00 o 4.51.00.

      Puoi eseguire update.sh su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione Edge all-in-one (AIO). Ad esempio:

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

   7. Riavvia il componente della UI Edge su tutti i nodi in esecuzione, se non lo hai già fatto:

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

   8. Verifica 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 4.52.00.

   Aggiornamento alla versione 4.52.00 da un repository locale

   Se i nodi Edge sono protetti da un firewall o in altro modo 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 in un nodo e poi 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 da utilizzare oppure puoi utilizzare il tuo.

   Per eseguire l'aggiornamento da un repository 4.52.00 locale:

   1. Crea un repository locale 4.52.00 come descritto in "Creare un repository Apigee locale" in Installare l'utilità apigee-setup di Edge.
   2. Per installare apigee-service da un file .tar:
      1. Nel nodo con il repository locale, usa il comando seguente per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella directory /tmp del nuovo nodo.
      3. Sul nuovo nodo, annulla il tar 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

         Tieni presente che in questo comando includi il percorso della directory repos.

   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 il server web Nginx" in Installare l'utilità apigee-setup di Edge.
      2. Sul nodo remoto, scarica il file bootstrap_4.52.00.sh di Edge in /tmp/bootstrap_4.52.00.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

         Dove uName:pWord sono il nome utente e la password che hai impostato in precedenza per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo repository.

      3. Sul nodo remoto, installa l'utilità e le dipendenze apigee-setup Edge:

         sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         Dove uName:pWord sono il nome utente e la password del repository.

   4. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come illustrato nell'esempio seguente:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

   5. Aggiorna l'utilità apigee-validate sul server di gestione, come illustrato nell'esempio seguente:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   6. Aggiorna l'utilità apigee-provision sul server di gestione, come illustrato nell'esempio seguente:

      /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, devi aggiornare i seguenti componenti:
        • cs: Cassandra
        • edge: tutti i componenti Edge tranne UI perimetrale: server di gestione, processore di messaggi, router, server QPID, server Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO Apigee (se hai installato SSO)
        • ue Nuova UI Edge
        • ui: interfaccia utente classica di Edge
        • zk: guardiano dello zoo
      • configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione della versione 4.50.00 o 4.51.00.

      Puoi eseguire update.sh su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione 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 in esecuzione, se non lo hai già fatto:

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

   9. Verifica 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 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 altri nodi.
   • Per qualsiasi macchina con più componenti perimetrali (server di gestione, processore di messaggi, router, server QPID, ma non il 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 delle macchine specificato.
   • Non esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornata quando specifichi l'opzione -c edge.

   Upgrade autonomo con 1 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) È stata aggiornata l'utilità apigee-adminapi:

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

   Upgrade autonomo a due nodi

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

   Consulta Topologie di installazione per l'elenco delle topologie perimetrali e dei 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 sulla macchina 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 la UI 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 quando hai installato SSO.

   8. Riavvia il componente della UI Edge sulla macchina 1:

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

   Upgrade a 5 nodi

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

   Consulta Topologie di installazione per l'elenco delle topologie perimetrali e dei 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 e Postgres sulla macchina 4:

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

   3. Aggiorna Qpid e Postgres sulla macchina 5:

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

   4. Aggiorna LDAP sulla macchina 1:

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

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

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

   6. Aggiorna l'UI di Edge:
      • UI classica: se utilizzi l'interfaccia utente classica, aggiorna il componente ui sulla macchina 1, come illustrato nell'esempio seguente:

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

      • Nuova UI di Edge: se hai installato la nuova UI di Edge, aggiorna il componente ue sulla macchina appropriata (potrebbe non essere la macchina 1):

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

   7. (Se hai installato apigee-adminapi) È 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 quando hai installato SSO.

   9. Riavvia il componente dell'interfaccia utente:
      • Interfaccia utente classica: se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulla macchina 1, come illustrato nell'esempio seguente:

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

      • Nuova UI di Edge: se hai installato la nuova UI di 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 di nove nodi:

   Consulta Topologie di installazione per l'elenco delle topologie perimetrali e dei 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 6 e 7:

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

   3. Aggiorna Postgres sulla macchina 8:

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

   4. Aggiorna Postgres sulla macchina 9:

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

   5. Aggiorna LDAP sulla macchina 1:

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

   6. Aggiorna i componenti Edge 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 la UI classica (ui) sulla macchina 1:

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

   8. (Se hai installato apigee-adminapi) Aggiorna l'utilità apigee-adminapi sulla macchina 1:

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

   9. (Se hai installato 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 SSO.

   10. Riavvia il componente dell'interfaccia utente:
       • Interfaccia utente classica: se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulla macchina 1, come illustrato nell'esempio seguente:

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

       • Nuova UI di Edge: se hai installato la nuova UI di 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 delle topologie perimetrali e dei 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 sulle macchine 4 e 5:

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

   6. Aggiorna i componenti Edge sulle macchine 12, 13, 8, 9, 6, 7, 10 e 11 in questo ordine:

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

   7. Aggiorna la nuova UI (ue) o la UI classica (ui) sulle macchine 6 e 7:

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

   8. (Se hai installato apigee-adminapi) È 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 il servizio SSO di Apigee sulle macchine 6 e 7:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.

   10. Riavvia il componente dell'interfaccia utente:
       • UI 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 UI di Edge: se hai installato la nuova UI di 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 delle topologie perimetrali e dei numeri di nodi.

   1. Aggiorna Cassandra e ZooKeeper:
      1. Sulle macchine 1, 2 e 3 nel data center 1:

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

      2. Sulle macchine 7, 8 e 9 nel data center 2

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

   2. Aggiorna qpidd:
      1. Macchine 4, 5 nel data center 1
         1. Aggiorna qpidd sulla macchina 4:

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

         2. Aggiorna qpidd sulla macchina 5:

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

      2. Macchine 10 e 11 nel data center 2
         1. Aggiorna qpidd sulla macchina 10:

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

         2. Aggiorna qpidd sulla macchina 11:

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

   3. Aggiorna Postgres:
      1. Macchina 6 nel data center 1

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

      2. Macchina 12 nel data center 2

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

   4. Aggiorna LDAP:
      1. Macchina 1 nel data center 1

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

      2. Macchina 7 nel data center 2

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

   5. Aggiorna i componenti Edge:
      1. Macchine 4, 5, 6, 1, 2, 3 nel data center 1

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

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

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

   6. Aggiorna la nuova UI (ue) o la UI classica (ui):
      1. Macchina 1 nel data center 1:

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

      2. Macchina 7 nel data center 2:

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

   7. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità di 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

      Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.

   9. Riavvia il nuovo componente della UI Edge (edge-management-ui) o della UI classica (edge-ui) sulle macchine 1 e 7:

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

   Per una configurazione non standard

   Se hai una configurazione non standard, aggiorna i componenti Edge nel seguente ordine:

   1. ZooKeeper
   2. Cassandra
   3. qpidd, ps
   4. LDAP
   5. Edge, ovvero il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, server Edge Postgres, server di gestione, processore di messaggi e router.
   6. UI Edge (classica o nuova)
   7. apigee-adminapi
   8. SSO Apigee

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