Actualización Data Gate de la versión 5.2 a la versión 5.3

Información que necesita para completar esta tarea

Revise la siguiente información antes de actualizar Data Gate :

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

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 Data Gate 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 Obtener la olm-utils-v4 imagen del registro de contenedores privado.

Servicios de requisito previo

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

1. Db2

   o

2. Db2 Warehouse

Procedimiento

Completa las siguientes tareas para actualizar Data Gate :

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 Data Gate :

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 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

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=datagate

Actualización de instancias de servicio existentes

Después de actualizar Data Gate, debe actualizar todas las instancias de servicio asociadas con Data Gate.

1. Para configurar tu perfil, ejecuta el siguiente comando:

   export CPD_PROFILE_NAME=<my_profile_name>
   

   Donde <my_profile_name> es el nombre de tu perfil.

2. Elija una de las siguientes opciones para actualizar sus instancias de servicio:

   Actualizar una instancia de servicio específica en una Cloud Pak for Data instancia

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

   Donde:

   <dg_service_instance_name>

   Es el nombre (nombre para mostrar) de su instancia de servicio.

   --watch

   es un parámetro opcional. Si lo especificas, la información sobre el estado de la actualización se añade a la salida de pantalla. Veamos este ejemplo:

   La actualización de la instancia de servicio DG-xxyyy 1699321926126046 sigue en curso
   La actualización de la instancia de servicio DG-xxyyy 1699321926126046 sigue en curso
   La actualización de la instancia de servicio DG-xxyyy 1699321926126046 sigue en curso
   .
   .
   .

   Actualizar todas las instancias de servicio del mismo tipo de servicio

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

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

Puede utilizar uno de los siguientes comandos para verificar que la implementación se ha actualizado y está lista para usar:

• Ejecute el siguiente comando y espere a que el estado cambie a Completed:

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

• Comprueba la información de estado sobre la actualización de la instancia del servicio en el resultado del paso 2. Data Gate La instancia se ha actualizado si el service-instance upgrade comando contiene la siguiente línea:

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

• Ejecute el siguiente comando y compruebe si ha Provision status cambiado a UPGRADED:

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

  Ejemplo:

   Namespace Service type Version ID Name Provision status Upgrade version option
   ---------           ------------        -------             --                  ----                ----------------    ----------------------
   zen1 dg 9.0.0 1699321926126046 DG-xxyyy ACTUALIZADO []

Qué hacer a continuación

Actualización a la versión 5.2.1

Es posible que tengas que incluir los cambios de configuración de tu Db2/Db2 almacén en el nuevo Data Gate mapa de configuración. Para obtener más información, consulte Actualización de los cambios necesarios en la configuración del servidor de destino ( Db2 ).

Actualizar a una versión inferior a 5.2.1

Es posible que tenga que ajustar la configuración incorrecta de su base de Db2 datos de destino. Para obtener más información, consulte Corrección de ajustes de configuración incorrectos de Db2 después de una actualización.

Después de eso, Data Gate está listo para usar. Para empezar a utilizar Data Gate, consulte Administración de Data Gate.