Aggiornamento di Apigee Edge 4.51.00 o 4.52.00 alla versione 4.52.01

Apigee supporta l'upgrade di Edge per il cloud privato dalla versione 4.51.00 o versione 4.52.00 direttamente Versione 4.52.01. 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.3

Questa versione di Edge per il cloud privato include un upgrade a Zookeeper 3.8.3. Nell'ambito di quell'aggiornamento, tutti i dati di Zookeeper verranno migrati a Zookeeper 3.8.3.

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.

  1. Se non è installato sul nodo ZooKeeper, installa nc: 
      sudo yum install nc
  2. 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.3-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.

  3. 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:

  1. Scarica ed esegui il bootstrap di Edge per il cloud privato 4.52, come descritto in Esegui l'aggiornamento alla versione 4.52.01 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.
  2. 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), puoi 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.
  3. 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:

  1. Per prima cosa, esegui i passaggi di rollback su osservatori e follower.
  2. Scarica ed esegui il bootstrap della versione di 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.
  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
  5. Installa Zookeeper come di consueto: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. 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.
  7. 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 per il cloud privato include un upgrade a Postgres 14. Nell'ambito di questo upgrade, viene eseguita la migrazione di tutti i dati di Postgres a Postgres 14.

  • Se si esegue l'upgrade da Edge per il cloud privato da 4.51.00 a 4.52.01, è necessario seguire ulteriori passaggi di upgrade di Postgres. Fai riferimento alla sezione Upgrade obbligatorio a Postgres 14 se esegui l'upgrade dalla versione 4.51.00 alla 4.52.01.
  • Se si esegue l'upgrade da Edge per il cloud privato da 4.52.00 a 4.52.01, non sono necessari passaggi di upgrade aggiuntivi di Postgres.

Upgrade Qpid

Questa release di Edge per il cloud privato include un upgrade del J-Broker Qpid.

Ti consigliamo di selezionare uno dei seguenti metodi per eseguire l'upgrade di Qpid:

Upgrade in loco senza tempi di inattività

Questo metodo garantisce l'assenza di tempi di inattività per l'ambiente di runtime Edge e riduce al minimo l'eventuale perdita di dati di runtime acquisiti per l'analisi.

Per eseguire un upgrade in loco senza tempi di inattività a Qpid:

  1. Scegli un nodo Qpid con cui iniziare.
  2. Arresta il broker Qpid sul nodo: 
    apigee-service apigee-qpidd stop
  3. Blocca il traffico in entrata sulla porta 5672 del broker da tutti i processori di messaggi applicando un firewall. Puoi applicare questo firewall a livello di istanza del nodo Qpid o firewall esterno/componente di rete.

    Ti consigliamo di eseguire lo stesso passaggio per tutti gli indirizzi IP del processore di messaggi. Ad esempio, alle richieste DROP provenienti dagli indirizzi IP del processore di messaggi al nodo Qpid sulla porta 5672 utilizzando IPTables, potresti utilizzare un comando come questo:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Avvia di nuovo il broker Qpid per svuotare gli eventuali messaggi esistenti: 
    apigee-service apigee-qpidd start
  5. Controlla che le code esistenti siano vuote: 
    qpid-stat -q

    Se i messaggi sono bloccati nella coda dei messaggi non recapitabili (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), svuota lo svuotamento in coda seguendo i passaggi per risolvere i dati di analisi bloccati nella coda dei messaggi non recapitabili.

  6. Dopo aver verificato che le code sono state svuotate sul nodo precedente, interrompi apigee-qpidd: 
    apigee-service apigee-qpidd stop
  7. Esegui l'upgrade di Qpid sul nodo: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Riavvia edge-qpid-server: 
    apigee-service edge-qpid-server restart

  9. Rimuovi la regola firewall applicata nel passaggio 3.

    Esegui lo stesso passaggio di rimozione per tutti gli indirizzi IP del processore di messaggi a cui è stato applicato il firewall. Una volta rimossi i firewall, le richieste provenienti dagli indirizzi IP del processore di messaggi sarà accettato il nodo Qpid sulla porta 5672. Se hai utilizzato iptables per aggiungere il firewall, per rimuovi il firewall e, per elencare le impostazioni esistenti, puoi usare i comandi seguenti:

    iptables -F
  iptables -L
  10. Utilizza il monitoraggio web per verificare che le code Qpid stiano ricevendo messaggi: 
    http://QPID_NODE_IP:8090
  11. Ripeti i passaggi da 1 a 9 per ciascun nodo Qpid.

Messa in servizio di un nuovo nodo Qpid

Questo metodo configura e installa apigee-qpidd e edge-qpid-server su un nuovo nodo.

  1. Aggiungi un nuovo nodo Qpid. Questo passaggio configura un nodo Qpid con J-broker. Per la procedura dettagliata, consulta Aggiungere un server Qpid.
  2. Scegli un nodo Qpid esistente (un nodo della versione da cui stai eseguendo l'upgrade).
  3. Arresta il broker Qpid sul nodo: 
    apigee-service apigee-qpidd stop
  4. Blocca il traffico in entrata sulla porta 5672 del broker da tutti i processori di messaggi applicando un firewall. Puoi applicare questo firewall a livello di istanza del nodo Qpid o firewall esterno/componente di rete.

    Ti consigliamo di eseguire lo stesso passaggio per tutti gli indirizzi IP del processore di messaggi. Ad esempio, alle richieste DROP provenienti dagli indirizzi IP del processore di messaggi al nodo Qpid sulla porta 5672 utilizzando IPTables, potresti utilizzare un comando come questo:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. Avvia di nuovo il broker Qpid per svuotare gli eventuali messaggi esistenti: 
    apigee-service apigee-qpidd start
  6. Verifica che le code esistenti siano vuote: 
    qpid-stat -q

    Se i messaggi sono bloccati nella coda dei messaggi non recapitabili (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), svuota la seguendo la procedura descritta nell'argomento di risoluzione dei problemi Dati di Analytics bloccati nella coda messaggi non recapitabili Qpidd.

  7. Dopo aver verificato lo svuotamento delle code sul nodo precedente, interrompi apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. Annulla la registrazione del vecchio nodo Qpid seguendo i passaggi in Rimuovi un server Qpid.
  9. Continua ad aggiungere un nuovo nodo e a rimuovere un vecchio nodo, uno alla volta, finché tutti i nodi Qpid non saranno upgrade eseguito.

Esegui il rollback

Per eseguire il rollback a una release di funzionalità precedente, assicurati di scaricare il file bootstrap.sh per la versione a cui vuoi eseguire il rollback. Per eseguire il rollback alla versione 4.52.00, scarica bootstrap_4.52.00.sh.

Per eseguire il rollback di Qpid, segui questi passaggi su tutti gli host Qpid:

  1. Arresta il broker Qpid esistente 
    apigee-service apigee-qpidd stop
  2. Blocca il traffico in entrata sulla porta 5672 del broker da tutti i processori di messaggi applicando un firewall. Puoi applicare questo firewall a livello di istanza del nodo Qpid o firewall esterno/componente di rete.

    Ti consigliamo di eseguire lo stesso passaggio per tutti gli indirizzi IP del processore di messaggi. Ad esempio, alle richieste DROP provenienti dagli indirizzi IP del processore di messaggi al nodo Qpid sulla porta 5672 utilizzando IPTables, potresti utilizzare un comando come questo:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Avvia di nuovo il broker qpid per svuotare gli eventuali messaggi esistenti: 
    apigee-service apigee-qpidd start
  4. Assicurati che le code esistenti siano vuote. Per verificare, accedi a Qpid di gestione dell'ambiente: 
    http://QPID_NODE_IP:8090
     Nota: se la porta 8090 sul nodo QPID non è accessibile, puoi utilizzare meccanismi alternativi come il port forwarding SSH per accedere all'URL.
  5. Dopo aver verificato lo svuotamento delle code, interrompi e disinstalla Qpid: 
    apigee-service apigee-apidd uninstall
  6. Elimina la directory dei dati Qpid: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Reinstalla il broker Qpid: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Una volta reinstallato il broker Qpid, rimuovi le impostazioni del firewall ed elenca quelle esistenti utilizzando i seguenti comandi: 
    iptables -F
     
    iptables -L

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:

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.

  1. Aggiorna i computer nell'ordine corretto per l'installazione come descritto Ordine di aggiornamento della macchina.
  2. 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).
  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 nuovamente raggiungibile il router.
  5. Ripeti i passaggi da 2 a 4 per gli altri router.
  6. Continua l'aggiornamento per eventuali macchine rimanenti nell'installazione.

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

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.01 su un nodo con una connessione a internet esterna

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

  1. Se presente, 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 root per installare gli RPM perimetrali.
  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 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

  7. Se stai utilizzando Edge 4.51.00:

    1. Scarica il file Edge bootstrap_4.52.01.sh in /tmp/bootstrap_4.52.01.sh: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. Installa l'utilità e le dipendenze Edge 4.52.01 apigee-service eseguendo questo comando: 
      sudo bash /tmp/bootstrap_4.52.01.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.01.

Aggiornamento alla versione 4.52.01 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.01 locale:

  1. Creare un repository 4.52.01 locale come descritto in "Creare 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.01.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.01.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.01.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&quot; alla pagina Installare Edge Utilità apigee-setup.
    2. Sul nodo remoto, scarica il file Edge bootstrap_4.52.01.sh su /tmp/bootstrap_4.52.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.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.01.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.

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

Ordine di aggiornamento della macchina

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

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

Upgrade autonomo con un nodo

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

  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 Postgres sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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 Qpid sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Aggiorna l'interfaccia utente 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 installato l'accesso SSO.

  9. 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 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 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 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 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
  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 installato l'accesso SSO.

  11. 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 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 sul computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 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
  6. Aggiorna Qpid sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 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 sui computer 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 in questo ordine: 
    /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 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 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 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
  5. 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
  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

      3. Dove sso_config_file è il file di configurazione che hai creato installato l'accesso SSO.

  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. 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.
  6. qpidd
  7. UI Edge (classica o nuova)
  8. apigee-adminapi
  9. SSO Apigee

Al termine dell'aggiornamento, assicurati di riavviare il componente Edge UI su tutte le macchine in esecuzione li annotino.