Instalación Cognos Dashboards

Un administrador de instancias puede instalar Cognos Dashboards en IBM® Software Hub la versión 5.3.

¿Quién debe completar esta tarea?

Administrador de instancias Para instalar Cognos Dashboards, debe ser administrador de instancias. Un administrador de instancias tiene permiso para instalar software en los siguientes proyectos:

El proyecto de los operadores para la instancia

Los operadores para esta instancia de Cognos Dashboards están instalados en el proyecto operators.

En los comandos de instalación, la variable ${PROJECT_CPD_INST_OPERATORS} de entorno hace referencia al proyecto de los operadores.

El proyecto de operandos para la instancia

Los recursos personalizados para y Cognos Dashboardscontrol plane se instalan en el proyecto operandos.

En los comandos de instalación, la variable ${PROJECT_CPD_INST_OPERANDS} de entorno hace referencia al proyecto operandos.

¿Cuándo necesitas completar esta tarea?

Revise las siguientes opciones para determinar si necesita completar esta tarea:

  • Si desea instalar varios servicios al mismo tiempo, siga el proceso descrito en Ejecutar una instalación por lotes de soluciones y servicios.
  • Si no lo instaló Cognos Dashboards como parte de una instalación por lotes, complete esta tarea para agregar Cognos Dashboards a su entorno.

    Repita según sea necesario. Si es responsable de varias instancias de IBM Software Hub, puede repetir esta tarea para instalar más instancias de Cognos Dashboards en el clúster.

Información que necesita para completar esta tarea

Revise la siguiente información antes de realizar la instalación Cognos Dashboards :

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 está IBM Software Hubcontrol plane instalado en la versión 5.3.1, debe instalar Cognos Dashboards en 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
restricción de contexto de seguridad

Cognos Dashboards funciona con la restricción de contexto de seguridad Red Hat® OpenShift® Container Platform predeterminada, restricted-v2.

Common core services

Cognos Dashboards requiere el IBM Software Hub common core services.

Si los no common core services están instalados en el proyecto de operandos para la instancia, los common core services se instalan automáticamente al instalar Cognos Dashboards. La common core services instalación aumenta el tiempo que tarda en completarse.

Requisitos de almacenamiento
Debe especificar las clases de almacenamiento al instalar Cognos Dashboards. Se recomiendan las siguientes clases de almacenamiento. Sin embargo, si no utiliza estas clases de almacenamiento en su clúster, asegúrese de especificar una clase de almacenamiento con una definición equivalente.

* indica que la clase de almacenamiento solo se utiliza si common core services necesita instalarse.

Almacenamiento Notas Clases de almacenamiento
OpenShift Data Foundation Al instalar el servicio, especifique el almacenamiento de archivos y el almacenamiento en bloques.
  • Almacenamiento de archivos: ocs-storagecluster-cephfs
  • Almacenamiento en bloque: ocs-storagecluster-ceph-rbd *
IBM Fusion Data Foundation Al instalar el servicio, especifique el almacenamiento de archivos y el almacenamiento en bloques.
  • Almacenamiento de archivos: ocs-storagecluster-cephfs
  • Almacenamiento en bloque: ocs-storagecluster-ceph-rbd *
IBM Fusion Global Data Platform Cuando instale el servicio, especifique la misma clase de almacenamiento tanto para el almacenamiento de archivos como para el almacenamiento en bloques.
  • Almacenamiento de archivos:

    Cualquiera de las siguientes clases de almacenamiento:

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
  • Almacenamiento en bloque:

    Cualquiera de las siguientes clases de almacenamiento:

    • ibm-spectrum-scale-sc *
    • ibm-storage-fusion-cp-sc
IBM Storage Scale Container Native Cuando instale el servicio, especifique la misma clase de almacenamiento tanto para el almacenamiento de archivos como para el almacenamiento en bloques.
  • Almacenamiento de archivos: ibm-spectrum-scale-sc
  • Almacenamiento en bloque: ibm-spectrum-scale-sc *
Portworx Al instalar el servicio, la --storage_vendor=portworx opción garantiza que el servicio utilice las clases de almacenamiento correctas.
  • Almacenamiento de archivos: portworx-rwx-gp3-sc

    (Equivalente a portworx-shared-gp3 en instalaciones antiguas)

  • Almacenamiento en bloque:
    • portworx-couchdb-sc *
    • portworx-elastic-sc *
    • portworx-gp3-sc *
NFS Cuando instale el servicio, especifique la misma clase de almacenamiento tanto para el almacenamiento de archivos como para el almacenamiento en bloques.
  • Almacenamiento de archivos: managed-nfs-storage
  • Almacenamiento en bloque: managed-nfs-storage *
Almacenamiento de Amazon Elastic Al instalar el servicio, especifique el almacenamiento de archivos y el almacenamiento en bloques.

El almacenamiento de archivos lo proporciona Amazon Elastic File System. El almacenamiento en bloque es proporcionado por Amazon Elastic Block Store.
  • Almacenamiento de archivos: efs-nfs-client
  • Almacenamiento en bloque:

    Cualquiera de las siguientes clases de almacenamiento:

    • gp2-csi *
    • gp3-csi *
NetApp Trident Cuando instale el servicio, especifique la misma clase de almacenamiento tanto para el almacenamiento de archivos como para el almacenamiento en bloques.
  • Almacenamiento de archivos: ontap-nas
  • Almacenamiento en bloque: ontap-nas *
Nutanix Al instalar el servicio, especifique el almacenamiento de archivos y el almacenamiento en bloques.
  • Almacenamiento de archivos: nutanix-file
  • Almacenamiento en bloque: nutanix-volume

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 Cognos Dashboards.
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 se ejecutará la instalación está configurada como una estación de trabajo cliente y tiene las siguientes interfaces de línea de comandos:
  • IBM Software Hub Línea de comandos: cpd-cli
  • OpenShift Línea de comandos: oc
  • Helm Línea de comandos: helm
Dónde encontrar más información
Si esta tarea no se ha completado, consulte Configuración de una estación de trabajo cliente.
Panel de control
Esta tarea asume que IBM Software Hubcontrol plane está instalado.
Dónde encontrar más información
Si esta tarea no se ha completado, consulte Instalació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 Cognos Dashboards 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.
Equilibrador de carga
La configuración del tiempo de espera del equilibrador de carga se ajusta para Cognos Dashboards.
Dónde encontrar más información
Si esta tarea no se ha completado, consulte Cambiar la configuración del equilibrador de carga.
Recursos con ámbito de clúster
Esta tarea asume que existen recursos con ámbito de clúster, como definiciones de recursos personalizados, roles de clúster y enlaces de roles de clúster.
Dónde encontrar más información
Si esta tarea no está completa, consulte Creación de recursos con ámbito de clúster para la IBMSoftware Hub 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

Complete las siguientes tareas para instalar Cognos Dashboards :

  1. Instalación del servicio
  2. Validación de la instalación
  3. Qué hacer a continuación

Instalación del servicio

Para instalar Cognos Dashboards :

  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. Instale el operador y el recurso personalizado para Cognos Dashboards.

    El comando que ejecute dependerá del almacenamiento de su clúster.

    Red Hat OpenShift Almacenamiento de la base de datos 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Almacenamiento Fusion Data Foundation 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Almacenamiento de la plataforma de datos global Fusion
    Recuerda: cuando utilizas IBM Fusion Global Data Platform storage, tanto ${STG_CLASS_BLOCK} como ${STG_CLASS_FILE} apuntan a la misma clase de almacenamiento, normalmente ibm-spectrum-scale-sc o ibm-storage-fusion-cp-sc.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Storage Escala contenedor Almacenamiento nativo
    Recuerda: cuando utilizas IBM Storage Scale Container Native storage, tanto ${STG_CLASS_BLOCK} como ${STG_CLASS_FILE} apuntan a la misma clase de almacenamiento, normalmente ibm-spectrum-scale-sc.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    Almacenamiento de Portworx 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    Almacenamiento NFS
    Recuerda: cuando utilizas NFS storage, tanto ${STG_CLASS_BLOCK} como ${STG_CLASS_FILE} apuntan a la misma clase de almacenamiento, normalmente managed-nfs-storage.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWS solo con EFS almacenamiento
    Recuerda: cuando utilizas EFS storage, tanto ${STG_CLASS_BLOCK} como ${STG_CLASS_FILE} apuntan a la misma clase de almacenamiento, normalmente efs-nfs-client.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    AWS con EFS y EBS almacenamiento 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NetApp Trident
    Recuerda: cuando utilizas NetApp Trident storage, tanto ${STG_CLASS_BLOCK} como ${STG_CLASS_FILE} apuntan a la misma clase de almacenamiento, normalmente ontap-nas.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=dashboard \
--release=${VERSION} \
--patch_id=${PATCH_ID} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}

Validación de la instalación

Cognos Dashboards se instala cuando el install-components comando devuelve:
[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=dashboard

Qué hacer a continuación

  1. Complete la configuración posterior a la instalación.

Una vez completados los pasos anteriores, ya Cognos Dashboards está listo para usar.