Edge per Private Cloud v. 4.16.09
Quali versioni di Edge puoi aggiornare alla 4.16.09?
È possibile aggiornare Apigee Edge versione 4.16.01.0x e 4.16.05.x alla 4.16.09.
Se disponi di una versione di Edge precedente alla 4.16.01, devi prima eseguire la migrazione a versione 4.16.01.x e quindi eseguire l'aggiornamento alla versione 4.16.09.
Chi può eseguire l'aggiornamento
L'utente che esegue l'aggiornamento deve corrispondere all'utente che ha installato inizialmente Edge, oppure a un eseguito come root.
Dopo aver installato gli RPM perimetrali, qualsiasi utente potrà configurarli.
Richiesto upgrade a Java JDK versione 8
Questa release di Edge richiede l'installazione di Java JDK versione 8 su tutte le versioni Edge di elaborazione dei nodi. È possibile installare Oracle JDK 8 o OpenJDK 8. Se Java JDK 8 non è installato lo script di aggiornamento può installarla.
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 disattivate predefinite" all'indirizzo http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
Downgrade di Zookeeper in caso di aggiornamento da 4.16.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 Zookeeper è stata modificata di nuovo in apigee-zookeeper-3.4.5-0.0.94x. Questo impedisce a yum di aggiornare Zookeeper a versioni successive dalla 4.16.01. Il modo per corrompere questa situazione è eseguire yum downgrade apigee-zookeeper prima di aggiornare Zookeeper.
Puoi verificare la tua 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 della proprietà impostazioni
Se hai impostato delle proprietà modificando i file .properties in /opt/apigee/customer/application, vengono conservati dall'aggiornamento.
Aggiorna prerequisiti
Controlla i seguenti prerequisiti prima di eseguire l'upgrade di Apigee Edge:
- Esegui il backup di tutti i nodi
Prima di eseguire l'aggiornamento, è consigliabile eseguire un backup completo di tutti i nodi per motivi di sicurezza motivi. Usa la procedura della versione attuale di Edge per eseguire il backup.
Ciò ti consente di avere un piano di backup, nel caso in cui l'aggiornamento a una nuova versione non funzionino correttamente. Per ulteriori informazioni sul backup, 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
Gestione di un aggiornamento non riuscito
In caso di errore di un aggiornamento, puoi provare a risolvere il problema e quindi eseguire update.sh di nuovo. Puoi eseguire l'aggiornamento più volte e continuarlo dal punto in cui era stato interrotto disattivata.
Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta l'argomento Procedura di rollback 4.16.09 per ulteriori informazioni.
Informazioni sull'aggiornamento di Logging
Per impostazione predefinita, il file update.sh scrive le informazioni di log in:
/opt/apigee/var/log/apigee-setup/update.log
Se l'utente che esegue l'utilità update.sh non ha accesso a quella directory, scrive il log nella directory /tmp come file denominato update_username.log.
Se l'utente non ha accesso a /tmp, l'utilità update.sh non va a buon fine.
Upgrade richiesto a Postgres 9.4
Questa release di Edge include un upgrade a Postgres 9.4. Nell'ambito di questo upgrade, I dati Postgres vengono migrati a Postgres 9.4.
Durante il processo di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi vengono ancora scritti nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono tornati online, l'analisi viene quindi eseguito il push dei dati ai nodi Postgres.
Il nodo di standby Postgres aggiuntivo è obbligatorio se devi eseguire il rollback dell'aggiornamento per perché. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo di standby di Postgres diventa il nodo master Nodo Postgres dopo il rollback. Di conseguenza, quando installi il nuovo nodo standby Postgres, devono trovarsi su un nodo che soddisfa tutti i requisiti hardware di un server Postgres, come definiti l'installazione di Edge Requisiti.
Installazione di un nuovo Postgres nodo in standby
Questa procedura crea un server in standby Postgres su un nuovo nodo. Assicurati di installare un nuovo Server di standby Postgres per la tua versione esistente di Edge (4.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 corrente di Edge.
Per creare un nuovo nodo in standby di Postgres:
- Nel master Postgres attuale, modifica /opt/apigee/customer/application/postgresql.properties
per impostare il seguente token. Se il file non esiste, crealo:
conf_pg_hba_replication.connection=host replica apigee existing_slave_ip/32 trust\ \nreplica host apigee new_slave_ip/32 trust
dove existing_slave_ip è l'indirizzo IP del servizio Postgres attuale server in standby, mentre new_slave_ip è l'indirizzo IP del nuovo server in standby nodo. - Riavvia apigee-postgresql
nel master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql riavvio - Verifica che il nuovo nodo in standby sia stato aggiunto visualizzando /opt/apigee/apigee-postgresql/conf/pg_hba.conf
nel master. Il file dovrebbe contenere le seguenti righe:
replica host apigee trust_ip_slave_esistente/32
attendibilità apigee new_slave_ip/32 della replica host - Installa il nuovo server di standby Postgres:
- Modifica il file di configurazione che hai utilizzato per installare la versione corrente di Edge per specificare
quanto segue:
# indirizzo IP del modello principale:
PG_MASTER=192.168.56.103
# indirizzo IP del nuovo nodo in standby
PG_STANDBY=192.168.56.102 - Disabilita SELinux come descritto in Installare Edge Utilità apigee-setup.
- 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 esegui l'aggiornamento dalla versione 4.16.01, scarica il file bootstrap.sh di Edge. - Installa l'utilità e le dipendenze apigee-service Edge:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord - Usa 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 dica che è in standby.
- Modifica il file di configurazione che hai utilizzato per installare la versione corrente di Edge per specificare
quanto segue:
Ritiro di un Postgres nodo
Al termine dell'aggiornamento, dismetti il nuovo nodo in standby:
- Assicurati che Postgres sia in esecuzione:
> Stato /opt/apigee/apigee-service/bin/apigee-all
Se Postgres non è in esecuzione, avvialo:
> /opt/apigee/apigee-service/bin/apigee-all start - Recupera l'UUID del nuovo nodo in standby eseguendo il seguente comando cURL sul nuovo nodo
nodo in standby:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
Dovresti vedere l'UUID del nodo alla fine dell'output, nel formato:
"tipo" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75" - Arresta il nuovo nodo in standby eseguendo questo 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 trust di replica apigee existing_slave_ip/32 - Riavvia apigee-postgresql sul master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql riavvio - Verifica che il nuovo nodo in standby sia stato rimosso visualizzando /opt/apigee/apigee-postgresql/conf/pg_hba.conf
nel master. Nel file dovresti vedere solo la seguente riga:
replica host apigee existing_slave_ip/32 - Elimina l'UUID del nodo in standby da ZooKeeper eseguendo la seguente gestione perimetrale
Chiamata API sul nodo del server di gestione:
> curl -u sysAdminEmail:password -X ELIMINA 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 abbattendo Edge.
L'aggiornamento senza tempi di inattività è possibile solo con una configurazione a 5 nodi o superiore.
La chiave per eseguire l'upgrade senza tempi di inattività è rimuovere dal carico ogni router, uno alla volta. con il bilanciatore del carico di rete passthrough esterno regionale. Quindi, aggiorna il router e tutti gli altri componenti sulla stessa macchina del router, quindi aggiungi di nuovo il router al bilanciatore del carico.
- Aggiorna i computer nell'ordine corretto per l'installazione come descritto di seguito nella sezione "Ordina di aggiornamento della macchina".
- Quando è il momento di aggiornare i router, selezionare un router qualsiasi e renderlo irraggiungibile, come descritta in Attivazione/disattivazione 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 gli altri router.
- Continua l'aggiornamento per eventuali macchine rimanenti nell'installazione.
Prima/dopo l'aggiornamento, prendi in considerazione quanto segue:
- Sul nodo combinato router e processore di messaggi:
- Prima dell'aggiornamento, esegui queste operazioni:
- Rendi il router irraggiungibile.
- Rendi il processore di messaggi irraggiungibile.
- Dopo l'aggiornamento, procedi nel seguente modo:
- Rendi raggiungibile il processore di messaggi.
- Rendi il router raggiungibile.
- Prima dell'aggiornamento, esegui queste operazioni:
- Su singolo nodo router:
- Prima dell'aggiornamento, assicurati che il router non sia raggiungibile.
- Dopo l'aggiornamento, rendi il router raggiungibile.
- Su singolo nodo del processore di messaggi:
- Prima dell'aggiornamento, rendi il processore di messaggi irraggiungibile.
- Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.
Utilizzo di un file di configurazione invisibile all'utente
Devi passare un file di configurazione invisibile al comando update. Il file di configurazione invisibile dovrebbe essere lo stesso usato per installare Edge 4.16.01 o 4.16.05.
Procedura per Aggiornamento alla versione 4.16.09 su un nodo con una connessione a internet esterna
Usa la seguente procedura per aggiornare i componenti Edge su un nodo:
- Se attualmente utilizzi la replica master-standby di Postgres, installa un nuovo Postgres nodo in standby come descritto sopra in Installare un nuovo nodo in standby Postgres.
- Se presente, disabilita tutti i job CRON configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
- Accedi al tuo nodo come root per installare gli RPM perimetrali.
Nota: anche se l'installazione di RPM richiede l'accesso root, puoi eseguire Edge configurazione senza accesso root. - Disabilita SELinux come descritto in Installare BeyondCorp apigee-setup un'utilità.
- Scarica il file bootstrap_4.16.09.sh 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 - Installare l'utilità Edge 4.16.09 apigee-service e
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 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 Installazione di Java. JAVA_FIX assume i seguenti valori:
I = Installa OpenJDK 1.8 (impostazione predefinita)
C = Continua senza installare Java
D = Esci. Per questa opzione, devi installare Java personalmente. - Usa apigee-service per
aggiorna 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, aggiorna questo elemento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup - Se hai installato direttamente la versione 4.16.01, il che significa che non hai eseguito un upgrade da
4.15.07.0x, 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. - Se hai installato la versione 4.16.05 direttamente o tramite un aggiornamento, devi aggiornare
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.
- 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 corrente di Edge, devi installare o aggiornare
Utilità apigee-validate sulla
il server di gestione.
- Se attualmente utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sulla
Server di gestione:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate - Se attualmente utilizzi Edge 4.16.01: installa l'utilità apigee-validate sulla
Server di gestione:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Nota: se hai installato l'utilità apigee-validate su un messaggio Il nodo del processore durante l'installazione della versione 4.16.01, puoi aggiornarlo utilizzando il seguente comando quel nodo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate
Tuttavia, a partire dalla versione 4.16.05 e successive, Apigee consiglia di installare ed eseguire Utilità apigee-validate su il server di gestione. - Se esegui l'upgrade dalla versione 4.16.01: modifica il file di configurazione passato al
Utilità apigee-validate. Nella
La release 4.16.01 Edge, il file di configurazione utilizzato da apigee-validate richiedeva quanto segue
proprietà:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGIONE=dc-1
In questa versione, il file di configurazione richiede solo la proprietà APIGEE_ADMINPW. Puoi rimuovere le altre due proprietà del file.
- Se attualmente utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sulla
Server di gestione:
- Aggiorna apigee-provision
utilità:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision - Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine dei computer
aggiorna" sotto:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile
L'unico requisito del file di configurazione è che quest'ultimo deve essere accessibile o leggibile da "apigee" utente.
Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco delle possibili componenti includono:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =tutti i componenti Edge ad eccezione della UI perimetrale: server di gestione, processore di messaggi, router, server QPID, server Postgres
ui = UI perimetrale
all = aggiorna tutti i componenti su (da usare solo per un profilo di installazione Edge aio o un'installazione API BaaS asa) profilo)
e = ElasticSearch
b = stack BaaS API
p = Portale BaaS dell'API
ebp = ElasticSearch, API BaaS Stack e portale API BaaS sullo stesso nodo - Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.
- Se hai installato un nuovo nodo in standby Postgres, dismetti il nodo come descritto sopra in Disattivazione di un nodo Postgres.
Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in 4.16.09 Processo di rollback.
Procedura per l'aggiornamento alla versione 4.16.09 da un account locale repository
Se i nodi Edge sono protetti da un firewall o in qualche altro modo non possono accedere il repository Apigee su internet, quindi puoi eseguire l'aggiornamento da un repository locale, o mirroring del repository Apigee.
Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:
- Crea un file .tar del repository, copialo su un nodo, quindi aggiorna Edge .tar.
- Installa un server web sul nodo con il repository locale in modo che altri nodi possano accedervi. Apigee ti fornisce il server web Nginx oppure puoi utilizzare server web.
Per eseguire l'aggiornamento da un repository 4.16.09 locale:
- Se attualmente utilizzi la replica master-standby di Postgres, installa un nuovo Postgres nodo in standby come descritto sopra in Installare un nuovo nodo in standby Postgres.
- Creare un repository 4.16.09 locale come descritto in "Creare un repository Apigee locale" in Install the Edge apigee-setup
un'utilità.
Nota: se hai già un repository 4.16.01 o 4.16.05 esistente, puoi aggiungere 4.16.09 come descritto in "Aggiornare un repository Apigee locale" su Installare apigee-setup di Google Cloud. -
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 - Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo in nella directory /tmp sul un nuovo nodo.
- Sul nuovo nodo, sposta il 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 . ad esempio /tmp/repos. - Installa l'utilità apigee-service Edge e le dipendenze da /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Nota che in questo comando viene incluso il percorso della directory dei repository.
- 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 "Eseguire l'installazione dal repository utilizzando webserver" alla pagina Installare Edge Utilità apigee-setup.
- 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.sh -o /tmp/bootstrap_4.16.09.sh
dove uName:pWord sono il nome utente e la password che hai impostato sopra nel repository, mentre remoteRepo è l'indirizzo IP o il nome DNS il nodo repo. - Sul nodo remoto, installa l'utilità e le dipendenze di apigee-service Edge:
> 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.
- Usa apigee-service per
aggiorna 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, aggiorna questo elemento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup - Se hai installato direttamente la versione 4.16.01, il che significa che non hai eseguito un upgrade da
4.15.07.0x, 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. - Se hai installato la versione 4.16.05 direttamente o tramite un aggiornamento, devi aggiornare
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.
- 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 corrente di Edge, devi installare o aggiornare
Utilità apigee-validate sulla
il server di gestione.
- Se attualmente utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sulla
Server di gestione:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate - Se attualmente utilizzi Edge 4.16.01: installa 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 messaggio. Il nodo del processore durante l'installazione della versione 4.16.01, puoi aggiornarlo utilizzando il seguente comando quel nodo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-confirm
Tuttavia, a partire dalla versione 4.16.05 e successive, Apigee consiglia di installare ed eseguire Utilità apigee-convalida sul server di gestione. - Se esegui l'upgrade dalla versione 4.16.01: modifica il file di configurazione passato al
Utilità apigee-validate. Nella
La release 4.16.01 Edge, il file di configurazione utilizzato da apigee-validate richiedeva quanto segue
proprietà:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGIONE=dc-1
In questa versione, il file di configurazione richiede solo la proprietà APIGEE_ADMINPW. Puoi rimuovere le altre due proprietà del file.
- Se attualmente utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sulla
Server di gestione:
- Aggiorna apigee-provision
utilità:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision - Esegui l'utilità di aggiornamento sui nodi nell'ordine descritto di seguito in "Ordine del computer
aggiorna" sotto:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile
L'unico requisito del file di configurazione è che quest'ultimo deve essere accessibile o leggibile da "apigee" utente.
Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco delle possibili componenti includono:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =tutti i componenti Edge ad eccezione della UI perimetrale: server di gestione, processore di messaggi, router, server QPID, server Postgres
ui = UI perimetrale
all = aggiorna tutti i componenti su (da usare solo per un profilo di installazione Edge aio o un'installazione API BaaS asa) profilo)
e = ElasticSearch
b = stack BaaS API
p = Portale BaaS dell'API
ebp = ElasticSearch, API BaaS Stack e portale API BaaS sullo stesso nodo - Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.
- Se hai installato un nuovo nodo in standby Postgres, dismetti il nodo come descritto sopra in Disattivazione di un nodo Postgres.
Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in 4.16.09 Processo di rollback.
Ordine di aggiornamento della macchina
L'ordine con cui aggiorni le macchine in un'installazione Edge è importante. Il più considerazioni importanti per un aggiornamento sono:
- Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi ad altri nodi.
- Per qualsiasi macchina con più componenti Edge (server di gestione, processore di messaggi, router, server QPID ma non server Postgres), utilizza "-c edge" per aggiornarli tutti contemporaneamente.
- Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nella all'ordine della macchina specificato.
- Non esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornato quando specifichi bordo" .
Per una versione autonoma per 1 host installazione
- Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper:
> gnam 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 componenti Edge rimanenti:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Aggiorna l'UI Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Per una versione autonoma di 2 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 1:
> gnam 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 sul computer 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:
- Arresta server Postgres, server Qpid e postgresql:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - 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 server Postgres, server Qpid e postgresql:
- Aggiorna i componenti Edge sulla macchina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Per un cluster a 5 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Assicurati di aver installato un nuovo nodo in standby Postgres come descritto sopra in Installare un nuovo nodo Postgres nodo in standby.
- Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 1, 2 e
3:
> gnam downgrade apigee-zookeeper - Aggiorna Cassandra e ZooKeeper sulla macchina 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 sul computer 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 l'interfaccia utente 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 per cui hai aggiunto
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 PostgreSQL):
> /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 comandi seguenti sulla macchina
5:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verifica lo stato della replica inviando i seguenti script su entrambi i server. La
dovrebbe visualizzare risultati identici su entrambi i server per garantire
replica:
Sulla macchina 4, il nodo master, esegui:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Verifica che sia l'istanza principale.
Nella macchina 5, il nodo in standby:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifica che dica che è in standby.
- 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 ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Disattivazione di un Postgres predefinito.
Per un cluster a 9 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Assicurati di aver installato un nuovo nodo in standby Postgres come descritto sopra in Installare un nuovo nodo Postgres nodo in standby.
- Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 1, 2 e
3:
> slurp eseguire il downgrade di apigee-zookeeper - Aggiorna Cassandra e ZooKeeper sulla macchina 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 sul computer 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Aggiorna i componenti Edge sulla macchina 6, 7, 1, 4 e 5 in questo ordine:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Aggiorna l'interfaccia utente 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 per cui hai aggiunto
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 PostgreSQL):
> /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 comandi seguenti sulla macchina
09:
> 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 inviando i seguenti script su entrambi i server. La
dovrebbe visualizzare risultati identici su entrambi i server per garantire
replica:
Sulla macchina 8, il nodo master, esegui:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Verifica che sia l'istanza principale.
Nella macchina 9, il nodo in standby:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifica che dica che è in standby.
- 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 ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Disattivazione di un Postgres predefinito.
Per un cluster da 13 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Assicurati di aver installato un nuovo nodo in standby Postgres come descritto sopra in Installare un nuovo nodo Postgres nodo in standby.
- Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 1, 2 e
3:
> slurp eseguire il downgrade di apigee-zookeeper - Aggiorna Cassandra e ZooKeeper sulla macchina 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 sui computer 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:
- 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 per cui hai aggiunto
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 PostgreSQL):
> /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 comandi seguenti sulla macchina
09:
> 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 inviando i seguenti script su entrambi i server. La
dovrebbe visualizzare risultati identici su entrambi i server per garantire
replica:
Sulla macchina 8, il nodo master, esegui:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Verifica che sia l'istanza principale.
Nella macchina 9, il nodo in standby:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifica che dica che è in standby.
- 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 ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Disattivazione di un Postgres predefinito.
Per un cluster da 12 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Assicurati di aver installato un nuovo nodo in standby Postgres come descritto sopra in Installare un nuovo nodo Postgres nodo in standby.
- Aggiorna Cassandra e ZooKeeper:
- Se esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 1, 2,
e 3 nel data center 1:
> slurp eseguire il downgrade di apigee-zookeeper - Nelle 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 sulla macchina 7, 8,
e 9 nel data center 2:
> slurp eseguire il downgrade di 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 esegui l'aggiornamento dalla versione 4.16.01, esegui il downgrade di Zookeeper sulla macchina 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 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
- Macchine 4, 5, 1, 2, 3 nel data center 1
- Aggiorna UI:
- 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 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 per cui hai aggiunto
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 PostgreSQL):
> /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 comandi seguenti sulla macchina
12:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Verifica lo stato della replica inviando i seguenti script su entrambi i server. La
dovrebbe visualizzare risultati identici su entrambi i server per garantire
replica:
Sulla macchina 6, il nodo master, esegui:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Verifica che sia l'istanza principale.
Nella macchina 12, il nodo in standby:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifica che dica che è in standby.
- 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 ritirare il nuovo nodo in standby utilizzando la procedura riportata sopra in Disattivazione di un Postgres predefinito.
Per un BaaS con API a 7 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Aggiorna Cassandra sulla macchina 5, 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - Aggiorna ElasticSearch e lo stack BaaS API sulla macchina 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - Aggiorna il portale BaaS dell'API sulla macchina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Per un BaaS con API a 10 host installazione
Consulta Topologie di installazione per l'elenco di topologie Edge e numeri di nodi.
- Aggiorna Cassandra sulla macchina 8, 9 e 10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - Aggiorna ElasticSearch sulla macchina 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - Aggiorna lo stack BaaS dell'API sulla macchina 4, 5 e 6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - Aggiorna il portale BaaS dell'API sulla macchina 7:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Per un'installazione non standard
Se disponi di un'installazione non standard, aggiorna i componenti Edge nel seguente ordine:
- ZooKeeper
- Cassandra
- qpidd
- LDAP
- Edge, ovvero "-c edge" profilo su tutti i nodi nell'ordine: nodi con server Qpid ma
e non il server Postgres, il server di gestione, il processore di messaggi e il router.
Nota: se nel nodo sono installati sia il server Qpid sia il server Postgres, esegui "-bordo c" del profilo come parte del passaggio 8. - UI Edge
- postgresql sul master Postgres, incluso l'upgrade.
- postgresql nell'standby di Postgres.
- Edge, ovvero "-c edge" profilo su tutti i nodi Qpid e Postgres combinati o su qualsiasi nodi Postgres autonomi.