Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Aggiornamento di Apigee Edge da 4.16.01 a 4.16.05

Edge for Private Cloud v. 4.16.05

Quali versioni di Edge puoi aggiornare alla versione 4.16.05

Puoi aggiornare solo Apigee Edge versione 4.16.01.x alla versione 4.16.05.

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

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 "Suite di cifrari disabilitate per impostazione predefinita" all'indirizzo http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Avviso: questa release di Edge non supporta JDK 7. Se attualmente utilizzi JDK 7, devi eseguire l'upgrade a JDK 8. Se esegui il rollback dell'installazione di Edge 4.16.05, puoi facoltativamente riconfigurare Edge in modo che utilizzi Java JDK 7.

Downgrade di Zookeeper

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.948. In questo modo, yum non esegue l'upgrade di ZooKeeper a una versione successiva alla 4.16.01. Per correggere questa situazione, devi eseguire yum downgrade apigee-zookeeper prima di aggiornare ZooKeeper.

Puoi controllare la versione di ZooKeeper utilizzando il seguente comando:

> rpm -qa |grep apigee-zookeeper

Se questo comando restituisce la versione di Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Poi devi eseguire il downgrade.

Requisiti di spazio su disco per l'aggiornamento

Assicurati di avere almeno 1 GB di spazio libero su disco prima di eseguire l'aggiornamento.

Propagazione automatica delle impostazioni delle proprietà dalla versione 4.16.01.x

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

Aggiornamento dell'utilità apigee-validate

Nella versione 4.16.01, hai installato ed eseguito l'utilità apigee-validate su un nodo Processore dei messaggi. Nella versione 4.16.05, l'utilità apigee-validate è stata aggiornata per essere eseguita sul nodo Management Server.

Quando esegui l'aggiornamento alla versione 4.16.05, hai due opzioni per aggiornare l'utilità apigee-validate:

Consigliato da Apigee: installa ed esegui l'utilità apigee-validate sul nodo del server di gestione.

Se vuoi, puoi disinstallare l'utilità apigee-validate dai nodi processore di messaggi. Se lo lasci sul nodo Processore di messaggi, devi aggiornarlo alla versione 4.16.05.
In alternativa, aggiorna l'utilità apigee-validate sul nodo del processore di messaggi ed eseguila da lì. Tuttavia, Apigee consiglia di installarlo ed eseguirlo dal server di gestione.

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 di nuovo update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà dall'ultimo punto in cui è stato interrotto.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta la sezione 4.16.05 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.

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:
  1. Rendi il router non raggiungibile.
  2. Rendi irraggiungibile il processore di messaggi.
- Dopo l'aggiornamento, esegui le seguenti operazioni:
  1. Rendi raggiungibile il processore di messaggi.
  2. Rendi raggiungibile il router.
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 utilizzato per installare Edge 4.16.01.

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

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

Se presenti, disattiva i cron job configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
Accedi al nodo come utente root per installare gli RPM Edge
Nota: sebbene l'installazione degli 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.05 bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Installa l'utilità apigee-service di Edge 4.16.05 e le dipendenze:
> sudo bash /tmp/bootstrap_4.16.05.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:
1. Se hai installato la versione 4.16.01 eseguendo l'upgrade di Edge versione 4.15.07.0x, devi installare l'utilità apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Questo comando installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.
  
  Se hai già installato l'utilità apigee-setup, aggiornala:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Se hai installato direttamente la versione 4.16.01, ovvero non hai eseguito un upgrade dalla versione 4.15.07.0x, devi aggiornare l'utilità apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Questo aggiornamento di apigee-service installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.
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, puoi aggiornarla utilizzando il seguente comando su quel nodo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Tuttavia, per la versione 4.16.05, Apigee consiglia di installare ed eseguire l'utilità apigee-validate sul server di gestione.
Modifica il file di configurazione passato all'utilità apigee-validate. Nella release precedente 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.
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". Ad esempio, inserisci il file nella directory /tmp del nodo.
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 di 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 BaaS API
- p = API BaaS Portal
- 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.

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

Procedura per l'aggiornamento alla versione 4.16.05 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.05 locale:

Crea un repository 4.16.05 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, puoi aggiungere il repository 4.16.05.
Per installare apigee-service da un file .tar:
1. 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.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo nella directory /tmp del nuovo nodo.
3. Sul nuovo nodo, decomprimi il file nella directory /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  Questo comando crea una nuova directory, denominata repos, nella directory contenente il file .tar. Ad esempio, /tmp/repos.
4. Installa l'utilità apigee-service di Edge e le dipendenze da /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Tieni presente che in questo comando includi il percorso della directory repos.
Per installare apigee-service utilizzando il server web Nginx:
1. Configura il server web Nginx come descritto in "Installa dal repository utilizzando il server web Nginx" in Installa l'utilità apigee-setup di Edge.
2. Sul nodo remoto, scarica il file bootstrap_4.16.05.sh di Edge in /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.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.
3. Sul nodo remoto, installa l'utilità apigee-service di Edge e le dipendenze:
  > sudo bash /tmp/bootstrap_4.16.05.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:
1. Se hai installato la versione 4.16.01 eseguendo l'upgrade di Edge versione 4.15.07.0x, devi installare l'utilità apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Questo comando installa l'utilità update.sh in <inst_dir>/apigee/apigee-setup/bin.
  
  Se hai già installato l'utilità apigee-setup, aggiornala:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 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.
Installa l'utilità apigee-validate sul nodo del 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, puoi aggiornarla utilizzando il seguente comando su quel nodo:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Tuttavia, per la versione 4.16.05, Apigee consiglia di installare ed eseguire l'utilità apigee-validate sul server di gestione.
Modifica il file di configurazione passato all'utilità apigee-validate. Nella release precedente 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.
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". Ad esempio, inserisci il file nella directory /tmp del nodo.
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 di 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 BaaS API
- p = API BaaS Portal
- 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.

Per eseguire il rollback dell'aggiornamento in un secondo momento, utilizza la procedura descritta in 4.16.05 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.
Devi aggiornare tutti i nodi qpidd e postgresql prima di aggiornare i nodi Router e processore di messaggi.
Per qualsiasi macchina con più componenti Edge (Management Server, processore di messaggi, Router, QPID Server, 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".
Dopo aver aggiornato un nodo Router, devi rimuovere tutti i file dalla directory /opt/nginx/conf.d, quindi riavviare il Router.