Aggiornamento di Apigee Edge da 4.16.09 a 4.17.01

Edge per Private Cloud v. 4.17.01

Versioni di Edge aggiornabili alla 4.17.01

Puoi aggiornare Apigee Edge versione 4.16.09.0x a 4.17.01 utilizzando questa procedura.

Se hai una versione di Edge precedente alla versione 4.16.01, devi prima eseguire la migrazione alla versione 4.16.01.x e poi eseguire l'aggiornamento alla versione 4.17.01.

Chi può eseguire l'aggiornamento

L'utente che esegue l'aggiornamento deve essere lo stesso dell'utente che ha installato in origine Edge o di un utente in esecuzione come root.

Dopo aver installato gli Edge RPM, qualsiasi utente può configurarli.

Quali componenti devi aggiornare

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

È richiesto l'upgrade a Qpid 1.35

Questa release contiene un aggiornamento obbligatorio a Qpid 1.35. Durante l'aggiornamento di un nodo Qpid, devi:

  • Impedisci temporaneamente a router e processori di messaggi di scrivere nel nodo Qpid bloccando la porta 5672 sul nodo Qpid. Puoi utilizzare il seguente comando per bloccare questa porta sul nodo Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
  • Attendi che la coda Qpid sia vuota per garantire che il nodo Qpid abbia elaborato tutti i messaggi prima dell'aggiornamento. Utilizza questo comando per assicurarti che la coda di messaggi Qpid sia vuota:
    > qpid-stat -q
  • Aggiornare il nodo Qpid.
  • Sblocca la porta 5672 sul nodo Qpid per consentire l'accesso da router e processori di messaggi. Puoi utilizzare il seguente comando per sbloccare questa porta:
    > sudo iptables -F

    Tieni presente che se utilizzi iptables per altre regole, puoi utilizzare l'opzione -D per annullare la modifica specifica:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP

Questo processo è descritto in dettaglio di seguito per ogni topologia Edge.

Obbligatorio per abilitare il repository EPEL

Devi abilitare Extra Packages for Enterprise Linux (o EPEL) per installare o aggiornare Edge. Il comando da utilizzare dipende dalla versione di RedHat/CentOS in uso:

  • Per RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Per RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Obbligatorio in caso di aggiornamento quando si utilizza l'autenticazione esterna

Puoi integrare un servizio di directory esterno in un'installazione di cloud privato Apigee Edge esistente. Questa funzionalità è progettata per funzionare con qualsiasi servizio di directory che supporti LDAP, ad esempio Active Directory, OpenLDAP e altri. Una soluzione LDAP esterna consente agli amministratori di sistema di gestire le credenziali utente da un servizio di gestione delle directory centralizzato all'esterno dei sistemi che le utilizzano, ad esempio Apigee Edge.

Per ulteriori informazioni, consulta Configurazione dell'autenticazione esterna.

Quando l'autenticazione esterna è abilitata, la maggior parte dei clienti utilizza il campo del nome dell'account SAM di Active Directory come nome utente per l'autenticazione, anziché un indirizzo email utilizzato dal server Edge OpenLDAP.

Se hai eseguito l'integrazione con un servizio di directory esterno, aggiungi la seguente riga al file di configurazione quando aggiorni Edge alla versione 4.17.01:

IS_EXTERNAL_AUTH="true"

Questa riga configura Edge in modo che supporti un nome account, anziché un indirizzo email, come nome utente.

Propagazione automatica delle impostazioni delle proprietà

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

Aggiorna prerequisiti

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

  • Esegui il backup di tutti i nodi
    Prima dell'aggiornamento, per motivi di sicurezza ti consigliamo di eseguire un backup completo di tutti i nodi. Utilizza 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

Gestione di un aggiornamento non riuscito

In caso di errore di un aggiornamento, puoi provare a risolvere il problema, quindi a eseguire di nuovo update.sh. Puoi eseguire l'aggiornamento più volte e riprenderlo dal punto in cui è stato interrotto.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta la sezione 4.17.01 Procedura di rollback per ulteriori informazioni.

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 l'utente che esegue l'utilità update.sh non ha accesso a quella 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 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 causare il ripristino di Edge.

L'aggiornamento senza tempo di inattività è possibile solo con una configurazione a 5 nodi o più.

La chiave per eseguire un upgrade senza tempo di inattività consiste nel rimuovere ogni router, uno alla volta, dal bilanciatore del carico. Aggiorna quindi il router e tutti gli altri componenti sulla stessa macchina del router e aggiungi di nuovo quest'ultimo al bilanciatore del carico.

  1. Aggiorna le macchine nell'ordine corretto per l'installazione come descritto di seguito in "Ordine di aggiornamento della macchina".
  2. Quando è il momento di aggiornare i router, selezionane uno qualsiasi e rendilo non raggiungibile, come descritto in Attivare/disattivare la connettività di 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 nuovamente raggiungibile il router.
  5. Ripeti i passaggi da 2 a 4 per i router rimanenti.
  6. Continua l'aggiornamento per le eventuali macchine rimanenti nell'installazione.

Prima/dopo l'aggiornamento:

  • Sul nodo combinato router e processore dei messaggi:
    • Prima dell'aggiornamento:
      1. Rendi il router irraggiungibile.
      2. Rendere il processore di messaggi irraggiungibile.
    • Dopo l'aggiornamento:
      1. Rendi raggiungibile il processore di messaggi.
      2. Rendi raggiungibile il router.
  • Su un singolo nodo router:
    • Prima dell'aggiornamento, rendi il router irraggiungibile.
    • Dopo l'aggiornamento, rendi il router raggiungibile.
  • Su un singolo nodo del processore di messaggi:
    • Prima dell'aggiornamento, rendi il processore di messaggi irraggiungibile.
    • Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.

Utilizzo di un file di configurazione invisibile all'utente

Devi passare un file di configurazione invisibile all'utente al comando update. Il file di configurazione invisibile all'utente deve essere lo stesso utilizzato per installare Edge 4.16.01 o 4.16.05.

Procedura per l'aggiornamento alla versione 4.17.01 su un nodo con una connessione a internet esterna

Utilizza 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.
    Nota: sebbene l'installazione RPM richieda l'accesso root, puoi eseguire la configurazione Edge senza accesso root.
  3. Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
  4. Scarica il file Edge 4.17.01 bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  5. Installa l'utilità e le dipendenze apigee-service Edge 4.17.01:
    > sudo bash /tmp/bootstrap_4.17.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 controlla se Java 1.8 è installato. Se non lo fai, lo installa. Utilizza l'opzione JAVA_FIX per specificare come gestire l'installazione Java. JAVA_FIX accetta i seguenti valori:

    I = Installa OpenJDK 1.8 (predefinito)
    C = Continua senza installare Java
    Q = Esci. Per questa opzione, devi installare Java autonomamente.
  6. (solo CentOS-6.x e RedHat-6.x) Su tutti i nodi Qpid, esegui questo comando per assicurarti di scaricare la versione di Qpid corretta:
    > yum install apigee-qpidd --disablerepo=epel
  7. Utilizza apigee-service per aggiornare l'utilità apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento
  8. Aggiorna l'utilità apigee-validate sul server di gestione:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
  9. Aggiorna l'utilità apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision
  10. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina" di seguito:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    L'unico requisito del file di configurazione è che il file di configurazione sia accessibile o leggibile dall'utente "apigee".

    Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
    ldap = OpenLDAP Sa StackEsa = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Tutti i componenti Edge eccetto Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    ui




  11. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in 4.16.09 Procedura di rollback.

Procedura per l'aggiornamento alla versione 4.17.01 da un repository locale

Se i nodi perimetrali sono protetti da un firewall o in qualche 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, quindi 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 server web personale.

Per aggiornare da un repository 4.17.01 locale:

  1. Crea un repository 4.17.01 locale come descritto in "Crea un repository Apigee locale" in Installa l'utilità Edge apigee-setup.
    Nota: se hai già un repository 4.16.09 esistente, puoi aggiungere il repository 4.17.01 come descritto in "Aggiornare un repository Apigee locale" all'indirizzo Installa l'utilità Edge apigee-setup.
  2. Per installare apigee-service da un file .tar:
    1. Sul nodo con il repository locale, utilizza il seguente comando per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror pacchetto
    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 iltar del file nella directory /tmp:
      > tar -xzf apigee-4.17.01.tar.gz

      Questo comando crea una nuova directory, denominata repository, nella directory contenente il file .tar. Ad esempio /tmp/repos.
    4. Installa l'utilità e le dipendenze apigee-service Edge da /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.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 "Installazione dal repository utilizzando il server web Nginx" in Installa l'utilità apigee-setup di Edge.
    2. Sul nodo remoto, scarica il file Edge bootstrap_4.17.01.sh in /tmp/bootstrap_4.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap0osh/4.17. il nome utente del nodo remoteRepo:3939/bootstrap0osh/4.17 è impostato su
      .

    3. Sul nodo remoto, installa l'utilità e le dipendenze Edge apigee-service:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigee=pWordup apigeeprotocol=http://passwordrep

  4. Utilizza apigee-service per aggiornare l'utilità apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento
  5. Aggiorna l'utilità apigee-validate sul server di gestione.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate aggiornamento
  6. Aggiorna l'utilità apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision
  7. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina" di seguito:
    > /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile

    L'unico requisito del file di configurazione è che il file di configurazione sia accessibile o leggibile dall'utente "apigee".

    Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
    ldap = OpenLDAP Sa StackEsa = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Tutti i componenti Edge eccetto Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    ui




  8. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in Processo di rollback 4.16.09.

Ordine di aggiornamento della macchina

L'ordine di aggiornamento delle macchine in un'installazione Edge è importante. Le considerazioni più importanti di un aggiornamento sono:

  • Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
  • Per qualsiasi macchina con più componenti Edge (server di gestione, processore 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 della macchina specificato.
  • Non esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornata quando specifichi l'opzione "-c edge".
  • (Solo CentOS-6.x e RedHat-6.x) Su tutti i nodi Qpid con una connessione a internet esterna, assicurati di aver eseguito il seguente comando per scaricare la versione di Qpid corretta come mostrato sopra:
    > yum install apigee-qpidd --disablerepo=epel

Per un'installazione autonoma su un solo host

  1. Aggiorna Cassandra e ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Imposta la seguente regola iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
  3. Controlla la coda di messaggi Qpid:
    > qpid-stat -q

    Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  4. Aggiorna qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Svuota iptables:
    > sudo iptables -F
  6. Aggiorna postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Avvia postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql inizia
  8. Aggiorna LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Aggiorna i restanti componenti Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Aggiorna UI Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione autonoma su 2 host

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.

  1. Aggiorna Cassandra e ZooKeeper sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Imposta la seguente regola iptables sulla macchina 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
  3. Controlla la coda di messaggi Qpid sulla macchina 2:
    > qpid-stat -q

    Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  4. Aggiorna qpidd sulla macchina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Flush iptables sulla macchina 2:
    > sudo iptables -F
  6. Aggiorna postgresql sulla macchina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Avvia postgresql sulla macchina 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. Aggiorna LDAP sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Aggiorna i componenti Edge sulle macchine 2 e 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Aggiorna UI sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione in cluster su 5 host

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei 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. Imposta la seguente regola iptables sulla macchina 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
  3. Controlla la coda di messaggi Qpid sulla macchina 4:
    > qpid-stat -q

    Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  4. Aggiorna qpidd sulla macchina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Flush iptables sulla macchina 4:
    > sudo iptables -F
  6. Ripeti i passaggi da 2 a 5 sulla macchina 5.
  7. Aggiorna postgresql sulla macchina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Avvia postgresql sulla macchina 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ripetere i passaggi 7 e 8 sulla macchina 5.
  10. Aggiorna LDAP sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Aggiorna i componenti Edge sulla macchina 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Aggiorna UI sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione in cluster con nove host

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei 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. Imposta la seguente regola iptables sulla macchina 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
  3. Controlla la coda di messaggi Qpid sulla macchina 6:
    > qpid-stat -q

    Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  4. Aggiorna qpidd sulla macchina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Flush iptables sulla macchina 6:
    > sudo iptables -F
  6. Ripeti i passaggi da 2 a 5 sulla macchina 7.
  7. Aggiorna postgresql sulla macchina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Avvia postgresql sulla macchina 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ripetere i passaggi 7 e 8 sulla macchina 7.
  10. Aggiorna LDAP sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. Aggiorna UI sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione in cluster con 13 host

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei 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. Imposta la seguente regola iptables sulla macchina 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
  3. Controlla la coda di messaggi Qpid sulla macchina 12:
    > qpid-stat -q

    Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  4. Aggiorna qpidd sulla macchina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Flush iptables sulla macchina 12:
    > sudo iptables -F
  6. Ripetere i passaggi da 2 a 5 sulla macchina 13.
  7. Aggiorna postgresql sulla macchina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Avvia postgresql sulla macchina 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Ripetere i passaggi 7 e 8 sulla macchina 13.
  10. Aggiorna LDAP sulle macchine 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. Aggiorna la UI sulle macchine 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione in cluster con 12 host

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.

  1. Aggiorna Cassandra e ZooKeeper:
    1. Sulle macchine 1, 2 e 3 del data center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Sulle macchine 7, 8 e 9 del data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aggiorna qpidd:
    1. Macchine 4 e 5 nel data center 1
      1. Imposta la seguente regola iptables sulla macchina 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
      2. Controlla la coda di messaggi Qpid sulla macchina 4:
        > qpid-stat -q

        Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
      3. Aggiorna qpidd sulla macchina 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Flush iptables sulla macchina 4:
        > sudo iptables -F
      5. Ripeti i passaggi da 1 a 4 sulla macchina 5.
    2. Macchine 10 e 11 nel data center 2
      1. Imposta la seguente regola iptables sulla macchina 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'nome host' -i eth0 -j DROP
      2. Controlla la coda di messaggi Qpid sulla macchina 10:
        > qpid-stat -q

        Continua a controllare la coda fino a quando il conteggio nella colonna "msg" è 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
      3. Aggiornamento di qpidd sulla macchina 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Flush iptables sulla macchina 10:
        > sudo iptables -F
      5. Ripetere i passaggi da 1 a 4 sulla macchina 11.
  3. Aggiorna postgresql:
    1. Macchine 6 nel data center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Macchine 12 nel data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql inizia
  4. Aggiorna LDAP:
    1. Macchine 1 nel data center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Macchine 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 l'interfaccia utente:
    1. Macchina 1 nel data center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Macchina 7 nel data center 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione BaaS con API con 7 host

Devi aggiungere due nuove proprietà al file di configurazione prima di eseguire la procedura di upgrade:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Per un esempio completo di file di configurazione, consulta Installazione di API BaaS.

Devi inoltre assicurarti che la porta 2551 sia aperta su tutti i nodi dello stack per l'accesso da tutti gli altri nodi dello stack.

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.

  1. Aggiorna Cassandra sulle macchine 5, 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Aggiornamento di ElasticSearch e dello stack BaaS dell'API sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Aggiornamento del portale API BaaS sulla macchina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Per un'installazione BaaS con API con 10 host

Devi aggiungere due nuove proprietà al file di configurazione prima di eseguire la procedura di upgrade:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Per un esempio completo di file di configurazione, consulta Installazione di API BaaS.

Devi inoltre assicurarti che la porta 2551 sia aperta su tutti i nodi dello stack per l'accesso da tutti gli altri nodi dello stack.

Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.

  1. Aggiorna Cassandra sulle macchine 8, 9 e 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Aggiornamento di ElasticSearch sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Aggiornamento dello stack API BaaS sulle macchine 4, 5 e 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Aggiornamento del portale API BaaS sulla macchina 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Per un'installazione non standard

Se non disponi di un'installazione standard, aggiorna i componenti Edge nel seguente ordine:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, che indica il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, server Postgres, server di gestione, processore di messaggi e router.
    Nota: se nel nodo sono installati sia il server Qpid che il server Postgres, esegui il passaggio del profilo "-c edge".
  6. UI perimetrale