Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiorna Apigee Edge 4.16.05.x all'ultima versione 4.16.05

Edge per Private Cloud v. 4.16.05

Questo documento contiene la procedura da utilizzare per aggiornare l'installazione 4.16.05 esistente per utilizzare gli RPM più recenti e i file di supporto di Apigee. Questa procedura utilizza l'utilità update.sh per eseguire l'aggiornamento.

Quali versioni di Edge puoi aggiornare all'ultima release 4.16.05

Puoi aggiornare solo alla versione più recente un'installazione di Apigee Edge versione 4.16.05.x esistente nella versione 4.16.05.

Se attualmente utilizzi Edge versione 4.16.01.0x o precedente, devi prima eseguire la migrazione 4.16.05. Vedi Aggiornamento di Apigee Edge dalla versione 4.16.01 alla versione 4.16.05 per informazioni su come migrare alla versione 4.16.05.

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.

Requisiti di spazio su disco per l'aggiornamento

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

Propagazione automatica della proprietà impostazioni da 4.16.05.x

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, vedi 4.16.05 Processo di rollback.

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, viene utilizzata 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 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 descritto nella sezione successiva "Rendere irraggiungibili un router e un processore 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 gli altri router.
Continua l'aggiornamento per eventuali macchine rimanenti nell'installazione.

Realizzazione di un router e Processore di messaggi non raggiungibile

In una configurazione di produzione, avrai più router e processori di messaggi da raggiungere per garantire prestazioni ottimali ed è necessario abilitare/disabilitare la connettività di questi router Processori prima/dopo l'aggiornamento.

La seguente chiamata API configura un nodo come raggiungibile o non raggiungibile:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

dove UUID è l'UUID del router o del processore di messaggi e raggiungibile sia impostato su true o false.

Per determinare l'UUID del router, utilizza il seguente comando cURL:

> curl http://<routerIP>:8081/v1/servers/self

Se devi determinare l'UUID del processore di messaggi, utilizza il seguente cURL :

> curl http://<mpIP>:8082/v1/servers/self

Prima/dopo l'aggiornamento, prendi in considerazione quanto segue:

Sul nodo combinato router e processore di messaggi:
- Prima dell'aggiornamento, esegui queste operazioni:
  1. Rendi il router irraggiungibile utilizzando la chiamata API mostrata sopra.
  2. Rendi il processore di messaggi irraggiungibile.
- Dopo l'aggiornamento, procedi nel seguente modo:
  1. Rendi raggiungibile il processore di messaggi.
  2. Rendi il router raggiungibile.
Su singolo nodo router:
- Prima dell'aggiornamento, rendi il router 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.05.

Procedura per l'aggiornamento 4.16.05 su un nodo con una connessione Internet esterna

Usa la seguente procedura 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 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à.
Svuota tutte le cache di Yum:
> sudo yum pulisci tutto
Scarica l'ultimo 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
Aggiorna l'utilità e le dipendenze del servizio apigee-service Edge:
> 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 Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.
Usa apigee-service per 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.
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. Ad esempio, metti il file nella directory /tmp del nodo.

Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco delle possibili includono:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =tutti i componenti Edge tranne UI Edge: server di gestione, processore di messaggi, router, Server QPID, server Postgres
- ui = UI perimetrale
- all = aggiorna tutti i componenti sulla macchina (da usare solo per un profilo di installazione Edge aio) o un profilo di installazione API BaaS asa)
- e = ElasticSearch
- b = stack BaaS API
- p = Portale BaaS delle API
- ebp = ElasticSearch, API BaaS Stack e portale API BaaS sullo stesso nodo
Testa l'aggiornamento eseguendo l'utilità apigee-validate, Test the install.

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

Assicurati di avere un repository 4.16.05 locale come descritto in Installare i componenti Edge su un nodo.
Aggiorna il repository locale:
1. Scarica l'ultimo file Edge 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
2. Esegui la sincronizzazione:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
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
2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo in nella directory /tmp sul un nuovo nodo.
3. Sul nuovo nodo, sposta il 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 . ad esempio /tmp/repos.
4. 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.
5. Disattiva SELinux come descritto in Installare Edge Utilità apigee-setup.
6. Installa l'utilità apigee-service Edge e le dipendenze da /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Nota che in questo comando viene incluso il percorso della directory dei repository.
Per installare apigee-service utilizzando il server web Nginx:
1. Configura il server web Nginx come descritto in "Eseguire l'installazione dal repository utilizzando webserver" alla pagina Installa Componenti periferici su un nodo.
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.sh -o /tmp/bootstrap_4.16.05.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.
3. 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.
4. Disattiva SELinux come descritto in Installare Edge Utilità apigee-setup.
5. Sul nodo remoto, installa l'utilità e le dipendenze di apigee-service Edge:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  dove uName:pWord sono il nome utente e la password del repository.
Se presente, disabilita tutti i job CRON configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
Usa apigee-service per 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.
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. Ad esempio, metti il file nella directory /tmp del nodo.

Utilizza l'opzione "-c" per specificare il componente da aggiornare. L'elenco delle possibili includono:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =tutti i componenti Edge tranne UI Edge: server di gestione, processore di messaggi, router, Server QPID, server Postgres
- ui = UI perimetrale
- all = aggiorna tutti i componenti sulla macchina (da usare solo per un profilo di installazione Edge aio) o un profilo di installazione API BaaS asa)
- e = ElasticSearch
- b = stack BaaS API
- p = Portale BaaS delle API
- ebp = ElasticSearch, API BaaS Stack e portale API BaaS sullo stesso nodo
Testa l'aggiornamento eseguendo l'utilità apigee-validate, Test the install.

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.
Devi aggiornare tutti i nodi qpidd e postgresql prima di aggiornare qualsiasi Nodi del router e del processore di messaggi.
Per qualsiasi macchina con più componenti Edge (server di gestione, processore di messaggi, router, server QPID, server Postgres), utilizza "-c edge" per aggiornarli tutti contemporaneamente nel tempo.
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" .
Dopo aver aggiornato un nodo router, devi rimuovere tutti i file dalla directory /opt/nginx/conf.d, quindi riavvia il router.