Migración de aplicaciones mediante la utilidad de migración

Como administrador de servicio de Essbase, puede usar la utilidad de migración (migrationTools.jar) para migrar una instancia completa de Essbase (todas sus aplicaciones, usuarios y grupos, y otros artefactos) de una instancia de la nube a otra en un único proceso.

Puede utilizar la utilidad de migración para migrar desde aplicaciones de origen y elementos de despliegues de Essbase en OCI a través de Marketplace. La utilidad migra varias aplicaciones a la vez. También migra artefactos, reglas, usuarios y grupos.

Tenga en cuenta que los comandos de la interfaz de línea de comandos (CLI) de Essbase, lcmimport y lcmexport no migran usuarios y grupos.

Antes de utilizar la utilidad de migración, complete el siguiente requisito: Configurar el certificado SSL.

Casos de uso de la utilidad de migración

Estos son algunos casos de uso para migrar con la utilidad de migración.

Migre usuarios de Essbase de LDAP de WebLogic en el origen a OCI Identity and Access Management (IAM) u Oracle Identity Cloud Service (IDCS) en el destino.
Use la utilidad de migración para despliegues básicos sin personalizar. Si su despliegue incluye personalizaciones, como soluciones personalizadas de inicio de sesión único, use CLI en lugar de la utilidad de migración.
Cuando el despliegue de Essbase de origen es de
- Marketplace de Essbase en Oracle Cloud Infrastructure, mediante OCI Identity and Access Management (IAM) u Oracle Identity Cloud Service (IDCS), o
- Essbase Marketplace en Oracle Cloud Infrastructure, mediante LDAP embebido
a continuación, antes de utilizar los pasos de la utilidad Migración que se indican a continuación para exportar, cree primero una nueva aplicación confidencial como se describe en Creación de una aplicación de identidad confidencial. Además, antes de utilizar la utilidad de migración para importar, cambie los detalles del host y de IAM o IDCS en import.properties para que apunten a la instancia de Essbase de destino.

Pasos para migrar aplicaciones y usuarios en la nube mediante la utilidad de migración

Antes de utilizar la utilidad de migración, si aún no lo ha hecho, aplique un parche a la instancia de Essbase de origen a la última versión.
Si todavía no se ha instalado, descargue e instale Java SE Development Kit (JDK) 8 desde Oracle Technology Network.
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 espacios, incluya la ruta en el valor del variable entre comillas, por ejemplo, "C:\Program Files\Java\jdk1.8.0_171".
Inicie sesión en la interfaz web de Essbase de destino y navegue a la consola.
En la Consola, acceda a Herramientas de escritorio y amplíe Herramientas de línea de comandos.
Haga clic en Descargar junto a Utilidad de migración.
Descargue el archivo zip de la utilidad de migración en una unidad local. Para obtener resultados óptimos, escoja una ruta sin espacios, como C:\Oracle
Extraiga el archivo zip y consulte los archivos extraídos (propiedades, jar y readme) en la carpeta migrationTools.

Antes de ejecutar la exportación de la utilidad de migración, edite el archivo export.properties, que se encuentra en el mismo directorio que la utilidad. Proporcione los detalles de la instancia de origen de Essbase desde la que está migrando.

Exportar propiedad	Descripción
userName	Es obligatorio. Nombre del usuario administrador de Essbase.
contraseña	Es obligatorio. Contraseña de administrador de Essbase.
Host	Es obligatorio. Dirección IP del equilibrador de carga, si se ha configurado un equilibrador de carga durante el despliegue de Essbase. De lo contrario, el nombre de host o la dirección IP que se corresponde con la dirección IP pública de Essbase.
port	Opcional: Puerto de recepción HTTP de la instancia de Essbase de origen. Si la instancia de origen está configurada en modo seguro (TLS) y se asume el puerto `isTLS`=true 443. Si la instancia de origen está configurada con el proveedor de identidad LDAP, establezca el puerto como 80.
isTLS	Opcional: true o false. Si es true, la instancia de origen se configura en modo seguro (TLS) mediante el valor `port` especificado.
Proxy	Opcional: Dirección de host de proxy HTTP, si la conexión a la instancia de Essbase de origen requiere un proxy. El host y el puerto de proxy están separados por dos puntos. Si se omite el puerto proxy, se supone que su valor es 80. Ejemplo con el puerto omitido: `www-proxy-example.com`. Ejemplo con puerto incluido: `www-proxy-example.com:80`
omitir datos	Opcional: El valor por defecto es false. Establézcalo en true si solo se deben exportar los esquemas de la aplicación de Essbase.
omitir usuario	Opcional: true o false. Establézcalo en Verdadero solo si no es necesario exportar usuarios y/o grupos. El valor por defecto es false.
idcsHost	Solo es necesario al migrar usuarios y/o grupos de una instancia desplegada en OCI a través de Marketplace. Host del dominio de identidad del origen en IAM o IDCS. En la URL del dominio de identidad (ejemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraiga solo la parte del dominio después de la cadena. Ejemplo: `identity.oraclecloud.com`
idcsTenant	Solo es necesario para migrar usuarios o grupos de una instancia desplegada en OCI a través de Marketplace. Identificador del arrendamiento del dominio de identidad del host de origen en IAM o IDCS. En la URL del dominio de identidad (ejemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraiga solo `idcs-<string_of_numbers_and_letters>`.
ID de cliente	Solo es necesario para migrar usuarios o grupos de una instancia desplegada en OCI a través de Marketplace. Identificador de cliente del host de origen para la autorización de OAuth, que se encuentra en la aplicación de identidad confidencial integrada.
clientSecret	Solo es necesario para migrar usuarios o grupos de una instancia desplegada en OCI a través de Marketplace. Secreto de cliente del host de origen para la autorización de OAuth, que se encuentra en la aplicación de identidad confidencial integrada.
ID de aplicación	Solo es necesario para migrar usuarios o grupos de una instancia desplegada en OCI a través de Marketplace. Identificador de la aplicación de identidad confidencial integrada en el dominio de identidad de OCI (IAM o IDCS). Esta aplicación de identidad se debe configurar con roles de aplicación que se pueden otorgar a usuarios y grupos. Esta propiedad permite otorgar roles a los usuarios y grupos migrados.

Edite el archivo import.properties, que se encuentra en el mismo directorio que la utilidad. Proporcione los detalles de la instancia de destino de Essbase a la que está migrando.

Propiedad de importación	Descripción
userName	Es obligatorio. Nombre de usuario del administrador de Essbase de la instancia de destino.
contraseña	Es obligatorio. Contraseña de administrador de Essbase de la instancia de destino.
Host	Es obligatorio. Dirección IP de la instancia de destino del equilibrador de carga, si se ha configurado un equilibrador de carga durante el despliegue de Essbase. De lo contrario, el nombre de host o la dirección IP que se corresponde con la dirección IP pública de Essbase.
port	Opcional: Puerto de recepción HTTP de la instancia de Essbase de destino. Si la instancia de destino está configurada en modo seguro (TLS) y se asume el puerto `isTLS`=true 443. Si la instancia de origen está configurada con el proveedor de identidad LDAP, establezca el puerto como 80.
isTLS	Opcional: true o false. Si es true, la instancia de destino se configura en modo seguro (TLS) mediante el valor `port` especificado.
Contraseña de usuario	Opcional: Contraseña inicial que se asignará a los nuevos usuarios que la utilidad migre a la aplicación de identidad integrada en IAM o IDCS. Para cambiar las contraseñas después de la migración, utilice la consola de OCI.
Proxy	Opcional: Dirección de host de proxy HTTP, si la conexión a la instancia de destino de Essbase requiere un proxy. El host y el puerto de proxy están separados por dos puntos. Si se omite el puerto proxy, se supone que su valor es 80. Ejemplo con el puerto omitido: `www-proxy-example.com`. Ejemplo con puerto incluido: `www-proxy-example.com:80`
omitir usuario	Opcional: true o false. Establézcalo en Verdadero solo si no es necesario importar usuarios y/o grupos. El valor por defecto es false.
idcsHost	Solo es necesario para migrar usuarios o grupos a una instancia desplegada en OCI a través de Marketplace. Host de dominio de identidad de destino. En la URL del dominio de identidad (ejemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraiga solo la parte del dominio después de la cadena. Ejemplo: `identity.oraclecloud.com`
idcsTenant	Solo es necesario para migrar usuarios o grupos a una instancia desplegada en OCI a través de Marketplace. Identificador de arrendamiento del dominio de identidad del host de destino. En la URL del dominio de identidad (ejemplo: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, extraiga solo `idcs-<string_of_numbers_and_letters>`.
ID de cliente	Solo es necesario para migrar usuarios o grupos a una instancia desplegada en OCI a través de Marketplace. Identificador de cliente del host de destino para la autorización de OAuth, que se encuentra en la aplicación de identidad confidencial integrada.
clientSecret	Solo es necesario para migrar usuarios o grupos a una instancia desplegada en OCI a través de Marketplace. Secreto de cliente del host de destino para la autorización de OAuth, que se encuentra en la aplicación de identidad confidencial integrada.
ID de aplicación	Solo es necesario para migrar usuarios o grupos a una instancia desplegada en OCI a través de Marketplace. Identificador de la aplicación de identidad confidencial integrada en el dominio de identidad de OCI (IAM o IDCS). Esta aplicación de identidad se debe configurar con roles de aplicación que se pueden otorgar a usuarios y grupos. Esta propiedad permite otorgar roles a los usuarios y grupos migrados.
overwrite	Opcional: Establezca el valor en true si las aplicaciones que se van a importar ya existen en el destino y desea sobrescribirlas. El valor por defecto es false.
Certificados	Opcional: Ruta de acceso completa a todos los archivos de certificados de confianza para todos los servidores TLS/SSL. Para Windows, escape las barras invertidas con otra barra invertida. Ejemplo: `C:\\migrationTools\\all_certs.pem`

Ejecute la utilidad de migración en Java con el comando de exportación para exportar todas las aplicaciones, usuarios y grupos del catálogo de instancias de origen de Essbase a un archivo comprimido.

java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar export export.properties <new_tar_file>

Por ejemplo:

java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com -Dhttps.proxyPort=80 migrationTools.jar export export.properties export.tar.gz

Ejecute la utilidad de migración en Java con el comando import para importar el archivo comprimido a la instancia de destino.

java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>

Después de ejecutar la importación, los datos se migran al catálogo de Essbase de la instancia destino.