Migración de aplicaciones del servicio en la nube

Puede migrar aplicaciones y cubos entre instancias de servicios en la nube. Descubra cómo preparar la migración y consulte algunos de los casos de uso.

Se puede utilizar la herramienta de interfaz de línea de comandos (CLI) para migrar la aplicación y los artefactos de origen en los despliegues y versiones del servicio en la nube de Essbase. Esto se utiliza para migrar las aplicaciones de una en una.

Se puede utilizar la herramienta de utilidad de migración para migrar a la vez varias aplicaciones, artefactos y usuarios en los servicios en la nube de Essbase.

Preparación para migrar aplicaciones de servicio en la nube

Existen algunas consideraciones y requisitos al migrar una aplicación de servicio en la nube.

  • Si está migrando en versiones y despliegues en la nube de Essbase, de la versión 17.3.3 (o anterior), utilice los scripts para migrar a Essbase. Consulte Scripts para tareas de administración en Administración de Oracle Analytics Cloud - Classic. Esto también se aplica a la exportación e importación de roles de aplicación y scripts aprovisionados.

  • No está soportada la restauración de una aplicación o base de datos desde una copia de seguridad anterior, después de que dicha aplicación o base de datos se hayan vuelto a crear mediante importación de LCM.

  • Antes de utilizar cualquier herramienta de migración, las variables globales, los ajustes de configuración de correo electrónico y los ajustes del escáner de archivos se deben definir en la instancia de destino.

Los roles de usuario necesarios son los siguientes:

  • Para exportación: Gestor de aplicaciones para la aplicación creada. Además, los siguientes roles pueden utilizar la herramienta CLI y la utilidad LCM: administrador de servicio para todas las aplicaciones; usuario avanzado para todas las aplicaciones creadas por el usuario avanzado.
  • Para la importación: usuario avanzado o administrador de servicio, para crear nuevas aplicaciones durante la importación.

Artefactos del servicio en la nube migrados

En la siguiente tabla, se describen los artefactos de Essbase globales, de nivel de aplicación y de nivel de cubo que se pueden migrar entre instancias de servicio en la nube.

Artefacto Soportado para la migración de nube a nube Excepciones/Comentarios
Metadatos de aplicaciones y cubos sí Los metadatos de aplicaciones incluyen el tipo y la configuración de las aplicaciones. Los metadatos de cubos incluyen las propiedades y la configuración de los cubos.
Archivos de configuración de nivel de aplicación sí Se migran estos archivos (si los hubiera).
Scripts de cálculo sí Se migran los cálculos a nivel de cubo y a nivel de aplicación.
Servidor de catálogo no Se migran los archivos enumerados en Archivos, en la sección Aplicaciones/<nombre de aplicación> de la interfaz web. No se migran otros archivos almacenados bajo carpetas compartidas/usuario. Puede descargarlos y restaurarlos en la interfaz web manualmente.
Conexiones y orígenes de datos sí Gracias a la utilidad de migración, se migran las conexiones y los orígenes de datos de nivel de aplicación y de sistema.

Gracias a la herramienta CLI, se migran las conexiones y los orígenes de datos creados en el nivel de aplicación.

Con ambas herramientas, debe incluir el siguiente argumento en las operaciones lcmExport: -include-server-level (o la abreviatura -isl).
Datos sí Para poder migrar los datos, deben encontrarse en el directorio de cubo, en el servicio en la nube.
Volúmenes de disco NA Las definiciones de volumen de disco no se aplican a instancias en la nube de Essbase.
Definiciones de obtención de detalles sí Se migran las definiciones de obtención de detalles.
Libros de trabajo y archivos de Excel sí Se migran los libros de trabajo y archivos de Excel.
Filtros sí Se migran los filtros a nivel de cubo y los filtros creados por el usuario.
Variables globales sí Debe incluir el argumento -isl en los comandos lcmExport. Si usa la utilidad de migración, debe definir variables globales en la instancia de destino antes de realizar la migración.
Diseños sí Se migran los diseños a nivel de cubo.
Objetos de informes enlazados (LRO) sí Se incluyen aquí para que haya compatibilidad de fondos con las aplicaciones locales migradas.
Alias de ubicación sí Los alias de ubicación se migran junto con el cubo.
Archivos log no No se migran los archivos log.
Consultas con nombre sí Se migran las consultas con nombre a nivel de cubo.
Esquemas y fórmulas sí No se pueden migrar las fórmulas que contengan @XREF.
Particiones sí

Se migran las particiones replicadas y transparentes.

Solo se exportan al sistema de archivos las definiciones de las particiones del cubo de destino. Al migrar los cubos particionados, debe importar el cubo de origen antes que el cubo de destino. De lo contrario, puede que no se restauren las definiciones de las particiones.
Scripts de informe sí Se migran los scripts de informe a nivel de cubo y a nivel de aplicación. Se incluyen aquí para que haya compatibilidad de fondos con las aplicaciones locales migradas.
Archivos de reglas, de texto y en formato .csv sí Se migran los archivos a nivel de cubo y a nivel de aplicación.
Casos sí Si un cubo admite casos y tiene una dimensión de sandbox, los casos se migran.
Variables de sustitución sí Se migran las variables de sustitución a nivel de cubo y a nivel de aplicación. Si tiene variables de sustitución a nivel global (servidor), debe convertirlas en variables de nivel de aplicación antes de realizar la migración, o bien volver a crearlas en la consola posteriormente.
Usuarios y grupos - Se migran usuarios y grupos mediante la utilidad de migración, no mediante la herramienta CLI.
Roles de usuario sí Los roles de usuario solo se pueden migrar de una instancia en la nube de Essbase a otra.
Archivos de cartera sí Se migran los archivos de cartera específicos de la aplicación.

Migración de aplicaciones del servicio en la nube mediante la herramienta CLI

Se puede utilizar la herramienta de interfaz de línea de comandos (CLI) para migrar la aplicación y los elementos de origen en los despliegues y versiones del servicio en la nube de Essbase. Esto se utiliza para migrar las aplicaciones de una en una.

El flujo de trabajo estándar es el siguiente:
  1. Exportación de la aplicación: ejecute la herramienta CLI mediante el comando lcmExport para exportar una aplicación del servicio en la nube del archivo de origen a un archivo ZIP.
  2. Importación de la aplicación al destino: ejecute la herramienta CLI mediante el comando lcmImport para importar la aplicación del archivo ZIP al archivo de destino.

Cuando existen particiones en el origen entre una aplicación de origen o base de datos, y una aplicación o base de datos de destino, solo se exportan las particiones del destino al sistema de archivos. Cuando las particiones existen entre los cubos que se van a migrar, deberá importar el origen de datos antes que el destino de datos. De lo contrario, las definiciones de partición no se pueden restaurar.

Migración de aplicaciones del servicio en la nube mediante la utilidad de migración

Puede utilizar la utilidad de migración para migrar aplicaciones y elementos de origen en los despliegues y las versiones de servicio en la nube de Essbase. La utilidad migra varias aplicaciones, elementos y usuarios a la vez.

Como usuario administrador de servicio de Essbase, puede usar la utilidad de migración para migrar una instancia completa (todas las aplicaciones, usuarios y grupos, y otros artefactos) de una instancia en la nube a otra en un único proceso. Tenga en cuenta que la herramienta de línea de comandos (CLI), mediante la importación y exportación de LCM, requiere que migre todas las aplicaciones a la vez, pero no migra los usuarios.

Casos de uso
  • Se recomienda esta utilidad si migra usuarios a Oracle Identity Cloud Service (IDCS) en Oracle Cloud Infrastructure (OCI), desde LDAP embebido para Weblogic, o desde IDCS en OCI Essbase clásico.
  • Los usuarios de LDAP de Weblogic pueden migrar los usuarios de LDAP en el origen a IDCS en el destino.
  • Use esta utilidad para despliegues básicos sin personalizar. Utilice la herramienta CLI en lugar de la utilidad de migración si el despliegue incluye personalizaciones como: ejecución de scripts MAXL en el servidor, carga de datos o creación de dimensiones mediante controladores personalizados, o si las aplicaciones incluyen particiones definidas o soluciones de SSO personalizadas.
Migración de aplicaciones y usuarios de servicio en la nube mediante la utilidad de migración
  1. Antes de usar la utilidad, se recomienda ejecutar la actualización de parche más reciente de Essbase a la última versión, en caso de que aún no lo haya hecho.
  2. Si todavía no está instalado, descargue e instale Java SE Development Kit 8 desde Oracle Technology Network.
  3. Defina el nombre de variable de entorno JAVA_HOME en el sistema para que apunte a la carpeta de instalación de JDK. Si la ruta de instalación contiene algún espacio, incluya la ruta en el valor de variable entre comillas, como: "C:\Program Files\Java\jdk1.8.0_171".
  4. En Essbase, abra el separador Consola.
  5. En la Consola, acceda a Herramientas de escritorio y amplíe Herramientas de línea de comandos.
  6. Haga clic en Descargar, junto a la herramienta denominada Utilidad de migración.
  7. Descargue migrationTools.zip en una unidad local. Para obtener resultados óptimos, escoja una ruta sin espacios, como C:\Oracle.
  8. Extraiga migrationTools.zip y consulte los archivos extraídos (propiedades, jar y readme) en la carpeta migrationTools.
  9. Antes de ejecutar los comandos de importación y exportación, proporcionados con la utilidad de migración, debe editar los archivos de propiedades.
    1. Edite las cadenas de propiedades del archivo export.properties:
      • userName: nombre de usuario administrador de Essbase.
      • password: contraseña de administrador de Essbase.
      • host: host o dirección IP de Essbase.
      • port: puerto de Essbase. Introduzca "80" para el origen de LDAP. De lo contrario, acepte el valor por defecto de 443 (SSL/TLS) para el origen de IDCS.
    2. Edite las cadenas de propiedades del archivo import.properties:
      • userName: nombre de usuario administrador de Essbase.
      • password: contraseña de administrador de Essbase.
      • host: host o dirección IP de Essbase.
      • port: puerto de Essbase. Acepte el valor por defecto de 443 (SSL/TLS) para el destino de IDCS.
      • userPassword: contraseña inicial asignada para todos los usuarios importados nuevos o reemplazados.
    3. Si está importando a POD de IDCS, edite las siguientes propiedades en import.properties. Puede obtener valores de la consola de servicio de IDCS.
      • idcsHost: host de IDCS.
      • idcsTenant: inquilino de IDCS.
      • clientId: ID de cliente para autorización OAuth.
      • clientSecret: secreto de cliente para autorización OAuth.
      • appId: ID de aplicación.
  10. Para ejecutar la utilidad de migración, utilice el siguiente comando de java para exportar todas las aplicaciones, usuarios y grupos del catálogo de instancia de origen de Essbase mediante un archivo TAR. 
    java -jar migrationTools.jar export export.properties <new_tar_file>
  11. Tras exportar de la instancia de origen, utilice el siguiente comando de java para importar el archivo de datos TAR a la instancia de destino. 
    java -jar migrationTools.jar import import.properties <existing_tar_file>
  12. Después de ejecutar la importación, los datos se almacenan en el catálogo de Essbase de la instancia de destino. Si algunas de las aplicaciones exportadas ya existen en el destino, no se sobrescriben. Se sobrescriben todos los datos de usuario existentes.

Migrar de FCCS o PBCS

Se pueden migrar aplicaciones y bases de datos de Financial Consolidation and Close Cloud Service (FCCS) o de Planning and Budgeting Cloud Service (PBCS).

  1. Exporte desde Planning and Budgeting Cloud Service (PBCS) o Financial Consolidation and Close Cloud Service (FCCS) a través de la interfaz o la herramienta de línea de comandos de la utilidad EPM Automate mediante exportsnapshot. Consulte comandos de la utilidad EPM Automate en Trabajar con EPM Automate para Oracle Enterprise Performance Management Cloud.
  2. Ejecute la herramienta CLI para importar la aplicación de Essbase y los cubos del archivo .zip de PBCS mediante el comando CLI lcmimport.