Aggiornamento di Data Gate dalla versione 5.1 alla versione 5.3

Informazioni necessarie per completare questa attività

Prima di aggiornare Data Gate, consultare le seguenti informazioni:

Requisiti di versione

Tutti i componenti associati a un'istanza di IBM Software Hub devono essere installati nella stessa versione. Ad esempio, se la versione IBM Software Hubcontrol plane è 5.3.1, è necessario aggiornare Data Gate alla versione 5.3.1.

Variabili di ambiente

I comandi in questa attività utilizzano variabili di ambiente in modo da poter eseguire i comandi esattamente come sono scritti.

• Se non disponi dello script che definisce le variabili di ambiente, consulta Configurazione delle variabili di ambiente di installazione.
• Per utilizzare le variabili di ambiente dallo script, è necessario caricare le variabili di ambiente prima di eseguire i comandi in questa attività. Ad esempio, eseguire:

  source ./cpd_vars.sh

Prima di iniziare

Questo compito presuppone che siano soddisfatti i seguenti prerequisiti:

Requisiti di sistema

Questo compito presuppone che il cluster soddisfi i requisiti minimi per Data Gate.

Dove trovare ulteriori informazioni
Se questa operazione non è stata completata, consultare i requisiti di sistema.

Workstation

Questo compito presuppone che la workstation da cui verrà eseguito l'aggiornamento sia configurata come workstation client e disponga delle seguenti interfacce della riga di comando:

• IBM Software Hub CLI: cpd-cli
• OpenShift® CLI: oc
• Helm CLI: oc

Dove trovare ulteriori informazioni
Se questa operazione non è stata completata, consultare Aggiornamento delle workstation client.

Piano di controllo

Questo compito presuppone che il IBM Software Hubcontrol plane sia aggiornato.

Dove trovare ulteriori informazioni
Se questa operazione non è stata completata, consultare Aggiornamento di un'istanza di IBM Software Hub.

Registro privato dei container

Se il tuo ambiente utilizza un registro container privato (ad esempio, il tuo cluster è air-gapped), questa attività presuppone che le seguenti attività siano state completate:

1. Le immagini del software Data Gate vengono replicate nel registro container privato.

   Dove trovare ulteriori informazioni
   Se questa operazione non è stata completata, consulta la sezione Duplicazione delle immagini in un registro container privato.

2. Il cpd-cli è configurato per estrarre olm-utils-v4 l'immagine dal registro dei container privato.

   Dove trovare ulteriori informazioni
   Se questa operazione non è stata completata, consultare Recupero dell'immagine olm-utils-v4 dal registro dei container privato.

Servizi preliminari

Prima di aggiornare Data Gate, assicurarsi che i seguenti servizi siano aggiornati e in esecuzione:

1. Db2

   oppure

2. Db2 Warehouse

Procedura

Per aggiornare Data Gate, esegui le seguenti operazioni:

1. Miglioramento del servizio
2. Convalida dell'aggiornamento
3. Aggiornamento delle istanze di servizio esistenti
4. Verifica dell'aggiornamento dell'istanza del servizio
5. Cosa fare dopo

Miglioramento del servizio

Per aggiornare Data Gate :

1. Accedi al cpd-cli cluster Red Hat® OpenShift Container Platform :

   ${CPDM_OC_LOGIN}

   Ricorda: CPDM_OC_LOGIN è un alias del cpd-cli manage login-to-ocp comando.
2. Aggiorna l'operatore e la risorsa personalizzata per Data Gate.

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=datagate \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --upgrade=true

Convalida dell'aggiornamento

[SUCCESS]... The install-components command ran successfully

Se desideri verificare che lo stato della risorsa personalizzata sia Completed, puoi eseguire il cpd-cli manage get-cr-status comando:

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=datagate

Aggiornamento delle istanze di servizio esistenti

Dopo aver aggiornato Data Gate, è necessario aggiornare tutte le istanze di servizio associate a Data Gate.

1. Per impostare il tuo profilo, esegui il seguente comando:

   export CPD_PROFILE_NAME=<my_profile_name>
   

   Dove <my_profile_name> è il nome del tuo profilo.

2. Scegli una delle seguenti opzioni per aggiornare le tue istanze di servizio:

   Aggiornare un'istanza di servizio specifica in un'istanza di Cloud Pak for Data

   
   cpd-cli service-instance upgrade --instance-name=<dg_service_instance_name> \
   --service-type=dg \
   --profile=${CPD_PROFILE_NAME} --watch

   dove:

   <nome_istanza_servizio_dg>

   È il nome (nome visualizzato) dell'istanza del servizio.

   --watch

   È un parametro facoltativo. Se specificato, le informazioni sullo stato dell'aggiornamento vengono aggiunte all'output dello schermo. Vedi questo esempio:

   L'aggiornamento dell'istanza di servizio DG-xxyyy 1699321926126046 è ancora in corso
   L'aggiornamento dell'istanza di servizio DG-xxyyy 1699321926126046 è ancora in corso
   L'aggiornamento dell'istanza di servizio DG-xxyyy 1699321926126046 è ancora in corso
   .
   .
   .

   Aggiorna tutte le istanze dello stesso tipo di servizio

   cpd-cli service-instance upgrade \
   --all \
   --service-type=dg \
   --profile=${CPD_PROFILE_NAME} --watch

Verifica dell'aggiornamento dell'istanza del servizio

È possibile utilizzare uno dei seguenti comandi per verificare che la distribuzione sia stata aggiornata e sia pronta per l'uso:

• Esegui il seguente comando e attendi che lo stato cambi in Completed:

  oc get dginstance instance_id -o jsonpath='{.status.datagateInstanceStatus} {"\n"}'

• Controlla le informazioni sullo stato dell'aggiornamento dell'istanza del servizio nell'output del passaggio 2. Data Gate L'istanza è stata aggiornata se il service-instance upgrade comando contiene la seguente riga:

  [SUCCESS] ... Service instance DG-xxyyy, 1699324826126046 upgrade is
          complete.

• Esegui il seguente comando e verifica se è Provision status cambiato in UPGRADED:

  cpd-cli service-instance list --profile=${CPD_PROFILE_NAME} --service-type dg

  Esempio:

   Spazio dei nomi Tipo di servizio Versione ID Nome Stato di fornitura Opzione di aggiornamento versione
   ---------           ------------        -------             --                  ----                ----------------    ----------------------
   zen1 dg 9.0.0 1699321926126046 DG-xxyyy AGGIORNATO []

Cosa fare successivamente

Aggiornamento alla versione 5.1.3

Potrebbe essere necessario includere le modifiche alla configurazione del magazzino Db2/Db2 nel configmap Data Gate appena creato. Per ulteriori informazioni, vedere Aggiornamento delle modifiche necessarie alla configurazione dell' Db2 e di destinazione.

Aggiornamento a una versione precedente all' 5.1.3

Potrebbe essere necessario modificare le impostazioni errate del database di destinazione dell' Db2. Per ulteriori informazioni, vedere Correzione delle impostazioni di configurazione errate di Db2 dopo un aggiornamento.

A questo punto, Data Gate è pronto per l'uso. Per iniziare a utilizzare Data Gate, consultare Amministrazione di Data Gate.