Actualización Db2 Warehouse de la versión 5.1 a la versión 5.3

Información que necesita para completar esta tarea

Revise la siguiente información antes de actualizar Db2 Warehouse :

Requisitos de versión

Todos los componentes asociados a una instancia de IBM Software Hub deben instalarse en la misma versión. Por ejemplo, si la IBM Software Hubcontrol plane está en la versión 5.3.1, debe actualizarla Db2 Warehouse a la versión 5.3.1.

Variables de entorno

Los comandos de esta tarea utilizan variables de entorno para que puedas ejecutarlos tal y como están escritos.

• Si no dispone del script que define las variables de entorno, consulte Configuración de las variables de entorno de instalación.
• Para utilizar las variables de entorno del script, debe obtener las variables de entorno antes de ejecutar los comandos de esta tarea. Por ejemplo, ejecute:

  source ./cpd_vars.sh

Antes de empezar

Esta tarea supone que se cumplen los siguientes requisitos previos:

Requisitos del sistema

Esta tarea asume que el clúster cumple los requisitos mínimos para Db2 Warehouse.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte los requisitos del sistema.

Estación de trabajo

Esta tarea asume que la estación de trabajo desde la que ejecutará la actualización está configurada como una estación de trabajo cliente y tiene las siguientes interfaces de línea de comandos:

• IBM Software Hub Interfaz de línea de comandos: cpd-cli
• OpenShift® Interfaz de línea de comandos: oc
• Helm Interfaz de línea de comandos: oc

Dónde encontrar más información
Si esta tarea no se ha completado, consulte Actualización de estaciones de trabajo cliente.

Panel de control

Esta tarea asume que el se IBM Software Hubcontrol plane ha actualizado.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte Actualización de una instancia de IBM Software Hub.

Registro de contenedor privado

Si su entorno utiliza un registro de contenedores privado (por ejemplo, su clúster está aislado), esta tarea da por hecho que se han completado las siguientes tareas:

1. Las imágenes de Db2 Warehouse software se reflejan en el registro de contenedores privado.

   Dónde encontrar más información
   Si esta tarea no se ha completado, consulte Duplicar imágenes en un registro de contenedores privado.

2. El cpd-cli está configurado para extraer la olm-utils-v4 imagen del registro de contenedores privado.

   Dónde encontrar más información
   Si esta tarea no se ha completado, consulte Obtención de la imagen olm-utils-v4 del registro de contenedores privado.

Red Hat® OpenShift AI

Si planea utilizar funciones que requieren Red Hat OpenShift AI, esta tarea asume que Red Hat OpenShift AI está instalado.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte Instalación de Red Hat OpenShift AI.

Recursos con ámbito de clúster

Esta tarea asume que se han actualizado los recursos del ámbito del clúster, como las definiciones de recursos personalizados, las funciones del clúster y los enlaces de funciones del clúster.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte Actualización de los recursos del clúster para la plataforma y los servicios.

Secretos de extracción de imágenes

Esta tarea asume que existen los secretos que contienen las credenciales de extracción de imágenes para la instancia.

Dónde encontrar más información
Si esta tarea no se ha completado, consulte Creación de secretos de extracción de imágenes para una instancia de IBM Software Hub.

Procedimiento

Completa las siguientes tareas para actualizar Db2 Warehouse :

1. Mejora del servicio
2. Validación de la actualización
3. Actualización de instancias de servicio existentes
4. Verificación de la actualización de la instancia de servicio
5. Qué hacer a continuación

Actualización del servicio

Para actualizar Db2 Warehouse :

1. Inicie sesión cpd-cli en el Red Hat OpenShift Container Platform clúster:

   ${CPDM_OC_LOGIN}

   Recuerda: CPDM_OC_LOGIN es un alias del cpd-cli manage login-to-ocp comando.
2. Actualizar el operador y el recurso personalizado para Db2 Warehouse.

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

Validación de la actualización

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

Si desea confirmar que el estado del recurso personalizado es Completed, puede ejecutar el cpd-cli manage get-cr-status comando:

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

Actualización de instancias de servicio existentes

Después de actualizar Db2 Warehouse, debe actualizar todas las instancias de servicio asociadas con Db2 Warehouse.

Antes de empezar

Crea un perfil en la estación de trabajo desde la que vas a actualizar las instancias del servicio.

El perfil debe estar asociado a un IBM Software Hub usuario que tenga alguno de los siguientes permisos:

• Crear instancias de servicio (can_provision)
• Gestionar instancias de servicio (manage_service_instances)

Para obtener más información, consulte «Creación de un perfil para utilizar los comandos de gestión de cpd-cli ».

Elimine los parches personalizados y los scripts de anulación, si procede:

1. Inicie sesión en Red Hat OpenShift Container Platform como un usuario con permisos suficientes para completar la tarea:

   oc login OpenShift_URL:port

2. Ejecute el siguiente comando para eliminar los parches personalizados y los scripts de sustitución:
   1. Para recursos Db2uCluster personalizados, ejecute el siguiente comando:

      oc set volume statefulset/c-${DB2U_ID}-db2u -n ${PROJECT_CPD_INST_OPERANDS} --remove --name=<volume_name>

   2. Para recursos Db2uInstance personalizados, ejecute los siguientes comandos:
      1. Encuentre el índice « VolumeMount »:

         oc get db2uengine c-${DB2U_ID}-db2u -n ${PROJECT_CPD_INST_OPERANDS} -o json | jq '.spec.podTemplate.spec.containers[0].volumeMounts | to_entries[] | select(.value.name=="<volume_name>")'

         Guarde la clave como: MNT_IDX=5.

      2. Busca el índice de volumen:

         oc get db2uengine c-${DB2U_ID}-db2u -n ${PROJECT_CPD_INST_OPERANDS} -o json | jq '.spec.podTemplate.spec.volumes | to_entries[] | select(.value.name=="<volume_name>")'

         Guarde la clave como: VOL_IDX=7.

      3. Corrija las entradas:

         oc patch db2uengine c-${DB2U_ID}-db2u \
           -n ${PROJECT_CPD_INST_OPERANDS} \
           --type='json' \
           -p="[
                 {\"op\":\"remove\",\"path\":\"/spec/podTemplate/spec/containers/0/volumeMounts/${MNT_IDX}\"},
                 {\"op\":\"remove\",\"path\":\"/spec/podTemplate/spec/volumes/${VOL_IDX}\"}
               ]"

Procedimiento

Para actualizar las instancias del servicio:

1. Obtén la lista de instancias del servicio « Db2 Warehouse »:

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

2. Establezca la variable INSTANCE_NAME de entorno con el nombre de la instancia del servicio que desea actualizar:

   export INSTANCE_NAME="<instance-name>"

3. Comprueba si tu instancia Db2 Warehouse de servicio está en estado de ejecución:

   cpd-cli service-instance status ${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME} \
   --service-type=db2wh

4. Actualizar la instancia del servicio:

   cpd-cli service-instance upgrade \
   --service-type=db2wh \
   --instance-name=${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME}

5. Supervise su estado Db2uCluster Db2uInstance o para comprobar si el estado del recurso personalizado cambia a Not Ready y, a continuación, a Ready :
   • Para recursos Db2uCluster personalizados, ejecute el siguiente comando:

     oc get db2ucluster <instance_id> -o jsonpath='{.status.state} {"\n"}'

   • Para recursos Db2uInstance personalizados, ejecute el siguiente comando:

     oc get db2uinstance <instance_id> -o jsonpath='{.status.state} {"\n"}'

   Si el estado del recurso personalizado vuelve a ser UpgradeCheckFailed, consulte la sección de resolución db2ckupgrade de problemas.
6. Verifique que la instancia del servicio se haya actualizado y esté lista para usar.
7. Repite los pasos anteriores para actualizar cada instancia de servicio asociada a esta instancia de IBM Software Hub.

Verificación de la actualización de la instancia de servicio

Puede utilizar un comando o la consola web para verificar que la instancia del servicio se ha actualizado y está lista para usar.

1. Obtenga su estado Db2uCluster Db2uInstance o. Espere a que el estado cambie a Ready:
   • Para recursos Db2uCluster personalizados, ejecute el siguiente comando:

     oc get db2ucluster <instance_id> -o jsonpath='{.status.state} {"\n"}'

   • Para recursos Db2uInstance personalizados, ejecute el siguiente comando:

     oc get db2uinstance <instance_id> -o jsonpath='{.status.state} {"\n"}'

2. Comprueba el estado de tus instancias Db2 Warehouse de servicio:

   cpd-cli service-instance status ${INSTANCE_NAME} \
   --profile=${CPD_PROFILE_NAME} \
   --service-type=db2wh

3. Comprueba si la instancia del servicio está actualizada:

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

Qué hacer a continuación

Revisa la configuración posterior a la instalación del servicio « Db2 Warehouse » para determinar si es necesario completar alguna tarea antes de que los usuarios puedan acceder al servicio « Db2 Warehouse ».