Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiornamento di Apigee Edge da 4.16.01 a 4.16.05

Edge per Private Cloud v. 4.16.05

Versioni di Edge aggiornabili alla 4.16.05

Puoi aggiornare Apigee Edge solo dalla versione 4.16.01.x alla 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 per poi eseguire l'aggiornamento alla versione 4.16.05.

Chi può eseguire l'aggiornamento

L'utente che esegue l'aggiornamento deve essere lo stesso dell'utente che ha installato in origine Edge o di un utente in esecuzione come root.

Dopo aver installato gli Edge RPM, qualsiasi utente può configurarli.

È richiesto l'upgrade a Java JDK versione 8

Questa release di Edge richiede l'installazione di Java JDK versione 8 su tutti i nodi di elaborazione perimetrale. Puoi installare Oracle JDK 8 o OpenJDK 8. Se Java JDK 8 non è già installato, lo script di aggiornamento può installarlo automaticamente.

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 disabilitate predefinite" 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 per utilizzare Java JDK 7.

custode dello zoo di livello inferiore

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 di Zookeeper è stata ripristinata in apigee-zookeeper-3.4.5-0.0.948. Questo impedisce a yum di eseguire l'upgrade di Zookeeper a una versione successiva dalla 4.16.01. Per correggere questa situazione, esegui il downgrade di yum apigee-zookeeper prima di aggiornare Zookeeper.

Puoi controllare la tua versione di Zookeeper utilizzando il seguente comando:

> rpm -qa |grep apigee-zookeeper

Se questo comando restituisce la versione Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

quindi 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à da 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 Message Processor. Nella versione 4.16.05, l'utilità apigee-validate è stata aggiornata in modo da eseguirla sul nodo Management Server.

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

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

Facoltativamente, puoi disinstallare l'utilità apigee-validate dai nodi del processore di messaggi. Se lo lasci sul nodo Message Processor, devi aggiornarlo a 4.16.05.
In alternativa, aggiorna l'utilità apigee-validate sul nodo del processore di messaggi ed eseguilo da lì. Tuttavia, Apigee consiglia di installarlo ed eseguirlo dal server di gestione.

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, vedi Backup e ripristino.
Assicurati che Edge sia in esecuzione
Assicurati che Edge sia 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 un aggiornamento, puoi provare a risolvere il problema e poi a 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 Procedura di rollback 4.16.05 per ulteriori informazioni.

Informazioni sull'aggiornamento di 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 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 di seguito in "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) di messaggi.
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/dopo l'aggiornamento:

Sul nodo combinato router e processore dei messaggi:
- Prima dell'aggiornamento:
  1. Rendi il router irraggiungibile.
  2. Rendere il processore di messaggi irraggiungibile.
- Dopo l'aggiornamento:
  1. Rendi raggiungibile il processore di messaggi.
  2. Rendi raggiungibile il router.
Su un singolo nodo router:
- Prima dell'aggiornamento, rendi il router irraggiungibile.
- Dopo l'aggiornamento, rendi il router raggiungibile.
Su un 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 all'utente al comando update. Il file di configurazione invisibile all'utente 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 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
Nota: sebbene l'installazione RPM richieda l'accesso root, puoi eseguire la configurazione Edge senza accesso root.
Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
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à e le dipendenze apigee-service di Edge 4.16.05:
> 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 controlla se Java 1.8 è installato. Se non lo fai, lo installa. Utilizza l'opzione JAVA_FIX per specificare come gestire l'installazione 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à <inst_dir>/apigee/apigee-setup/bin.
  
  Se hai già installato l'utilità apigee-setup, aggiornala:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento
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 ad apigee-service installa l'utilità apigee-service insetup. /apigee/apigee. <inq/apigee-setup
Installa l'utilità apigee-validate sul server di gestione:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Nota: se avete installato l'utilità apigee-validate su un nodo Processore di messaggi, potete aggiornarla utilizzando il seguente comando su quel nodo:
> /opt/apigee/apigee-service/bin/apigee-service
Modifica il file di configurazione passato all'utilità apigee-validate. Nella release Edge precedente, 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" di seguito:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile
L'unico requisito del file di configurazione è che il file di configurazione sia accessibile o leggibile dall'utente "apigee". Ad esempio, inserisci il file nella directory /tmp sul nodo.
Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
- ldap = OpenLDAP
- cs = Cassandra
- zk = custode dello zoo
- qpid = qpidd
- ps = postgresql
- edge =Tutti i componenti Edge eccetto UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
- ui = UI perimetrale
- all = aggiorna tutti i componenti sulla macchina (da utilizzare solo per un profilo di installazione Aio Edge o un profilo di installazione API BaaS asa)
- e = ElasticSearch
- b = Stack BaaS API
- p = Portale API BaaS
- ebp = ElasticSearch, Stack BaaS API e il Portale API BaaS sullo stesso nodo
Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

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

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

Per aggiornare 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à Edge apigee-setup.
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 seguente comando 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 pacchetto
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, annulla iltar del file nella directory /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  Questo comando crea una nuova directory, denominata repository, nella directory contenente il file .tar. Ad esempio /tmp/repos.
4. Installa l'utilità e le dipendenze Edge apigee-service da /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  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 "Installazione dal repository utilizzando il server web Nginx" in Installa l'utilità apigee-setup di Edge.
2. Sul nodo remoto, scarica il file Edge bootstrap_4.16.05.sh in /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05 dove il nome utente remoteRepo:3939/bootstrap_4.16.05.
3. Sul nodo remoto, installa l'utilità e le dipendenze Edge apigee-service:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigee=pWordpWord apigeeprotocol=http://
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 aggiornamento
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 ad apigee-service installa l'utilità apigee-service /apigee-apigee
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 Aggiornamento
Tuttavia, per il 16/4/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 Edge precedente, 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" di seguito:
> /opt/apigee/apigee-setup/bin/update.sh -c componente -f configFile
L'unico requisito del file di configurazione è che il file di configurazione sia accessibile o leggibile dall'utente "apigee". Ad esempio, inserisci il file nella directory /tmp sul nodo.
Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco dei possibili componenti include:
- ldap = OpenLDAP
- cs = Cassandra
- zk = custode dello zoo
- qpid = qpidd
- ps = postgresql
- edge =Tutti i componenti Edge eccetto UI Edge: server di gestione, processore di messaggi, router, server QPID, server Postgres
- ui = UI perimetrale
- all = aggiorna tutti i componenti sulla macchina (da utilizzare solo per un profilo di installazione Aio Edge o un profilo di installazione API BaaS asa)
- e = ElasticSearch
- b = Stack BaaS API
- p = Portale API BaaS
- ebp = ElasticSearch, Stack BaaS API e il Portale API BaaS sullo stesso nodo
Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.

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

Ordine di aggiornamento della macchina

L'ordine di aggiornamento delle macchine in un'installazione Edge è importante. Le considerazioni più importanti di 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 (server di gestione, processore di messaggi, router, server QPID, 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".
Dopo aver aggiornato un nodo Router, devi rimuovere tutti i file dalla directory /opt/nginx/conf.d, quindi riavviare il router.