Aggiorna Apigee Edge 4.51.00 o 4.52.00 o 4.52.01 a 4.52.02

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

Chi può eseguire l'aggiornamento

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

Dopo aver installato gli RPM di 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 i prerequisiti

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

  • Esegui il backup di tutti i nodi
    Per motivi di sicurezza, ti consigliamo di eseguire un backup completo di tutti i nodi prima di eseguire l'aggiornamento. Utilizza la procedura per la versione corrente di Edge per eseguire il backup.

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

  • Assicurati che Edge sia in esecuzione
    Assicurati che Edge sia in esecuzione durante la procedura di aggiornamento utilizzando il comando: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Esegui l'upgrade delle utilità richieste
    Prima di iniziare la procedura di upgrade, assicurati che le seguenti utilità siano aggiornate:
    • apigee-lib
    • apigee-adminapi
    • apigee-machinekey
    • apigee-configutil
  • Assicurati che la strategia di compattazione di Cassandra sia LeveledCompactionStrategy
    In base alla versione corrente, apporta le modifiche necessarie alla strategia di compattazione di Cassandra. Segui i passaggi riportati di seguito, quindi torna alla procedura di upgrade principale:

Quali passaggi speciali da considerare per l'upgrade

Per eseguire l'upgrade a Edge for Private Cloud 4.52.02, valuta la possibilità di eseguire passaggi specifici per l'upgrade di determinati software. I passaggi necessari dipendono dalla versione corrente. Consulta la tabella seguente per i vari software che richiedono passaggi supplementari e segui le istruzioni dettagliate per ciascuno. Dopo aver completato le attività necessarie, torna alla procedura di upgrade principale per continuare la procedura.

Versione corrente Software che richiede passaggi speciali per l'upgrade alla versione 4.52.02 Riferimento
4.52.01 Cassandra Modificare la strategia di compattazione di Cassandra
4.52.00 Cassandra, Zookeeper, Qpid Modificare la strategia di compattazione di Cassandra
4.51.00 Cassandra, Zookeeper, Qpid, Postgres Modificare la strategia di compattazione di Cassandra

Dopo aver eseguito i passaggi necessari in base alla tua versione, torna alla procedura di upgrade principale per continuare.

Propagazione automatica delle impostazioni della proprietà

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

Upgrade obbligatorio a Cassandra 3.11.16

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

Poiché si tratta di un upgrade importante, sono state necessarie alcune modifiche al modello di dati di Apigee in Cassandra per garantire un rendimento ottimale nelle versioni più recenti. Sebbene queste modifiche siano minime, la procedura di upgrade interrompe alcune API di gestione, interessando sia l'interfaccia utente di Apigee sia il portale per gli sviluppatori. Il documento riportato di seguito specifica le API esatte che non funzioneranno e illustra i passaggi durante l'upgrade quando inizia e termina l'interruzione. È importante sottolineare che non dovrebbe verificarsi alcuna interruzione del traffico di runtime durante l'upgrade.

Rollback di alto livello

Applica gli upgrade di Cassandra un nodo alla volta. Non appena un nodo viene aggiornato, vengono applicate alcune modifiche allo schema che non possono essere annullate direttamente. Leggi attentamente la sezione sul rollback, poiché è possibile utilizzare tecniche diverse a seconda dell'entità dell'upgrade del cluster.

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

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

Documentazione delle API nel portale per gli sviluppatori

Il portale per sviluppatori Drupal di Apigee offre varie funzionalità per la documentazione delle API. Sebbene sia consigliabile non utilizzare più il portale per sviluppatori basato su Drupal 7, se lo utilizzi ancora e ne usi la funzionalità SmartDocs, il documento Utilizzo delle API SmartDocs è rivolto a te. Se utilizzi versioni più recenti del portale per gli sviluppatori, la documentazione dell'API non sarà interessata da questo upgrade.

Quando esegui l'upgrade di Apigee alla versione 4.52.02, la migrazione a una versione più recente non verrà eseguita automaticamente per i modelli API creati utilizzando la funzionalità SmartDocs del portale per sviluppatori di Drupal 7. Dovrai esportare manualmente ogni modello utilizzando il portale per gli sviluppatori e importarli di nuovo al termine dell'upgrade.

Terminologia utilizzata nelle sezioni seguenti

Runtime: il runtime comprende 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 di runtime per i proxy esistenti. Tuttavia, non include il deployment di nuovi proxy o nuove revisioni di proxy.

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

In ogni passaggio riportato di seguito, viene descritto lo stato di runtime e gestione man mano che avanzi nelle varie fasi della procedura di upgrade. Tieni presente che il traffico di runtime non è interessato durante l'upgrade. Tuttavia, si verificano interruzioni per un piccolo sottoinsieme di API di gestione e funzionalità del portale per gli sviluppatori.

Passaggio 0: stato di inizio

  1. Cassandra in Apigee in esecuzione con la versione 2.1.22.
  2. Componenti di Edge for Private Cloud 4.52.02:
    • Server di gestione che comunica con Cassandra tramite il protocollo Thrift precedente.
    • Server di runtime (Message Processors e Router) che comunicano con Cassandra tramite il protocollo Thrift precedente.
Stato del runtime in questa fase Stato della gestione in questa fase
Runtime completamente funzionale Gestione completamente funzionale

Passaggio 1: preparati all'upgrade

I passaggi riportati di seguito si aggiungono ai file standard che in genere crei, ad esempio il file di configurazione standard di Apigee per abilitare gli upgrade dei componenti.

  1. Modifica Cassandra in modo che utilizzi LeveledCompactionStrategy.
  2. Esegui il backup di Cassandra utilizzando Apigee.
  3. Acquisisci istantanee VM dei nodi Cassandra (se possibile).
  4. Crea un file di configurazione dell'upgrade di Cassandra su ogni nodo Cassandra in /opt/apigee/apigee-cassandra/cass_upgrade.conf con i seguenti contenuti: 
    # 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 ogni nodo Cassandra.
  • Se utilizzi la funzionalità SmartDocs del portale per gli sviluppatori Apigee Drupal 7, esporta ciascuno dei tuoi modelli scaricandolo in formato JSON dall'interfaccia utente del portale per gli sviluppatori. Questi modelli dovranno essere reimportati in Apigee dopo l'aggiornamento dei server di gestione.
  • Assicurati che le porte 9160 e 9042 siano accessibili da tutti i componenti di Edge for Private Cloud 4.52.02 ai nodi Cassandra, se non sono già presenti. Per ulteriori informazioni, consulta Requisiti delle porte.

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

  1. Esegui l'upgrade di tutti i nodi Cassandra in tutte le regioni uno alla volta. Esegui i seguenti comandi su ogni nodo: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Dopo aver aggiornato un nodo, esegui il seguente comando sul nodo per eseguire alcune convalide prima di procedere: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Il codice riportato sopra produrrà un output simile al seguente: 
    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 La seguente funzione di gestione viene degradata dopo l'upgrade di Cassandra:

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 del runtime Stato di gestione
Runtime completamente funzionale API di gestione in stato di degradamento:

Passaggio 3a: [facoltativo] importa gli SmartDoc 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 decidere di farlo anche in un secondo momento.

Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

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

Esegui l'upgrade di tutti i nodi Router e Message Processor in tutte le regioni uno alla volta:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stato del runtime Stato di 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.

A questo punto, se stai eseguendo l'upgrade da versioni precedenti a Edge for Private Cloud 4.52.01 e stai seguendo passaggi aggiuntivi per l'upgrade di Qpid o Postgres, segui i rispettivi passaggi per l'upgrade.

Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

Passaggio 6: passaggi successivi all'upgrade

Dopo il completamento dell'upgrade, esegui il seguente comando su ciascun nodo Cassandra uno alla volta:

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

Esegui il seguente comando per eliminare le vecchie tabelle inutilizzate dal cluster Cassandra. Fino a quando non viene eseguito, non puoi utilizzare alcune funzionalità di Cassandra (ad esempio la configurazione di una nuova autenticazione; i vecchi meccanismi di autenticazione continueranno a funzionare). Questo comando può essere eseguito solo su un nodo del cluster:

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

Completa il passaggio 3a, se non l'hai ancora fatto.

Stato del runtime Stato di gestione
Runtime completamente funzionale Gestione completamente funzionale

Upgrade richiesto a Zookeeper 3.8.3

Anche se Edge for Private Cloud 4.52.02 non include un upgrade 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 for Private Cloud 4.51.00 o 4.52.00, consulta la sezione Upgrade richiesto a Zookeeper 3.8.3 per eseguire l'upgrade di Zookeeper.
  • Se esegui l'upgrade dalla versione 4.52.01 di Edge for Private Cloud, dovresti già utilizzare la versione 3.8.3 di Zookeeper e non devi seguire procedure speciali per l'upgrade di Zookeeper.

Upgrade obbligatorio a Postgres 14

  • Se esegui l'upgrade da Edge for Private Cloud 4.51.00 a 4.52.02, devi seguire i passaggi per l'upgrade di Postgres, anche se Edge for Private Cloud 4.52.02 non include un upgrade di Postgres. L'upgrade da Edge for Private Cloud 4.51.00 a 4.52.02 richiede ulteriori passaggi di upgrade di Postgres. Fai riferimento alla sezione Upgrade obbligatorio a Postgres 14.
  • Se esegui l'upgrade da Edge for Private Cloud 4.52.00 o 4.52.01 a 4.52.02, non sono necessari ulteriori passaggi di upgrade di Postgres.

Upgrade obbligatorio a Qpid J-Broker

Anche se Edge for Private Cloud 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 l'upgrade di QPID.

  • Se stai eseguendo l'upgrade da Edge for Private Cloud 4.51.00 o 4.52.00 a 4.52.02, devi seguire ulteriori passaggi di upgrade di QPID. Consulta la sezione Eseguire l'upgrade di Qpid se stai eseguendo l'upgrade dalla versione 4.51.00 o 4.52.00 alla versione 4.52.02.
  • Se esegui l'upgrade da Edge for Private Cloud 4.52.01 a 4.52.02, dovresti già utilizzare la versione più recente di Qpid Broker e non sono necessari ulteriori passaggi di upgrade di QPID.

Interfaccia utente del nuovo Edge

Questa sezione elenca le considerazioni relative all'interfaccia utente di Edge. Per ulteriori informazioni, consulta La nuova UI di Edge per il cloud privato.

Installare l'interfaccia utente di Edge

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

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

Per ulteriori informazioni, vedi Installare la nuova UI di Edge.

Aggiornare l'interfaccia utente di Edge

Per aggiornare il componente dell'interfaccia utente di Edge, prendi in considerazione la versione di Edge per il cloud privato da cui stai eseguendo l'upgrade:

Aggiornamento con mTLS di Apigee

Per aggiornare Apigee mTLS , segui questi passaggi:

Eseguire il rollback di un aggiornamento

In caso di errore di aggiornamento, puoi provare a correggere il problema ed eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà da dove si era interrotto l'ultima volta.

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

Informazioni sugli aggiornamenti del logging

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

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

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

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

Aggiornamento senza tempi di inattività

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

L'aggiornamento senza tempi di riposo è possibile solo con una configurazione di 5 nodi o più.

La chiave per l'upgrade senza tempi di riposo è rimuovere ogni 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 la tua installazione, come descritto in Ordine di aggiornamento delle macchine.
  2. Quando è il momento di aggiornare i router, selezionane uno e impostalo come non raggiungibile, come descritto in Abilitazione/disattivazione della raggiungibilità del server (Message Processor/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 elaboratore di messaggi sullo stesso nodo.
  4. Rendi di nuovo raggiungibile il router.
  5. Ripeti i passaggi da 2 a 4 per gli altri router.
  6. Continua l'aggiornamento per le eventuali altre macchine dell'installazione.

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

Utilizzare un file di configurazione silenzioso

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

Eseguire l'aggiornamento alla versione 4.52.02 su un nodo con una connessione a internet esterna

Per aggiornare i componenti Edge su un nodo, segui questa procedura:

  1. Se presenti, disattiva tutti i job cron configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
  2. Accedi al tuo nodo come utente root per installare gli RPM di Edge.
  3. Installa yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
  5. Se esegui l'installazione su Oracle 7.x, esegui il seguente comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Se esegui l'installazione su AWS, esegui i seguenti comandiyum-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 al momento utilizzi Edge 4.51.00:

    1. Scarica il file bootstrap_4.52.02.sh di Edge su /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 di Edge 4.52.02 apigee-service eseguendo il seguente 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 sia installato Java 1.8. In caso contrario, il programma di installazione lo installerà per te.

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

      • I: installa OpenJDK 1.8 (valore predefinito).
      • C: continua senza installare Java.
      • Q: esci. Per questa opzione, devi installare Java autonomamente.
    3. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Esegui l'utilità update sui tuoi nodi eseguendo il seguente comando: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Esegui questa operazione nell'ordine descritto in Ordine di aggiornamenti della macchina.

      Dove:

      • component è il componente Edge da aggiornare. I valori possibili includono:
        • cs: Cassandra
        • edge: tutti i componenti di Edge, ad eccezione dell'interfaccia utente di Edge: server di gestione, elaboratore di messaggi, router, server QPID, server Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO Apigee (se hai installato SSO)
        • ue: nuova interfaccia utente di Edge
        • ui: interfaccia utente di Edge classica
        • zk: Zookeeper
      • configFile è lo stesso file di configurazione utilizzato per definire i componenti di Edge durante l'installazione di 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. Se non l'hai ancora fatto, riavvia i componenti dell'interfaccia utente di Edge su tutti i nodi su cui sono in esecuzione: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

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

Aggiornamento alla versione 4.52.02 da un repository locale

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

Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:

  • Crea un file .tar del repository, copialo in un nodo e aggiorna Edge dal file .tar.
  • Installa un server web sul nodo con il repository locale in modo che gli altri nodi possano accedervi. Apigee fornisce il server web Nginx da utilizzare oppure puoi utilizzare il tuo server web.

Per eseguire l'aggiornamento da un repository locale 4.52.02:

  1. Crea un repository locale 4.52.02 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. Sul nodo con il repository locale, utilizza il seguente comando per impacchettare 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 nella directory /tmp del nuovo nodo.
    3. Sul nuovo nodo, estrae il 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à apigee-service di Edge e le dipendenze da /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Tieni presente che in questo comando devi includere il percorso della directory dei repository.

  3. Per installare apigee-service utilizzando il server web Nginx:
    1. Configura il server web Nginx come descritto in "Installa dal repository utilizzando il server web Nginx" in Installa l'utilità Edge apigee-setup.
    2. Sul nodo remoto, scarica il file bootstrap_4.52.02.sh di Edge in /tmp/bootstrap_4.52.02.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      dove uName:pWord sono il nome utente e la password impostati in precedenza per il repo e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repo.

    3. Sul nodo remoto, installa l'utilità apigee-setup di Edge e le dipendenze: 
      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.

  4. Utilizza apigee-service per aggiornare l'utilità apigee-setup, come mostrato nell'esempio seguente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Aggiorna l'utilità apigee-validate sul server di gestione, come mostrato nell'esempio seguente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aggiorna l'utilità apigee-provision sul server di gestione, come mostrato nell'esempio seguente: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Esegui l'utilità update sui nodi nell'ordine descritto in Ordine di aggiornamento 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 di Edge, ad eccezione dell'interfaccia utente di Edge: server di gestione, elaboratore di messaggi, router, server QPID, server Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO Apigee (se hai installato SSO)
      • ue Interfaccia utente del nuovo Edge
      • ui: interfaccia utente di Edge classica
      • zk: Zookeeper
    • configFile è lo stesso file di configurazione utilizzato per definire i componenti Edge durante l'installazione di 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. Se non l'hai ancora fatto, riavvia i componenti dell'interfaccia utente su tutti i nodi su cui sono in esecuzione: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

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

Ordine di aggiornamento della macchina

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

  • Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
  • Per qualsiasi macchina con più componenti Edge (server di gestione, elaboratore di messaggi, router, server QPID, ma non server Postgres), utilizza l'opzione -c edge per aggiornarli tutti contemporaneamente.
  • Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nell'ordine delle macchine specificato.
  • Non è previsto un passaggio separato per aggiornare la monetizzazione. Viene aggiornato quando specifichi l'opzione -c edge.

Upgrade autonomo a 1 nodo

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

  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 2 nodi

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

Consulta Topologie di installazione per l'elenco delle topologie di Edge 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 Postgres sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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 Qpid sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Aggiorna la UI sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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 di Edge sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade di 5 nodi

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

Consulta Topologie di installazione per l'elenco delle topologie di Edge 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 Postgres sulla macchina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna Postgres sulla macchina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aggiorna LDAP sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna i componenti Edge sulle macchine 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna Qpid sulla macchina 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aggiorna Qpid sulla macchina 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aggiorna l'interfaccia utente di Edge:
    • Interfaccia utente classica:se utilizzi l'interfaccia utente classica, aggiorna il componente ui sulla macchina 1, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nuova 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
  9. (Se hai installato apigee-adminapi) È stata aggiornata l'utilità apigee-adminapi sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (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.

  11. Riavvia il componente dell'interfaccia utente:
    • Interfaccia utente classica: se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulla macchina 1, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nuova UI 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 di 9 nodi

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

Consulta Topologie di installazione per l'elenco delle topologie di Edge 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 Postgres sulla macchina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna Postgres sulla macchina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aggiorna LDAP sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna i componenti Edge sulle macchine 6, 7, 8, 9, 1, 4 e 5 nell'ordine indicato: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna Qpid sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aggiorna la nuova interfaccia utente (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 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 mostrato 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 di 13 nodi

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

Consulta Topologie di installazione per l'elenco delle topologie di Edge 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 Postgres sulla macchina 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aggiorna Postgres sulla macchina 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aggiorna LDAP sulle macchine 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna i componenti Edge sulle macchine 12, 13, 8, 9, 6, 7, 10 e 11 nell'ordine indicato: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna Qpid sulle macchine 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Aggiorna la nuova interfaccia utente (ue) o quella 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 Apigee SSO sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Riavvia il componente dell'interfaccia utente:
    • Interfaccia utente classica:se utilizzi l'interfaccia utente classica, riavvia il componente edge-ui sulle macchine 6 e 7, come mostrato nell'esempio seguente: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nuova UI 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 di 12 nodi

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

Consulta Topologie di installazione per l'elenco delle topologie di Edge 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 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
  3. 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
  4. Aggiorna i componenti di 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
  5. Aggiorna qpidd:
    1. Macchine 4 e 5 nel data center 1
      1. Aggiorna qpidd sulla macchina 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aggiorna qpidd sulla macchina 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Macchine 10, 11 nel data center 2
      1. Aggiorna qpidd sulla macchina 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aggiorna qpidd sulla macchina 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Aggiorna la nuova interfaccia utente (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) È stata aggiornata l'utilità apigee-adminapi:
    1. Macchina 1 nel data center 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Macchina 7 nel data center 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  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

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

  9. Riavvia il componente della nuova UI di Edge (edge-management-ui) o della UI di Edge classica (edge-ui) sulle macchine 1 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Per una configurazione non standard

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

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

Al termine dell'aggiornamento, assicurati di riavviare il componente dell'interfaccia utente di Edge su tutte le macchine su cui è in esecuzione.