Migrar activos a inventarios con la migration-tool utilidad

Puede migrar activos de catálogos a inventarios.

Si ya utiliza inventarios para gestionar sus casos de uso, no es necesario que realice ninguna acción.

Hechos rápidos

Servicios o planes de servicio requeridos
IBM watsonx.governance
IBM Knowledge Catalog
Permisos necesarios
Función de administrador en el clúster
Otros requisitos
La herramienta es compatible con las Linux plataformas ( arm64 y amd64 ) y Mac (chip Intel y chip Apple).
Restricciones
Tenga en cuenta las siguientes restricciones:
  • Asigne un único usuario administrador para realizar la migración de la cuenta.
  • Mientras se realiza la migración, no realice ninguna otra operación en la cuenta
  • No modifique ni elimine el state.db archivo.

Descripción general de la funcionalidad

Utilice esta herramienta para migrar casos de uso y modelos externos de todos los catálogos a los inventarios.

watsonx.governance Ahora las tiendas almacenan casos de uso y modelos externos en inventarios. Anteriormente, estos activos se creaban en catálogos. Si tienes activos en catálogos, utiliza la herramienta de migración para trasladarlos a los inventarios.

La herramienta migra los siguientes activos:

  • Casos de uso y modelos externos en el catálogo de activos de la plataforma. La herramienta migra estos activos al inventario predeterminado.
  • Casos de uso y modelos externos en otros catálogos. La herramienta crea un inventario para cada catálogo y migra los activos a los nuevos inventarios. La herramienta utiliza la siguiente convención de nomenclatura para los nuevos inventarios: <catalog_name>_inv.

Uso de la herramienta

La herramienta de migración es una utilidad de línea de comandos.

Asegúrate de que solo un usuario ejecute la herramienta para tu cuenta.

La herramienta de migración modifica los metadatos de los inventarios y activos con su ID de usuario y la marca de tiempo de cuando ejecutó la herramienta. Los campos de metadatos afectados son: creado por, última actualización por, last_access_id, creado en, last_access_time:

Preparación para ejecutar la herramienta de migración

  1. Descargar la herramienta.
    1. Descargar el archivo de licencia: Paquete de archivos de licencia
    2. Descargue el paquete de herramientas utilizando uno de los siguientes enlaces:
  2. Descomprima el migration-tool archivo.
  3. Asegúrate de tener acceso de lectura y escritura a los migration-tool archivos.
  4. Proporcione al sistema acceso a la aplicación.
  5. Ejecute el mandato siguiente: export ENVIRONMENT_NAME=icp4data
  6. Ejecute la ruta del archivo de la herramienta de migración. Por ejemplo:
    /Users/<username>/Downloads/<migration-tool-filename>
Nota: Si ha descargado la herramienta de migración desde un sitio externo, es posible que su sistema la bloquee. Ve a Ajustes del sistema y permite aplicaciones de fuentes externas.

Antes de empezar

  • El proceso de migración lleva algún tiempo. Asegúrate de que tu conexión a Internet sea estable durante todo el proceso.
  • Si tiene activos de la consola de gobernanza que migrar, asegúrese de que la integración de la consola de gobernanza ( OpenPages ) esté habilitada. De lo contrario, puede causar problemas.
  • Si tiene activos de modelos externos que migrar, asegúrese de que el seguimiento de modelos externos esté habilitado. De lo contrario, puede causar problemas.

Ejecutar la herramienta

Tienes tres opciones para migrar activos:

  • Migrar todos los activos de los catálogos a los inventarios mediante un único comando.
  • Migrar todos los activos de los catálogos, pero realizar la migración por etapas ejecutando varios comandos.
  • Migrar activos específicos.

Migrar todos los activos de los catálogos a los inventarios

Cuando ejecutas el comando, la herramienta de migración realiza todo el flujo de trabajo, que consta de las siguientes etapas:

  1. precheck

    La herramienta comprueba si se cumplen todas las condiciones necesarias para proceder con la migración de forma segura. Si alguna condición obligatoria no se cumple, el proceso se detiene aquí. Las condiciones obligatorias son:

    • El usuario debe disponer del watsonx servicio de gobernanza
    • El usuario debe tener el acceso adecuado para crear los activos
    • El clúster debe tener las configuraciones necesarias, como la integración de la consola de gobernanza habilitada para los activos de la consola de gobernanza y la gobernanza de modelos externos habilitada para los activos de modelos externos.

  2. Rellenar

    Una vez superadas las validaciones de Precheck, la herramienta recopila todos los activos relevantes de los catálogos, incluido el catálogo de activos de la plataforma, y los almacena en una tabla de base de datos local. Este proceso prepara los datos necesarios para la migración real.

  3. Crear

    Una vez completadas las etapas de Precheck y Populate, la herramienta le pregunta si desea continuar con la migración.

    • Introduzca y para continuar con la migración. La herramienta inicia la migración propiamente dicha. Este proceso incluye la creación de todos los activos.
    • Introduzca n para detener la migración. La herramienta detiene el proceso inmediatamente y elimina automáticamente la tabla de estado.
    Nota: Los activos del catálogo de activos de la plataforma se migran al inventario predeterminado.

  4. Descargar informe

    Cuando finaliza la etapa Crear, la herramienta le pregunta si desea descargar un informe. Escriba y o n.

Utilice el siguiente comando para migrar todos los casos de uso y modelos externos que se encuentran en los catálogos.

<migration-tool-file-path> --server <server_url> --account <account_id> -u <username> -p <password>

Migración por etapas

Con esta opción, la migración se ejecuta por etapas.

  1. Ejecute la herramienta en dry-run modo. En dry-run el modo, la herramienta solo ejecuta las etapas de comprobación previa y rellenado.
<migration-tool-file-path> --server <server_url> --account <account_id> -u <username> -p <password> --dry-run
  1. Ejecute el comando Crear. Una vez completado correctamente el comando de prueba, ejecute el siguiente comando para crear los activos. Este comando inicia el proceso de migración.
<migration-tool-file-path> create --server <server_url> --account <account_id> -u <username> -p <password>
  1. Descargar el informe. Ejecute el siguiente comando para descargar el informe de migración.
<migration-tool-file-path> report --server <server_url> --account <account_id> -u <username> -p <password>

Migración de activos específicos

Puede seleccionar los activos que desea migrar de los catálogos, casos de uso y modelos externos.

  1. Ejecute el comando en modo simulación**. En dry-run este modo, la herramienta solo ejecuta las etapas de verificación previa y rellenado.
<migration-tool-file-path> --server <server_url> --account <account_id> -u <username> -p <password> --dry-run

  1. Especifique los activos que se van a migrar o no se van a migrar.

    El siguiente código muestra la sintaxis:

<migration-tool-file-path> update --server <server_url> --account <account_id> -u <username> -p <password> --values=<asset_ids> --id-type=<catalog/usecase/modelstub> --include=<true/false>

La --values bandera utiliza los siguientes parámetros: --id-type=catalog
Utilice este parámetro para migrar los activos del catálogo.
--id-type=usecase Utilice este parámetro para migrar los activos de los casos de uso.
--id-type=modelstub Utilice este parámetro para migrar los activos del modelo externo.
--include=true Utilice este parámetro para migrar solo los ID que especifique. Esta opción conserva los activos que usted especifique y elimina todos los demás activos de la base de datos.

  • --include=false Utilice este parámetro para migrar todos los activos excepto los que especifique. Esta opción elimina los activos que especifiques de la base de datos y conserva todos los demás.

Asegúrate de seleccionar los activos desde el nivel del contenedor.

Importante: Migra todos los activos dependientes a la vez, de lo contrario la migración tendrá problemas. Por ejemplo: si se selecciona un modelo externo o un caso de uso, pero no los catálogos donde se encuentran esos activos, la migración encuentra problemas.

Ejemplo: Migración de un caso de uso

Por ejemplo, si desea migrar solo un caso de uso, primero seleccione el catálogo en el que se creó el caso de uso y, a continuación, seleccione el caso de uso. Ejecute el siguiente comando para seleccionar el catálogo y el caso de uso.

<migration-tool-file-path> update --server <server_url> --account <account_id> -u <username> -p <password> --values=<catalog_id> --id-type=catalog --include=true
<migration-tool-file-path> update --server <server_url> --account <account_id> -u <username> -p <password> --values=<usecase_id> --id-type=usecase --include=true

Ejemplo: Migración de un modelo externo

Por ejemplo, para migrar un modelo externo, seleccione el catálogo en el que se creó el modelo externo, luego seleccione el caso de uso y, a continuación, seleccione el modelo externo.

<migration-tool-file-path> update --server <server_url> --account <account_id> -u <username> -p <password> --values=<catalog_id> --id-type=catalog --include=true
<migration-tool-file-path> update --server <server_url> --account <account_id> -u <username> -p <password> --values=<usecase_id> --id-type=usecase --include=true
<migration-tool-file-path> update --server <server_url> --account <account_id> -u <username> -p <password> --values=<model_id> --id-type=modelstub --include=true
  1. Ejecutando el comando Crear. Una vez completado correctamente el comando de prueba, ejecute el siguiente comando para crear los activos. Este comando inicia el proceso de migración.
<migration-tool-file-path> create --server <server_url> --account <account_id> -u <username> -p <password>
  1. Descargar el informe. Ejecute el siguiente comando para descargar el informe de migración.
<migration-tool-file-path> report --server <server_url> --account <account_id> -u <username> -p <password>

Notas adicionales

  • La etiqueta Migrated_Usecase se añade a los casos de uso migrados.
  • La etiqueta Migrated-Stub se añade a los modelos externos migrados, junto con la etiqueta del nombre de la fase.
  • La etiqueta «obsoleta» se añade a los modelos externos y a los casos de uso en los catálogos.
  • Después de la migración, los casos de uso que se encuentran en los catálogos no se muestran en la página de casos de uso de IA. Del mismo modo, los modelos externos que se encuentran en los catálogos no se muestran en la página Modelos externos. Sin embargo, si tienes una IBM Knowledge Catalog instancia, aún puedes verlos en los catálogos.
  • Se admite la reejecución de la herramienta. Puede ejecutar la herramienta varias veces. La herramienta continúa donde lo dejaste.
  • Una vez completada la migración, modifique las configuraciones de la consola de seguimiento y gobernanza de modelos externos para utilizar inventarios.

Referencia de mandatos

La herramienta admite los siguientes comandos:

create

Este comando crea los activos que se van a migrar.

update

Este comando se utiliza para seleccionar los activos que se van a migrar. Al utilizar update, los siguientes indicadores son obligatorios:

  • --id-type bandera: --id-type=catalog/usecase/modelstub)
  • --include flag: --include=true/false) La --include=true opción mantiene solo los ID de activos especificados, mientras que --include=false excluye solo los ID especificados.
reset

Este comando revierte los activos migrados a su estado anterior. Restaura los activos a las versiones originales que existían antes de la migración.

El siguiente código muestra la sintaxis:

<migration-tool-file-path> reset --server <server_url> --account <account_id> -u <username> -p <password>

Comando de reejecución

Puede volver a ejecutar la herramienta si se detiene inesperadamente. Cuando lo vuelves a ejecutar, la herramienta se reanuda automáticamente desde donde se detuvo. Sin embargo, en algunos casos es posible que aparezcan errores al final del proceso. Aunque veas estos errores, comprueba los resultados en la interfaz de usuario. En la mayoría de los casos, los activos se migran correctamente.

Para volver a ejecutar la herramienta, utilice el siguiente comando:

   <migration-tool-file-path> --server <server_url> --account <account_id> -u <username> -p <password> --skip-precheck

Si sigue teniendo problemas, consulte la sección Solución de problemas para conocer los pasos a seguir.

Comando de reinicio

Puede revertir todos los activos migrados a su estado original utilizando el comando Restablecer.

Cuando el restablecimiento se completa correctamente, la herramienta elimina automáticamente la tabla de la base de datos de estado.

Sin embargo, en algunos casos, el restablecimiento puede mostrar un error hacia el final. Por ejemplo, es posible que aparezca el mensaje «El restablecimiento no se ha completado correctamente». Si ve este error, compruebe los resultados en la interfaz de usuario. En la mayoría de los casos, los activos se revierten correctamente.

Cuando un restablecimiento finaliza con un error, la herramienta no elimina la tabla de la base de datos de estado y, en su lugar, le solicita confirmación.

  • Si tiene previsto volver a ejecutar el comando Reset, no elimine la tabla de la base de datos de estado.
  • Si ha finalizado el restablecimiento y la interfaz de usuario se ve correctamente, puede eliminar la tabla de la base de datos de estado.

Si sigue teniendo problemas, consulte la sección Solución de problemas para conocer los pasos a seguir.

Parámetros

Parámetros de la herramienta Migrationi
Parámetro Descripción
-a --account ID de cuenta BSS (por defecto 999). Obligatorio.
-v --disableSSLVerification Desactivar la verificación de SSL.
-d --dry-run Ejecuta la migración sin crear recursos.
-h --help Ver ayuda.
-p --password Contraseña de usuario.
-s --server Servidor URL. Obligatorio.
-x --skip-precheck Omitir la verificación previa.
-u --username Nombre de usuario.

Estado de migración

El estado de la migración se establece en uno de los siguientes valores:

  • Si la migración se completó correctamente, el estado se establece en completed.
  • Si la migración está en curso, el estado se establece en in_progress.
  • Si la migración ha fallado con un error, el estado se establece en error.

Si el estado de la migración es error pero el error no es motivo de preocupación, puede cambiar el estado a completed utilizando el siguiente comando CURL.

curl --request PATCH \
  --url 'https://<server_url>/v1/aigov/factsheet/migration_status?status=completed' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

status could be set to "", "in_progress", "error", "completed"

Resolución de problemas

Errores con la migración

Problema : La herramienta genera errores inesperados al final.

Solución

  • Vuelva a ejecutar la herramienta y compruebe la interfaz de usuario para verificar si la migración se ha completado correctamente.
  • Si la repetición no funciona correctamente, intente restablecer el sistema y vuelva a ejecutar la herramienta.
  • Si solo algunos activos no han podido migrarse o si tiene problemas para realizar un seguimiento de los errores, añadir datos personalizados o añadir archivos adjuntos, migre los activos manualmente.

Errores con el comando de reinicio

Problema : La herramienta muestra un error después de ejecutar un restablecimiento.

Solución :

  1. Verifique el activo en la interfaz de usuario. A pesar del error, es posible que el restablecimiento de los activos se haya completado. Verifique los activos en la interfaz de usuario antes de continuar con el siguiente paso de resolución de problemas.
  2. Si observa problemas en la interfaz de usuario, no elimine la tabla de estado. Vuelve a ejecutar el comando de restablecimiento.
  3. Si los problemas persisten, siga estos pasos:
    1. Elimine manualmente el activo concreto del inventario.
    2. Elimine la etiqueta «obsoleto» del activo original que se encuentra en el catálogo.
    3. Elimine la tabla de estados.

Errores al volver a ejecutar la herramienta

En la mayoría de los casos, volver a ejecutar la herramienta resuelve los problemas, pero es posible que al final aparezcan problemas que son previsibles en algunos escenarios.

  • Verifique la interfaz de usuario. Comprueba si el activo se ha migrado correctamente.
  • Si sigue viendo los problemas en varios activos, realice un restablecimiento y vuelva a ejecutar la migración.
  • Si solo algunos activos no han podido migrarse o si tiene problemas para realizar un seguimiento de los errores, añadir datos personalizados o añadir archivos adjuntos, migre los activos manualmente.

Falta un activo modelo en una fase

Problema : Antes de la migración, se realiza un seguimiento del modelo hasta el caso de uso y es visible en las tres fases. Pero después de la migración, el modelo no aparece en una fase de la página Hoja informativa o Ciclo de vida del caso de uso.

Solución : Vaya al inventario migrado, vea la ficha técnica del modelo y, a continuación, haga clic en «Volver a rastrear ».