Actualización de Data Virtualization 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 Data Virtualization :

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 actualizar Data Virtualization 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

Common core services

Data Virtualization requiere el IBM Software Hub common core services.

Si los no common core services están en la versión correcta en el proyecto de operandos para la instancia, los common core services se actualizan automáticamente cuando actualizas Data Virtualization. La common core services actualización aumenta el tiempo que tarda en completarse.

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 Data Virtualization.

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 del software Data Virtualization se replican 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.

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.

Servicios de requisito previo

Antes de actualizar Data Virtualization, asegúrese de que los siguientes servicios estén actualizados y en funcionamiento:

Procedimiento

Realice las siguientes tareas para actualizar Data Virtualization :

1. Mejora del servicio
2. Validación de la actualización
3. Actualización de instancias de servicio existentes
4. Actualización de cualquier conector remoto que esté instalado
5. Qué hacer a continuación

Actualización del servicio

Para actualizar Data Virtualization :

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. Actualiza el operador y el recurso personalizado para Data Virtualization.

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

Actualización de instancias de servicio existentes

Después de actualizar Data Virtualization, debe actualizar todas las instancias de servicio asociadas a Data Virtualization.

Para actualizar la instancia del servicio:

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. Cambia al proyecto donde están instalados los pods de Data Virtualization.

   oc project ${PROJECT_CPD_INST_OPERANDS}

3. Obtén la lista de instancias del servicio « Data Virtualization »:

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

4. Actualiza una instancia cada vez. Para cada instancia que desee actualizar, siga estos pasos:
   1. Antes de actualizar la instancia, guarde una copia del archivo bigsql db2u-dv CR.yaml:

      oc -n ${DV_INSTANCE_NAMESPACE} get bigsql db2u-dv -o yaml  > db2u-dv-before-upgrade.yaml

   2. Establezca la DV_INSTANCE_NAME variable de entorno con el nombre de la instancia que desea actualizar:

      export DV_INSTANCE_NAME=<instance-name>

   3. Ejecute el siguiente comando para actualizar la instancia:

      cpd-cli service-instance upgrade \
      --instance-name=${DV_INSTANCE_NAME} \
      --service-type=dv \
      --profile=${CPD_PROFILE_NAME}

   4. Ejecute uno de los siguientes comandos para verificar que la versión ahora sea 3.3.1 para las instancias actualizadas:

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

      • oc get bigsql db2u-dv -o jsonpath='{.status.version}{"\n"}'

   5. Guarde una copia del nuevo bigsql db2u-dv archivo CR.yaml después de la actualización:

      oc -n ${DV_INSTANCE_NAMESPACE} get bigsql db2u-dv -o yaml  > db2u-dv-after-upgrade.yaml

   6. Tanto en el archivo.yaml original como en el actualizado, revisa los ajustes de CPU y memoria que aparecen en la sección podConfig > db2u > recursos. Si la configuración del archivo.yaml posterior a la actualización no coincide con la configuración del archivo.yaml anterior a la actualización, cambie los valores manualmente. Para obtener más información, consulta «Scaling» en Data Virtualization. El siguiente ejemplo muestra la configuración de la CPU y la memoria en un archivo.yaml:

      podConfig:
            db2u:
              annotations:
                certmanager.k8s.io/disable-auto-restart: "true"
                cloudpakId: eb9998dcc5d24e3eb5b6fb488f750fe2
                cloudpakInstanceId: 98fc14ad-8a0a-4d4c-93bc-f44bc7dfdbe8
                cloudpakName: IBM Cloud Pak for Data
                hook.activate.cpd.ibm.com/command: '[]'
                hook.deactivate.cpd.ibm.com/command: '[]'
                hook.quiesce.cpd.ibm.com/command: '[]'
                hook.unquiesce.cpd.ibm.com/command: '[]'
                productChargedContainers: All
                productCloudpakRatio: "1:1"
                productID: eb9998dcc5d24e3eb5b6fb488f750fe2
                productMetric: VIRTUAL_PROCESSOR_CORE
                productName: IBM Data Virtualization
                productVersion: 2.2.5
              labels:
                ServiceInstanceID: "1733557758610243"
                app.kubernetes.io/instance: "1733557758610243"
                app.kubernetes.io/managed-by: db2u-operator
                app.kubernetes.io/name: db2u-dv
                icpdsupport/addOnId: dv
                icpdsupport/app: dv
                icpdsupport/createdBy: "1000331001"
                icpdsupport/module: instance
                icpdsupport/podSelector: dv
                icpdsupport/serviceInstanceId: "1733557758610243"
              resource:
                db2u:
                  limits:
                    cpu: 4
                    ephemeral-storage: 5Gi
                    memory: 16Gi
                  requests:
                    cpu: 4
                    ephemeral-storage: 1200Mi
                    memory: 16Gi

5. Espere hasta que se completen todas las actualizaciones de instancias antes de continuar con los siguientes pasos.

   Importante: Cada una de sus instancias de Data Virtualization de tamaño personalizado tendrá ahora cinco pods de agente Data Virtualization, cada uno de los cuales requiere dos CPU. Para ajustar el uso de recursos de los pods de los agentes, consulta la sección «Personalización del tamaño de los pods y del uso de recursos de los agentes de Data Virtualization ».

Actualización de conectores remotos

Si ha instalado conectores remotos, puede actualizarlos mediante el procedimiento UPDATEREMOTECONNECTOR almacenado. Este procedimiento se ejecuta utilizando el editor SQL o la Db2 consola del clúster.

• Para actualizar todos los conectores remotos, ejecute el siguiente procedimiento almacenado.

  call dvsys.updateremoteconnector('',?,?)

• Si necesita actualizar un conjunto de conectores remotos, pase una lista separada por comas.

  call dvsys.updateremoteconnector('<REMOTE_CONNECTOR_NODES>',?,?)

  Puede obtener el <REMOTE_CONNECTOR_NODES> ejecutando el mandato siguiente.

  select node_name from dvsys.listnodes where AGENT_CLASS='R'

Qué hacer a continuación