Pasos de migración

Planifique la migración, instale un nuevo despliegue de la versión 10 y transfiera los datos de la versión 5 a la 10.

Acerca de esta tarea

En el nivel superior, los pasos de la migración son los siguientes:

  • Planifique la migración.
  • Instale y configure un sistema de la versión 10 que se adapte mejor a sus necesidades actuales e integre los datos de la versión 5.
  • Realice una copia de seguridad de los datos de la versión 5 y migre los datos al nuevo despliegue de la versión 10.

Procedimiento

Lleve a cabo los siguientes pasos:

  1. Planifique la migración:
    • Consulte el apartado Visión general de la migración.
    • Asegúrese de que dispone de versiones del software admitidas. Consulte el apartado Versiones soportadas.
    • Revise el runbook de migración. En este documento, se ofrece una visión general de las consideraciones de planificación y el flujo global de migración. Consulte el apartado Obtención del runbook de migración.
    • Planifique el nuevo despliegue de la versión 10. Al pasar de v5 a v10, aproveche la oportunidad para revisar la topología, los registros de usuarios, las organizaciones de proveedores, etc. Puede que le interese ver los datos existentes en el sistema v5 y hacer una limpieza antes de ejecutar el extracto. Esto ayudará a garantizar que solo se migren los objetos obligatorios en v10.
    • Si está migrando a DataPower API Gateway, migre un despliegue de prueba de concepto antes de migrar la copia de seguridad completa de la versión 5. Migre entre 10 y 20 de las API de la versión 5 que más utilice y pruébelas para determinar qué valores de la utilidad de migración podría necesitar para convertir las API a DataPower API Gateway.
  2. Instale y configure un sistema v10.

    Instale y despliegue v10 teniendo presente el uso de los datos entrantes v5. Antes de enviar (push) los datos v5 a v10, el sistema v10 debe estar activo y en ejecución, con los servicios de pasarela, organizaciones de proveedores, registros de usuarios, etc. listos para recibir los datos.

    Importante:

    Verifique que ha completado los pasos siguientes como parte del despliegue del entorno v10:

    • Asegúrese de crear el mismo número de gestores de API que en el despliegue de v5.
    • Use Cloud Manager para configurar la topología. Consulte Definición de la topología.
    • Si la topología v10 utiliza nombres y cantidades de servicios de pasarela idénticos a los de v5, la utilidad de migración correlacionará automáticamente la información de configuración. Si la configuración v10 usa distintos nombres o un número distinto de ellos, habrá que correlacionar manualmente los servicios de pasarela v5 con los servicios de pasarela v10. En un paso posterior se le guiará en la correlación de los servicios de pasarela. Puede revisar los requisitos de correlación consultando Correlación de un servicio de pasarela.
    • Revisar tipos y configuraciones de pasarela:

      API Connect v10 soporta dos tipos de servicio de pasarela: DataPower Gateway (compatible con v5) y DataPower API Gateway. El tipo DataPower API Gateway no está soportado en API Connect v5. Cuando se registra el servicio de pasarela en el sistema v10, hay que seleccionar el tipo de servicio de pasarela. Si se selecciona la pasarela de API (API Gateway), el proceso de migración tendrá que incluir un paso de conversión (portado) de las definiciones de API v5 del formato de DataPower Gateway (compatible con v5) al formato de DataPower API Gateway. La utilidad de migración proporciona una opción para realizar la portabilidad. En un paso posterior se facilitan instrucciones de línea de comandos.

      Para revisar los tipos de pasarela y la configuración, consulte Tipos de pasarela de API Connect y Registro de un servicio de pasarela.

    • Cree las organizaciones de proveedores. Si la configuración v10 de las organizaciones de proveedores utiliza diferentes nombres o una cantidad diferente, habrá que correlacionar manualmente las organizaciones de proveedores v5 con las organizaciones de proveedores v10. En un paso posterior se le guiará para correlacionar las organizaciones de proveedores. Puede revisar los requisitos de correlación consultando Correlación de una organización de proveedores.
    • Cuando migre los espacios de catálogo de una organización de proveedores que utilice un registro de usuarios local (LUR), asegúrese de que el LUR esté configurado con el valor de visibilidad de Público o Personalizado. Si se establece en Personalizado, asegúrese de que se selecciona la organización de proveedores. Puede obtener información sobre la configuración de la visibilidad consultando Configuración de la visibilidad de un registro de usuarios.
    • Configure registros de usuarios como LDAP según sea necesario para que coincidan con los registros de usuarios utilizados con los usuarios de v5.
    • El proceso de migración incluye la migración de los usuarios. La configuración de los usuarios en API Connect incluye el envío de un correo electrónico a los usuarios para que configuren sus cuentas. La forma recomendada de hacerlo durante una migración automatizada es configurar un servidor SMTP temporal. Una opción de código abierto de SMTP es MailHog. Consulte el https://github.com/mailhog/MailHog. Cuando haya completado el proceso de migración, asegúrese de sustituir el servidor SMTP temporal por el servidor SMTP permanente para el despliegue de API Connect v10.
    • Cree los servicios de portal que desee usar con los catálogos que tenga previsto migrar. Los catálogos se configurarán en los Portales una vez enviados los datos de migración al sistema v10.
  3. Realice una copia de seguridad de los datos de la versión 5 y migre los datos al nuevo despliegue de la versión 10.
    1. Descargue el programa de utilidad de migración. Consulte el apartado Obtención de la utilidad de migración de API Connect.
    2. Determine si el sistema v5 contiene catálogos que utilicen un registro de usuarios delegado de portal (PDUR).

      El uso del PDUR era opcional en la versión 5. La migración de sistemas que utilizan un PDUR es muy parecida a la migración de sistemas que no lo utilizan, pero incluye algunos pasos adicionales. Si no está seguro de si un catálogo v5 usa un PDUR, compruebe los parámetros de registro de v5. Consulte Selección del registro de usuarios delegados de portal.

    3. Continúe con las instrucciones que se apliquen a su despliegue: