Aggiornamento Apigee Edge da 4.17.05 o da 4.17.09 a 4.18.05

Edge per Private Cloud v4.18.05

In questa sezione viene descritto come eseguire i seguenti upgrade:

  • Dal 17.04.05 al 18.04.05
  • Dal 17.04.09 al 18.04.05

Chi può eseguire l'aggiornamento

L'utente che esegue l'aggiornamento deve corrispondere all'utente che ha installato inizialmente Edge, oppure a un eseguito come root.

Dopo aver installato gli RPM perimetrali, qualsiasi utente potrà configurarli.

Quali componenti devi aggiornare

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

Mantieni la compatibilità

Quando esegui l'upgrade di Apigee Edge per il cloud privato alla versione 4.18.05, devi assicurarti che dell'implementazione fa riferimento solo alle proprietà supportate nei propri file di configurazione.

Proprietà Località Descrizione
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Rimuovi questa proprietà dal file router.properties. Per impostare le opzioni di ripetizione in 4.18.05, utilizzare lo strumento virtuale di configurazione host.

Propagazione automatica della proprietà impostazioni

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

Aggiunta richiesta di SMTPMAILFROM parametro di configurazione

Edge 4.17.05 ha aggiunto un nuovo parametro obbligatorio al file di configurazione utilizzato quando abiliti un server SMTP.

Upgrade richiesto a Postgres 9.6

Questa release di Edge include un upgrade a Postgres 9.6. Nell'ambito di questo upgrade, I dati Postgres vengono migrati a Postgres 9.6.

La maggior parte dei sistemi di produzione perimetrale utilizza due nodi Postgres configurati per la replica in standby del master. Durante il processo di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi restano nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono di nuovo online, i dati di analisi viene quindi eseguito il push ai nodi Postgres.

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

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

    Se devi eseguire il rollback dell'aggiornamento, è necessario un nodo in standby Postgres aggiuntivo per qualsiasi motivo. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo in standby Postgres diventa il nodo Postgres master dopo il rollback. Pertanto, quando installi nuovo nodo di standby Postgres, deve trovarsi su un nodo che soddisfa tutti i requisiti di un server Postgres, come definiti Requisiti di installazione.

    In un'installazione con 1 e 2 nodi di Edge, le topologie utilizzate per la prototipazione e i test, hanno un solo nodo Postgres. Puoi aggiornare questi nodi Postgres direttamente senza dover per creare un nuovo nodo Postgres.

  • Se utilizzi lo spazio di archiviazione di rete per i nodi Postgres, consigliato da Apigee, non è necessario installare un nuovo nodo Postgres. Nella di seguito, puoi saltare i passaggi che specificano di installare e poi ritirare Nodo in standby Postgres.

    Prima di iniziare il processo di aggiornamento, acquisisci uno snapshot di rete del datastore utilizzato Postgres. Se poi si verificano errori durante l'aggiornamento e sei costretto a eseguire un rollback, puoi ripristinare il nodo Postgres da questo snapshot.

Installazione di un nuovo Postgres nodo in standby

Questa procedura crea un server in standby Postgres su un nuovo nodo. Assicurati di installare un nuovo Server di standby Postgres per la tua versione esistente di Edge (4.17.05 o 4.17.09), non per la versione 4.18.05.

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

Per creare un nuovo nodo in standby di Postgres:

  1. Nel master Postgres attuale, modifica /opt/apigee/customer/application/postgresql.properties per impostare il seguente token. Se il file non esiste, crealo: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    Dove existing_slave_ip è l'indirizzo IP dell'attuale Postgres server in standby e new_slave_ip è l'indirizzo IP del nuovo nodo in standby.

  2. Riavvia apigee-postgresql nel master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifica che il nuovo nodo in standby sia stato aggiunto visualizzando la /opt/apigee/apigee-postgresql/conf/pg_hba.conf file nel master. Dovresti vedere le seguenti righe del file: 
    host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
  4. Installa il nuovo server di standby Postgres:
    1. Modifica il file di configurazione che hai utilizzato per installare la versione corrente di Edge per specificare le seguenti: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Disabilita SELinux come descritto in Installa l'utilità apigee-setup Edge.
    3. Scarica il file bootstrap_4.17.0x.sh di Edge, dove x è 5 (per 4.17.05) o 9 (per 4.17.09) per /tmp/bootstrap_4.17.0x.sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Installa l'utilità e le dipendenze Edge apigee-service: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. Usa apigee-service per installare l'utilità apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Installa Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Sul nuovo nodo in standby, esegui questo comando: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Verifica che dica che è in standby.

Ritiro di un nodo Postgres

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

  1. Assicurati che Postgres sia in esecuzione: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Se Postgres non è in esecuzione, avvialo: 

    /opt/apigee/apigee-service/bin/apigee-all start

  2. Recupera l'UUID del nuovo nodo in standby eseguendo il seguente comando cURL sul nuovo nodo nodo in standby: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Dovresti vedere l'UUID del nodo alla fine dell'output, nel formato: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Arresta il nuovo nodo in standby eseguendo il comando seguente sul nuovo nodo in standby: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Sul nodo master Postgres, modifica /opt/apigee/customer/application/postgresql.properties per rimuovere il nuovo nodo in standby da conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
  5. Riavvia apigee-postgresql sul master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Verifica che il nuovo nodo in standby sia stato rimosso visualizzando la /opt/apigee/apigee-postgresql/conf/pg_hba.conf file nel master. Dovresti vedere solo la seguente riga del file: 
    host replication apigee existing_slave_ip/32 trust
  7. Elimina l'UUID del nodo in standby da ZooKeeper eseguendo la seguente gestione perimetrale Chiamata API sul nodo del server di gestione: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

Aggiorna prerequisiti

Controlla i seguenti prerequisiti prima di eseguire l'upgrade di Apigee Edge:

  • Esegui il backup di tutti i nodi
    Prima di eseguire l'aggiornamento, è consigliabile 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, consulta la sezione 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

Gestione di un aggiornamento non riuscito

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 continuarlo dal punto in cui era stato interrotto disattivata.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta Esegui il rollback 4.18.05 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, scrive il log 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 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 in Ordine di aggiornamento della macchina.
  2. Quando è il momento di aggiornare i router, selezionare un router qualsiasi e renderlo irraggiungibile, come descritto in Attivazione/disattivazione del server (Processore di messaggi/router) Raggiungibilità.
  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/dopo l'aggiornamento, prendi in considerazione quanto segue:

  • Sul nodo combinato router e processore di messaggi:
    • Prima dell'aggiornamento, esegui queste operazioni:
      1. Rendi il router irraggiungibile.
      2. Rendi il processore di messaggi irraggiungibile.
    • Dopo l'aggiornamento, procedi nel seguente modo:
      1. Rendi raggiungibile il processore di messaggi.
      2. Rendi il router raggiungibile.
  • Su singolo nodo router:
    • Prima dell'aggiornamento, assicurati che il router non sia raggiungibile.
    • Dopo l'aggiornamento, rendi il router raggiungibile.
  • Su 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 al comando update. Il file di configurazione invisibile dovrebbe essere lo stesso usato per installare Edge 4.17.0x.

Aggiorna a 4.18.05 su un nodo con una connessione Internet esterna

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

  1. Se attualmente utilizzi la replica master-standby di Postgres con spazio di archiviazione locale, installare un nuovo nodo in standby di Postgres come descritto in Installare un nuovo nodo di Postgres nodo in standby.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Prendi invece un uno snapshot di rete del datastore utilizzato da Postgres. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  2. Se presente, disabilita tutti i job CRON configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
  3. Accedi al tuo nodo come root per installare gli RPM perimetrali.
  4. Installa yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Disabilita SELinux come descritto in Installare l'utilità apigee-setup di Edge.
  6. Se esegui l'installazione su Oracle 7.x, esegui questo comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Se esegui l'installazione su AWS, esegui quanto segue 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
  8. Scarica il file Edge 4.18.05 bootstrap_4.18.05.sh in /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Installa l'utilità e le dipendenze Edge 4.18.05 apigee-service: 
    sudo bash /tmp/bootstrap_4.18.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 Java dell'installazione. JAVA_FIX assume i seguenti valori:

    • I = Installa OpenJDK 1.8 (predefinito)
    • C = Continua senza installare Java
    • D = Esci. Per questa opzione, devi installare Java personalmente.
  10. Usa apigee-service per aggiornare l'utilità apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Aggiorna l'utilità apigee-validate sul server di gestione: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Aggiorna l'utilità apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto in Ordine di aggiornamento della macchina: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    Utilizza l'opzione -c per specificare il componente da aggiornare. L'elenco delle possibili includono:

    • "cs" = Cassandra
    • "E" = ElasticSearch
    • "bordo" =Tutti i componenti Edge tranne l'UI Edge. Il "bordo" il componente include Server di gestione, processore di messaggi, router, server QPID, server Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = SSO perimetrale
    • "UI" = UI perimetrale
    • "zk" = Zookeeper

    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
  14. Se non lo hai già fatto, riavvia il componente Edge UI su tutte le macchine che lo eseguono: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Testa l'aggiornamento eseguendo l'utilità apigee-validate in Gestione come descritto in Testare l'installazione.
  16. Se hai installato un nuovo nodo in standby Postgres, dismetti il nodo come descritto in Il ritiro di un Nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Consulta Obbligatorio per l'upgrade a Postgres 9.6 per ulteriori informazioni.

Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in Eseguire il rollback della versione 4.18.05.

Aggiornamento alla versione 4.18.05 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.18.05 locale:

  1. Se attualmente utilizzi la replica master-standby di Postgres, installa un nuovo Postgres nodo in standby come descritto in Installare un nuovo Postgres nodo in standby.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Prendi invece un uno snapshot di rete del datastore utilizzato da Postgres. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  2. Crea un repository 4.18.05 locale come descritto in "Creare un repository Apigee locale" su Installa l'utilità apigee-setup Edge.
  3. 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.18.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 in nella directory /tmp sul nuovo nodo.
    3. Sul nuovo nodo, sposta il file nella directory /tmp: 
      tar -xzf apigee-4.18.05tar.gz

      Questo comando crea una nuova directory, denominata repository, nella directory contenente il file . ad esempio /tmp/repos.

    4. Installa l'utilità apigee-service Edge e le dipendenze da /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Nota che in questo comando viene incluso il percorso della directory dei repository.

  4. 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" alla pagina Installare Edge apigee-setup.
    2. Sul nodo remoto, scarica il file Edge bootstrap_4.18.05.sh su /tmp/bootstrap_4.18.05.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.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à Edge apigee-service e delle dipendenze: 
      sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  5. Usa apigee-service per aggiornare l'utilità apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Aggiorna l'utilità apigee-validate sul server di gestione: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Aggiorna l'utilità apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. 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

    L'unico requisito del file di configurazione è che quest'ultimo deve essere accessibile o leggibile da "apigee" utente.

    Utilizza l'opzione -c per specificare il componente da aggiornare. L'elenco delle possibili includono:

    • "cs" = Cassandra
    • "E" = ElasticSearch
    • "bordo" =Tutti i componenti Edge tranne l'UI Edge. Il "bordo" il componente include Server di gestione, processore di messaggi, router, server QPID, server Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = SSO perimetrale
    • "UI" = UI perimetrale
    • "zk" = Zookeeper

    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
  9. Riavvia il componente Edge UI su tutte le macchine che lo eseguono, se non lo hai già fatto: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Testa l'aggiornamento eseguendo l'utilità apigee-validate in Gestione come descritto in Testare l'installazione.
  11. Se hai installato un nuovo nodo in standby Postgres, dismetti il nodo come descritto in Disattivazione un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in Eseguire il rollback della versione 4.18.05.

Ordine di aggiornamento della macchina

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

  • 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, server QPID ma non server Postgres), utilizza "-c edge" per aggiornarli 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 aggiornato quando specifichi bordo" .
di Gemini Advanced.

Installazione autonoma con un nodo

  1. Aggiorna Cassandra e ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aggiorna Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aggiorna LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Arresta il server Postgres, il server Qpid e PostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Aggiorna postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Aggiorna il database Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. Aggiorna i restanti componenti Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Aggiorna UI Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (Se hai installato SSO Edge) Aggiorna SSO Edge: 
    /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 Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Installazione autonoma a 2 nodi

Consulta Topologie di installazione per l'elenco di 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 Qpid sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aggiorna LDAP sul computer 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Aggiorna i componenti Edge sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Aggiorna l'interfaccia utente sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Se hai installato SSO Edge) Aggiorna SSO Edge 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.

  7. Aggiorna postgresql sulla macchina 2:
    1. Arresta server Postgres, server Qpid e postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Aggiorna postgresql: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Aggiorna il database Postgres: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Aggiorna i componenti Edge sulla macchina 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Riavvia il componente UI Edge sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Installazione a 5 nodi

Consulta Topologie di installazione per l'elenco di e numeri di nodi.

  1. Assicurati di aver installato un nuovo nodo in standby Postgres come descritto in Installazione un nuovo nodo in standby di Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Prendi invece un uno snapshot di rete del datastore utilizzato da Postgres. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  2. Aggiorna Cassandra e ZooKeeper sulla macchina 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aggiorna Qpid sulle macchine 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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 SSO Edge) Aggiorna SSO Edge 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.

  8. Aggiorna le macchine 4 e 5:
    1. Arresta il server Postgres e il server Qpid sulla macchina 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Arresta il server Postgres, il server Qpid e postgresql sulla macchina 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Se installato, arresta il server Postgres e postgresql nel nuovo standby che hai aggiunto per il rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Aggiorna postgresql sulle macchine 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Aggiorna il database Postgres sulla macchina 4 (solo master PostgreSQL): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Aggiorna postgresql sulle macchine 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Avvia il server Postgres e il server Qpid sulle macchine 4 e 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. Configura Postgres come nodo in standby eseguendo i comandi seguenti sulla macchina 5: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. Verifica lo stato della replica inviando i seguenti script su entrambi i server. La deve visualizzare risultati identici su entrambi i server per garantire una replica corretta:
      • Nella macchina 4, il nodo master, esegui: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Verifica che sia l'istanza principale.

      • Nella macchina 5, il nodo in standby: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Verifica che dica che è in standby.

  9. Aggiorna i componenti Edge sul computer 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Assicurati di ritirare il nuovo nodo in standby come descritto in Disattivazione un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  11. Riavvia il componente UI Edge sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Cluster a 9 nodi installazione

Consulta Topologie di installazione per l'elenco di e numeri di nodi.

  1. Assicurati di aver installato un nuovo nodo in standby Postgres come descritto in Installazione un nuovo nodo in standby di Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Prendi invece un uno snapshot di rete del datastore utilizzato da Postgres. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  2. Aggiorna Cassandra e ZooKeeper sulla macchina 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aggiorna Qpid sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 1, 4 e 5 in questo ordine: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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 SSO Edge) Aggiorna SSO Edge 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.

  8. Aggiorna le macchine 8 e 9:
    1. Arresta il server Postgres sulla macchina 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Arresta il server Postgres e postgresql sulla macchina 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arresta il server Qpid sulle macchine 6 e 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se installato, arresta il server Postgres e postgresql nel nuovo standby che hai aggiunto per il rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Aggiorna postgresql sulle macchine 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aggiorna il database Postgres sulla macchina 8 (solo master PostgreSQL): 
      /-->
opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aggiorna postgresql sulle macchine 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Avvia il server Postgres sulle macchine 8 e 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Avvia il server Qpid sulle macchine 6 e 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configura Postgres come nodo in standby eseguendo i comandi seguenti sulla macchina 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Verifica lo stato della replica inviando i seguenti script su entrambi i server. La deve visualizzare risultati identici su entrambi i server per garantire una replica corretta:
      • Sulla macchina 8, il nodo master, esegui: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Verifica che sia l'istanza principale.

      • Nella macchina 9, il nodo in standby: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Verifica che dica che è in standby.

  9. Aggiorna i componenti Edge sulle macchine 8 e 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Assicurati di ritirare il nuovo nodo in standby come descritto in Disattivazione un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  11. Riavvia il componente UI Edge sulla macchina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Installazione in cluster a 13 nodi

Consulta Topologie di installazione per l'elenco di e numeri di nodi.

  1. Assicurati di aver installato un nuovo nodo in standby Postgres come descritto in Installazione un nuovo nodo in standby di Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Prendi invece un uno snapshot di rete del datastore utilizzato da Postgres. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  2. Aggiorna Cassandra e ZooKeeper sulla macchina 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aggiorna Qpid sulle macchine 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 sulla macchina 12, 13, 6, 7, 10 e 11 in questo ordine: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna l'interfaccia utente sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se hai installato SSO Edge) Aggiorna SSO Edge sui computer 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.

  8. Aggiorna le macchine 8 e 9:
    1. Arresta il server Postgres sulla macchina 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Arresta il server Postgres e postgresql sulla macchina 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arresta il server Qpid sulle macchine 12 e 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se installato, arresta il server Postgres e postgresql nel nuovo standby che hai aggiunto per il rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Aggiorna postgresql sulle macchine 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aggiorna il database Postgres sulla macchina 8 (solo master PostgreSQL): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aggiorna postgresql sulle macchine 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Avvia il server Postgres sulle macchine 8 e 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Avvia il server Qpid sulle macchine 12 e 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configura Postgres come nodo in standby eseguendo i comandi seguenti sulla macchina 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Verifica lo stato della replica inviando i seguenti script su entrambi i server. La deve visualizzare risultati identici su entrambi i server per garantire una replica corretta:
      • Sulla macchina 8, il nodo master, esegui: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Verifica che sia l'istanza principale.

      • Nella macchina 9, il nodo in standby: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Verifica che dica che è in standby.

  9. Aggiorna i componenti Edge sulle macchine 8 e 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Assicurati di ritirare il nuovo nodo in standby come descritto in Disattivazione un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  11. Riavvia il componente Edge UI sulle macchine 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Installazione in cluster a 12 nodi

Consulta Topologie di installazione per l'elenco di e numeri di nodi.

  1. Assicurati di aver installato un nuovo nodo in standby Postgres come descritto in Installazione un nuovo nodo in standby di Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Prendi invece un uno snapshot di rete del datastore utilizzato da Postgres. Consulta Obbligatorio per l'upgrade a Postgres 9.6 per ulteriori informazioni.

  2. 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
  3. 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. Ripeti il passaggio 1 sulla macchina 5.
    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. Ripeti il passaggio 1 sulla macchina 11.
  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 di Edge:
    1. Macchine 4, 5, 1, 2, 3 nel data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Macchine 10, 11, 7, 8, 9 nel data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna UI:
    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
  7. (Se hai installato SSO Edge) Aggiorna SSO Edge:
      .
    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.

  8. Aggiorna la macchina 6 nel data center 1 e 12 nel data center 2:
      .
    1. Arresta il server Postgres sulla macchina 6: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Arresta il server Postgres e postgresql sulla macchina 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Arresta il server Qpid sulle macchine 4, 5, 10 e 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se installato, arresta il server Postgres e postgresql nel nuovo standby che hai aggiunto per il rollback: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Aggiorna postgresql sulle macchine 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Aggiorna il database Postgres sulla macchina 6 (solo master PostgreSQL): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Aggiorna postgresql sulle macchine 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Avvia il server Postgres sulle macchine 6 e 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Avvia il server Qpid sulle macchine 4, 5, 10 e 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configura Postgres come nodo in standby eseguendo i comandi seguenti sulla macchina 12: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. Verifica lo stato della replica inviando i seguenti script su entrambi i server. La dovrebbe visualizzare risultati identici su entrambi i server per garantire replica:

      Sulla macchina 6, il nodo master, esegui:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Verifica che sia l'istanza principale.

      Nella macchina 12, il nodo in standby:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Verifica che dica che è in standby.

  9. Aggiorna i componenti Edge sulle macchine 6 e 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Assicurati di ritirare il nuovo nodo in standby come descritto in Rimuovere un Postgres nodo.

    Se utilizzi lo spazio di archiviazione di rete, non è necessario installare il nuovo nodo. Consulta È necessario eseguire l'upgrade a Postgres 9.6 per ulteriori informazioni.

  11. Riavvia il componente UI Edge sulle macchine 1 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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 "-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. UI Edge
  7. SSO perimetrale

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