Edge for Private Cloud versione 4.16.09
Quali versioni di Edge possono essere aggiornate alla versione 4.16.09
Puoi aggiornare Apigee Edge 4.16.01.0x e 4.16.05.x alla versione 4.16.09.
Se hai una versione di Edge precedente alla 4.16.01, devi prima eseguire la migrazione alla versione 4.16.01.x e poi aggiornarla alla versione 4.16.09.
L'utente che esegue l'aggiornamento deve essere lo stesso che ha installato Edge in origine o un utente che esegue come utente root.
Dopo aver installato gli RPM perimetrali, qualsiasi utente potrà configurarli.
Upgrade obbligatorio alla versione 8 di Java JDK
Questa release di Edge richiede l'installazione di Java JDK versione 8 su tutti i nodi di elaborazione Edge. È possibile installare Oracle JDK 8 o OpenJDK 8. Se Java JDK 8 non è già installato, lo script di aggiornamento può installarlo per te.
Nell'ambito dell'aggiornamento a Java 8, alcuni algoritmi di crittografia TLS non sono più disponibili in Oracle JDK 8. Per l'elenco completo, consulta la sezione "Suite di crittografia disattivate per impostazione predefinita" all'indirizzo http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
Avviso: questa release di Edge non supporta JDK 7. Se attualmente utilizzi JDK 7 con Edge 4.16.01, devi eseguire l'upgrade a JDK 8. Se esegui il rollback dell'installazione di Edge 4.16.09, puoi eventualmente riconfigurare Edge in modo che utilizzi Java JDK 7.
Downgrade di Zookeeper se esegui l'aggiornamento da 4.16.01
La versione dell'RPM di Zookeeper in Edge for 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 ripristinata in apigee-zookeeper-3.4.5-0.0.94x .
In questo modo, yum impedisce l'upgrade di Zookeeper a una versione successiva alla 4.16.01. Il modo per correggerla è eseguire yum downgrade apigee-zookeeper prima di aggiornare Zookeeper.
Puoi controllare la versione di Zookeeper utilizzando il seguente comando:
> rpm -qa |grep apigee-zookeeper
Se questo comando restituisce la versione di Zookeeper:
apigee-zookeeper-3.4.5-1.0.905
e poi devi eseguire il downgrade.
Propagazione automatica delle impostazioni
della proprietà
Se hai impostato proprietà modificando i file .properties in /opt/apigee/customer/application , questi valori vengono mantenuti dall'aggiornamento.
Aggiorna i 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. Utilizza la procedura per la versione corrente di Edge per eseguire il backup.
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 la procedura 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 aggiornamento, puoi provare a correggere il problema, quindi eseguire di nuovo update.sh. Puoi eseguire l'aggiornamento più volte e continuarlo dal punto in cui era stato interrotto.
Se l'errore richiede di eseguire il rollback dell'aggiornamento alla versione precedente, consulta la sezione 4.16.09 Procedura di rollback per saperne di più.
Nota: le topologie all-in-one e a 2 nodi di Edge sono progettate per gli ambienti di iniziazione e prototipazione, non per la produzione. Pertanto, non è prevista alcuna procedura di rollback per le topologie all-in-one e a due nodi. Se l'aggiornamento di queste topiarie non va a buon fine e la ripetizione dell'aggiornamento non risolve il problema, l'opzione più semplice è eseguire una nuova installazione di 4.16.09.
Per impostazione predefinita, l'utilità update.sh
scrive le informazioni dei 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 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 va a buon fine.
Upgrade obbligatorio 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 di Postgres a Postgres 9.4.
Durante il processo di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi continuano a essere 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.
Avviso: la maggior parte dei sistemi di produzione Edge utilizza la replica master-standby di Postgres. Se la tua installazione attuale utilizza la replica master-standby di Postgres, nell'ambito della procedura di upgrade devi installare un nuovo nodo standby Postgres per la durata dell'upgrade.
Una volta completato l'upgrade, puoi ritirare il nodo in standby Postgres.
Il nodo Postgres standby aggiuntivo è necessario se devi eseguire il rollback dell'aggiornamento per qualsiasi motivo. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo Postgres di standby diventa il nodo Postgres master dopo il rollback. Pertanto, quando installi il nuovo nodo Postgres di riserva, deve essere su un nodo che soddisfi 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 Postgres di riserva su un nuovo nodo. Assicurati di installare un nuovo server di standby Postgres per la tua 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 utilizzato per installare la versione corrente di Edge.
Per creare un nuovo nodo Postgres di standby:
Nell'attuale master Postgres, modifica il file /opt/apigee/customer/application/postgresql.properties per impostare il seguente token. Se questo 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 il nuovo IP_slave_ip è il nuovo indirizzo IP in standby del server Post_slave attuale e il nuovo indirizzo IP in standby è l'indirizzo IP del server Post_slave attuale
Riavviare apigee-postgresql
sul master Postgres:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Verifica che il nuovo nodo in standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf
sul master. In questo file dovresti vedere le seguenti righe:
host replication apigee
existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Installa il nuovo server Postgres di standby:
Modifica il file di configurazione utilizzato per installare la versione corrente di Edge in modo da specificare quanto segue:
# Indirizzo IP del master corrente:
PG_MASTER=192.168.56.103
# Indirizzo IP del nuovo nodo di standby
PG_STANDBY=192.168.56.102
Disattiva SELinux come descritto in Installa l'utilità di configurazione di Edge
apigee-setup .
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 stai eseguendo l'aggiornamento da 4.16.01, scarica il file bootstrap.sh di Edge.
Installa l'utilità apigee-service di Edge e le dipendenze:
> sudo bash
/tmp/bootstrap_4.16.05.sh apigeeuser=uName
apigeepassword=pWord
Utilizza apigee-service per installare l'utilità apigee-setup:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Installa Postgres:
>
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f
configFile
Sul nuovo nodo in standby, esegui questo comando:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-standby
Verifica che sia indicato in standby.
Ritiro di un nodo Postgres
Al termine dell'aggiornamento, dismetti il nuovo nodo in standby:
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
Arresta il nuovo nodo in standby eseguendo il seguente comando sul nuovo nodo in standby:
>
/opt/apigee/apigee-service/bin/apigee-all stop
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
replica apigee existing_slave_ip /32 trust
Riavvia apigee-postgresql sul master Postgres:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql riavvio
Verifica che il nuovo nodo di standby sia stato rimosso visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. In questo file dovresti vedere solo la riga seguente:
host replication apigee
existing_slave_ip /32 trust
Elimina l'UUID del nodo standby da ZooKeeper effettuando la seguente chiamata API di gestione perimetrale sul nodo di Management Server:
> curl -u
sysAdminEmail:password -X DELETE
http://<ms_IP> :8080/v1/servers/<new_slave_uuid>
Aggiornamento senza tempi di inattività
Un aggiornamento senza tempi di inattività o in sequenza ti consente di aggiornare l'installazione di Edge senza interrompere il servizio.
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 ogni router, uno alla volta, dal bilanciatore del carico. Aggiorna quindi il router e tutti gli altri componenti sulla stessa macchina del router,
quindi aggiungi di nuovo il router al bilanciatore del carico.
Aggiorna le macchine nell'ordine corretto per l'installazione come descritto di seguito in "Ordine di aggiornamento della macchina".
Al momento dell'aggiornamento dei router, seleziona un router qualsiasi e rendilo irraggiungibile, come descritto in Attivare/disattivare la connettività del server (processore di messaggi/router) .
Aggiorna il router selezionato e tutti gli altri componenti Edge sulla stessa macchina del router.
Tutte le configurazioni Edge mostrano un router e un elaboratore di messaggi sullo stesso nodo.
Rendi di nuovo raggiungibile il router.
Ripeti i passaggi da 2 a 4 per gli altri router.
Continua l'aggiornamento per eventuali macchine rimanenti nell'installazione.
Tieni presente quanto segue prima/dopo l'aggiornamento:
Nel nodo Router e Message Processor combinato:
Prima dell'aggiornamento:
Rendi il router irraggiungibile.
Rendi il processore di messaggi non raggiungibile.
Dopo l'aggiornamento:
Rendi raggiungibile il processore di messaggi.
Rendi il router raggiungibile.
Su un singolo nodo router:
Prima dell'aggiornamento, rendi il router non raggiungibile.
Dopo l'aggiornamento, assicurati che il router sia raggiungibile.
Su un singolo nodo di elaborazione dei messaggi:
Prima dell'aggiornamento, rendi il Message Processor irraggiungibile.
Dopo l'aggiornamento, rendi raggiungibile il Message Processor.
Utilizzo di un file di configurazione silenzioso
Devi passare un file di configurazione silenzioso al comando di aggiornamento. Il file di configurazione silenzioso dovrebbe essere lo stesso che hai utilizzato per installare Edge 4.16.01 o 4.16.05.
Procedura per eseguire l'aggiornamento alla versione 4.16.09 su un nodo con una connessione a internet esterna
Per aggiornare i componenti Edge su un nodo, segui questa procedura:
Se attualmente utilizzi la replica master-standby di Postgres, installa un nuovo nodo
di standby Postgres come descritto sopra in Installare un nuovo nodo in standby Postgres .
Se presenti, disattiva tutti i job CRON configurati per eseguire un'operazione di riparazione su Cassandra
fino al completamento dell'aggiornamento.
Accedi al tuo nodo come utente root per installare gli RPM di Edge.
Nota : anche se l'installazione del pacchetto RPM richiede l'accesso come utente root, puoi eseguire la configurazione di Edge senza questo accesso.
Disattiva SELinux come descritto in Installare l'utilità apigee-setup di Edge .
Scarica il file bootstrap_4.16.09.sh di Edge 4.16.09 in /tmp/bootstrap_4.16.09.sh :
> curl
https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
Installa l'utilità apigee-service e le dipendenze di 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 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 (valore predefinito)
C = Continua senza installare Java
Q = Esci. Per questa opzione, devi installare Java autonomamente.
Utilizza apigee-service per
aggiornare l'utilità apigee-setup:
Se hai installato 4.16.01 eseguendo l'upgrade della versione 4.15.07.0x di Edge, 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 update
Se hai installato direttamente la versione 4.16.01, ovvero non hai eseguito l'upgrade dalla versione 4.15.07.0x, devi aggiornare l'utilità apigee-setup :
>
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Questo aggiornamento di apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin .
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
Questo aggiornamento di apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin .
A seconda della versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
Se al momento utilizzi Edge 4.16.05 : aggiorna l'utilità apigee-validate sul
server di gestione:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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 Message Processor durante l'installazione di 4.16.01, puoi aggiornarla utilizzando il seguente comando sul nodo:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Tuttavia, a partire dalla versione 4.16.05 e successive, Apigee consiglia di installare ed eseguire l'utilità apigee-validate sul
server di gestione.
Se esegui l'upgrade da 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.
Aggiorna l'utilità apigee-provision :
>
/opt/apigee/apigee-service/bin/apigee-service apigee-provision
Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina ":
>
/opt/apigee/apigee-setup/bin/update.sh -c component -f
configFile
L'unico requisito per il file di configurazione è che sia accessibile o leggibile dall'utente "apigee".
Utilizza l'opzione "-c" per specificare il componente da aggiornare. Puoi
contenere:
al
al
o di un
elemento di qualsiasi elemento può includere:
al
al
al
al
al
al
ldap
Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione .
Se hai installato un nuovo nodo Postgres di riserva, esegui il ritiro del nodo come descritto sopra in
Ritiro 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 tuoi nodi Edge si trovano dietro un firewall o 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 su un nodo, quindi aggiorna Edge dal
file .tar.
Installa un server web sul nodo con il repository locale in modo che gli altri nodi possano accedervi.
Apigee fornisce il server web Nginx da utilizzare oppure puoi utilizzare il tuo
server web.
Per eseguire l'aggiornamento da un repository 4.16.09 locale:
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 .
Crea un repository locale 4.16.09 come descritto in "Creare un repository Apigee locale" in Installare l'utilità apigee-setup di Edge .
Nota : se hai già un repository 4.16.01 o 4.16.05 esistente, puoi aggiungere il repository
4.16.09 come descritto in "Aggiornare un repository Apigee locale" in Installare l'utilità Edge apigee-setup .
Per installare apigee-service da un file .tar :
Sul nodo con il repository locale, utilizza il seguente comando per impacchettare il repository locale
in un unico file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz :
>
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella directory /tmp sul nuovo nodo.
Sul nuovo nodo, estrae il file nella directory /tmp:
> tar -xzf
apigee-4.16.09.tar.gz
Questo comando crea una nuova directory denominata repos nella directory contenente il file .tar. Ad esempio /tmp/repos.
Installa l'utilità e le dipendenze di 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 è incluso il percorso della directory repos.
Per installare apigee-service utilizzando il server web Nginx:
Configura il server web Nginx come descritto in "Installa dal repository utilizzando il server web Nginx" in Installa l'utilità Edge Apigee-Setup .
Sul nodo remoto, scarica il file bootstrap_4.16.09.sh di Edge in
/tmp/bootstrap_4.16.09.sh:
> /usr/bin/curl
http://uName: pWord @remoteRepo :3939/bootstrap_4.16.09.sh
-o /tmp/bootstrap_4.16.09.sh
dove uName:pWord sono il nome utente e la password impostati sopra per
il repository e remoteRepo è l'indirizzo IP o il nome DNS del
nodo del repository.
Sul nodo remoto, installa l'utilità apigee-service di Edge e le dipendenze:
> sudo bash
/tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo :3939
apigeeuser=uName apigeepassword=pWord
apigeeprotocol=http://
dove uName:pWord sono il nome utente e la password del repo.
Utilizza apigee-service per
aggiornare l'utilità apigee-setup:
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
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 update
Se hai installato direttamente la versione 4.16.01, ovvero non hai eseguito l'upgrade dalla versione 4.15.07.0x, devi aggiornare l'utilità apigee-setup:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Questo aggiornamento di apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin .
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 update
Questo aggiornamento di apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin .
A seconda della versione corrente di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
Se al momento utilizzi Edge 4.16.05 : aggiorna l'utilità apigee-validate sul
server di gestione:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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 Message Processor durante l'installazione di 4.16.01, puoi aggiornarla utilizzando il seguente comando su quel nodo:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Tuttavia, a partire dalla versione 4.16.05 e successive, Apigee consiglia di installare ed eseguire l'utilità apigee-validate sul server di gestione.
Se stai eseguendo 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.
Aggiorna l'utilità apigee-provision :
>
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine di aggiornamento della macchina":
>
/opt/apigee/apigee-setup/bin/update.sh -c component -f
configFile
L'unico requisito per il file di configurazione è che sia accessibile o leggibile dall'utente "apigee".
Utilizza l'opzione "-c" per specificare il componente da aggiornare. Puoi
contenere:
al
al
o di un
elemento di qualsiasi elemento può includere:
al
al
al
al
al
al
ldap
Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione .
Se hai installato un nuovo nodo Postgres di riserva, esegui il ritiro del nodo come descritto sopra in
Ritiro 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 in cui aggiorni le macchine in un'installazione Edge è importante. I fattori 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 aggiornare la monetizzazione. Viene aggiornato quando specifichi l'opzione "-c
edge".
Per un'installazione autonoma con un solo host
Nota: per un'installazione con un solo host, non è necessario creare un nuovo nodo in standby Postgres.
Se esegui l'aggiornamento dalla versione 4.16.01 , esegui il downgrade di Zookeeper:
> yum downgrade
apigee-zookeeper
Aggiorna Cassandra e ZooKeeper:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f
configFile
Aggiorna qpidd:
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Aggiorna LDAP:
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
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
Aggiorna postgresql:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Aggiorna il database Postgres:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Aggiorna i restanti componenti Edge:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aggiorna l'interfaccia utente di Edge:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Per un'installazione autonoma con 2 host
Nota: per un'installazione con due host, non devi creare un nuovo node Postgres di standby.
Consulta Topologie di installazione per un elenco delle topologie di Edge e dei numeri di nodi.
Se esegui l'aggiornamento dalla versione 4.16.01 , esegui il downgrade di Zookeeper sulla macchina 1:
> yum downgrade
apigee-zookeeper
Aggiorna Cassandra e ZooKeeper sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f
configFile
Aggiorna qpidd sulla macchina 2:
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Aggiorna LDAP sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aggiorna i componenti Edge sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aggiorna l'interfaccia utente sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Aggiorna postgresql sulla macchina 2:
Interrompi 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
Aggiorna postgresql:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Aggiorna il database Postgres:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Aggiorna i componenti Edge sulla macchina 2 e sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aggiorna i componenti Edge sulla macchina 2:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Per un'installazione in cluster a 5 host
Consulta Topologie di installazione per un elenco delle topologie Edge e dei numeri di nodi.
Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres .
Se esegui l'aggiornamento da 4.16.01 , esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3:
> yum downgrade
apigee-zookeeper
Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f
configFile
Aggiorna qpidd sulle macchine 4 e 5:
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Aggiorna LDAP sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aggiorna i componenti Edge sulle macchine 1, 2 e 3:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aggiorna l'interfaccia utente sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Aggiorna le macchine 4 e 5:
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
Interrompi 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
Interrompi il server Postgres e postgresql sul nuovo nodo di 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
Aggiorna postgresql sulle macchine 4:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Aggiorna il database Postgres sulla macchina 4 (solo master Postgres):
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Aggiorna postgresql sulle macchine 5:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
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
Configura Postgres come nodo di 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
Verifica lo stato della replica eseguendo 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
Verifica che sia indicato che si tratta del master.
Sulla macchina 5, il nodo di standby:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-standby
Verifica che sia indicato come standby.
Aggiorna i componenti Edge sulla macchina 4, 5:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Assicurati di eseguire il ritiro del nuovo nodo di standby utilizzando la procedura descritta in Ritiro di un nodo Postgres .
Per un'installazione in cluster di 9 host
Consulta Topologie di installazione
per l'elenco di topologie Edge e numeri di nodi.
Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres .
Se esegui l'aggiornamento dalla versione 4.16.01 , esegui il downgrade di Zookeeper sulle macchine 1, 2 e
3:
> yum
esegui il downgrade apigee-zookeeper
Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Aggiorna qpidd sulle macchine 6 e 7:
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Aggiorna LDAP sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
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
Aggiorna l'interfaccia utente sulla macchina 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Aggiorna le macchine 8 e 9:
Interrompi il server Postgres sulla macchina 8:
>
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
Interrompi 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
Interrompi il server Qpid sulle macchine 6 e 7:
>
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
Interrompi il server Postgres e postgresql sul nuovo nodo in 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
Aggiorna postgresql sulle macchine 8:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Aggiorna il database Postgres sulla macchina 8 (solo master Postgres):
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Aggiorna postgresql sulle macchine 9:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Avvia il server Postgres sulle macchine 8 e 9:
>
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
Avvia il server Qpid sulle macchine 6 e 7:
>
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
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
Verifica lo stato della replica eseguendo i seguenti script su entrambi i server. Il
sistema deve visualizzare risultati identici su entrambi i server per garantire una replica
efficace:
Sulla macchina 8, sul nodo master, esegui:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-master
Verifica che sia il master.
Nella macchina 9, il nodo in standby:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-standby
Verifica che sia indicato in standby.
Aggiorna i componenti Edge sulle macchine 8 e 9:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Assicurati di eseguire il ritiro del nuovo nodo di standby utilizzando la procedura descritta in Ritiro di un nodo Postgres .
Per un'installazione in cluster con 13 host
Consulta Topologie di installazione per un elenco delle topologie di Edge e dei numeri di nodi.
Assicurati di aver installato un nuovo nodo in standby Postgres come descritto in precedenza in Installazione di un nuovo nodo in standby Postgres .
Se esegui l'aggiornamento da 4.16.01 , esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3:
> yum
downgrade apigee-zookeeper
Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Aggiorna qpidd sulle macchine 12 e 13:
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Aggiorna LDAP sulle macchine 4 e 5:
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
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
Aggiorna l'interfaccia utente sulle macchine 6 e 7:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Aggiorna le macchine 8 e 9:
Interrompi il server Postgres sulla macchina 8:
>
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
Interrompi 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
Arresta il server Qpid sulle macchine 12 e 13:
>
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
Interrompi il server Postgres e postgresql sul nuovo nodo di 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
Aggiorna postgresql sulle macchine 8:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Aggiorna il database Postgres sulla macchina 8 (solo master Postgres):
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Aggiorna postgresql sulle macchine 9:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Avvia il server Postgres sulle macchine 8 e 9:
>
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
Avvia il server Qpid sulle macchine 12 e 13:
>
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
Configura Postgres come nodo di 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
Verifica lo stato della replica eseguendo i seguenti script su entrambi i server. Il
sistema deve visualizzare risultati identici su entrambi i server per garantire una replica
efficace:
Sulla macchina 8, sul nodo master, esegui:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-master
Verifica che sia il master.
Nella macchina 9, il nodo in standby:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-standby
Verifica che sia indicato in standby.
Aggiorna i componenti Edge sulle macchine 8 e 9:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Assicurati di ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Disattivazione di un nodo Postgres .
Per un'installazione in cluster di 12 host
Consulta Topologie di installazione per un elenco delle topologie Edge e dei numeri di nodi.
Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres .
Aggiorna Cassandra e ZooKeeper:
Se esegui l'aggiornamento da 4.16.01 , esegui il downgrade di Zookeeper sulle macchine 1, 2 e 3 nel data center 1:
> yum
downgrade apigee-zookeeper
Sulle macchine 1, 2 e 3 nel data center 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Se esegui l'aggiornamento da 4.16.01 , esegui il downgrade di Zookeeper sulle macchine 7, 8 e 9 nel data center 2:
> yum
downgrade apigee-zookeeper
Sulle macchine 7, 8 e 9 nel data center 2
>
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Aggiorna qpidd:
Macchine 4 e 5 nel data center 1
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Macchine 10, 11 nel data center 2
>
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Aggiorna LDAP:
Macchine 1 nel data center 1
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Macchine 7 nel data center 2
>
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Aggiorna i componenti di Edge:
Macchine 4, 5, 1, 2, 3 nel data center 1
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Macchine 10, 11, 7, 8, 9 nel data center 2
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aggiorna l'interfaccia utente:
Macchina 1 nel data center 1:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Macchina 7 nel data center 2:
>
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Aggiorna la macchina 6 nel data center 1 e la 12 nel data center 2:
Interrompi il server Postgres sulla macchina 6:
>
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
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
Interrompi il server Qpid sulle macchine 4, 5, 10 e 11:
>
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
Interrompi il server Postgres e postgresql sul nuovo nodo di 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
Aggiorna postgresql sulle macchine 6:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Aggiorna il database Postgres sulla macchina 6 (solo master Postgres):
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Aggiorna postgresql sulle macchine 12:
>
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Avvia il server Postgres sulle macchine 6 e 12:
>
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
Avvia il server Qpid sulle macchine 4, 5, 10 e 11:
>
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
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
Verifica lo stato della replica eseguendo 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
Verifica che sia indicato che si tratta del master.
Sulla macchina 12, il nodo di standby:
>
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
postgres-check-standby
Verifica che sia indicato che si tratta del nodo di standby.
Aggiorna i componenti Edge sulle macchine 6 e 12:
>
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Assicurati di eseguire il ritiro del nuovo nodo di standby utilizzando la procedura descritta in Ritiro di un nodo Postgres .
Per un'installazione di BaaS API con 7 host
Consulta Topologie di installazione per un elenco delle topologie Edge e dei numeri di nodi.
Aggiorna Cassandra sulle macchine 5, 6 e 7:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Aggiorna ElasticSearch e lo stack API BaaS sulle macchine 1, 2 e 3:
>
/opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
Aggiorna il portale API BaaS sulla macchina 4:
>
/opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Per un'installazione BaaS con API a 10 host
Consulta Topologie di installazione per un elenco delle topologie Edge e dei numeri di nodi.
Aggiorna Cassandra sulle macchine 8, 9 e 10:
>
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
Aggiorna ElasticSearch sulle macchine 1, 2 e 3:
>
/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
Aggiorna lo stack BaaS dell'API sulle macchine 4, 5 e 6:
>
/opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
Aggiorna il portale API BaaS sulla macchina 7:
>
/opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Per un'installazione non standard
Se hai un'installazione non standard, aggiorna i componenti di Edge nel seguente ordine:
ZooKeeper
Cassandra
qpidd
LDAP
Edge, ovvero il profilo "-c edge" su tutti i nodi nell'ordine: nodi con il server Qpid, ma non il server Postgres, il server di gestione, il Message Processor e il router.
Nota : se nel nodo sono installati sia il server Qpid sia il server Postgres, esegui il passaggio del profilo "-c edge" nell'ambito del passaggio 8.
Interfaccia utente Edge
postgresql sul master Postgres, incluso l'upgrade.
postgresql nell'standby di Postgres.
Edge, ovvero il profilo "-c edge" su tutti i nodi Qpid e Postgres combinati o su qualsiasi
nodo Postgres autonomo.