Aggiornamento di Apigee Edge da 4.16.09 a 4.17.05

Edge for Private Cloud v. 4.17.05

Quali versioni di Edge puoi aggiornare alla versione 4.17.05

Puoi aggiornare Apigee Edge dalla versione 4.16.09.0x alla versione 4.17.05 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.05.

Chi può eseguire l'aggiornamento

L'utente che esegue l'aggiornamento deve essere lo stesso che ha installato Edge originariamente o un utente che esegue l'operazione come root.

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

Quali componenti devi aggiornare

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

Upgrade obbligatorio a Qpid 1.35

Questa release contiene un aggiornamento obbligatorio a Qpid 1.35. Nell'ambito dell'aggiornamento di un nodo Qpid, devi:

  • Impedisci temporaneamente ai router e ai processori di messaggi di scrivere sul 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 `hostname` -i eth0 -j DROP
  • Attendi che la coda Qpid si svuoti dei messaggi per assicurarti che il nodo Qpid abbia elaborato tutti i messaggi prima dell'aggiornamento. Utilizza il seguente comando per assicurarti che la coda di messaggi Qpid sia vuota:
    > qpid-stat -q
  • Aggiorna 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 `hostname` -i eth0 -j DROP

Questa procedura è descritta in dettaglio di seguito per ogni topologia Edge.

Obbligatorio per abilitare il repository EPEL

Per installare o aggiornare Edge, devi attivare Extra Packages for Enterprise Linux (o EPEL). Il comando da utilizzare dipende dalla versione di RedHat/CentOS:

  • 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

Aggiunta obbligatoria del parametro di configurazione SMTPMAILFROM

Edge 4.17.05 ha aggiunto un nuovo parametro obbligatorio al file di configurazione utilizzato quando attivi un server SMTP. Ora devi impostare SMTPMAILFROM nel file di configurazione quando attivi il server SMTP. Questo parametro ha il seguente formato:

SMTPMAILFROM="My Company <myco@company.com>"

Obbligatorio se l'aggiornamento viene eseguito quando si utilizza l'autenticazione esterna

Puoi integrare un servizio di directory esterno in un'installazione di Apigee Edge Private Cloud esistente. Questa funzionalità è progettata per funzionare con qualsiasi servizio di directory che supporti LDAP, come 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, esterno a sistemi come Apigee Edge che li utilizzano.

Per saperne di più, consulta Topologie di installazione.

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 OpenLDAP di Edge.

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

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 della proprietà

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

Prerequisiti per l'aggiornamento

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

  • Esegui il backup di tutti i nodi
    Prima di eseguire l'aggiornamento, per motivi di sicurezza è consigliabile eseguire un backup completo di tutti i nodi. Per eseguire il backup, utilizza la procedura per la tua versione attuale di Edge.

    In questo modo, avrai un piano di backup 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 attivo e in esecuzione durante il processo di aggiornamento utilizzando il comando:

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

Gestione di un aggiornamento non riuscito

In caso di errore di aggiornamento, puoi provare a correggere il problema e poi eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà dall'ultima interruzione.

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

Informazioni sull'aggiornamento del logging

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

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

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

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

Aggiornamento senza tempi di inattività

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

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

La chiave per l'upgrade senza tempi di inattività è rimuovere ogni router, uno alla volta, dal bilanciatore del carico. Quindi aggiorna il router e tutti gli altri componenti sulla stessa macchina del router, poi aggiungi nuovamente il router al bilanciatore del carico.

  1. Aggiorna le macchine nell'ordine corretto per l'installazione, come descritto di seguito in "Ordine di aggiornamento delle macchine".
  2. Quando è il momento di aggiornare i router, seleziona un router e rendilo non raggiungibile, come descritto in Attivazione/disattivazione della raggiungibilità 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 i router rimanenti.
  6. Continua l'aggiornamento per tutte le macchine rimanenti nell'installazione.

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

  • Sul nodo combinato Router e Processore di messaggi:
    • Prima dell'aggiornamento, esegui le seguenti operazioni:
      1. Rendi il router non raggiungibile.
      2. Rendi irraggiungibile il processore di messaggi.
    • Dopo l'aggiornamento, esegui le seguenti operazioni:
      1. Rendi raggiungibile il processore di messaggi.
      2. Rendi raggiungibile il router.
  • Su un singolo nodo del router:
    • Prima dell'aggiornamento, rendi il router non raggiungibile.
    • Dopo l'aggiornamento, rendi raggiungibile il router.
  • Su un singolo nodo Processore di messaggi:
    • Prima dell'aggiornamento, rendi irraggiungibile il processore di messaggi.
    • Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.

Utilizzo di un file di configurazione invisibile

Devi passare un file di configurazione invisibile al comando di aggiornamento. Il file di configurazione silenziosa deve essere lo stesso utilizzato per installare Edge 4.16.09.

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

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

  1. Se presenti, disattiva i cron job 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 di RPM richieda l'accesso root, puoi eseguire la configurazione di Edge senza l'accesso root.
  3. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
  4. Scarica il file bootstrap_4.17.05.sh di Edge 4.17.05 in /tmp/bootstrap_4.17.05.sh:
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  5. Installa l'utilità apigee-service di Edge 4.17.05 e le dipendenze:
    > sudo bash /tmp/bootstrap_4.17.05.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, lo installa 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 (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 il seguente comando per assicurarti di scaricare la versione corretta di Qpid:
    > 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 update
  8. Aggiorna l'utilità apigee-validate sul server di gestione:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. Aggiorna l'utilità apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    L'unico requisito per il file di configurazione è che deve essere accessibile o leggibile dall'utente "apigee".

    Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =tutti i componenti Edge ad eccezione della UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
    ui = UI Edge
    all = aggiorna tutti i componenti sulla macchina (utilizza solo per un profilo di installazione Edge aio o un profilo di installazione API BaaS asa)
    e = ElasticSearch
    b = stack API BaaS
    p = portale API BaaS
    ebp = ElasticSearch, stack API BaaS e portale API BaaS sullo stesso nodo
  11. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.

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

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

Se i nodi Edge si trovano dietro un firewall o se in qualche altro modo 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, 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 fornisce il server web Nginx che puoi utilizzare oppure puoi utilizzare il tuo server web.

Per eseguire l'aggiornamento da un repository 4.17.05 locale:

  1. Crea un repository 4.17.05 locale come descritto in "Crea un repository Apigee locale" in Installa l'utilità apigee-setup di Edge.
    Nota: se hai già un repository 4.16.09, puoi aggiungere il repository 4.17.05 come descritto in "Aggiorna un repository Apigee locale" in Installa l'utilità apigee-setup di 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 singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.17.05.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, estrai il file nella directory /tmp:
      > tar -xzf apigee-4.17.05.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.17.05.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 "Installa 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.05.sh in /tmp/bootstrap_4.17.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

      dove uName:pWord sono il nome utente e la password impostati sopra per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.
    3. Sul nodo remoto, installa l'utilità apigee-service di Edge e le dipendenze:
      > sudo bash /tmp/bootstrap_4.17.05.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:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Aggiorna l'utilità apigee-validate sul server di gestione.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aggiorna l'utilità apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    L'unico requisito per il file di configurazione è che deve essere accessibile o leggibile dall'utente "apigee".

    Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =tutti i componenti Edge ad eccezione della UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
    ui = UI Edge
    all = aggiorna tutti i componenti sulla macchina (utilizza solo per un profilo di installazione Edge aio o un profilo di installazione API BaaS asa)
    e = ElasticSearch
    b = stack API BaaS
    p = portale API BaaS
    ebp = ElasticSearch, stack API BaaS e portale API BaaS sullo stesso nodo
  8. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.

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

Ordine di aggiornamento della macchina

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

  • Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
  • Per qualsiasi macchina con più componenti Edge (Management Server, processore di messaggi, Router, QPID Server, ma non Postgres Server), 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 l'aggiornamento della monetizzazione. Viene aggiornato 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 comando seguente per scaricare la versione corretta di Qpid, come mostrato sopra:
    > yum install apigee-qpidd --disablerepo=epel

Per un'installazione autonoma con 1 host

  1. Imposta SMTPMAILFROM nel file di configurazione se hai attivato SMTP su Edge. Questo parametro ha il seguente formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Aggiorna Cassandra e ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Imposta la seguente regola iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Controlla la coda dei messaggi Qpid:
    > qpid-stat -q

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

Per un'installazione autonoma con 2 host

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

  1. Imposta SMTPMAILFROM nel file di configurazione se hai attivato SMTP su Edge. Questo parametro ha il seguente formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Aggiorna Cassandra e ZooKeeper sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Imposta la seguente regola iptables sulla macchina 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Controlla la coda dei messaggi Qpid sulla macchina 2:
    > qpid-stat -q

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

Per un'installazione in cluster con 5 host

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

  1. Imposta SMTPMAILFROM nel file di configurazione se hai attivato SMTP su Edge. Questo parametro ha il seguente formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Imposta la seguente regola iptables sulla macchina 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Controlla la coda dei messaggi Qpid sulla macchina 4:
    > qpid-stat -q

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

Per un'installazione in cluster con 9 host

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

  1. Imposta SMTPMAILFROM nel file di configurazione se hai attivato SMTP su Edge. Questo parametro ha il seguente formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Imposta la seguente regola iptables sulla macchina 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Controlla la coda dei messaggi Qpid sulla macchina 6:
    > qpid-stat -q

    Continua a controllare la coda finché il conteggio nella colonna "msg" non è pari a 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  5. Aggiorna qpidd sulla macchina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Svuota le tabelle IP sulla macchina 6:
    > sudo iptables -F
  7. Ripeti i passaggi da 3 a 6 sulla macchina 7.
  8. Aggiorna postgresql sulla macchina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Avvia postgresql sulla macchina 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Ripeti i passaggi 8 e 9 sulla macchina 7.
  11. Aggiorna LDAP sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Aggiorna i componenti Edge sulle macchine 6, 7, 8, 9, 1, 4 e 5 in questo ordine:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Aggiorna la 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. Imposta SMTPMAILFROM nel file di configurazione se hai attivato SMTP su Edge. Questo parametro ha il seguente formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Imposta la seguente regola iptables sulla macchina 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Controlla la coda dei messaggi Qpid sulla macchina 12:
    > qpid-stat -q

    Continua a controllare la coda finché il conteggio nella colonna "msg" non è pari a 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
  5. Aggiorna qpidd sulla macchina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Svuota le tabelle IP sulla macchina 12:
    > sudo iptables -F
  7. Ripeti i passaggi da 3 a 6 sulla macchina 13.
  8. Aggiorna postgresql sulla macchina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Avvia postgresql sulla macchina 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Ripeti i passaggi 8 e 9 sulla macchina 13.
  11. Aggiorna LDAP sulle macchine 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. 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
  13. 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. Imposta SMTPMAILFROM nel file di configurazione se hai attivato SMTP su Edge. Questo parametro ha il seguente formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. 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
  3. Aggiorna qpidd:
    1. Macchine 4, 5 nel data center 1
      1. Imposta la seguente regola iptables sulla macchina 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Controlla la coda dei messaggi Qpid sulla macchina 4:
        > qpid-stat -q

        Continua a controllare la coda finché il conteggio nella colonna "msg" non è pari a 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. Svuota le tabelle IP sulla macchina 4:
        > sudo iptables -F
      5. Ripeti i passaggi da 1 a 4 sulla macchina 5.
    2. Macchine 10, 11 nel data center 2
      1. Imposta la seguente regola iptables sulla macchina 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Controlla la coda di messaggi Qpid sulla macchina 10:
        > qpid-stat -q

        Continua a controllare la coda finché il conteggio nella colonna "msg" non è pari a 0. Non puoi eseguire l'upgrade di Qpid finché non ha elaborato tutti i messaggi.
      3. Aggiorna qpidd sulla macchina 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Svuota le tabelle IP sulla macchina 10:
        > sudo iptables -F
      5. Ripeti i passaggi da 1 a 4 sulla macchina 11.
  4. 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 start
  5. 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
  6. 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
  7. 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 di API BaaS 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 Stack per l'accesso da tutti gli altri nodi 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. Aggiorna lo stack ElasticSearch e API BaaS sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

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

Per un'installazione di API BaaS su 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 Stack per l'accesso da tutti gli altri nodi 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. Aggiorna Elasticsearch sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Aggiorna lo stack API BaaS sulle macchine 4, 5 e 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Aggiorna il portale API BaaS sulla macchina 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Per un'installazione non standard

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

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