Aggiorna Apigee Edge da 4.19.06 o da 4.50.00 a 4.51.00

Questa sezione descrive come eseguire l'upgrade da Apigee Edge 4.19.06 o 4.50.00 a 4.51.00.

Chi può eseguire l'aggiornamento

L'utente che esegue l'aggiornamento deve essere la stessa persona che ha installato Edge inizialmente o un utente che esegue l'aggiornamento come utente root.

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

Quali componenti devi aggiornare

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

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.

Upgrade obbligatorio a Postgres 10.17

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

La maggior parte dei sistemi di produzione Edge utilizza due nodi Postgres configurati per la replica master-standby. Durante la procedura di aggiornamento, mentre i nodi Postgres sono inattivi per l'aggiornamento, i dati di analisi vengono comunque scritti nei nodi Qpid. Una volta aggiornati e di nuovo online, i dati di analisi vengono inviati ai nodi Postgres.

Il modo in cui esegui l'aggiornamento di Postgres dipende da come hai configurato lo spazio di archiviazione dei dati per i tuoi nodi Postgres:

  • Se utilizzi lo spazio di archiviazione dei dati locale per i tuoi nodi Postgres, devi installare un nuovo nodo Postgres di riserva per la durata dell'upgrade. Al termine dell'upgrade, puoi ritirare il nuovo nodo standby Postgres.

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

    In una configurazione di Edge con 1 e 2 nodi, le topologie utilizzate per la prototipazione e i test, hai un solo nodo Postgres. Puoi aggiornare questi nodi Postgres direttamente senza dover creare un nuovo nodo Postgres.

  • Se utilizzi lo spazio di archiviazione di rete per i tuoi nodi Postgres, come consigliato da Apigee, non devi installare un nuovo nodo Postgres. Nelle procedure riportate di seguito, puoi saltare i passaggi che specificano di installare e successivamente dimettere un nuovo nodo Postgres di standby.

    Prima di iniziare la procedura di aggiornamento, acquisisci uno snapshot di rete dello spazio dati utilizzato da Postgres. Se si verificano errori durante l'aggiornamento e devi eseguire un rollback, puoi ripristinare il nodo Postgres da questo snapshot.

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.19.06 o 4.50.00), non per la versione 4.51.00.

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:

  1. Nell'attuale master Postgres, modifica il file /opt/apigee/customer/application/postgresql.properties per impostare il seguente token. Se il file non esiste, creane uno: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    dove existing_standby_ip è l'indirizzo IP dell'attuale server standby Postgres e new_standby_ip è l'indirizzo IP del nuovo nodo standby.

  2. Riavvia apigee-postgresql sul master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifica che il nuovo nodo di standby sia stato aggiunto visualizzando il file /opt/apigee/apigee-postgresql/conf/pg_hba.conf sul master. Dovresti vedere le seguenti righe nel file: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Installa il nuovo server Postgres di standby:
    1. Modifica il file di configurazione utilizzato per installare la versione corrente di Edge per specificare quanto segue: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Disattiva SELinux come descritto in Installa l'utilità apigee-setup di Edge.
    3. Esegui una delle seguenti operazioni, a seconda della versione di Edge da cui esegui l'upgrade:
      • Se esegui l'upgrade da Edge 4.19.06, scarica il file bootstrap_4.19.06.sh di Edge in /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Poi, installa l'utilità apigee-service di Edge e le dipendenze: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Se esegui l'upgrade da Edge 4.50.00, scarica il file bootstrap_4.50.00.sh di Edge in /tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Poi, installa l'utilità apigee-service di Edge e le dipendenze: 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    4. Utilizza apigee-service per installare l'utilità apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Installa Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Sul nuovo nodo di standby, esegui il seguente comando: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Verifica che sia in modalità standby.

Eseguire un upgrade in loco di Postgres

Per eseguire un upgrade in situ a Postgres 10.17, svolgi i seguenti passaggi:

  1. Esegui l'upgrade di postgres sull'host master 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Esegui il comando di configurazione sull'host principale: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Esegui il comando configure sull'host principale: 
    apigee-service apigee-postgresql configure
  4. Riavvia l'host principale: 
    apigee-service apigee-postgresql restart
  5. Configuralo come principale: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Assicurati che l'host principale sia stato avviato: 
    apigee-service apigee-postgresql wait_for_ready
  7. Interrompi la modalità standby: 
    apigee-service apigee-postgresql stop
  8. Esegui l'upgrade della modalità standby.

    Nota:se questo passaggio genera errori/non va a buon fine, può essere ignorato. update.sh tenterà di avviare il server di riserva con una configurazione errata. Se l'installazione di Postgres viene aggiornata alla versione 10.17, l'errore può essere ignorato.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Assicurati che la modalità standby sia interrotta: 
    apigee-service apigee-postgresql stop
  10. Rimuovi la vecchia configurazione di standby: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Configura la replica sul server di standby: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Al termine di questa procedura, lo standby verrà avviato correttamente.

Ritiro di un nodo Postgres

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

  1. 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

  2. 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"

  3. Interrompi il nuovo nodo di standby eseguendo il seguente comando sul nuovo nodo di standby: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Sul nodo master Postgres, modifica /opt/apigee/customer/application/postgresql.properties per rimuovere il nuovo nodo di standby da conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Riavvia apigee-postgresql sul master Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Verifica che il nuovo nodo di standby sia stato rimosso visualizzando il /opt/apigee/apigee-postgresql/conf/pg_hba.conf file sul master. Dovresti vedere solo la seguente riga nel file: 
    host replication apigee existing_standby_ip/32 trust
  7. Elimina l'UUID del nodo di standby da ZooKeeper effettuando la seguente chiamata all'API Edge Management sul nodo del server di gestione: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Aggiorna i 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 ti consigliamo di eseguire un backup completo di tutti i nodi. 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 in esecuzione durante la procedura di aggiornamento utilizzando il comando: 
    /opt/apigee/apigee-service/bin/apigee-all status

Interfaccia utente del nuovo Edge

Questa sezione elenca le considerazioni relative all'interfaccia utente di Edge. Per ulteriori informazioni, consulta La nuova UI di Edge per il cloud privato.

Installare l'interfaccia utente di Edge

Dopo aver completato l'installazione iniziale, Apigee consiglia di installare l'interfaccia utente di Edge, un'interfaccia utente avanzata per sviluppatori e amministratori di Apigee Edge for Private Cloud.

Tieni presente che l'interfaccia utente di Edge richiede di disattivare l'autenticazione di base e di utilizzare un IDP come SAML o LDAP.

Per ulteriori informazioni, vedi Installare la nuova UI di Edge.

Aggiornare l'interfaccia utente di Edge

Per aggiornare il componente dell'interfaccia utente di Edge, prendi in considerazione la versione di Edge per il cloud privato da cui stai eseguendo l'upgrade:

Aggiornamento con mTLS di Apigee

Per aggiornare Apigee mTLS , segui questi passaggi:

Eseguire il rollback di un aggiornamento

In caso di errore di aggiornamento, puoi provare a correggere il problema, quindi eseguire nuovamente update.sh. Puoi eseguire l'aggiornamento più volte e l'aggiornamento continuerà da dove si era interrotto l'ultima volta.

Se l'errore richiede il rollback dell'aggiornamento alla versione precedente, consulta Eseguire il rollback alla versione 4.51.00 per istruzioni dettagliate.