Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiornamento di Apigee Edge dalla 4.16.01/4.16.05 alla 4.17.09

Edge for Private Cloud versione 4.17.09

Quali versioni di Edge puoi aggiornare alla 4.17.09?

Puoi aggiornare Apigee Edge 4.16.01.0x e 4.16.05.x alla versione 4.17.09 utilizzando questa procedura.

Se hai una versione di Edge precedente alla 4.16.01, devi prima eseguire la migrazione alla versione 4.16.01 e poi aggiornarla alla versione 4.17.09.

Puoi eseguire la migrazione dalla versione 4.15.07 di Apigee Edge alla versione 4.16.01.
Se hai una versione di Edge precedente alla 4.15.07, devi prima eseguire la migrazione alla versione 4.15.07 e poi alla versione 4.16.01.
- Se stai eseguendo la migrazione da Edge versione 4.14.04 o successiva: esegui la migrazione direttamente alla versione 4.15.07.
- Se esegui la migrazione da Edge versione 4.14.01: devi prima eseguire la migrazione alla versione 4.14.04 e poi alla versione 4.15.07.

Chi può eseguire l'aggiornamento

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

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

Quali componenti devi aggiornare

Devi aggiornare tutti i componenti di Edge. Edge non supporta una configurazione che contiene componenti di più versioni.

Downgrade di Zookeeper se esegui l'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 di Zookeeper è stata ripristinata in apigee-zookeeper-3.4.5-0.0.94x. In questo modo, yum impedisce l'upgrade di Zookeeper a una versione successiva alla 4.16.01. Per risolvere il problema, esegui 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

e poi devi eseguire il downgrade.

Propagazione automatica delle impostazioni della proprietà

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

Aggiorna prerequisiti

Prima di eseguire l'upgrade di Apigee Edge, assicurati di soddisfare i seguenti prerequisiti:

Esegui il backup di tutti i nodi
Per motivi di sicurezza, prima di eseguire l'aggiornamento è consigliabile eseguire un backup completo di tutti i nodi. Utilizza la procedura per la versione corrente di Edge per eseguire il backup.

Ciò consente di 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 attivo e in esecuzione durante il processo di aggiornamento utilizzando il comando:

> /opt/apigee/apigee-service/bin/apigee-all

Gestione di un aggiornamento non riuscito

In caso di errore di aggiornamento, puoi provare a correggere il problema, quindi eseguire di nuovo update.sh. Puoi eseguire l'aggiornamento più volte e continuarlo dal punto in cui era stato interrotto.

Se l'errore richiede di eseguire il rollback dell'aggiornamento alla versione precedente, consulta la sezione 4.17.09 Procedura di rollback per saperne di più.

Informazioni sugli aggiornamenti 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.

Upgrade obbligatorio alla versione 8 di Java JDK

Questa release di Edge richiede l'installazione della versione 8 di Java JDK su tutti i nodi di elaborazione di 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 crittografia disattivate per impostazione predefinita" all'indirizzo http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Obbligatorio per attivare il repository EPEL

Per installare o aggiornare Edge, devi attivare i pacchetti extra per Enterprise Linux (o EPEL). Il comando che utilizzi dipende dalla versione di RedHat/CentOS:

Per RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
Per RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Aggiunta obbligatoria del parametro di configurazione SMTPMAILFROM

Edge 4.17.05 ha aggiunto un nuovo parametro obbligatorio al file di configurazione utilizzato quando attivi un server SMTP. Se esegui l'aggiornamento da 4.17.01, devi impostare SMTPMAILFROM nel file di configurazione quando attivi il server SMTP.

La versione 4.17.09 dell'API BaaS ha anche aggiunto il supporto per la proprietà SMTPMAILFROM. Quando aggiorni l'API BaaS, devi impostare SMTPMAILFROM nel file di configurazione.

Questo parametro ha il seguente formato:

SMTPMAILFROM="My Company <myco@company.com>"

Obbligatorio se l'aggiornamento viene eseguito quando si utilizza l'autenticazione esterna

Puoi integrare un servizio di directory esterno in un'installazione di Apigee Edge Private Cloud esistente. Questa funzionalità è progettata per funzionare con qualsiasi servizio directory che supporta LDAP, come Active Directory, OpenLDAP e altri. Una soluzione LDAP esterna consente agli amministratori di sistema di gestire le credenziali utente da un servizio di gestione delle directory centralizzato, esterno a sistemi come Apigee Edge che le utilizzano.

Per saperne di più, consulta la sezione Configurazione dell'autenticazione esterna.

Quando l'autenticazione esterna è attiva, la maggior parte dei clienti utilizza il campo del nome dell'account SAM Active Directory come nome utente per l'autenticazione, anziché un indirizzo email utilizzato dal server OpenLDAP di Edge.

Se hai eseguito l'integrazione con un servizio directory esterno, aggiungi la seguente riga al file di configurazione quando aggiorni Edge alla versione 4.17.09:

IS_EXTERNAL_AUTH="true"

Questa riga configura Edge in modo da supportare un nome account anziché un indirizzo email come nome utente.

Upgrade obbligatorio a Qpid 1.35

Questa release contiene un aggiornamento obbligatorio a Qpid 1.35. Nell'ambito dell'aggiornamento di un nodo Qpid, devi:

Impedisci temporaneamente ai router e ai processori di messaggi di scrivere nel nodo Qpid bloccando la porta 5672 sul nodo Qpid. Puoi utilizzare il seguente comando per bloccare questa porta sul nodo Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Attendi che la coda Qpid sia vuota per assicurarti che il nodo Qpid abbia elaborato tutti i messaggi prima dell'aggiornamento. Utilizza il seguente comando per assicurarti che la coda di messaggi Qpid sia vuota:
> qpid-stat -q
Aggiorna il nodo Qpid.
Sblocca la porta 5672 sul nodo Qpid per consentire l'accesso da router e processori di messaggi. Puoi utilizzare il seguente comando per sbloccare questa porta:
> sudo iptables -F

Tieni presente che se utilizzi iptables per altre regole, puoi utilizzare l'opzione -D per annullare la modifica specifica:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Questo processo è descritto in dettaglio di seguito per ogni topologia Edge.

Upgrade obbligatorio a Postgres 9.4

Questa release di Edge include un upgrade a Postgres 9.4. Nell'ambito di questo upgrade, tutti i dati di Postgres vengono migrati a Postgres 9.4.

Durante la procedura 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 di nuovo online, i dati di analisi viene inviato ai nodi Postgres.

Se per qualsiasi motivo devi eseguire il rollback dell'aggiornamento, è necessario il nodo di standby di Postgres aggiuntivo. Se devi eseguire il rollback dell'aggiornamento, il nuovo nodo Postgres di standby diventa il nodo Postgres master dopo il rollback. Pertanto, quando installi il nuovo nodo Postgres di riserva, deve essere su un nodo che soddisfi tutti i requisiti hardware di un server Postgres, come definito nei Requisiti di installazione di Edge.

Installazione di un nuovo nodo standby Postgres

Questa procedura crea un server Postgres di riserva su un nuovo nodo. Assicurati di installare un nuovo server Postgres di riserva per la versione esistente di Edge (4.16.01 o 4.16.05), non per la versione 4.17.09.

Per eseguire l'installazione, utilizza lo stesso file di configurazione utilizzato per installare la versione corrente di Edge.

Per creare un nuovo nodo Postgres di standby:

Nel master Postgres attuale, modifica il file /opt/apigee/customer/application/postgresql.properties per impostare il token seguente. Se il file non esiste, creane uno:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

dove existing_slave_ip è l'indirizzo IP dell'attuale server standby Postgres e new_slave_ip è l'indirizzo IP del nuovo nodo standby.
Riavvia apigee-postgresql sul master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql riavvio
Verifica che il nuovo nodo di standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. In questo file dovresti vedere le seguenti righe:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Installa il nuovo server Postgres di standby:
1. Modifica il file di configurazione che hai utilizzato per installare la versione corrente di Edge per specificare quanto segue:
  
  # Indirizzo IP del master attuale:
  PG_MASTER=192.168.56.103
  # indirizzo IP del nuovo nodo in standby
  PG_STANDBY=192.168.56.102
2. Disattiva SELinux come descritto in Installa l'utilità di configurazione di Edge apigee-setup.
3. Scarica il 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
  
  Nota: se stai eseguendo l'aggiornamento da 4.16.01, scarica il file bootstrap.sh di Edge.
4. Installa l'utilità apigee-service di Edge e le dipendenze:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Utilizza apigee-service per installare l'utilità apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Installa Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. Sul nuovo nodo in standby, esegui questo comando:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Verifica che sia indicato in standby.

Ritiro di un nodo Postgres

Al termine dell'aggiornamento, ritira il nuovo nodo di riserva:

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 di standby eseguendo il seguente comando cURL sul nuovo nodo di standby:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Dovresti vedere l'UUID del nodo alla fine dell'output, nel formato:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Interrompi il nuovo nodo di standby eseguendo il seguente comando sul nuovo nodo di 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 replica apigee existing_slave_ip/32 trust
Riavvia apigee-postgresql sul master Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql riavvio
Verifica che il nuovo nodo di 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:
Replica host apigee existing_slave_ip/32 trust
Elimina l'UUID del nodo di standby da ZooKeeper eseguendo la seguente chiamata all'API di gestione di Edge sul nodo del server di gestione:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Aggiornamento senza tempi di inattività

Un aggiornamento senza tempi di inattività o in sequenza ti consente di aggiornare l'installazione di Edge senza interrompere il servizio.

L'aggiornamento senza tempi di inattività è possibile solo con una configurazione a 5 nodi o superiore.

La chiave per l'upgrade senza tempi di riposo è rimuovere ogni router, uno alla volta, dal bilanciatore del carico. 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 le macchine nell'ordine corretto per l'installazione come descritto di seguito in "Ordine di aggiornamento della macchina".
Al momento dell'aggiornamento dei router, seleziona un router qualsiasi e rendilo irraggiungibile, come descritto in Attivare/disattivare la connettività 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 di nuovo raggiungibile il router.
Ripeti i passaggi da 2 a 4 per gli altri router.
Continua l'aggiornamento per le eventuali altre macchine dell'installazione.

Tieni presente quanto segue prima/dopo l'aggiornamento:

Nel nodo Router e Message Processor combinato:
- Prima dell'aggiornamento:
  1. Rendi il router irraggiungibile.
  2. Rendi il processore di messaggi non raggiungibile.
- Dopo l'aggiornamento, esegui queste operazioni:
  1. Rendi raggiungibile il processore di messaggi.
  2. Rendi il router raggiungibile.
Su un singolo nodo router:
- Prima dell'aggiornamento, rendi il router non raggiungibile.
- Dopo l'aggiornamento, assicurati che il router sia raggiungibile.
Su singolo nodo del processore di messaggi:
- Prima dell'aggiornamento, rendi il Message Processor irraggiungibile.
- Dopo l'aggiornamento, rendi raggiungibile il processore di messaggi.

Utilizzo di un file di configurazione silenzioso

Devi passare un file di configurazione silenzioso al comando di aggiornamento. Il file di configurazione silenzioso dovrebbe essere lo stesso che hai utilizzato per installare Edge 4.16.01 o 4.16.05.

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

Per aggiornare i componenti Edge su un nodo, segui questa procedura:

Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
Se presenti, disattiva tutti i job CRON configurati per eseguire un'operazione di riparazione su Cassandra fino al completamento dell'aggiornamento.
Accedi al tuo nodo come utente root per installare gli RPM di Edge.
Nota: anche se l'installazione del pacchetto RPM richiede l'accesso come utente root, puoi eseguire la configurazione di Edge senza questo accesso.
Installa yum-utils e yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Disabilita SELinux come descritto in Installare l'utilità Edge apigee-setup.
Attiva il repository EPEL come descritto sopra.
Se esegui l'installazione su AWS, esegui il seguente comando yum-configure-manager:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Scarica il file bootstrap_4.17.09.sh Edge 4.17.09 in /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Installa l'utilità apigee-service e le dipendenze di Edge 4.17.09:
> sudo bash /tmp/bootstrap_4.17.09.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 installerà 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 (valore 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 4.16.01 eseguendo l'upgrade della versione 4.15.07.0x di Edge, devi installare l'utilità apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Questo comando installa l'utilità update.sh in /opt/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, 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 per apigee-service installa l'utilità update.sh/apigee-setup
3. Se hai installato la versione 4.16.05 direttamente o tramite aggiornamento, 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 /opt/apigee/apigee-setup/bin.
A seconda della versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
1. Se al momento utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sul server di gestione:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Se al momento utilizzi Edge 4.16.01: 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 del Message Processor durante l'installazione di 4.16.01, puoi aggiornarla utilizzando il seguente comando sul nodo:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Tuttavia, a partire dalla versione 4.16.05 e successive, Apigee consiglia di installare ed eseguire l'utilità apigee-validate sul server di gestione.
3. Se esegui l'upgrade da 4.16.01: modifica il file di configurazione passato all'utilità apigee-validate. Nella release Edge 4.16.01, 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.
Aggiorna l'utilità apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision
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 sia accessibile o leggibile dall'utente "apigee".

Utilizza l'opzione "-c" per specificare il componente da aggiornare. Puoi contenere:
al al o di un elemento di qualsiasi elemento può includere:
al al al al al al ldap
Testa l'aggiornamento eseguendo l'utilità apigee-validate sul server di gestione, come descritto in Testare l'installazione.
Se hai installato un nuovo nodo Postgres di riserva, esegui il ritiro del nodo come descritto sopra in Ritiro di un nodo Postgres.

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

Procedura per l'aggiornamento alla versione 4.17.09 da un repository locale

Se i nodi Edge sono protetti da un firewall o in altri modi 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, copialo in un nodo e poi 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 da utilizzare oppure puoi utilizzare il tuo server web.

Per eseguire l'aggiornamento da un repository locale 4.17.09:

Se al momento utilizzi la replica master-standby di Postgres, installa un nuovo nodo standby Postgres come descritto sopra in Installazione di un nuovo nodo standby Postgres.
Crea un repository locale 4.17.09 come descritto in "Creare un repository Apigee locale" in Installare l'utilità apigee-setup di Edge.
Nota: se hai già un repository 4.16.01 o 4.16.05, puoi aggiungere il repository 4.17.09 come descritto in "Aggiornare un repository Apigee locale" in Installare l'utilità apigee-setup di Edge.
Per installare apigee-service da un file .tar:
1. Sul nodo con il repository locale, utilizza il seguente comando per pacchettizzare il repo locale in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.17.09.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 sul nuovo nodo.
3. Sul nuovo nodo, estrae il file nella directory /tmp:
  > tar -xzf apigee-4.17.09.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.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Tieni presente che in questo comando devi includere il percorso alla directory dei repository.
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 Installare l'utilità Edge apigee-setup.
2. Sul nodo remoto, scarica il file bootstrap_4.17.09.sh di Edge in /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://nomeutente:password@repo remoto:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  dove nomeutente:password sono il nome utente e la password impostati sopra per il repo e repo remoto è l'indirizzo IP o il nome DNS del nodo del repo.
3. Sul nodo remoto, installa l'utilità apigee-service di Edge e le dipendenze:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  dove uName:pWord sono il nome utente e la password del repo.
Utilizza apigee-service per aggiornare l'utilità apigee-setup:
1. Se hai installato 4.16.01 eseguendo l'upgrade della versione 4.15.07.0x di Edge, devi installare l'utilità apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Questo comando installa l'utilità update.sh in /opt/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 /opt/apigee/apigee-setup/bin.
3. Se hai installato la versione 4.16.05 direttamente o tramite aggiornamento, 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 /opt/apigee/apigee-setup/bin.
A seconda della versione attuale di Edge, devi installare o aggiornare l'utilità apigee-validate sul server di gestione.
1. Se al momento utilizzi Edge 4.16.05: aggiorna l'utilità apigee-validate sul server di gestione:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Se al momento utilizzi Edge 4.16.01: 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 del Message Processor durante l'installazione di 4.16.01, puoi aggiornarla utilizzando il seguente comando su quel nodo:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Tuttavia, a partire dalla versione 4.16.05 e successive, Apigee consiglia di installare ed eseguire l'utilità apigee-validate sul server di gestione.
3. Se esegui l'upgrade da 4.16.01: modifica il file di configurazione passato all'utilità apigee-validate. Nella release Edge 4.16.01, 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.
Aggiorna l'utilità apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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 sia accessibile o leggibile dall'utente "apigee".

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 di Edge, tranne l'interfaccia utente di Edge: server di gestione, elaboratore di messaggi, router, server QPID, server Postgres
ui = interfaccia utente di Edge
all = aggiorna tutti i componenti sulla macchina (da utilizzare solo per un profilo di installazione Edge aio o un profilo di installazione API BaaS asa)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack e API BaaS Portal 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 Postgres di riserva, esegui il ritiro del nodo come descritto sopra in Ritiro di un nodo Postgres.

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

Ordine di aggiornamento della macchina

L'ordine in cui aggiorni le macchine in un'installazione Edge è importante. I fattori più importanti per un aggiornamento sono:

Devi aggiornare tutti i nodi Cassandra e ZooKeeper prima di aggiornare qualsiasi altro nodo.
Per qualsiasi macchina con più componenti Edge (Management Server, Message Processor, Router, QPID Server, ma non 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 esiste un passaggio separato per l'aggiornamento della monetizzazione. Viene aggiornato quando specifichi l'opzione "-c edge".