Aggiornamento EDB Postgres dalla versione 5.2 alla versione 5.3

Informazioni necessarie per completare questa attività

Prima di eseguire l'aggiornamento EDB Postgres, 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 IBM Software Hubcontrol plane è alla versione 5.3.1, è necessario aggiornare EDB Postgres 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 EDB Postgres.

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

Inoltre, se prevedi di utilizzare funzionalità che richiedono una GPU, assicurati di disporre del tipo e del numero di GPU adeguati per EDB Postgres.

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

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 EDB Postgres software 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 olm-utils-v4 dell'immagine dal registro container privato.

Operatori GPU

Se si intende utilizzare funzionalità che richiedono GPU, questa operazione presuppone che siano installati gli operatori necessari per l'utilizzo delle GPU.

Dove trovare ulteriori informazioni
Se questa operazione non è stata completata, consultare Installazione degli operatori per i servizi che richiedono GPU.

Risorse con ambito cluster

Questa operazione presuppone che le risorse a livello di cluster, quali definizioni di risorse personalizzate, ruoli cluster e associazioni di ruoli cluster, siano state aggiornate.

Dove trovare ulteriori informazioni
Se questa operazione non è stata completata, consultare Aggiornamento delle risorse a livello di cluster per la piattaforma e i servizi.

Segreti pull immagine

Questo compito presuppone che esistano i segreti che contengono le credenziali di pull dell'immagine per l'istanza.

Dove trovare ulteriori informazioni
Se questa operazione non è stata completata, consultare Creazione di segreti di pull immagine per un'istanza di IBM Software Hub.

Procedura

Per effettuare l'aggiornamento EDB Postgres, completa le seguenti operazioni:

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

Miglioramento del servizio

Per aggiornare EDB Postgres :

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 EDB Postgres.

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=edb_cp4d \
   --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=edb_cp4d

Aggiornamento delle istanze di servizio esistenti

Dopo l'aggiornamento EDB Postgres, è necessario aggiornare tutte le istanze di servizio associate a EDB Postgres.

Per aggiornare le istanze del servizio:

1. Accedi a Red Hat OpenShift Container Platform come amministratore dell'istanza.

   ${OC_LOGIN}

   Ricorda: OC_LOGIN è un alias del oc login comando.
2. Ottieni l'elenco delle EDB Postgres istanze di servizio:

   oc get CPDEdbInstance \
   --namespace=${PROJECT_CPD_INST_OPERANDS}

3. Imposta la variabile INSTANCE_NAME di ambiente con il nome dell'istanza del servizio che desideri aggiornare:

   export INSTANCE_NAME=<instance-name>

4. Imposta la variabile INSTANCE_VERSION di ambiente sulla versione corrispondente alla versione presente Cloud Pak for Data sul tuo cluster:

   export INSTANCE_VERSION=<version>

   Utilizzare la tabella seguente per determinare il valore appropriato:

   IBM Software Hub Versione	Versione componente aggiuntivo	Versioni delle istanze di servizio (Scegli uno)
   5.3.1	5.3.1	13.23, 14.20, 15.15, 16.11, 17.7, 18.1
   5.3.0	5.3.0	13.22, 14.19, 15.14, 16.10, 17.6

   Nota: non EDB Postgres supporta direttamente gli aggiornamenti delle versioni principali. Supportano solo aggiornamenti continui o aggiornamenti minori per PostgreSQL. Per ulteriori dettagli, consultare EDB PostgreSQL Aggiornamenti continui.

   Gli utenti devono eseguire un aggiornamento parallelo per le versioni principali, come descritto in Importazione del database di EDB PostgreSQL.

   Se l'aggiornamento è necessario per una versione principale, eseguire l'aggiornamento all'ultima versione.

5. Aggiorna la versione nella risorsa personalizzata dell'istanza di servizio:

   oc patch CPDEdbInstance ${INSTANCE_NAME} \
   --namespace=${PROJECT_CPD_INST_OPERANDS} \
   --type=merge \
   --patch='{"spec": {"version": "${INSTANCE_VERSION}"}}'

   Nota: a partire dalla versione 5.2.x, è supportato anche il seguente comando per aggiornare la versione nella risorsa personalizzata dell'istanza di servizio:

   ./cpd-cli service-instance upgrade \
     --instance-name=${INSTANCE_NAME} \
     --service-type=edb \
     --profile=${CPD_PROFILE_NAME} \
     --version=5.2.0 \
     --merge-override=true \
     --override=parameters.yaml

   Ecco un esempio del file parameters.yaml :

   parameters:
    version: '${INSTANCE_VERSION}'

6. Ripeti i passaggi precedenti per aggiornare ogni istanza di servizio nel progetto operands.

Cosa fare successivamente

Le istanze del database EDB Postgres esistenti sono pronte per l'uso. È necessario completare la configurazione post-installazione per il servizio EDB Postgres prima di accedere a EDB Postgres.