Aggiornamento di Apigee Edge da 4.16.09 a 4.17.09

Edge per Private Cloud v. 4.17.09

Quali versioni di Edge puoi aggiornare alla versione 4.17.09

Puoi aggiornare Apigee Edge dalla versione 4.16.09.0x 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.x e poi aggiornarla alla versione 4.17.09.

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 perimetrali, qualsiasi utente potrà configurarli.

Quali componenti devi aggiornare

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

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 a router e processori di messaggi di scrivere sul 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 invertire la modifica specifica:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Questa procedura è descritta in dettaglio di seguito per ogni topologia Edge.

Obbligatorio per abilitare il repository EPEL

Per installare o aggiornare Edge, devi abilitare Pacchetti aggiuntivi per Enterprise Linux (o EPEL). Il comando da utilizzare dipende dalla tua versione di RedHat/CentOS:

  • Per RedHat/CentOS/Oracle 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/Oracle 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

In Edge 4.17.05 è stato 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 con l'autenticazione esterna

Puoi integrare un servizio di directory esterno in un'installazione di Apigee Edge Private Cloud esistente. Questa funzionalità è progettata per essere utilizzata con qualsiasi servizio di 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 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 effettuato l'integrazione con un servizio di directory esterno, aggiungi la riga seguente 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.

Propagazione automatica delle impostazioni delle 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
    Prima di eseguire l'aggiornamento, è consigliabile eseguire un backup completo di tutti i nodi per motivi di sicurezza. Utilizza la procedura per la versione corrente di Edge per eseguire il backup.

    In questo modo avrai un piano di riserva 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 la procedura di aggiornamento utilizzando il comando:

    > /opt/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, quindi eseguire di nuovo update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà da dove si era interrotto la volta precedente.

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