Gestire le distribuzioni GoldenGate OCI

Informazioni sulle versioni di GoldenGate, su come e quando eseguire l'upgrade, ricevere o posporre notifiche e su come eseguire il rollback degli aggiornamenti.

Informazioni sulle versioni GoldenGate

OCI GoldenGate supporta più versioni concorrenti, ad esempio Oracle GoldenGate, Oracle GoldenGate for Big Data e Oracle GoldenGate for MySQL, per citarne alcune. Per ulteriori informazioni sulla versione appropriata, fare riferimento al riferimento alle versioni.

Ogni release ha un numero di build. Esistono i tre tipi di release indicati di seguito.

• Principale: il primo numero nella build indica una release principale. Di seguito sono riportati alcuni esempi. 21.

• Bundle: il secondo numero indica la release del bundle. Una release bundle è una serie di correzioni di bug per una release importante. Di seguito sono riportati alcuni esempi. 21.5

• Minore: i numeri finali indicano una release secondaria. Una release secondaria è costituita da una o più correzioni di bug in una release bundle. Di seguito sono riportati alcuni esempi. 21.5.0.0.0.

Nota: tutti i tipi di release possono contenere correzioni alla sicurezza.

A seconda del tipo di release e del fatto che includa o meno una correzione per la sicurezza, è necessario un periodo di tempo specifico per aggiornare la distribuzione quando diventa disponibile una nuova versione:

Tipo di release	Principale	Bundle	Secondaria
Correzione non di sicurezza	365 giorni	Per 180 giorni	Non applicabile
Correzione alla sicurezza	Non applicabile	Per 14 giorni	Per 14 giorni

Se non si esegue l'upgrade manualmente entro il periodo di tempo specificato, la distribuzione esegue automaticamente l'upgrade alla versione più recente alla fine di questo periodo di tempo.

Nota: è possibile visualizzare la data in cui una versione è supportata fino alla schermata di distribuzione Upgrade e all'elenco Aggiornamenti.

Deprecazione delle versioni

Una versione di GoldenGate è disponibile dalla data in cui è stata rilasciata alla data in cui è deprecata. Quando una versione non è più valida, non è più possibile selezionarla per la creazione o l'upgrade della distribuzione.

I periodi di non validità utilizzano gli stessi intervalli di tempo degli aggiornamenti della versione. Ad esempio:

• 365 giorni dopo una versione Major, la versione Major precedente è deprecata.

• 180 giorni dopo il rilascio di una versione del bundle, le versioni precedenti del bundle della stessa release principale non sono più valide.

• 14 giorni dopo il rilascio di una correzione di sicurezza (per le release Bundle o Minor), tutte le versioni precedenti della stessa release Major sono deprecate.

Nota: a partire da aprile 2027, tutte le distribuzioni di replica dei dati 21c verranno aggiornate automaticamente alla versione della release più recente disponibile. Le date di rilascio possono variare tra le aree.

Pianifica aggiornamenti

È possibile personalizzare le finestre di manutenzione che definiscono quando aggiornare la distribuzione. Se non si definisce una finestra di manutenzione, OCI GoldenGate calcola il momento migliore per eseguire l'upgrade della distribuzione in base alla data di rilascio della versione più recente e quindi esegue automaticamente l'upgrade della distribuzione durante il fine settimana più vicino alla fine calcolata del periodo di upgrade automatico.

Nota: quando viene rilasciata una nuova versione di una release Major, Bundle o Minor, OCI GoldenGate pianifica automaticamente un upgrade in base alla relativa sequenza temporale applicabile (365 giorni per Major, 180 giorni per Bundle, 14 giorni per Minor con correzione della sicurezza). Se una versione più recente della stessa release diventa disponibile, il servizio aggiorna la distribuzione utilizzando la versione più recente disponibile, ma la data pianificata rimane invariata.

È possibile personalizzare la finestra di manutenzione di OCI GoldenGate quando si crea la distribuzione o quando si modifica una distribuzione esistente. Quando una nuova versione di GoldenGate diventa disponibile, la distribuzione si aggiorna automaticamente il giorno e l'ora esatti scelti. Tuttavia, è possibile eseguire l'upgrade automatico delle distribuzioni prima del giorno e dell'ora scelti, quando l'intervallo di tempo di upgrade scelto per l'upgrade manuale non rientra nella finestra di manutenzione.

Si supponga, ad esempio, che il 1° gennaio siano rimasti 30 giorni per aggiornare la distribuzione, quindi che sia necessario eseguire l'aggiornamento manuale fino a martedì 31 gennaio. Tuttavia, la finestra di manutenzione personalizzata inizia la domenica a 10PM. Con questa finestra di manutenzione, OCI GoldenGate eseguirà l'upgrade della distribuzione la domenica successiva alle 10PM, poiché OCI GoldenGate dà sempre la priorità alla finestra personalizzata.

Per modificare la finestra di manutenzione personalizzata:

1. Nella pagina dei dettagli della distribuzione, in GoldenGate nell'area delle informazioni sulla distribuzione, selezionare Modifica per Manutenzione.

2. Nella finestra di dialogo Modifica parametri di manutenzione:

   1. (Facoltativo) Selezionare Personalizza finestra di manutenzione per modificare i seguenti campi dai valori predefiniti.

   2. Per il periodo di upgrade automatico della release principale in giorni, immettere un valore compreso tra 0 e 365.

   3. Per Periodo di upgrade automatico della release bundle in giorni, immettere un valore compreso tra 0 e 180.

   4. In Periodo di upgrade automatico del percorso di sicurezza in giorni, immettere un valore compreso tra 0 e 14.

   5. (Facoltativo) Selezionare Abilita upgrade automatico release secondaria, quindi immettere un valore per Periodo di upgrade automatico release minore in giorni.

3. Selezionare Salva modifiche.

Prima di eseguire l'upgrade

Prima di eseguire l'upgrade di una distribuzione, assicurarsi di completare i task riportati di seguito e verificare la presenza di transazioni con tempi di esecuzione lunghi.

Assicurarsi che i log di archivio siano disponibili per il recupero

Usare il comando seguente nel client di amministrazione per determinare il log di archivio meno recente che potrebbe essere necessario ripristinare all'avvio di Extract. Il campo Recovery Checkpoint mostra il log meno recente necessario per il recupero.

Admin Client > INFO EXTRACT group_name, SHOWCH

È meglio eseguire attività di aggiornamento al di fuori delle ore di punta. Se ci sono transazioni di grandi dimensioni e con tempi di esecuzione lunghi, si potrebbe considerare che nel sistema di origine, il nuovo Extract potrebbe dover iniziare l'elaborazione dal normale checkpoint di recupero, piuttosto che rispetto al checkpoint di recupero limitato, se il primo record della transazione aperta meno recente al momento dell'arresto di Extract si trova in un log non presente nel sistema.

Cancella transazioni con tempi di esecuzione lunghi

Per cancellare le transazioni con tempi di esecuzione lunghi, sono disponibili due opzioni:

• È possibile ripristinare gli archivi e includerlo in quello mostrato nel checkpoint di recupero visualizzato con:

  Admin Client > INFO EXTRACT

  (Se il database di origine lo supporta).

• È possibile cancellare le transazioni con tempi di esecuzione lunghi applicabili all'estrazione che si sta aggiornando. Ciò può essere fatto saltando le transazioni o costringendole al trail come transazioni impegnate. Saltare una transazione può causare la perdita di dati e forzare una transazione al trail può aggiungere dati indesiderati al trail se viene eseguito il rollback della transazione. Per saltare o forzare una transazione:

  1. Visualizza le transazioni aperte:

     Admin Client > SEND EXTRACT group_name, SHOWTRANS

  2. Registrare l'ID transazione di qualsiasi transazione che si desidera eseguire il cleanup.

  3. Eseguire il cleanup delle transazioni precedenti utilizzando SEND EXTRACT e l'opzione SKIPTRANS per ignorare una transazione oppure FORCETRANS per forzare una transazione nello stato corrente a Trail come transazione di cui è stato eseguito il commit. Ad esempio:

     Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]}

  4. Dopo aver completato il cleanup delle transazioni con tempi di esecuzione lunghi, forzare un checkpoint Bounded Recovery.

     Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Sincronizza repliche

Per le distribuzioni con repliche parallele, assicurarsi di sincronizzare le repliche prima di eseguire l'aggiornamento:

Admin Client > SYNCHRONIZE REPLICAT group_name

Per ulteriori informazioni, vedere il riferimento all'interfaccia della riga di comando SYNCHRONIZE REPLICAT.

Aggiorna una distribuzione

Prima di eseguire l'aggiornamento, assicurarsi di completare i passi Prima.

Quando si aggiorna una distribuzione,

• La distribuzione viene arrestata e quindi riavviata al termine dell'upgrade.

• Tutti i processi Oracle GoldenGate vengono arrestati e quindi riavviati se configurati per l'avvio automatico.

Per aggiornare una distribuzione:

1. Nella pagina Distribuzioni selezionare la distribuzione da aggiornare.

2. Nella pagina dei dettagli della distribuzione, dal menu Azioni, selezionare Aggiorna.

3. Nel pannello Distribuzione upgrade selezionare una versione GoldenGate disponibile a cui eseguire l'upgrade, quindi selezionare Upgrade.

Nota: ulteriori informazioni sulle versioni.

Il completamento dell'aggiornamento richiede alcuni minuti. Selezionare Aggiornamenti nella pagina dei dettagli della distribuzione al termine dell'upgrade per visualizzare la cronologia dell'upgrade o se si verifica un problema durante il processo di upgrade.

Aggiorna tabelle heartbeat

È inoltre necessario aggiornare le tabelle di heartbeat se sono utilizzate nella distribuzione. Una volta completato l'aggiornamento, è possibile effettuare una delle seguenti operazioni:

• Eseguire il comando UPGRADE HEARTBEATTABLE nel client di amministrazione per aggiungere colonne aggiuntive per tabelle e viste di ritardo. GoldenGate utilizza queste colonne aggiuntive per tenere traccia della posizione di riavvio Extract. Ulteriori informazioni.

• Nella console di distribuzione aprire il menu di navigazione per la console di amministrazione, quindi selezionare Configurazione. connettersi al database; Quando vengono visualizzate le tabelle di heartbeat, selezionare Aggiorna dal menu Azione.

Notifiche di aggiornamento

OCI GoldenGate invia notifiche di eventi per indicare quando è disponibile un upgrade e quando viene pianificato un upgrade. Per ulteriori informazioni, consulta i tipi di eventi di aggiornamento GoldenGate o ulteriori informazioni sugli eventi.

Tempo per l'aggiornamento	< 180 giorni	< 30 giorni	< 7 giorni
Periodo di notifica	Ogni 30 giorni	Ogni 7 giorni	Ogni giorno

Nota: OCI GoldenGate invia ogni giorno una notifica per le correzioni alla sicurezza.

È inoltre possibile ottenere informazioni sugli aggiornamenti imminenti dai banner di notifica visualizzati nella pagina dei dettagli della distribuzione.

Disattiva notifica

È possibile posporre o ritardare le notifiche di eventi e banner. Il periodo di disattivazione temporanea cambia quando ci si avvicina alla fine dell'intervallo di tempo per l'aggiornamento manuale.

Tempo per l'aggiornamento	< 180 giorni	< 30 giorni	< 7 giorni
Periodo disattivazione temporanea	Per 30 giorni	Per 7 giorni	Non consentita

Nota: la disattivazione temporanea per le correzioni di sicurezza degli aggiornamenti secondari o di bundle non è consentita.

Puoi annullare lo snooze in qualsiasi momento.

Rollback aggiornamenti

È possibile eseguire il rollback di una versione di distribuzione a quella precedente. Il rollback è consentito solo per l'aggiornamento riuscito più recente alla versione precedente.

Nota: durante il rollback, il file system di distribuzione viene ripristinato all'ultimo stato prima dell'upgrade.

Il rollback non è consentito se la versione precedente non è più valida.

Per eseguire il rollback di un aggiornamento:

1. Dalla pagina Distribuzioni, selezionare la distribuzione di cui si desidera eseguire il rollback.

2. Nella pagina dei dettagli della distribuzione selezionare Aggiornamenti.

3. Nell'elenco Aggiornamenti individuare la versione precedente più recente, quindi nel relativo menu Azione selezionare Rollback.

4. Selezionare la versione a cui eseguire il rollback, quindi selezionare Rollback.

Nota: per un elenco delle versioni disponibili, fare riferimento al riferimento alle versioni.

Lo stato della distribuzione viene modificato in aggiornamento e il completamento richiede alcuni minuti.

Ripianifica aggiornamenti

È possibile ripianificare gli aggiornamenti pianificati automaticamente. È possibile ripianificare l'aggiornamento a una data più vicina o posticiparlo a una data successiva.

Nota: la rischedulazione non tiene conto delle finestre di manutenzione. La data appena pianificata non può essere successiva al valore definito di OCI GoldenGate. Per ulteriori informazioni, vedere Informazioni sulle versioni di GoldenGate.

Per ripianificare un aggiornamento:

1. Dalla pagina Distribuzioni, selezionare la distribuzione di cui si desidera ripianificare l'upgrade.

2. Nella pagina dei dettagli della distribuzione selezionare Aggiornamenti.

3. Nell'elenco Aggiornamenti individuare la versione precedente più recente, quindi nel relativo menu Azione selezionare Riprogramma.

4. Nella finestra Ripianifica upgrade della distribuzione, selezionare la data e l'ora per eseguire l'upgrade.

5. Selezionare Salva modifiche.

Nell'elenco Aggiornamenti, la data e l'ora pianificate riflettono le modifiche.

Annulla aggiornamenti

È possibile annullare un aggiornamento pianificato automaticamente solo se la versione di destinazione è una release secondaria.

Nota: l'annullamento di un aggiornamento a una release secondaria non disabiliterà implicitamente gli aggiornamenti automatici per le release secondarie e deve essere disabilitato manualmente. È possibile disabilitare l'upgrade automatico della release secondaria dalla pagina dei dettagli di distribuzione. Per ulteriori informazioni, vedere Pianificazione degli aggiornamenti.

Per annullare un aggiornamento:

1. Nella pagina Distribuzioni selezionare la distribuzione di cui si desidera annullare l'upgrade.

2. Nella pagina dei dettagli della distribuzione selezionare Aggiornamenti.

3. Nell'elenco Aggiornamenti individuare la versione precedente più recente, quindi nel relativo menu Azione selezionare Annulla.

4. Nella finestra Annulla upgrade della distribuzione, selezionare Annulla upgrade della distribuzione.

Lo stato dell'aggiornamento viene aggiornato su Annullato.

Problemi noti

Dopo l'upgrade a Oracle GoldenGate 23.26.x, errore di gateway non valido nella console di distribuzione 502 o impossibile elencare i processi GoldenGate dopo il login

Le distribuzioni di Oracle Cloud Infrastructure GoldenGate 23.26 potrebbero non essere integre dopo l'upgrade da etichette precedenti alla versione 23.26.x o dopo l'esecuzione di un'operazione di arresto/avvio su una distribuzione 23.26.x.

Soluzione: l'aggiornamento ha interessato le distribuzioni Oracle all'etichetta oggoracle:23.26.1.0.0_260331 per risolvere il problema.

Per i Big Data e altre etichette non Oracle, una correzione verrà annunciata a breve. Contattare il supporto per la mitigazione manuale provvisoria per evitare l'impatto.

Problemi durante il rollback dalle build 21.15 o 23.x alla release 21.14

Quando si tenta di eseguire il rollback di una build 21.15 o 23.x in una delle build riportate di seguito.

• Oracle (21.14.0.0.0_240525)

• Big data (21.14.0.0.0_240515)

• MySQL (21.14.0.0.0_240404)

• MSSQL (21.14.0.0.0_240404)

È possibile che si verifichi uno dei seguenti problemi:

• Problema di connessioni/credenziali mancante a causa della nuova funzione di crittografia del wallet introdotta 21.15 in poi.

  Soluzione: è necessario annullare l'assegnazione e riassegnare le connessioni esistenti alla distribuzione e ricreare gli utenti mancanti necessari per qualsiasi percorso di distribuzione o ricezione in uso.

• Avvio di Service Manager non riuscito a causa di un problema con il servizio metriche delle prestazioni nei rollback dalla versione 23.x alla versione 21.14. Se si verifica questo problema, contattare il Supporto Oracle.

• I processi Oracle GoldenGate non riescono con l'errore "OGG-02431 Intestazione record non valida trovata nel file di checkpoint".

  Soluzione: aggiornare la distribuzione alla build 21.14 più recente disponibile nella serie. Contattare il Supporto Oracle se il problema persiste.