Edge for Private Cloud v. 4.16.09
Quali versioni di Edge puoi aggiornare alla versione 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 4.16.01, devi prima eseguire la migrazione alla versione 4.16.01.x e poi eseguire l'aggiornamento alla versione 4.16.09.
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.
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. Puoi 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, alcune crittografie TLS non sono più disponibili in Oracle JDK 8. Per l'elenco completo, consulta la sezione "Default Disabled Cipher Suites" (Suite di crittografia disabilitate per impostazione predefinita) all'indirizzo http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
Eseguire il downgrade di ZooKeeper se l'aggiornamento viene eseguito dalla versione 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 riportata ad apigee-zookeeper-3.4.5-0.0.94x. In questo modo, yum non esegue l'upgrade di ZooKeeper a una versione successiva alla 4.16.01. Per correggere questa situazione, esegui 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
Poi devi eseguire il downgrade.
Propagazione automatica delle impostazioni della proprietà
Se hai impostato delle proprietà modificando i file .properties in /opt/apigee/customer/application, questi valori vengono conservati dall'aggiornamento.
Prerequisiti per l'aggiornamento
Prima di eseguire l'upgrade di Apigee Edge, assicurati di soddisfare i seguenti prerequisiti:
- Esegui il backup di tutti i nodi
Prima di eseguire l'aggiornamento, per motivi di sicurezza è consigliabile eseguire un backup completo di tutti i nodi. Per eseguire il backup, utilizza la procedura per la tua versione attuale di Edge.
In questo modo, avrai un piano di backup nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, vedi 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:
> /<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 e poi eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà dall'ultima interruzione.
Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta la sezione 4.16.09 Rollback Process per ulteriori informazioni.
Informazioni sull'aggiornamento del logging
Per impostazione predefinita, l'utilità update.sh scrive le informazioni di log in:
/opt/apigee/var/log/apigee-setup/update.log
Se l'utente che esegue l'utilità update.sh non ha accesso a questa directory, il log viene scritto nella directory /tmp come file denominato update_username.log.
Se l'utente non ha accesso a /tmp, l'utilità update.sh non va a buon fine.
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 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 tornati online, i dati di analisi vengono inviati ai nodi 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 Postgres master dopo il rollback. Pertanto, quando installi il nuovo nodo Postgres in standby, questo deve trovarsi 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 di standby Postgres su un nuovo nodo. Assicurati di installare un nuovo server Postgres in standby 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 utilizzato per installare la versione attuale di Edge.
Per creare un nuovo nodo standby Postgres:
- Sul 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 standby attuale e new_slave_ip è l'indirizzo IP del nuovo nodo standby. - Riavvia apigee-postgresql sul master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Verifica che il nuovo nodo 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 di standby Postgres:
- Modifica il file di configurazione utilizzato per installare la versione corrente di Edge per specificare quanto segue:
# indirizzo IP del master corrente:
PG_MASTER=192.168.56.103
# indirizzo IP del nuovo nodo standby
PG_STANDBY=192.168.56.102 - Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
- Scarica il file bootstrap_4.16.05.sh di Edge 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 dalla versione 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 standby, esegui questo comando:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifica che sia indicato che si tratta dello standby.
- Modifica il file di configurazione utilizzato per installare la versione corrente di Edge per specificare quanto segue:
Disattivazione di un nodo Postgres
Al termine dell'aggiornamento, dismetti il nuovo nodo di 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 - Ottieni 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" - Arresta il nuovo nodo standby eseguendo questo comando sul nuovo nodo 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 standby da conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust - Riavvia apigee-postgresql sul master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Verifica che il nuovo nodo standby sia stato rimosso visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. In questo file dovresti vedere solo la seguente riga:
host replication apigee existing_slave_ip/32 trust - 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>
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.
- Aggiorna le macchine nell'ordine corretto per l'installazione, come descritto di seguito in "Ordine di aggiornamento delle macchine".
- Quando è il momento di aggiornare i router, seleziona un router e rendilo non raggiungibile, come descritto in Attivazione/disattivazione della raggiungibilità del server (processore di messaggi/router).
- 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.
- Rendi nuovamente raggiungibile il router.
- Ripeti i passaggi da 2 a 4 per i router rimanenti.
- Continua l'aggiornamento per tutte le macchine rimanenti nell'installazione.
Prima/dopo l'aggiornamento, tieni presente quanto segue:
- Sul nodo combinato Router e Processore di messaggi:
- Prima dell'aggiornamento, esegui le seguenti operazioni:
- Rendi il router non raggiungibile.
- Rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, esegui le seguenti operazioni:
- Rendi raggiungibile il processore di messaggi.
- Rendi raggiungibile il router.
- Prima dell'aggiornamento, esegui le seguenti operazioni:
- Su un singolo nodo del router:
- Prima dell'aggiornamento, rendi il router non raggiungibile.
- Dopo l'aggiornamento, rendi raggiungibile il router.
- Su un singolo nodo Processore di messaggi:
- Prima dell'aggiornamento, rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.
Utilizzo di un file di configurazione invisibile
Devi passare un file di configurazione invisibile al comando di aggiornamento. Il file di configurazione silenziosa deve essere lo stesso che hai 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 seguente procedura per aggiornare i componenti Edge su un nodo:
- Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby di Postgres come descritto sopra in Installazione di un nuovo nodo standby di Postgres.
- Se presenti, disattiva i cron job configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
- Accedi al nodo come root per installare gli RPM Edge.
Nota: sebbene l'installazione di RPM richieda l'accesso root, puoi eseguire la configurazione di Edge senza l'accesso root. - Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
- 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 - Installa l'utilità apigee-service di Edge 4.16.09 e le dipendenze:
> 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 (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 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 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 ad apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.
- Se hai installato la versione 4.16.01 eseguendo l'upgrade di Edge versione 4.15.07.0x, devi installare l'utilità apigee-setup:
- A seconda della versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
- Se 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 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 di messaggi durante l'installazione della versione 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 esegui l'upgrade dalla versione 4.16.01: modifica il file di configurazione passato all'utilità apigee-validate. Nella release 4.16.01 di Edge, 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.
- Se utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sul server di gestione:
- 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 deve essere accessibile o leggibile dall'utente "apigee".
Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =tutti i componenti Edge ad eccezione della UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
ui = UI Edge
all = aggiorna tutti i componenti sulla macchina (utilizza solo per un profilo di installazione Edge aio o un profilo di installazione API BaaS asa)
e = ElasticSearch
b = stack API BaaS
p = portale API BaaS
ebp = ElasticSearch, stack API BaaS e portale API BaaS sullo stesso nodo - Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.
- Se hai installato un nuovo nodo standby Postgres, dismetti il nodo come descritto sopra in Dismettere 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 Edge si trovano dietro un firewall o se in qualche altro modo non possono accedere al repository Apigee tramite internet, puoi eseguire l'aggiornamento da un repository locale o da un mirror del repository Apigee.
Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:
- Crea un file .tar del repository, copia il file .tar in un nodo, quindi aggiorna Edge dal file .tar.
- Installa un server web sul nodo con il repository locale in modo che altri nodi possano accedervi. Apigee fornisce il server web Nginx che puoi utilizzare oppure puoi utilizzare il tuo server web.
Per eseguire l'aggiornamento da un repository 4.16.09 locale:
- Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby di Postgres come descritto sopra in Installazione di un nuovo nodo standby di Postgres.
- Crea un repository 4.16.09 locale come descritto in "Crea un repository Apigee locale" in Installa l'utilità apigee-setup di Edge.
Nota: se hai già un repository 4.16.01 o 4.16.05, puoi aggiungere il repository 4.16.09 come descritto in "Aggiorna un repository Apigee locale" in Installa l'utilità apigee-setup di Edge. -
Per installare apigee-service da un file .tar:
- Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.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 del nuovo nodo.
- Sul nuovo nodo, estrai 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à apigee-service di Edge e le dipendenze 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.
- Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
-
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à apigee-setup di Edge.
- 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 che hai impostato 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 repository.
- 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 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 ad 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.
- Se hai installato la versione 4.16.01 eseguendo l'upgrade di Edge versione 4.15.07.0x, devi installare l'utilità apigee-setup:
- A seconda della versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
- Se 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 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 messaggi durante l'installazione della versione 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 esegui l'upgrade dalla versione 4.16.01: modifica il file di configurazione passato all'utilità apigee-validate. Nella release 4.16.01 di Edge, 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.
- Se utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sul server di gestione:
- 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 deve essere accessibile o leggibile dall'utente "apigee".
Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =tutti i componenti Edge ad eccezione della UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
ui = UI Edge
all = aggiorna tutti i componenti sulla macchina (utilizza solo per un profilo di installazione Edge aio o un profilo di installazione API BaaS asa)
e = ElasticSearch
b = stack API BaaS
p = portale API BaaS
ebp = ElasticSearch, stack API BaaS e portale API BaaS sullo stesso nodo - Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testa l'installazione.
- Se hai installato un nuovo nodo standby Postgres, dismetti il nodo come descritto sopra in Dismettere 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 di Edge è importante. Le considerazioni più importanti per un aggiornamento sono:
- Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
- Per qualsiasi macchina con più componenti Edge (Management Server, processore di messaggi, Router, QPID Server, ma non Postgres Server), utilizza l'opzione "-c edge" per aggiornarli tutti contemporaneamente.
- Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nell'ordine delle macchine specificato.
- Non è previsto un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornato quando specifichi l'opzione "-c edge".
Per un'installazione autonoma con 1 host
- Se stai eseguendo 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 la UI Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Per un'installazione autonoma con 2 host
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- 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 la UI sulla macchina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Aggiorna postgresql sulla macchina 2:
- 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 componenti Edge sulla macchina 2 e sulla macchina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Arresta il server Postgres, il server Qpid e postgresql:
- Aggiorna i componenti Edge sulla macchina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Per un'installazione in cluster con 5 host
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
- Se stai eseguendo l'aggiornamento dalla versione 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 sulla macchina 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Aggiorna la UI sulla macchina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Aggiorna le macchine 4 e 5:
- 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 - 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 - Arresta il server Postgres e postgresql sul nuovo nodo standby 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 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 - 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 indichi che è il 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 è in standby.
- Arresta il server Postgres e il server Qpid sulla macchina 4:
- Aggiorna i componenti Edge sulla macchina 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Assicurati di dismettere il nuovo nodo standby utilizzando la procedura descritta sopra in Dismissione di un nodo Postgres.
Per un'installazione in cluster con 9 host
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
- Se stai eseguendo l'aggiornamento dalla versione 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 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 questo ordine:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Aggiorna la UI sulla macchina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Aggiorna le macchine 8 e 9:
- Arresta il server Postgres sulla macchina 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - 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 - Arresta il server Qpid sulle macchine 6 e 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Arresta il server Postgres e postgresql sul nuovo nodo standby 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 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 è in standby.
- Arresta il server Postgres sulla macchina 8:
- Aggiorna i componenti Edge sulle macchine 8 e 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Assicurati di dismettere il nuovo nodo standby utilizzando la procedura descritta sopra in Dismissione 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.
- Assicurati di aver installato un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
- Se stai eseguendo l'aggiornamento dalla versione 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 sulle macchine 12, 13, 6, 7, 10 e 11 in questo ordine:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Aggiorna la UI sulle macchine 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Aggiorna le macchine 8 e 9:
- Arresta il server Postgres sulla macchina 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - 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 - Arresta il server Qpid sulle macchine 12 e 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Arresta il server Postgres e postgresql sul nuovo nodo standby 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 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 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 è in standby.
- Arresta il server Postgres sulla macchina 8:
- Aggiorna i componenti Edge sulle macchine 8 e 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Assicurati di dismettere il nuovo nodo standby utilizzando la procedura descritta sopra in Dismissione 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.
- 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 stai eseguendo 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 - 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 dalla versione 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
- Se stai eseguendo l'aggiornamento dalla versione 4.16.01, esegui il downgrade di ZooKeeper sulle macchine 1, 2 e 3 nel data center 1:
- Aggiorna qpidd:
- Macchine 4, 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
- Macchine 4, 5 nel data center 1
- 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
- Macchine 1 nel data center 1
- Aggiorna i componenti 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
- Macchine 4, 5, 1, 2, 3 nel data center 1
- 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
- Macchina 1 nel data center 1:
- Aggiorna la macchina 6 nel data center 1 e la macchina 12 nel data center 2:
- Arresta il server Postgres sulla macchina 6:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - 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 - Arresta il server Qpid sulle macchine 4, 5, 10 e 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Arresta il server Postgres e postgresql sul nuovo nodo standby 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 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 indichi che è il 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 è in standby.
- Arresta il server Postgres sulla macchina 6:
- Aggiorna i componenti Edge sulle macchine 6 e 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Assicurati di dismettere il nuovo nodo standby utilizzando la procedura descritta sopra in Dismissione di un nodo Postgres.
Per un'installazione di API BaaS con 7 host
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Aggiorna Cassandra sulle macchine 5, 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - Aggiorna lo stack Elasticsearch e API BaaS sulle macchine 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - Aggiorna il portale API BaaS sulla macchina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Per un'installazione di API BaaS su 10 host
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei 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 API BaaS 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 Edge nel seguente ordine:
- ZooKeeper
- Cassandra
- qpidd
- LDAP
- 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 sul nodo sono installati sia il server Qpid sia il server Postgres, esegui il passaggio del profilo "-c edge" come parte del passaggio 8. - UI Edge
- postgresql sul master Postgres, incluso l'upgrade.
- postgresql sullo standby Postgres.
- Edge, ovvero il profilo "-c edge" su tutti i nodi Qpid e Postgres combinati o su qualsiasi nodo Postgres autonomo.