Gestisci le tue distribuzioni OCI GoldenGate

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

Argomenti correlati

Informazioni sulle versioni GoldenGate

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

Ogni release ha un numero di build. Esistono tre tipi di release:

  • Maggiore: il primo numero nel numero di build indica una release principale. Di seguito sono riportati alcuni esempi. 21.
  • Bundle: il secondo numero indica la release del bundle. Una release bundle è un set di correzioni di bug per una release principale. 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 della sicurezza.

A seconda del tipo di release e se include o meno una correzione di sicurezza, è necessario disporre di 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, alla fine di questo periodo di tempo la distribuzione esegue automaticamente l'upgrade alla versione più recente.

Nota

È possibile visualizzare la data di supporto di una versione nella schermata di distribuzione dell'aggiornamento e nell'elenco Aggiornamenti.

Deprecazione delle versioni

Una versione GoldenGate è disponibile dalla data in cui è stata rilasciata alla data in cui non è più valida. Quando una versione non è più valida, non è più possibile selezionarla per la creazione o l'aggiornamento 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 non è più valida.
  • 180 giorni dopo il rilascio della versione Bundle, le versioni Bundle precedenti della stessa release Major 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

La data di rilascio può differire tra le aree.

Pianifica upgrade

È possibile personalizzare le finestre di manutenzione che definiscono l'inizio del periodo di tempo durante il quale aggiornare la distribuzione quando è disponibile una nuova versione di GoldenGate. Se non si definisce una finestra di manutenzione, OCI GoldenGate calcola il momento migliore per aggiornare la distribuzione in base alla data di rilascio dell'ultima versione.

Nota

Quando non è definita una finestra di manutenzione, OCI GoldenGate pianifica gli aggiornamenti nel fine settimana più vicino alla fine calcolata del periodo di aggiornamento automatico.

È possibile personalizzare la finestra di manutenzione OCI GoldenGate quando si crea la distribuzione o in un secondo momento dalla pagina dei dettagli della distribuzione. Quando è disponibile una nuova versione di GoldenGate, la distribuzione viene aggiornata automaticamente nel giorno e nell'ora esatti scelti. Tuttavia, le distribuzioni possono eseguire automaticamente l'upgrade prima del giorno e dell'ora scelti in cui il periodo di tempo della nuova versione per l'upgrade manuale non rientra nella finestra di manutenzione personalizzata.

Ad esempio, supponiamo che il 1° gennaio 2023 siano rimasti 30 giorni per aggiornare la distribuzione, quindi sarà necessario eseguire l'upgrade manuale fino a martedì 31 gennaio. Tuttavia, la finestra di manutenzione personalizzata inizia la domenica alle 10PM. Con questa finestra di manutenzione, OCI GoldenGate aggiornerà la distribuzione domenica 4 febbraio alle ore 10PM, poiché OCI GoldenGate assegnerà 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, per Manutenzione fare clic su Modifica.
  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 Periodo di aggiornamento automatico release principale in giorni, immettere un valore compreso tra 0 e 365.
    3. Per Periodo di aggiornamento automatico del rilascio del bundle in giorni, immettere un valore compreso tra 0 e 180.
    4. Per 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 secondaria in giorni.
  3. Fare clic su Salva modifiche.

Prima di aggiornare

Prima di aggiornare 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

Utilizzare il comando seguente nel client di amministrazione per determinare il log di archivio più vecchio 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 sono presenti transazioni di grandi dimensioni e con tempi di esecuzione lunghi, è possibile considerare che nel sistema di origine potrebbe essere necessario avviare l'elaborazione del nuovo Extract dal normale checkpoint di recupero. 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 a esecuzione lunga

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

  • È possibile ripristinare gli archivi e includere quello mostrato nel checkpoint di recupero mostrato 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. A tale scopo, è possibile saltare le transazioni o forzarle nel trail come transazioni impegnate. Saltare una transazione può causare perdita di dati e forzare una transazione al trail potrebbe aggiungere dati indesiderati al trail se viene eseguito il rollback della transazione. Per saltare o forzare una transazione:
    1. Visualizza transazioni aperte:
      Admin Client > SEND EXTRACT group_name, SHOWTRANS
    2. Registrare l'ID transazione di qualsiasi transazione che si desidera ripulire.
    3. Eseguire il cleanup delle transazioni precedenti utilizzando SEND EXTRACT e l'opzione SKIPTRANS per saltare una transazione oppure FORCETRANS per forzare una transazione nello stato corrente a trail come transazione impegnata. 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 di recupero limitato. 
      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.

Aggiornare una distribuzione

Assicurarsi di aver prima completato i passi Prima di eseguire l'aggiornamento.

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 Aggiorna distribuzione selezionare una versione GoldenGate disponibile a cui eseguire l'aggiornamento, quindi fare clic su Aggiorna.

    Nota

    Ulteriori informazioni sulle versioni.

Il completamento dell'aggiornamento richiede alcuni minuti. Fare clic su 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 di heartbeat
È inoltre necessario aggiornare le tabelle Heartbeat se sono utilizzate nella distribuzione. Una volta completato l'aggiornamento, è possibile:
  • Eseguire il comando UPGRADE HEARTBEATTABLE nel client di amministrazione per aggiungere colonne aggiuntive per le tabelle e le viste di ritardo. GoldenGate utilizza queste colonne supplementari per tenere traccia della posizione di riavvio di Extract. Ulteriori informazioni.
  • Nella console di distribuzione, aprire il menu di navigazione per la console di amministrazione, quindi fare clic su Configurazione. connettersi al database; Quando vengono visualizzate le tabelle Heartbeat, selezionare Aggiorna dal menu Azione.

Aggiorna notifiche

OCI GoldenGate invia notifiche di eventi per quando è disponibile un aggiornamento e quando è pianificato un aggiornamento. Per ulteriori informazioni, vedere GoldenGate Tipi di evento di aggiornamento 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 della sicurezza.

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

Disattiva notifiche

È possibile posporre o ritardare le notifiche di eventi e banner. Il periodo di posposizione cambia man mano che ci si avvicina alla fine del periodo di tempo per l'aggiornamento manuale.

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

Nota

Non è consentito posporre le correzioni di sicurezza degli aggiornamenti secondari o dei bundle.

È possibile annullare lo snooze in qualsiasi momento.

Esegui rollback aggiornamenti

È possibile eseguire il rollback di una versione della distribuzione alla versione precedente. Il rollback è consentito solo per l'ultimo aggiornamento riuscito alla versione precedente.

Nota

Durante il rollback, il file system di distribuzione viene ripristinato all'ultimo stato prima dell'aggiornamento.

Rollback non consentito quando la versione precedente non è più valida.

Per eseguire il rollback di un aggiornamento:

  1. Nella 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 fare clic su 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 gli 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 GoldenGate OCI. Per ulteriori informazioni, vedere Informazioni sulle versioni di GoldenGate.

Per ripianificare un aggiornamento:

  1. Nella 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 distribuzione, selezionare la data e l'ora per eseguire l'upgrade.
  5. Fare clic su 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 comporta la disabilitazione implicita degli aggiornamenti automatici per le release secondarie e deve essere disabilitato manualmente. È possibile disabilitare l'upgrade automatico della release secondaria dalla pagina dei dettagli della distribuzione. Per ulteriori informazioni, vedere Pianifica gli 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 distribuzione fare clic su Annulla upgrade distribuzione.

Lo stato dell'aggiornamento viene aggiornato su Annullato.

Problemi noti

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

Quando si tenta di eseguire il rollback di una build 21.15 o 23.x in:

  • Oracle (21.14.0.0_240525)
  • Big Data (21.14.0.0.0_240515)
  • MySQL (21.14.0.0.0_240404)
  • MSSQL (21.14.0.0.0.0_2404)

È possibile che si verifichi uno dei seguenti problemi:

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

    Soluzione alternativa: è necessario annullare l'assegnazione e riassegnare le connessioni esistenti alla distribuzione e ricreare gli utenti mancanti necessari per i percorsi di distribuzione o di 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. In caso di problemi, contattare il Supporto Oracle.
  • Processi Oracle GoldenGate non riusciti 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. Se il problema persiste, contattare il Supporto Oracle.