Instalación de « watsonx.data intelligence »
Un administrador de instancias puede instalar « watsonx.data intelligence » en IBM Software Hub la versión « 5.3 ».
- ¿Quién debe realizar esta tarea?
Administrador de la instancia: Para instalar watsonx.data intelligence, debe ser administrador de la instancia. Un administrador de instancia tiene permiso para instalar software en los siguientes proyectos:
- El proyecto de los operadores, por ejemplo
Los operadores para esta instancia de watsonx.data intelligence 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 control plane y watsonx.data intelligence se instalan en el proyecto operands.
En los comandos de instalación, la variable
${PROJECT_CPD_INST_OPERANDS}de entorno hace referencia al proyecto «operands».
- ¿Cuándo tienes que terminar esta tarea?
Revisa las siguientes opciones para determinar si debes realizar esta tarea:
- Si desea instalar varios servicios a la vez, siga los pasos que se indican en «Realización de una instalación por lotes de soluciones y servicios ».
- Si no ha instalado watsonx.data intelligence como parte de una instalación por lotes, realice esta tarea para añadir watsonx.data intelligence a su entorno.
Repita este proceso tantas veces como sea necesario. Si se encarga de varias instancias de IBM Software Hub, puede repetir esta tarea para instalar más instancias de watsonx.data intelligence en el clúster.
Información que necesita para completar esta tarea
Revisa la siguiente información antes de instalar « watsonx.data intelligence »:
- 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, debes instalar watsonx.data intelligence en la versión 5.3.1.
- Variables de entorno
Los comandos de esta tarea utilizan variables de entorno, por lo que puedes ejecutarlos tal y como están escritos.
- Si no dispone del script que define las variables de entorno, consulte la sección «Configuración de las variables de entorno de instalación ».
- Para utilizar las variables de entorno desde el script, debes cargar 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
watsonx.data intelligence funciona con la restricción de contexto de seguridad Red Hat® OpenShift® Container Platform predeterminada,
restricted-v2.
- Common core services
watsonx.data intelligence requiere el IBM Software Hub common core services.
Si los no common core services están instalados en el proyecto de operandos de la instancia, se common core services instalarán automáticamente al instalar watsonx.data intelligence. La common core services instalación alarga el tiempo que tarda en completarse.
- Requisitos de almacenamiento
- Debe especificar las clases de almacenamiento al instalar watsonx.data intelligence. 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.
Antes de empezar
Esta tarea da por supuesto que se cumplen los siguientes requisitos previos:
- Requisitos del sistema
- Esta tarea da por supuesto que el clúster cumple los requisitos mínimos para watsonx.data intelligence.
Dónde encontrar más información Si esta tarea no se ha completado, consulta los requisitos del sistema. Además, si tiene previsto utilizar funciones que requieran una GPU, asegúrese de disponer del tipo y el número adecuados de GPU para watsonx.data intelligence.Dónde encontrar más información Si esta tarea no se ha completado, consulta los requisitos de la GPU. - Estación de trabajo
- Esta tarea da por supuesto que la estación de trabajo desde la que se va a ejecutar la instalación está configurada como estación de trabajo cliente y dispone de 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:
helm
Dónde encontrar más información Si esta tarea no se ha completado, consulte la sección «Configuración de una estación de trabajo de cliente ». - IBM Software
Hub Interfaz de línea de comandos:
- Panel de control
- Esta tarea da por hecho que IBM Software
Hubcontrol plane está instalado.
Dónde encontrar más información Si aún no ha completado esta tarea, consulte «Instalación de una instancia de IBM » en Software Hub. - Registro de contenedor privado
- Si su entorno utiliza un registro de contenedores privado (por ejemplo, si su clúster está aislado físicamente), esta tarea da por hecho que las siguientes tareas ya se han completado:
- Las imágenes del software de watsonx.data intelligence se replican en el registro privado de contenedores.
Dónde encontrar más información Si esta tarea no se ha completado, consulta la sección «Duplicación de imágenes en un registro de contenedores privado ». - El
cpd-cliestá configurado para descargar laolm-utils-v4imagen del registro privado de contenedores.Dónde encontrar más información Si aún no has completado esta tarea, consulta la sección «Descarga de la imagen « olm-utils-v4 » del registro de contenedores privado ».
- Las imágenes del software de watsonx.data intelligence se replican en el registro privado de contenedores.
- Equilibrador de carga
- Los parámetros de tiempo de espera del equilibrador de carga se han ajustado para watsonx.data intelligence.
Dónde encontrar más información Si esta tarea no se ha completado, consulte «Cambiar la configuración del equilibrador de carga ». - Operadores de GPU
- Si tiene previsto utilizar funciones que requieren GPU, esta tarea da por hecho que los operadores necesarios para el uso de las GPU están instalados.
Dónde encontrar más información Si esta tarea no se ha completado, consulta la sección «Instalación de operadores para servicios que requieren GPU ». - Red Hat OpenShift AI
- Esta tarea da por hecho que Red Hat
OpenShift AI está instalado.
Dónde encontrar más información Si esta tarea no se ha completado, consulta la sección «Instalación de una IA de Red Hat OpenShift ». - Recursos con ámbito de clúster
- Esta tarea da por hecho que existen los recursos del ámbito del clúster, como las definiciones de recursos personalizados, las funciones del clúster y las asignaciones de funciones del clúster.
Dónde encontrar más información Si esta tarea no se ha completado, consulte «Creación de recursos con ámbito de clúster para la plataforma y los servicios de IBM Software Hub ». - Secretos de extracción de imágenes
- Esta tarea da por hecho que ya existen los secretos que contienen las credenciales para descargar la imagen de la instancia.
Dónde encontrar más información Si esta tarea no se ha completado, consulta «Creación de claves secretas para la descarga de imágenes» en una instancia de IBM Software Hub.
Procedimiento
Realice las siguientes tareas para instalar watsonx.data intelligence :
Especificar las opciones de instalación
Si tiene previsto instalar
watsonx.data™ intelligence, puede especificar las opciones de instalación en un archivo llamado install-options.yml en el cpd-cli
work directorio (por ejemplo: cpd-cli-workspace/olm-utils-workspace/work).
Los parámetros son opcionales. Si no se configuran estos parámetros de instalación, se utilizarán los valores predeterminados.
Siga las instrucciones correspondientes a la versión que IBM Software Hub haya instalado:
- Versión 5.3.1
El contenido de ejemplo en YAML utiliza los valores predeterminados.
5.3.1 y más adelante: El formato solo se aplica a IBM Software Hub la versión 5.3.1.
Mantenga la
---sintaxis al principio de la entrada para garantizar que esta se trate como un documento independiente.--- # ............................................................................ # watsonx.data intelligence parameters # ............................................................................ non_olm: watsonxDataintelligence: enableAISearch: false enableDataGovernanceCatalog: true enableKnowledgeGraph: true enableDataQuality: false enableDataLineage: true enableDataProduct: true enableGenerativeAICapabilities: true enableSemanticEnrichment: true enableSemanticEmbedding: false enableTextToSql: false enableModelsOn: cpu customModelTextToSQL: granite-3-3-8b-instruct- Versión 5.3.0
El contenido de ejemplo en YAML utiliza los valores predeterminados.
Si desea anular uno o varios de los valores predeterminados, añada los parámetros a la
non_olm:sección delinstall-options.ymlarchivo, dentro de lawatsonxDataintelligence:entrada.# ............................................................................ # watsonx.data intelligence parameters # ............................................................................ watsonxDataintelligence: enableAISearch: false enableDataGovernanceCatalog: true enableKnowledgeGraph: true enableDataQuality: false enableDataLineage: true enableDataProduct: true enableGenerativeAICapabilities: true enableSemanticEnrichment: true enableSemanticEmbedding: false enableTextToSql: false enableModelsOn: cpu customModelTextToSQL: granite-3-3-8b-instruct
| Propiedad | Descripción |
|---|---|
enableAISearch |
Especifique si desea habilitar la búsqueda semántica basada en modelos de lenguaje grande (LLM) para activos y artefactos en todos los espacios de trabajo.
|
enableDataGovernanceCatalog |
Especifique si desea habilitar las funciones de gobernanza de datos y de catálogo.
|
enableKnowledgeGraph |
Especifique si desea habilitar la función del gráfico de conocimiento. El gráfico de conocimiento ofrece las siguientes funciones:
|
enableDataQuality |
Especifique si desea habilitar las funciones de calidad de datos en los proyectos, de modo que pueda medir, supervisar y mantener la calidad de sus datos para garantizar que estos cumplan con sus expectativas y estándares para casos de uso específicos. Importante: Al habilitar la función de calidad de datos, DataStage Enterprise se instala automáticamente.
Si no ha adquirido una licencia DataStage independiente, el uso DataStage Enterprise se limita a la creación, gestión y ejecución de reglas de calidad de datos. Para ver ejemplos de usos permitidos, consulte «Activación de funciones adicionales tras la instalación o actualización de watsonx.data intelligence.»
|
enableDataLineage |
Especifique si desea habilitar las funciones de linaje de datos. El linaje de datos es el proceso de seguimiento de los datos a medida que se mueven y son utilizados por diferentes herramientas de software. El historial de cambios registra el origen de los datos, cómo se han transformado y a dónde se han trasladado.
|
enableDataProduct |
Especifique si desea habilitar las funciones de intercambio de datos. Al habilitar el intercambio de datos, los creadores de datos pueden agrupar los datos y los recursos relacionados en productos de datos, de modo que los usuarios tengan acceso a datos seguros y de alta calidad
|
enableGenerativeAICapabilities |
Especifica si deseas habilitar las funciones de IA generativa. Activa las funciones de IA generativa si tienes pensado utilizar las siguientes características:
|
|
Especifica si se debe habilitar la expansión de metadatos de la IA generativa. La ampliación de los metadatos incluye:
|
enableSemanticEmbedding |
Especifica si se debe habilitar la incrustación semántica. Debes habilitar la integración semántica si tienes pensado utilizar las siguientes funciones:
|
enableTextToSql |
Especifica si se deben generar consultas SQL a partir de entradas en lenguaje natural. Las funciones de conversión de texto a SQL pueden utilizarse para crear activos de datos basados en consultas, que pueden emplearse en productos de datos o en búsquedas.
|
enableModelsOn |
Especifica dónde quieres que se ejecuten los modelos que se utilizan con las funciones de IA generativa.
|
customModelTextToSql |
Especifica un modelo personalizado para las conversiones de texto a SQL.
|
Instalación del servicio
Para instalar « watsonx.data intelligence »:
- Inicia sesión
cpd-clien el Red Hat OpenShift Container Platform clúster:${CPDM_OC_LOGIN}Recuerda:CPDM_OC_LOGINes un alias delcpd-cli manage login-to-ocpcomando. - Instala el operador y el recurso personalizado para watsonx.data intelligence.
El comando que debas ejecutar depende del almacenamiento de tu clúster.
Red Hat OpenShift Almacenamiento de Data Foundation
Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
IBM Almacenamiento de Fusion Data Foundation
Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
IBM Almacenamiento de Fusion Global Data Platform
Recuerda: cuando utilizas IBM Fusion Global Data Platform almacenamiento, tanto${STG_CLASS_BLOCK}como${STG_CLASS_FILE}apuntan a la misma clase de almacenamiento, normalmenteibm-spectrum-scale-scoibm-storage-fusion-cp-sc.Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
IBM Storage Escalabilidad del 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, normalmenteibm-spectrum-scale-sc.Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
Almacenamiento de Portworx
Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
Almacenamiento NFS
Recuerda: cuando utilizas NFS storage, tanto${STG_CLASS_BLOCK}como${STG_CLASS_FILE}apuntan a la misma clase de almacenamiento, normalmentemanaged-nfs-storage.Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
AWS solo con almacenamiento en EFS
Recuerda: cuando utilizas el almacenamiento de tipo « EFS », tanto${STG_CLASS_BLOCK}como${STG_CLASS_FILE}apuntan a la misma clase de almacenamiento, normalmenteefs-nfs-client.Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
AWS con almacenamiento en EFS y EBS
Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
NetApp Trident
Recuerda: cuando utilizas NetApp Trident storage, tanto${STG_CLASS_BLOCK}como${STG_CLASS_FILE}apuntan a la misma clase de almacenamiento, normalmenteontap-nas.Ejecuta el comando adecuado para tu entorno:
- Instalación predeterminada (sin opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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}- Instalación personalizada (con opciones de instalación)
cpd-cli manage install-components \ --license_acceptance=true \ --components=watsonx_dataintelligence \ --release=${VERSION} \ --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} \ --param-file=/tmp/work/install-options.yml
Comprobación de la instalación
install-components comando devuelve:[SUCCESS]... The install-components command ran successfully
Si quieres comprobar que el estado del recurso personalizado es Completed, puedes ejecutar el cpd-cli
manage
get-cr-status comando:
cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=watsonx_dataintelligence
Qué hacer a continuación
Una vez completados los pasos anteriores, watsonx.data intelligence estará listo para su uso.