Questa sezione descrive come eseguire l'upgrade da Apigee Edge 4.19.06 o da 4.50.00 a 4.51.00.
Chi può eseguire l'aggiornamento
La persona che esegue l'aggiornamento deve essere la stessa che ha installato Edge in origine o la persona che esegue l'aggiornamento come root.
Dopo aver installato gli Edge RPM, chiunque può configurarli.
Quali componenti devi aggiornare
Devi aggiornare tutti i componenti di Edge. Edge non supporta una configurazione che contiene componenti di più versioni.
Propagazione automatica delle impostazioni delle proprietà
Se hai impostato delle proprietà modificando i file .properties
in
/opt/apigee/customer/application
, questi valori vengono conservati dall'aggiornamento.
È richiesto l'upgrade a Postgres 10.17
Questa release di Edge include un upgrade a Postgres 10.17. Nell'ambito di questo upgrade, viene eseguita la migrazione di tutti i dati Postgres a Postgres 10.17.
La maggior parte dei sistemi di produzione Edge utilizza due nodi Postgres configurati per la replica in standby master. Durante il processo di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi vengono comunque scritti nei nodi Qpid. Dopo che i nodi Postgres sono stati aggiornati e sono di nuovo online, i dati di analisi vengono inviati tramite push ai nodi Postgres.
Il modo in cui esegui l'aggiornamento di Postgres dipende da come hai configurato l'archiviazione dei dati per i nodi Postgres:
- Se utilizzi l'archiviazione locale dei dati per i nodi Postgres, devi installare un nuovo nodo in standby Postgres per la durata dell'upgrade. Al termine dell'upgrade, puoi ritirare il nuovo nodo in standby Postgres.
Il nodo standby Postgres aggiuntivo è obbligatorio se per qualsiasi motivo devi eseguire il rollback dell'aggiornamento. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo standby Postgres diventa il nodo Postgres master dopo il rollback. Di conseguenza, quando installi il nuovo nodo standby Postgres, questo deve trovarsi su un nodo che soddisfi tutti i requisiti hardware di un server Postgres, come definito nei requisiti di installazione di Edge.
In una configurazione di Edge a 1 e 2 nodi, topologie utilizzate per la prototipazione e i test, è presente un solo nodo Postgres. Puoi aggiornare questi nodi Postgres direttamente senza dover creare un nuovo nodo Postgres.
- Se utilizzi lo spazio di archiviazione di rete per i nodi Postgres, come consigliato da Apigee, non è necessario installare un nuovo nodo Postgres. Nelle procedure riportate di seguito, puoi saltare i passaggi che specificano di installare e ritirare in un secondo momento un nuovo nodo in standby Postgres.
Prima di iniziare il processo di aggiornamento, acquisisci uno snapshot di rete del datastore utilizzato da Postgres. Quindi, se si verificano errori durante l'aggiornamento e devi eseguire un rollback, puoi ripristinare il nodo Postgres da quello snapshot.
Installazione di un nuovo nodo standby Postgres
Questa procedura crea un server standby Postgres su un nuovo nodo. Assicurati di installare un nuovo server in standby Postgres per la versione esistente di Edge (4.19.06 o 4.50.00), non per la versione 4.51.00.
Per eseguire l'installazione, utilizza lo stesso file di configurazione che hai usato per installare la versione attuale di Edge.
Per creare un nuovo nodo standby Postgres:
- Nel master Postgres attuale, modifica il file
/opt/apigee/customer/application/postgresql.properties
per impostare il seguente token. Se il file non esiste, crealo:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
Dove existing_standby_ip è l'indirizzo IP del server standby Postgres attuale e new_standby_ip è l'indirizzo IP del nuovo nodo in 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. Il file dovrebbe contenere le seguenti righe:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Installa il nuovo server in standby Postgres:
- Modifica il file di configurazione che hai utilizzato per installare la versione attuale di Edge per specificare quanto segue:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
- Esegui una delle seguenti operazioni, a seconda della versione di Edge da cui esegui l'upgrade:
- Se stai eseguendo l'upgrade da Edge 4.19.06, scarica il file Edge bootstrap_4.19.06.sh in
/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
Quindi, installa l'utilità e le dipendenze Edge
apigee-service
:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- Se stai eseguendo l'upgrade da Edge 4.50.00, scarica il file Edge bootstrap_4.50.00.sh in
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
Quindi, installa l'utilità e le dipendenze Edge
apigee-service
:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- Se stai eseguendo l'upgrade da Edge 4.19.06, scarica il file Edge bootstrap_4.19.06.sh in
- 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 si tratti di standby.
- Modifica il file di configurazione che hai utilizzato per installare la versione attuale di Edge per specificare quanto segue:
Esecuzione di un upgrade in loco di Postgres
Per eseguire un upgrade in loco a Postgres 10.17, segui questi passaggi:
- Esegui l'upgrade di postgres sull'host master
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Esegui il comando di configurazione sull'host master:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- Esegui il comando di configurazione sull'host master:
apigee-service apigee-postgresql configure
- Riavvia l'host master:
apigee-service apigee-postgresql restart
- Configuralo come principale:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- Assicurati che l'host master sia stato avviato:
apigee-service apigee-postgresql wait_for_ready
- Interrompi lo standby:
apigee-service apigee-postgresql stop
- Esegui l'upgrade dello standby.
Nota:se questo passaggio contiene errori o non va a buon fine, puoi ignorarlo.
update.sh
tenterà di avviare il server di standby con una configurazione errata. Se viene eseguito l'upgrade dell'installazione Postgres alla versione 10.17, l'errore può essere ignorato./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Assicurati che lo standby sia arrestato:
apigee-service apigee-postgresql stop
- Rimuovi la precedente configurazione in standby:
rm -rf /opt/apigee/data/apigee-postgresql/
- Configura la replica sul server in standby:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
Una volta completata la procedura, lo standby verrà avviato correttamente.
Ritiro di un nodo Postgres
Al termine dell'aggiornamento, smetti di utilizzare 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
- Ottieni l'UUID del nuovo nodo in standby eseguendo il comando
curl
seguente sul nuovo nodo in standby:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
Dovresti vedere l'UUID del nodo alla fine dell'output, nel seguente formato:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Arresta il nuovo nodo standby eseguendo il comando seguente 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 standby daconf_pg_hba_replication.connection
:conf_pg_hba_replication.connection=host replication apigee existing_standby_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. Nel file dovresti vedere solo la seguente riga:host replication apigee existing_standby_ip/32 trust
- Elimina l'UUID del nodo standby da ZooKeeper effettuando la seguente chiamata API di gestione perimetrale sul nodo del server di gestione:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Aggiorna prerequisiti
Prima di eseguire l'upgrade di Apigee Edge, devi soddisfare i seguenti prerequisiti:
- Esegui il backup di tutti i nodi
Prima dell'aggiornamento, per motivi di sicurezza ti consigliamo di eseguire un backup completo di tutti i nodi. Utilizza la procedura relativa alla versione corrente di Edge per eseguire il backup.In questo modo puoi avere un piano di backup nel caso in cui l'aggiornamento a una nuova versione non funzioni correttamente. Per ulteriori informazioni sul backup, consulta Backup e ripristino.
- Assicurati che Edge sia in esecuzione
Assicurati che Edge sia in esecuzione durante il processo di aggiornamento utilizzando il comando:/opt/apigee/apigee-service/bin/apigee-all status
Nuova UI Edge
In questa sezione sono elencate le considerazioni relative all'interfaccia utente Edge. Per maggiori informazioni, consulta La nuova UI Edge per il cloud privato.
Installa l'UI Edge
Dopo aver completato l'installazione iniziale, Apigee consiglia di installare l'UI Edge, ovvero un'interfaccia utente avanzata per sviluppatori e amministratori di Apigee Edge per il cloud privato.
Tieni presente che l'interfaccia utente perimetrale richiede la disattivazione dell'autenticazione di base e l'utilizzo di un IdP, ad esempio SAML o LDAP.
Per maggiori informazioni, vedi Installare la nuova UI di Edge.
Aggiorna l'UI Edge
Per aggiornare il componente Edge UI, considera la versione di Edge per il cloud privato da cui stai eseguendo l'upgrade:
- Dal 19.4.06 o dal 4.50.00 al 4.51.00 (con la nuova UI Edge già installata): utilizza le
istruzioni per l'upgrade in questa sezione per il
componente
edge-management-ui
.
Aggiorna con Apigee mTLS
Per aggiornare Apigee mTLS , svolgi i seguenti passaggi:
Rollback di un aggiornamento
In caso di errore di un aggiornamento, puoi provare a risolvere il problema ed eseguire di nuovo update.sh
. Puoi eseguire l'aggiornamento più volte e riprenderlo dal punto in cui è stato interrotto.
Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, vedi Eseguire il rollback 4.51.00 per istruzioni dettagliate.
Informazioni sull'aggiornamento di Logging
Per impostazione predefinita, l'utilità update.sh
scrive le informazioni di log su:
/opt/apigee/var/log/apigee-setup/update.log
Se la persona che esegue l'utilità update.sh
non ha accesso a
quella directory, il log viene scritto nella directory /tmp
come file denominato
update_username.log
.
Se l'utente non ha accesso a /tmp
, l'utilità update.sh
non riesce.
Aggiornamento senza tempi di inattività
Un aggiornamento senza tempo di inattività, o aggiornamento in sequenza, ti consente di aggiornare l'installazione di Edge senza causare il ripristino di Edge.
L'aggiornamento senza tempo di inattività è possibile solo con una configurazione a 5 nodi o più.
La chiave per eseguire un upgrade senza tempo di inattività consiste nel rimuovere ogni router, uno alla volta, dal bilanciatore del carico. Aggiorna quindi il router e tutti gli altri componenti sulla stessa macchina del router e aggiungi di nuovo quest'ultimo al bilanciatore del carico.
- Aggiorna le macchine nell'ordine corretto per l'installazione come descritto nell'ordine di aggiornamento della macchina.
- Quando è il momento di aggiornare i router, selezionane uno qualsiasi e rendilo non raggiungibile, come descritto in Attivare/disattivare la connettività di server (processore/router).
- 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 le eventuali macchine rimanenti nell'installazione.
Prima e dopo l'aggiornamento, tieni presente quanto segue:
- Sul nodo combinato router e processore dei messaggi:
- Prima dell'aggiornamento:
- Rendi il router irraggiungibile.
- Rendere il processore di messaggi irraggiungibile.
- Dopo l'aggiornamento:
- Rendi raggiungibile il processore di messaggi.
- Rendi raggiungibile il router.
- Prima dell'aggiornamento:
- Su nodi router singoli:
- Prima dell'aggiornamento, rendi il router irraggiungibile.
- Dopo l'aggiornamento, rendi il router raggiungibile.
- Su singoli nodi del processore di messaggi:
- Prima dell'aggiornamento, rendi il processore di messaggi irraggiungibile.
- Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.
Utilizzare un file di configurazione invisibile all'utente
Devi passare un file di configurazione invisibile all'utente al comando update. Il file di configurazione invisibile all'utente deve essere lo stesso utilizzato per installare Edge 4.19.06 o 4.50.00.
Aggiorna a 4.51.00 su un nodo con una connessione a internet esterna
Utilizza la procedura seguente per aggiornare i componenti Edge su un nodo:
- Se presente, disabilita tutti i job
cron
configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento. - Accedi al nodo come root per installare gli RPM Edge.
- Installa
yum-utils
eyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
- Se l'installazione avviene su Oracle 7.x, esegui questo comando:
sudo yum-config-manager --enable ol7_optional_latest
- Se esegui l'installazione su AWS, esegui questi
comandi
yum-configure-manager
:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Scarica il file
bootstrap_4.51.00.sh
di Edge 4.51.00 su/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Installa l'utilità e le dipendenze
apigee-service
Edge 4.51.00 eseguendo questo comando:sudo bash /tmp/bootstrap_4.51.00.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 Java 1.8 sia installato. In caso contrario, il programma di installazione lo installerà per te.
Utilizza l'opzione
JAVA_FIX
per specificare come gestire l'installazione Java.JAVA_FIX
accetta i seguenti valori:I
: installa OpenJDK 1.8 (impostazione predefinita).C
: continua senza installare Java.Q
: esci. Per questa opzione, devi installare Java autonomamente.
- Utilizza
apigee-service
per aggiornare l'utilitàapigee-setup
, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Aggiorna l'utilità
apigee-validate
sul server di gestione, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Aggiorna l'utilità
apigee-provision
sul server di gestione, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Esegui l'utilità
update
sui tuoi nodi eseguendo questo comando:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Esegui questa operazione nell'ordine descritto in Ordine di aggiornamento della macchina.
Dove:
- component è il componente Edge da aggiornare. I valori possibili includono:
cs
: Cassandraedge
: tutti i componenti Edge eccetto UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (se hai installato SSO)ue
: nuova interfaccia utente di Edgeui
: interfaccia utente Edge classicozk
: guardiano dello zoo
- configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione 4.19.06 o 4.50.00.
Puoi eseguire
update.sh
su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione Edge all-in-one (AIO). Ad esempio:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component è il componente Edge da aggiornare. I valori possibili includono:
- Riavvia il componente della UI di Edge su tutti i nodi che lo eseguono, se non lo hai già fatto:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Verifica l'aggiornamento eseguendo l'utilità
apigee-validate
sul server di gestione, come descritto in Testare l'installazione.
Se in seguito decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback 4.51.00.
Aggiornamento alla versione 4.51.00 da un repository locale
Se i nodi perimetrali sono protetti da un firewall o in qualche altro modo non possono accedere al repository Apigee su internet, puoi eseguire l'aggiornamento da un repository locale, o mirroring, del repository Apigee.
Dopo aver creato un repository Edge locale, hai due opzioni per aggiornare Edge dal repository locale:
- Crea un file .tar del repository, copia il file .tar in un nodo, quindi aggiorna Edge dal file .tar.
- Installa un server web sul nodo con il repository locale in modo che altri nodi possano accedervi. Apigee ti fornisce il server web NGINX da utilizzare oppure puoi utilizzare il tuo server web.
Per aggiornare da un repository 4.51.00 locale:
- Crea un repository locale 4.51.00 come descritto in "Crea un repository Apigee locale" in Installa l'utilità Edge apigee-setup.
- Per installare apigee-service da un file .tar:
- Sul nodo con il repository locale, utilizza il seguente comando per pacchettizzare il repository locale in un unico file .tar denominato
/opt/apigee/data/apigee-mirror/apigee-4.51.00.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, annulla iltar del file nella directory
/tmp
:tar -xzf apigee-4.51.00.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 Edge
apigee-service
da/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Tieni presente che in questo comando includi il percorso della directory repository.
- Sul nodo con il repository locale, utilizza il seguente comando per pacchettizzare il repository locale in un unico file .tar denominato
- Per installare apigee-service utilizzando il server web NGINX:
- Configura il server web NGINX come descritto in "Installazione dal repository utilizzando il server web NGINX" in Installa l'utilità Edge apigee-setup.
- Sul nodo remoto, scarica il file Edge
bootstrap_4.51.00.sh
in/tmp/bootstrap_4.51.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
Dove uName:pWord sono il nome utente e la password che hai impostato in precedenza per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.
- Sul nodo remoto, installa l'utilità e le dipendenze Edge
apigee-setup
:sudo bash /tmp/bootstrap_4.51.00.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
, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Aggiorna l'utilità
apigee-validate
sul server di gestione, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Aggiorna l'utilità
apigee-provision
sul server di gestione, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Esegui l'utilità
update
sui nodi nell'ordine descritto in Ordine di aggiornamento della macchina:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Dove:
- component è il componente Edge da aggiornare. In genere vengono aggiornati i seguenti componenti:
cs
: Cassandraedge
: tutti i componenti Edge eccetto UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: SSO Apigee (se hai installato SSO)ue
Nuova UI di Edgeui
: interfaccia utente Edge classicozk
: guardiano dello zoo
- configFile è lo stesso file di configurazione che hai utilizzato per definire i componenti Edge durante l'installazione 4.19.06 o 4.50.00.
Puoi eseguire
update.sh
su tutti i componenti impostando component su "all", ma solo se hai un profilo di installazione Edge all-in-one (AIO). Ad esempio:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component è il componente Edge da aggiornare. In genere vengono aggiornati i seguenti componenti:
- Riavvia i componenti dell'interfaccia utente su tutti i nodi che la eseguono, se non l'hai ancora fatto:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Verifica l'aggiornamento eseguendo l'utilità
apigee-validate
sul server di gestione, come descritto in Testare l'installazione.
Se in seguito decidi di eseguire il rollback dell'aggiornamento, utilizza la procedura descritta in Eseguire il rollback 4.51.00.
Ordine di aggiornamento della macchina
L'ordine di aggiornamento delle macchine in un'installazione Edge è importante:
- Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
- Per qualsiasi macchina con più componenti Edge (server di gestione, processore di messaggi, router, server QPID ma non server Postgres), utilizza l'opzione
-c edge
per aggiornarli tutti contemporaneamente. - Se un passaggio specifica che deve essere eseguito su più macchine, eseguilo nell'ordine della macchina specificato.
- Non esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornata quando specifichi l'opzione
-c edge
.
Upgrade autonomo di 1 nodo
Per eseguire l'upgrade di una configurazione autonoma a un nodo alla versione 4.51.00:
- Aggiorna tutti i componenti:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Se hai installato
apigee-adminapi
) È stata aggiornata l'utilitàapigee-adminapi
:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Upgrade autonomo a due nodi
Aggiorna i componenti seguenti per un'installazione autonoma su due nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Aggiorna Cassandra e ZooKeeper sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Qpid e Postgres sulla macchina 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- Aggiorna LDAP sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulle macchine 2 e 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
- (Se hai installato
apigee-adminapi
) È stata aggiornata l'utilitàapigee-adminapi
sulla macchina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente Edge UI sulla macchina 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Upgrade di 5 nodi
Aggiorna i componenti seguenti per un'installazione su 5 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Aggiorna Cassandra e ZooKeeper sui computer 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Qpid e Postgres sulla macchina 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Aggiorna Qpid e Postgres sulla macchina 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Aggiorna LDAP sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulla macchina 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna l'interfaccia utente Edge:
- Interfaccia utente classica: se utilizzi la UI classica, aggiorna il componente
ui
sulla macchina 1, come illustrato nell'esempio seguente:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Nuova UI di Edge: se hai installato la nuova UI di Edge, aggiorna il componente
ue
sulla macchina appropriata (potrebbe non essere la macchina 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- Interfaccia utente classica: se utilizzi la UI classica, aggiorna il componente
- (Se hai installato
apigee-adminapi
) È stata aggiornata l'utilitàapigee-adminapi
sulla macchina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente dell'interfaccia utente:
- Interfaccia utente classica: se usi la UI classica, riavvia il componente
edge-ui
sulla macchina 1, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nuova UI di Edge: se hai installato la nuova UI di Edge, riavvia il componente
edge-management-ui
sulla macchina appropriata (potrebbe non essere la macchina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Interfaccia utente classica: se usi la UI classica, riavvia il componente
Upgrade in cluster di 9 nodi
Aggiorna i componenti seguenti per un'installazione in cluster di nove nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Aggiorna Cassandra e ZooKeeper sui computer 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Qpid sulle macchine 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna Postgres sulla macchina 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna Postgres sulla macchina 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna LDAP sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Aggiorna i componenti Edge sulla macchina 6, 7, 8, 9, 1, 4 e 5 in questo ordine:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna la nuova UI (
ue
) o la UI classica (ui
) sulla macchina 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se hai installato
apigee-adminapi
) Aggiorna l'utilitàapigee-adminapi
sulla macchina 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna Apigee SSO sulla macchina 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente dell'interfaccia utente:
- Interfaccia utente classica: se usi la UI classica, riavvia il componente
edge-ui
sulla macchina 1, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nuova UI di Edge: se hai installato la nuova UI di Edge, riavvia il componente
edge-management-ui
sulla macchina appropriata (potrebbe non essere la macchina 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Interfaccia utente classica: se usi la UI classica, riavvia il componente
Upgrade in cluster a 13 nodi
Aggiorna i componenti seguenti per un'installazione in cluster di 13 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Aggiorna Cassandra e ZooKeeper sulle macchine 1, 2 e 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aggiorna Qpid sulle macchine 12 e 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna Postgres sulla macchina 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aggiorna Postgres sulla macchina 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -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, 8, 9, 6, 7, 10 e 11 in questo ordine:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Aggiorna la nuova interfaccia utente (
ue
) o la UI classica (ui
) sulle macchine 6 e 7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Se hai installato
apigee-adminapi
) È stata aggiornata l'utilitàapigee-adminapi
sui computer 6 e 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Se hai installato Apigee SSO) Aggiorna il servizio SSO di Apigee sulle macchine 6 e 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Riavvia il componente dell'interfaccia utente:
- UI classica: se usi la UI classica, riavvia il componente
edge-ui
sulle macchine 6 e 7, come illustrato nell'esempio seguente:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nuova UI di Edge: se hai installato la nuova UI di Edge, riavvia il componente
edge-management-ui
sui computer 6 e 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- UI classica: se usi la UI classica, riavvia il componente
Upgrade in cluster a 12 nodi
Aggiorna i componenti seguenti per un'installazione in cluster di 12 nodi:
Consulta Topologie di installazione per l'elenco delle topologie Edge e dei numeri dei nodi.
- Aggiorna Cassandra e ZooKeeper:
- Sulle macchine 1, 2 e 3 nel data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Nelle macchine 7, 8 e 9 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Sulle macchine 1, 2 e 3 nel data center 1:
- Aggiorna qpidd:
- Macchine 4, 5 nel data center 1
- Aggiorna
qpidd
sulla macchina 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna
qpidd
sulla macchina 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiorna
- Macchine 10 e 11 nel data center 2
- Aggiornamento
qpidd
sulla macchina 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiornamento
qpidd
sulla macchina 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aggiornamento
- Macchine 4, 5 nel data center 1
- Aggiorna Postgres:
- Macchina 6 nel data center 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Macchina 12 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Macchina 6 nel data center 1
- Aggiorna LDAP:
- Macchina 1 nel data center 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Macchina 7 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Macchina 1 nel data center 1
- Aggiorna i componenti di Edge:
- Macchine 4, 5, 6, 1, 2, 3 nel data center 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Macchine 10, 11, 12, 7, 8, 9 nel data center 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Macchine 4, 5, 6, 1, 2, 3 nel data center 1
- Aggiorna la nuova interfaccia utente (
ue
) o quella classica (ui
):- Macchina 1 nel data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Macchina 7 nel data center 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Macchina 1 nel data center 1:
- (Se hai installato
apigee-adminapi
) È stata aggiornata l'utilitàapigee-adminapi
:- Macchina 1 nel data center 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Macchina 7 nel data center 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Macchina 1 nel data center 1:
- (Se hai installato Apigee SSO) Aggiorna il servizio SSO di Apigee:
- Macchina 1 nel data center 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Macchina 7 nel data center 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Dove sso_config_file è il file di configurazione che hai creato quando hai installato SSO.
- Macchina 1 nel data center 1:
- Riavvia il nuovo componente della UI di Edge (
edge-management-ui
) o della UI classica (edge-ui
) sulle macchine 1 e 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
Per una configurazione non standard
Se hai una configurazione non standard, aggiorna i componenti Edge nel seguente ordine:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, che indica il profilo "-c edge" su tutti i nodi nell'ordine: nodi con server Qpid, server Edge Postgres, server di gestione, processore di messaggi e router.
- UI Edge (classica o nuova)
apigee-adminapi
- SSO Apigee
Dopo aver completato l'aggiornamento, assicurati di riavviare il componente Edge UI su tutte le macchine che lo eseguono.