Aggiornamento Apigee Edge da 4.17.05 o da 4.17.09 a 4.18.05

Edge for Private Cloud v4.18.05

Questa sezione descrive come eseguire i seguenti upgrade:

  • Dalla versione 4.17.05 alla versione 4.18.05
  • Dalla versione 4.17.09 alla versione 4.18.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.

Mantieni la compatibilità

Quando esegui l'upgrade di Apigee Edge for Private Cloud alla versione 4.18.05, devi assicurarti che l'implementazione risultante faccia riferimento solo alle proprietà supportate nei 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 nella versione 4.18.05, utilizza le proprietà di configurazione dell'host virtuale.

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.

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.

Upgrade obbligatorio a Postgres 9.6

Questa release di Edge include un upgrade a Postgres 9.6. Nell'ambito di questo upgrade, viene eseguita la migrazione di tutti i dati Postgres a Postgres 9.6.

La maggior parte dei sistemi di produzione Edge utilizza due nodi Postgres configurati per la replica master-standby. Durante il processo di aggiornamento, mentre i nodi Postgres non sono attivi per l'aggiornamento, i dati di analisi vengono comunque scritti nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono tornati online, i dati di analisi vengono inviati ai nodi Postgres.

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

  • Se utilizzi il datastore locale per i nodi Postgres, devi installare un nuovo nodo Postgres in standby per la durata dell'upgrade. Al termine dell'upgrade, puoi dismettere il nuovo nodo di standby Postgres.

    Il nodo di standby Postgres aggiuntivo è necessario se devi eseguire il rollback dell'aggiornamento per qualsiasi motivo. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo standby Postgres diventa il nodo master Postgres dopo il rollback. Pertanto, quando installi il nuovo nodo standby Postgres, questo deve trovarsi su un nodo che soddisfi tutti i requisiti hardware di un server Postgres, come definito nei Requisiti di installazione di Edge.

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

  • Se utilizzi lo spazio di archiviazione di rete per i nodi Postgres, come consigliato da Apigee, non devi installare un nuovo nodo Postgres. Nelle procedure riportate di seguito, puoi saltare i passaggi che specificano di installare e successivamente dismettere un nuovo nodo standby Postgres.

    Prima di iniziare la procedura di aggiornamento, acquisisci uno snapshot di rete del datastore utilizzato da Postgres. In questo modo, se si verificano errori durante l'aggiornamento e devi eseguire un rollback, puoi ripristinare il nodo Postgres da quello snapshot.

Installazione di un nuovo nodo standby Postgres

Questa procedura crea un server di standby Postgres su un nuovo nodo. Assicurati di installare un nuovo server Postgres in standby per la 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 attuale di Edge.

Per creare un nuovo nodo standby Postgres:

  1. Nel master Postgres corrente, modifica il file /opt/apigee/customer/application/postgresql.properties per impostare il token seguente. 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 del server Postgres in standby attuale e new_slave_ip è l'indirizzo IP del nuovo nodo in standby.

  2. Riavvia apigee-postgresql sul master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifica che il nuovo nodo di standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Dovresti vedere le seguenti righe nel 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 utilizzato per installare la versione attuale di Edge per specificare quanto segue: 
      # 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. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di 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) in /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à Edge apigee-service e le dipendenze: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. Utilizza 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 standby, esegui questo comando: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Verifica che sia indicato che si tratta della modalità standby.

Disattivazione di un nodo Postgres

Al termine dell'aggiornamento, dismetti il nuovo nodo di 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 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 standby eseguendo questo comando sul nuovo nodo 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 di standby sia stato rimosso visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Dovresti vedere solo la seguente riga nel file: 
    host replication apigee existing_slave_ip/32 trust
  7. Elimina l'UUID del nodo in standby da ZooKeeper effettuando la seguente chiamata API di gestione Edge sul nodo del server di gestione: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

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 riserva nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, consulta Backup e ripristino.

  • Assicurati che Edge sia in esecuzione
    Assicurati che Edge sia 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 Esegui il rollback della versione 4.18.05 per saperne di più.

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 in Ordine di aggiornamento delle macchine.
  2. Quando è il momento di aggiornare i router, seleziona un router e rendilo non raggiungibile, come descritto in Abilitazione/disabilitazione 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 di 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 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 che hai utilizzato per installare Edge 4.17.0x.

Aggiorna alla versione 4.18.05 su un nodo con una connessione a internet esterna

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

  1. Se al momento utilizzi la replica master-standby di Postgres con lo spazio di archiviazione locale, installa un nuovo nodo standby di Postgres come descritto in Installazione di un nuovo nodo standby di Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non devi installare il nuovo nodo. In alternativa, acquisisci uno snapshot di rete del datastore utilizzato da Postgres. Per saperne di più, consulta Upgrade obbligatorio a Postgres 9.6.

  2. Se presenti, disattiva i cron job configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
  3. Accedi al nodo come root per installare gli RPM Edge.
  4. Installa yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
  6. Se l'installazione avviene su Oracle 7.x, esegui questo comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Se stai eseguendo l'installazione su AWS, esegui i seguenti yum-configure-manager comandi: 
    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à apigee-service Edge 4.18.05 e le dipendenze: 
    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 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.
  10. Utilizza 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 delle macchine: 
    /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:

    • "cs" = Cassandra
    • "e" = ElasticSearch
    • "edge" =tutti i componenti Edge, ad eccezione della UI Edge. Il componente "edge" include Management Server, processore di messaggi, Router, QPID Server, Edge Postgres Server.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = Interfaccia utente di Edge
    • "zk" = Zookeeper

    Puoi eseguire update.sh su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione all-in-one (aio) di Edge. Ad esempio:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Se non l'hai ancora fatto, riavvia il componente Edge UI su tutte le macchine su cui è in esecuzione: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.
  16. Se hai installato un nuovo nodo standby Postgres, dismetti il nodo come descritto in Dismissione di un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non devi 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 Esegui il rollback della versione 4.18.05.

Esegui l'aggiornamento alla versione 4.18.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, ma puoi anche utilizzare il tuo server web.

Per eseguire l'aggiornamento da un repository 4.18.05 locale:

  1. Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby di Postgres come descritto in Installazione di un nuovo nodo standby di Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non devi installare il nuovo nodo. In alternativa, acquisisci 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 "Crea un repository Apigee locale" in Installa l'utilità apigee-setup di Edge.
  3. 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.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 nella directory /tmp sul nuovo nodo.
    3. Sul nuovo nodo, decomprimi il file nella directory /tmp: 
      tar -xzf apigee-4.18.05tar.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.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Tieni presente che in questo comando includi 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 "Installa dal repository utilizzando il server web Nginx" in Installa l'utilità Edge apigee-setup.
    2. Sul nodo remoto, scarica il file Edge bootstrap_4.18.05.sh in /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 impostati in precedenza per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.

    3. Sul nodo remoto, installa l'utilità Edge apigee-service e le 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. Utilizza 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 nodi nell'ordine descritto in Ordine di aggiornamento delle macchine: 
    /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:

    • "cs" = Cassandra
    • "e" = ElasticSearch
    • "edge" =tutti i componenti Edge, ad eccezione della UI Edge. Il componente "edge" include Management Server, processore di messaggi, Router, QPID Server, Edge Postgres Server.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = Interfaccia utente di Edge
    • "zk" = Zookeeper

    Puoi eseguire update.sh su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione all-in-one (aio) di Edge. Ad esempio:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Se non l'hai ancora fatto, riavvia il componente Edge UI su tutte le macchine su cui è in esecuzione: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.
  11. Se hai installato un nuovo nodo standby Postgres, dismetti il nodo come descritto in Dismissione di un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non devi 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 Esegui il rollback della versione 4.18.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, Message Processor, 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".

Installazione autonoma a 1 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 l'interfaccia utente di Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (Se hai installato Edge SSO) Aggiorna Edge SSO: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. Riavvia il componente Edge UI: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Installazione autonoma a 2 nodi

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. Aggiorna Qpid sulla macchina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aggiorna LDAP sulla macchina 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 la UI sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Se hai installato Edge SSO) Aggiorna Edge SSO sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  7. Aggiorna postgresql sulla macchina 2:
    1. 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
    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 con 5 nodi

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

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

    Se utilizzi lo spazio di archiviazione di rete, non devi installare il nuovo nodo. In alternativa, acquisisci 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 sulle macchine 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 sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna i componenti Edge sulle macchine 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna la UI sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se hai installato Edge SSO) Aggiorna Edge SSO sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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 installati, arresta il server Postgres e postgresql sul nuovo nodo 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 Postgres): 
      /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 seguenti comandi 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 eseguendo i seguenti script su entrambi i server. Il sistema dovrebbe visualizzare risultati identici su entrambi i server per garantire una replica corretta:
      • Sulla macchina 4, il nodo master, esegui: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Verifica che sia indicato che si tratta del master.

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

        Verifica che sia indicato che si tratta della modalità standby.

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

    Se utilizzi lo spazio di archiviazione di rete, non devi 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 con 9 nodi

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

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

    Se utilizzi lo spazio di archiviazione di rete, non devi installare il nuovo nodo. In alternativa, acquisisci 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 sulle macchine 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 sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna i componenti Edge sulle macchine 6, 7, 1, 4 e 5 in questo ordine: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna la UI sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se hai installato Edge SSO) Aggiorna Edge SSO sulla macchina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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 installati, arresta il server Postgres e postgresql sul nuovo nodo 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 Postgres): 
      /-->
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 seguenti comandi 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 eseguendo i seguenti script su entrambi i server. Il sistema dovrebbe 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 indicato che si tratta del master.

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

        Verifica che sia indicato che si tratta della modalità 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 dismettere il nuovo nodo in standby come descritto in Dismissione di un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non devi 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 con 13 nodi

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

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

    Se utilizzi lo spazio di archiviazione di rete, non devi installare il nuovo nodo. In alternativa, acquisisci 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 sulle macchine 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 sulle macchine 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aggiorna i componenti Edge sulle macchine 12, 13, 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 Edge SSO) Aggiorna Edge SSO sulle macchine 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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 installati, arresta il server Postgres e postgresql sul nuovo nodo 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 Postgres): 
      /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 seguenti comandi 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 eseguendo i seguenti script su entrambi i server. Il sistema dovrebbe 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 indicato che si tratta del master.

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

        Verifica che sia indicato che si tratta della modalità 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 dismettere il nuovo nodo in standby come descritto in Dismissione di un nodo Postgres.

    Se utilizzi lo spazio di archiviazione di rete, non devi 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 con 12 nodi

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

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

    Se utilizzi lo spazio di archiviazione di rete, non devi installare il nuovo nodo. In alternativa, acquisisci 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:
    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. Aggiorna qpidd sulla macchina 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 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 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
  7. (Se hai installato Edge SSO) Aggiorna Edge SSO:
    1. Macchina 1 nel data center 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Macchina 7 nel data center 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. Aggiorna la macchina 6 nel data center 1 e la macchina 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 installati, arresta il server Postgres e postgresql sul nuovo nodo 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 Postgres): 
      /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 seguenti comandi 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 eseguendo i seguenti script su entrambi i server. Il sistema dovrebbe visualizzare risultati identici su entrambi i server per garantire una replica corretta:

      Sulla macchina 6, il nodo master, esegui:

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

      Verifica che sia indicato che si tratta del master.

      Sulla macchina 12, il nodo in standby:

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

      Verifica che sia indicato che si tratta della modalità 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 Ritiro di un nodo Postgres.

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

  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 il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, Edge Postgres Server, Management Server, processore di messaggi e Router.
  6. UI Edge
  7. Edge SSO

Al termine dell'aggiornamento, assicurati di riavviare il componente Edge UI su tutte le macchine che lo eseguono.