Upgrade dei microservizi Oracle GoldenGate - basati su GUI

Scopri i passi per eseguire l'upgrade dei microservizi Oracle GoldenGate utilizzando l'interfaccia GUI.

A questo punto, dovresti avere una nuova home dei microservizi Oracle GoldenGate 26ai e qualsiasi home delle release precedenti di Oracle GoldenGate MA.

Aggiornare Service Manager

Dopo aver installato la versione MA più recente di Oracle GoldenGate, il passo successivo consiste nell'upgrade di Service Manager.

Se si utilizza l'agente Oracle Grid Infrastructure (XAG), disabilitare l'istanza GoldenGate prima di eseguire l'upgrade di Service Manager:

$ agctl disable goldengate <goldengate_name>

Di seguito sono riportati i passi per eseguire l'aggiornamento di Service Manager.

Eseguire il login a Service Manager dall'URL: https://hostname:servicemanager_port
Espandere il collegamento ServiceManager nella sezione Distribuzioni della pagina Panoramica di Service Manager.
Fare clic su Dettagli, quindi sull'icona a forma di matita accanto alla sezione Dettagli distribuzione per aprire la finestra di dialogo che consente di modificare il percorso home di GoldenGate.
Aggiornare il percorso della home Oracle GoldenGate con il percorso completo della nuova home Oracle GoldenGate.
Fare clic su Applica.
Utilizzare l'elenco a discesa Azione per riavviare Service Manager.

Se si utilizza XAG, aggiornare i parametri dell'istanza GoldenGate:
```
 $ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient
```
NOTA: se si utilizza XAG, è necessario aggiornare anche le distribuzioni gestite dal Service Manager aggiornato. Non è supportata l'esecuzione di distribuzioni in un Service Manager utilizzando una release software GoldenGate diversa per il Service Manager.

Upgrade di una distribuzione

Per aggiornare una distribuzione:

Arrestare tutti i processi Extract e Replicat in modo esteso:
- Verificare la presenza di una transazione aperta (lunga esecuzione) e di Bounded Recovery in quanto l'arresto dell'estrazione potrebbe richiedere più tempo.
- Se sono visibili transazioni aperte non necessarie, ad esempio SEND EXTRACT group_name SHOWTRANS, è possibile ignorare o forzare immediatamente l'interruzione di tali transazioni. In questo caso, è possibile recuperare un checkpoint Bounded Recovery utilizzando il seguente comando:
  
  SEND EXTRACT group_name, BR BRCHECKPOINT immediate
Verificare la posizione corrente della directory home di Oracle GoldenGate 26ai da Service Manager.
1. Accedi al Service Manager: http://hostname:servicemanager_port
2. Espandere il collegamento ServiceManager nella sezione Distribuzioni della home page di Service Manager.
3. Copiare il percorso della home di Oracle GoldenGate.
Tornare alla sezione Distribuzioni ed espandere il collegamento della distribuzione da aggiornare.
Fare clic su Dettagli, quindi sull'icona a forma di matita accanto alla sezione Dettagli distribuzione per aprire la finestra di dialogo in cui è possibile modificare il percorso GoldenGate Home.
Aggiornare il percorso della home Oracle GoldenGate con il percorso completo della nuova directory home Oracle GoldenGate.
Fare clic su Sottometti e confermare che il percorso della home Oracle GoldenGate è stato aggiornato.
A seconda del database della distribuzione in fase di aggiornamento, potrebbero verificarsi modifiche aggiuntive alle impostazioni della variabile di ambiente.

Fare clic su Configurazione per modificare le impostazioni per le variabili di ambiente, se necessario.

(Solo per Oracle GoldenGate for Oracle AI Database), la funzione Unified Build richiede che solo TNS_ADMIN venga modificato in base al software Oracle Database Client all'interno di Oracle GoldenGate.

TNS_ADMIN = Posizione di tnsnames.ora e sqlnet.ora

La variabile di ambiente OGG_HOME può rilevare automaticamente DATABASE_HOME, LD_LIBRARY_PATH e JAVA_HOME. Nota: quando si esegue l'aggiornamento da 21c a 26ai, questo passo non è necessario. Se l'upgrade da Oracle GoldenGate 19c (o versione precedente) a 26ai, è necessaria solo la variabile di ambiente TNS_ADMIN.

(Solo per Oracle GoldenGate per SQL Server) Oracle GoldenGate 26ai for SQL Server on Linux include un driver ODBC per la connettività del database. Anche se non è necessario, si consiglia di utilizzare il driver confezionato. Per utilizzare il driver all'interno del package, è necessario creare due nuove variabili di ambiente e aggiornare qualsiasi file odbc.ini creato in precedenza.

Aggiungere le variabili di ambiente seguenti alla distribuzione:
- ODBCSYSINI = ${OGG_HOME}/msodbc
- ODBCINI = ${OGG_HOME}/msodbc/odbc.ini
Dopo aver creato le nuove variabili di ambiente, copiare il file odbc.ini esistente nella cartella GoldenGate msodbc e modificare il valore del driver ODBC di qualsiasi voce DSN nel seguente modo:
```
Driver=Microsoft ODBC Driver for SQL Server
```
Fare clic su Sottometti per salvare le modifiche apportate alle variabili di ambiente.
Tornare alla home page di Service Manager.
Fare clic sull'icona Riavvia nel campo Azioni per la distribuzione e fare clic su OK per riavviare la distribuzione.
Eseguire di nuovo il login al nuovo servizio di amministrazione e avviare tutte le estrazioni e le repliche.

Se si utilizza XAG, riabilitare l'istanza GoldenGate dopo l'upgrade della distribuzione:
```
 $ agctl enable goldengate <GoldenGate Name>
```

Una volta riavviato il Service Manager e le distribuzioni, l'aggiornamento viene completato.

Nota: per Oracle GoldenGate for PostgreSQL, vedere Passi successivi all'upgrade prima di avviare qualsiasi estrazione.