Aggiorna Apigee Edge alla versione 4.16.09

Edge per Private Cloud v. 4.16.09

Versioni di Edge aggiornabili alla 4.16.09

Puoi aggiornare Apigee Edge versione 4.16.01.0x e 4.16.05.x alla versione 4.16.09.

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

Chi può eseguire l'aggiornamento

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

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

È richiesto l'upgrade a Java JDK versione 8

Questa release di Edge richiede l'installazione di Java JDK versione 8 su tutti i nodi di elaborazione perimetrale. Puoi installare Oracle JDK 8 o OpenJDK 8. Se Java JDK 8 non è già installato, lo script di aggiornamento può installarlo automaticamente.

Nell'ambito dell'aggiornamento a Java 8, alcune crittografie TLS non sono più disponibili in Oracle JDK 8. Per l'elenco completo, consulta la sezione "Suite di crittografia disabilitate predefinite" all'indirizzo http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Downgrade di Zookeeper se esegui l'aggiornamento dalla versione 16.04.01

La versione dell'RPM di Zookeeper in Edge per Private Cloud 4.16.01 è apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Nelle versioni successive di Edge, la versione di Zookeeper è stata modificata in apigee-zookeeper-3.4.5-0.0.94x. Questo impedisce a yum di eseguire l'upgrade di Zookeeper a una versione successiva dalla 4.16.01. Per correggere questa situazione, esegui yum downgrade apigee-zookeeper prima di aggiornare Zookeeper.

Puoi controllare la tua versione di Zookeeper utilizzando il seguente comando:

> rpm -qa |grep apigee-zookeeper

Se questo comando restituisce la versione Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

quindi devi eseguire il downgrade.

Propagazione automatica delle impostazioni delle proprietà

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

Aggiorna prerequisiti

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

  • Esegui il backup di tutti i nodi
    Prima dell'aggiornamento, per motivi di sicurezza ti consigliamo di eseguire un backup completo di tutti i nodi. Utilizza la procedura relativa alla versione corrente di Edge per eseguire il backup.

    In questo modo puoi avere un piano di backup nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, vedi Backup e ripristino.
  • Assicurati che Edge sia in esecuzione
    Assicurati che Edge sia in esecuzione durante il processo di aggiornamento utilizzando il comando:

    > /<inst_root>/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, quindi a eseguire di nuovo update.sh. Puoi eseguire l'aggiornamento più volte e riprenderlo dal punto in cui è stato interrotto.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, vedi Procedura di rollback 4.16.09 per ulteriori informazioni.

Informazioni sull'aggiornamento di Logging

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

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

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

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

È richiesto l'upgrade a Postgres 9.4

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

Durante il processo di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi vengono comunque scritti nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono di nuovo online, i dati di analisi vengono inviati ai nodi Postgres.

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

Installazione di un nuovo nodo standby Postgres

Questa procedura crea un server standby Postgres su un nuovo nodo. Assicurati di installare un nuovo server in standby Postgres per la versione esistente di Edge (4.16.01 o 4.16.05), non per la versione 4.16.09.

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

Per creare un nuovo nodo standby Postgres:

  1. Nel master Postgres attuale, 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 replica apigee existing_slave_ip/32 trust\ \nreplica host apigee new_slave_ip/32 trust

    dove existing_slave_ip è l'indirizzo IP dell'attuale IP new_slave e il nodo IP di standby
  2. Riavvia apigee-postgresql sul master Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql spiega
  3. Verifica che il nuovo nodo standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Nel file dovresti vedere le seguenti righe:
    replica host apigee existing_slave_ip/32 trust
    replica host apigee new_slave_ip/32 trust
  4. Installa il nuovo server standby Postgres:
    1. Modifica il file di configurazione che hai utilizzato per installare la versione attuale di Edge per specificare quanto segue:

      # indirizzo IP del master attuale:
      PG_MASTER=192.168.56.103
      # Indirizzo IP del nuovo nodo in standby
      PG_STANDBY=192.168.56.102
    2. Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
    3. Scarica il file Edge bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Nota: se esegui l'aggiornamento del file Edge4.sh

      Nota:
    4. Installa l'utilità e le dipendenze Edge apigee-service:
      > sudo bash /tmp/bootstrap_4.16.05.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 il comando seguente:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Convalida che è in standby.

Ritiro di un nodo Postgres

Al termine dell'aggiornamento, smetti di utilizzare il nuovo nodo in standby:

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

    Se Postgres non è in esecuzione, avvialo:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Ottieni l'UUID del nuovo nodo in standby eseguendo il comando cURL seguente 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, "post-10" nel formato:

  3. Arresta il nuovo nodo standby eseguendo il comando seguente 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 standby da conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host replica 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 standby sia stato rimosso visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Nel file dovresti vedere solo la seguente riga:
    replica host apigee existing_slave_ip/32 trust
  7. Elimina l'UUID del nodo in standby da ZooKeeper effettuando la seguente chiamata API di gestione perimetrale sul nodo del server di gestione:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Aggiornamento senza tempi di inattività

Un aggiornamento senza tempo di inattività, o aggiornamento in sequenza, ti consente di aggiornare l'installazione di Edge senza causare il ripristino di Edge.

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

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

  1. Aggiorna le macchine nell'ordine corretto per l'installazione come descritto di seguito in "Ordine di aggiornamento della macchina".
  2. Quando è il momento di aggiornare i router, selezionane uno qualsiasi e rendilo non raggiungibile, come descritto in Attivare/disattivare la connettività di server (processore/router).
  3. Aggiorna il router selezionato e tutti gli altri componenti Edge sulla stessa macchina del router. Tutte le configurazioni Edge mostrano un router e un processore di messaggi sullo stesso nodo.
  4. Rendi nuovamente raggiungibile il router.
  5. Ripeti i passaggi da 2 a 4 per i router rimanenti.
  6. Continua l'aggiornamento per le eventuali macchine rimanenti nell'installazione.

Prima/dopo l'aggiornamento:

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

Utilizzo di un file di configurazione invisibile all'utente

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

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

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

  1. Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
  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 nodo come root per installare gli RPM Edge.
    Nota: sebbene l'installazione RPM richieda l'accesso root, puoi eseguire la configurazione Edge senza accesso root.
  4. Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
  5. Scarica il file Edge 4.16.09 bootstrap_4.16.09.sh in /tmp/bootstrap_4.16.09.sh:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. Installa l'utilità e le dipendenze apigee-service Edge 4.16.09:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    dove uName:pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.

    Per impostazione predefinita, il programma di installazione controlla se Java 1.8 è installato. Se non lo fai, lo installa. Utilizza l'opzione JAVA_FIX per specificare come gestire l'installazione Java. JAVA_FIX accetta i seguenti valori:

    I = Installa OpenJDK 1.8 (predefinito)
    C = Continua senza installare Java
    Q = Esci. Per questa opzione, devi installare Java autonomamente.
  7. Utilizza apigee-service per aggiornare l'utilità apigee-setup:
    1. Se hai installato la versione 4.16.01 eseguendo l'upgrade di Edge versione 4.15.07.0x, devi installare l'utilità apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Questo comando installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.

      Se hai già installato l'utilità apigee-setup, aggiornala:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento
    2. Se hai installato direttamente la versione 4.16.01, ovvero non hai eseguito un upgrade dalla versione 4.15.07.0x, devi aggiornare l'utilità apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      L'aggiornamento ad apigee-service installa l'utilità apigee-setup<inapigee-setup
    3. Se hai installato la versione 4.16.05 direttamente o tramite aggiornamento, devi aggiornare l'utilità apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento

      Questo aggiornamento ad apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.
  8. A seconda della tua versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
    1. Se attualmente utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sul server di gestione:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
    2. Se al momento utilizzi Edge 4.16.01: installa l'utilità apigee-validate sul server di gestione:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Nota: se hai installato l'utilità apigee-validate su un nodo del processore di messaggistica 4.16.01.


    3. Se esegui l'upgrade dalla versione 4.16.01: modifica il file di configurazione passato all'utilità apigee-validate. Nella release Edge 4.16.01, il file di configurazione utilizzato da apigee-validate richiedeva le seguenti proprietà:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      In questa release, il file di configurazione richiede solo la proprietà APIGEE_ADMINPW. Puoi rimuovere le altre due proprietà dal file.
  9. Aggiorna l'utilità apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision
  10. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina" di seguito:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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




  11. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.
  12. Se hai installato un nuovo nodo in standby Postgres, dismettilo come descritto sopra in Discommissione di un nodo Postgres.

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

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

Se i nodi perimetrali sono protetti da un firewall o in qualche altro modo non possono accedere al repository Apigee su internet, puoi eseguire l'aggiornamento da un repository locale, o mirroring, del repository Apigee.

Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:

  • Crea un file .tar del repository, copia il file .tar in un nodo, quindi aggiorna Edge dal file .tar.
  • Installa un server web sul nodo con il repository locale in modo che altri nodi possano accedervi. Apigee ti fornisce il server web Nginx da utilizzare oppure puoi utilizzare il tuo server web personale.

Per aggiornare da un repository 4.16.09 locale:

  1. Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
  2. Crea un repository 4.16.09 locale come descritto in "Crea un repository Apigee locale" in Installa l'utilità Edge apigee-setup.
    Nota: se disponi già di un repository 4.16.01 o 4.16.05, puoi aggiungere il repository 4.16.09 come descritto in "Aggiornare un repository Apigee locale" all'indirizzo Installa l'utilità Edge apigee-setup.
  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.16.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror pacchetto
    2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella directory /tmp del nuovo nodo.
    3. Sul nuovo nodo, annulla iltar del file nella directory /tmp:
      > tar -xzf apigee-4.16.09.tar.gz

      Questo comando crea una nuova directory, denominata repository, nella directory contenente il file .tar. Ad esempio /tmp/repos.
    4. Installa l'utilità e le dipendenze Edge apigee-service da /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Tieni presente che in questo comando includi il percorso della directory repos.
  4. Per installare apigee-service utilizzando il server web Nginx:
    1. Configura il server web Nginx come descritto in "Installazione dal repository utilizzando il server web Nginx" in Installa l'utilità apigee-setup di Edge.
    2. Sul nodo remoto, scarica il file Edge bootstrap_4.16.09.sh in /tmp/bootstrap_4.16.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09: il nome utente remoteRepo:3939 /bootstrap_4.shop-6.09 è impostato sopra il nodo remoteRepo:3939/bootstrap_4.16.09.

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

  5. Utilizza apigee-service per aggiornare l'utilità apigee-setup:
    1. Se hai installato la versione 4.16.01 eseguendo l'upgrade di Edge versione 4.15.07.0x, devi installare l'utilità apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Questo comando installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.

      Se hai già installato l'utilità apigee-setup, aggiornala:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento
    2. Se hai installato direttamente la versione 4.16.01, ovvero non hai eseguito un upgrade dalla versione 4.15.07.0x, devi aggiornare l'utilità apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      L'aggiornamento ad apigee-service installa l'utilità apigee-setup <inapigee-id
    3. Se hai installato la versione 4.16.05 direttamente o tramite aggiornamento, devi aggiornare l'utilità apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento

      Questo aggiornamento ad apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.
  6. A seconda della tua versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
    1. Se attualmente utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sul server di gestione:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
    2. Se al momento utilizzi Edge 4.16.01: installa l'utilità apigee-validate sul server di gestione:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Nota: se hai installato l'utilità apigee-validate su un nodo processore apigee-apigee1


    3. Se esegui l'upgrade dalla versione 4.16.01: modifica il file di configurazione passato all'utilità apigee-validate. Nella release Edge 4.16.01, il file di configurazione utilizzato da apigee-validate richiedeva le seguenti proprietà:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      In questa release, il file di configurazione richiede solo la proprietà APIGEE_ADMINPW. Puoi rimuovere le altre due proprietà dal file.
  7. Aggiorna l'utilità apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision
  8. Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina" di seguito:
    > /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile

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

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




  9. Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.
  10. Se hai installato un nuovo nodo in standby Postgres, dismettilo come descritto sopra in Discommissione di un nodo Postgres.

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

Ordine di aggiornamento della macchina

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

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

Per un'installazione autonoma su un solo host

  1. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper:
    > yum downgrade apigee-zookeeper
  2. Aggiorna Cassandra e ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aggiorna qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Aggiorna LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Interrompi Server Postgres, Qpid server 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
  6. Aggiorna postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Aggiorna il database Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Aggiorna i restanti componenti Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Aggiorna UI Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Per un'installazione autonoma su 2 host

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

  1. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 1:
    > yum downgrade apigee-zookeeper
  2. Aggiorna Cassandra e ZooKeeper sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Aggiorna qpidd sulla macchina 2:
    > /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 sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Aggiorna UI sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Aggiorna postgresql sulla macchina 2:
    1. Interrompi 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 e sulla macchina 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Aggiorna i componenti Edge sulla macchina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Per un'installazione in cluster su 5 host

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

  1. Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
  2. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3:
    > yum downgrade apigee-zookeeper
  3. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aggiornamento di qpidd sulle macchine 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Aggiorna LDAP sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aggiorna i componenti Edge sulla macchina 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna UI sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Aggiorna le macchine 4 e 5:
    1. Interrompi 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. Interrompi server Postgres, 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-postgre
    3. Interrompi 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 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 inviando i seguenti script su entrambi i server. Il sistema deve mostrare risultati identici su entrambi i server per garantire una replica riuscita:

      Sulla macchina 4, il nodo master, esegui:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Convalida che è il master.

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

      Convalida che è lo standby.
  9. Aggiorna i componenti Edge sulla macchina 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Assicurati di ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Decommissione di un nodo Postgres.

Per un'installazione in cluster con nove host

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 sopra in Installazione di un nuovo nodo standby Postgres.
  2. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3:
    > yum downgrade apigee-zookeeper
  3. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aggiorna qpidd sulle macchine 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Aggiorna LDAP sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aggiorna i componenti Edge sulle macchine 6, 7, 1, 4 e 5 in quest'ordine:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna UI sulla macchina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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. Interrompi 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. Interrompi 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 server Postgres sulle macchine 8 e 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Avvia il server server Qpid sulle macchine 6 e 7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configura Postgres come nodo 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
    11. Verifica lo stato della replica inviando i seguenti script su entrambi i server. Il sistema deve mostrare risultati identici su entrambi i server per garantire una replica riuscita:
      Sulla macchina 8, il nodo master, esegui:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Convalida che è il master.

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

      Convalida che è lo 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 utilizzando la procedura riportata sopra in Decommissione di un nodo Postgres.

Per un'installazione in cluster con 13 host

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 sopra in Installazione di un nuovo nodo standby Postgres.
  2. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3:
    > yum downgrade apigee-zookeeper
  3. Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Aggiorna qpidd sulle macchine 12 e 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Aggiorna LDAP sulle macchine 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Aggiorna i componenti Edge sulle macchine 12, 13, 6, 7, 10 e 11 nell'ordine indicato:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aggiorna la UI sulle macchine 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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. Interrompi 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. Interrompi 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 server server Qpid sulle macchine 12 e 13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. Configura Postgres come nodo 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
    11. Verifica lo stato della replica inviando i seguenti script su entrambi i server. Il sistema deve mostrare risultati identici su entrambi i server per garantire una replica riuscita:
      Sulla macchina 8, il nodo master, esegui:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Convalida che è il master.

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

      Convalida che è lo 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 utilizzando la procedura riportata sopra in Decommissione di un nodo Postgres.

Per un'installazione in cluster con 12 host

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 sopra in Installazione di un nuovo nodo standby Postgres.
  2. Aggiorna Cassandra e ZooKeeper:
    1. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3 nel data center 1:
      > yum downgrade apigee-zookeeper
    2. Sulle macchine 1, 2 e 3 del data center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulle macchine 7, 8 e 9 nel data center 2:
      > yum downgrade apigee-zookeeper
    4. Sulle macchine 7, 8 e 9 del 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
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Macchine 10 e 11 nel data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  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. 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. Interrompi 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. Interrompi 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 server Postgres sulle macchine 6 e 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. Avvia server 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 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-re4-on-standbyFile
    11. Verifica lo stato della replica inviando i seguenti script su entrambi i server. Il sistema deve mostrare risultati identici su entrambi i server per garantire una replica riuscita:
      Sulla macchina 6, il nodo master, esegui:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Convalida che è il master.

      Sulla macchina 12, il nodo standby:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Convalida che è in standby.
  8. Aggiorna i componenti Edge sulle macchine 6 e 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Assicurati di ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Decommissione di un nodo Postgres.

Per un'installazione BaaS con API con 7 host

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

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

Per un'installazione BaaS con API con 10 host

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

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

Per un'installazione non standard

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

  1. ZooKeeper
  2. Cassandra
  3. Qpidd
  4. LDAP
  5. Edge, ovvero il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid ma non server Postgres, server di gestione, processore di messaggi e router.
    Nota: se nel nodo sono installati sia il server Qpid che il server Postgres, esegui il passaggio del profilo "-c edge" come parte del passaggio 8.
  6. UI perimetrale
  7. postgresql sul master Postgres, incluso l'upgrade.
  8. postgresql nello standby Postgres.
  9. Edge, che indica il profilo "-c edge" su tutti i nodi Qpid e Postgres combinati o su qualsiasi nodo Postgres autonomo.