Migración de Oracle Analytics Cloud utilizando instantáneas

Las funciones de descarga y carga permiten guardar instantáneas en el sistema de archivos local y cargarlas de nuevo en la nube. Utilice estas funciones para migrar contenido entre dos servicios diferentes, migrar entre entornos de desarrollo, prueba y producción, y migrar un servicio desplegado en Oracle Cloud Infrastructure Classic a Oracle Cloud Infrastructure.

Temas:

Acerca de la migración de Oracle Analytics Cloud

La migración de contenido y valores de un entorno de Oracle Analytics Cloud a otro es sencilla gracias al uso de instantáneas. Puede migrarlo todo o tipos específicos de contenido.

Requisitos de migración

Antes de migrar el contenido de usuario mediante el uso de instantáneas, debe verificar el entorno de origen y el de destino:

Los entornos de origen y destino deben utilizar Oracle Analytics Cloud 5.1.x o una versión posterior. Las instantáneas tomadas de versiones anteriores no capturan el entorno completo.

Si no está seguro, pregunte a su representante de Oracle.
Si no lo ha hecho previamente, cree un servicio de destino en Oracle Cloud Infrastructure.

Consulte Creación de un servicio con Oracle Analytics Cloud en Administering Oracle Analytics Cloud on Oracle Cloud Infrastructure (Gen 2).
Si desea migrar datos basados en archivos, compruebe que los entornos de origen y destino estén activos y en ejecución, y configurados con credenciales de almacenamiento válidas.

Los problemas de acceso al almacenamiento pueden impedir la migración de archivos de datos mediante instantáneas. Si esto ocurre, puede utilizar la utilidad de migración de datos para descargar los archivos de datos y cargarlos a continuación por separado.

Elementos no migrados

Algunos artefactos de Oracle Analytics Cloud no están incluidos en las instantáneas. Tampoco están incluidos los artefactos que no son de Oracle Analytics Cloud.

Elementos no migrados	Más información
Configuración de antivirus	Registre la configuración de antivirus utilizada en el entorno de origen y utilice la misma información para configurar el antivirus en el destino. Consulte Configuración de un antivirus.
Configuración de servidor de correo	Registre la configuración del servidor de correo SMTP utilizada en el entorno de origen y utilice la información para configurar el servidor de correo en el destino. Consulte Configuración de un servidor de correo electrónico para entregar informes.
Otras instantáneas guardadas en el entorno de origen	Si es necesario, descargue las instantáneas individuales que desee migrar y cárguelas en el destino. Consulte Importación de instantáneas.
Usuarios (y grupos)	Migración del dominio de identidad de Oracle Cloud Infrastructure Identity and Access Management (IAM) Utilice las funciones de exportación e importación en la consola de Oracle Cloud Infrastructure para migrar usuarios y roles de un dominio de identidad a otro. Consulte Transferencia de datos en la documentación de Oracle Cloud Infrastructure. Migración de Oracle Identity Cloud Service Utilice las funciones de exportación e importación en la consola de Oracle Identity Cloud Service para migrar usuarios y roles de un dominio de identidad a otro. Consulte Gestión de usuarios de Oracle Identity Cloud Service y Gestión de grupos de Oracle Identity Cloud Service. Migración de servidor LDAP embebido de WebLogic Utilice el script `wls_ldap_csv_exporter` para exportar usuarios y grupos a un archivo CSV que pueda importar en Oracle Identity Cloud Service de destino. Consulte Exportación de usuarios y grupos de servidor LDAP embebido de WebLogic.
Configuración de gestión de identidad	Utilice la consola de Oracle Cloud Infrastructure en su entorno de destino para volver a configurar las asignaciones de rol de aplicación de cualquier usuario (o grupo) que haya configurado en el origen. Vuelva a configurar el inicio de sesión único (SSO), etc.
Configuración de red	Configure los requisitos de red en el entorno de destino según sea necesario.

Flujo de trabajo típico para la migración de Oracle Analytics Cloud

Si utiliza instantáneas para migrar Oracle Analytics Cloud a otro entorno, debe conocer la siguiente información.

Tarea	Descripción	Más información
Entender el proceso de migración utilizando instantáneas	Conozca qué se puede migrar y qué no en las instantáneas, así como cualquier otro requisito previo.	Acerca de la migración de Oracle Analytics Cloud
Crear el servicio de destino	Utilice la consola de Oracle Cloud Infrastructure para desplegar un nuevo servicio en Oracle Cloud Infrastructure.	Creación de un servicio con Oracle Analytics Cloud
Migrar usuarios y grupos	Utilice las funciones de exportación e importación en la consola de Oracle Cloud Infrastructure para migrar usuarios y roles de un dominio de identidad a otro. La forma de migrar usuarios de Oracle Analytics Cloud depende de si los dominios de identidad están disponibles en su cuenta en la nube. Si no está seguro, consulte Acerca de la configuración de usuarios y grupos. Si su sistema de origen usa un servidor LDAP embebido de WebLogic para la gestión de identificación, use el script `wls_ldap_csv_exporter` para exportar los usuarios y grupos a un archivo CSV.	Transferencia de datos (usuarios de IAM) Gestión de usuarios de Oracle Identity Cloud Service Exportación de usuarios y grupos de servidor LDAP embebido de WebLogic
Tomar una instantánea del origen	Capture el contenido que desea migrar en el sistema de origen.	Realización de una instantánea
Exportar la instantánea	Descargue la instantánea que desea migrar en el sistema de archivos local o en un cubo de almacenamiento de Oracle Cloud Infrastructure.	Exportación de instantáneas
Cargar la instantánea en el destino	Conéctese al sistema de destino y cargue la instantánea.	Importación de instantáneas
Restaurar el contenido de la instantánea	Seleccione la instantánea que acaba de cargar de la lista de instantáneas guardadas y restaure el contenido de la instantánea.	Restauración a partir de una instantánea
Migrar los archivos de datos	Utilice la utilidad de Migración de datos para migrar datos de un entorno a otro. Solo es necesario cuando: Desea migrar a una región diferente. Desea migrar a Oracle Analytics Cloud de 2ª generación desde Oracle Analytics Cloud de 1ª generación u Oracle Cloud Infrastructure Classic. El proceso de restauración falla debido a problemas de conectividad de red o acceso al almacenamiento.	Migración de datos basados en archivos
Volver a configurar el antivirus	Registre la configuración de antivirus en el entorno de origen y utilícela para configurar el antivirus en el destino.	Configuración de un antivirus
Volver a configurar el servidor de correo	Registre la configuración del servidor de correo SMTP en el entorno de origen y utilícela para configurar el servidor de correo en el destino.	Configuración de un servidor de correo electrónico para entregar informes
(Opcional) Migrar otras instantáneas	Descargue las instantáneas individuales que desee migrar y cárguelas en su entorno de destino, según sea necesario.	Exportación de instantáneas Importación de instantáneas
Migrar configuración de gestión de identidad	Utilice la consola de Oracle Cloud Infrastructure en su entorno de destino para volver a configurar las asignaciones de rol de aplicación de cualquier usuario (o grupo) que haya configurado en el origen. Vuelva a configurar el inicio de sesión único (SSO), etc.

Migración de datos basados en archivos

Los usuarios cargan archivos de datos (como hojas de cálculo) a Oracle Analytics Cloud para crear juegos de datos. Al migrar a un nuevo entorno de Oracle Analytics Cloud, puede llevarse estos datos basados en archivos. En ocasiones, los problemas de conectividad de red o de acceso al almacenamiento podrían impedirle migrar los archivos de datos en la instantánea. Para estos casos, Oracle Analytics Cloud ofrece una utilidad CLI (interfaz de línea de comandos) que le permite mover los archivos de datos a la nueva ubicación. La utilidad CLI de instantánea también transfiere todos los plugins y los archivos de extensión relacionados con los mapas que cargan los usuarios para la visualización de sus datos.

Ejecute la utilidad CLI de migración de datos si ve el mensaje Restore succeeded with errors - data restore failed (o similar) al tratar de restaurar una instantánea que contenga archivos de datos. Este mensaje aparece cuando:

Migra contenido de una región diferente.
Migra contenido de Oracle Analytics Cloud de 1ª generación o de Oracle Cloud Infrastructure Classic a Oracle Analytics Cloud de 2ª generación.
El proceso de restauración falla debido a otros problemas de conectividad de red o acceso al almacenamiento.

La utilidad CLI le permite mover archivos de datos directamente de un entorno a otro en un único paso. Si lo prefiere, también puede descargar los datos basados en archivos en un archivo ZIP y, a continuación, cargar los archivos de datos al entorno que desee en dos pasos independientes.

Compruebe los detalles del entorno.
- Verifique que tanto el sistema de origen como el de destino utilizan Oracle Analytics Cloud 5.3 o posterior. La utilidad CLI no está disponible en versiones anteriores.
  
  Si no está seguro, pregunte a su representante de Oracle.
- Compruebe que tanto el sistema de origen como el de destino estén activos y en ejecución, así como que Oracle Analytics Cloud esté configurado con credenciales de almacenamiento válidas.
- Compruebe el entorno local. Necesita Java 1.8 o posterior para poder ejecutar la utilidad CLI.
- Asegúrese de que puede acceder al entorno de origen y al destino de Oracle Analytics Cloud desde el entorno local en el que planea ejecutar la utilidad CLI.
- Verifique el nombre y la ubicación de la instantánea que ha descargado anteriormente y que contiene sus datos basados en archivos. Por ejemplo, /tmp/20190307095216.bar.
Descargue la utilidad CLI.
1. En el destino de Oracle Analytics Cloud, haga clic en Consola y, a continuación, en Instantáneas.
2. Haga clic en el menú Página , seleccione Migrar y, a continuación, Descargar utilidad de migración de datos.
  Siga las instrucciones para guardar localmente el archivo migrate-oac-data.zip.
Descomprima migrate-oac-data.zip.
El archivo ZIP contiene tres archivos:
- migrate-oac-data.jar
- config.properties
- readme

Si desea migrar archivos de datos almacenados en el entorno de origen directamente al destino en un único paso, configure la sección [MigrateData] en config.properties.

[MigrateData]
# Migrate data files from a source Oracle Analytics Cloud environment (OAC) to a target Oracle Analytics Cloud environment.
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>

Si desea descargar primero los archivos de datos del origen de Oracle Analytics Cloud a su entorno local para, a continuación, cargar los archivos de datos al entorno de destino de Oracle Analytics Cloud, configure las secciones [DownloadDataFiles] y [UploadDataFiles] en config.properties.

[DownloadDataFiles]
#Download Data Files: Download data files from Oracle Analytics Cloud storage to a local repository
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Local data file directory. Make sure you have enough space to download the data files to this directory. For example: /tmp/mydatafiledir 
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
     # Data fragment size. Data files are downloaded in fragments. Default fragment size is 500MB.
      MAX_DATA_FRAGMENT_SIZE_IN_MB=500

[UploadDataFiles]
#Upload data files: Upload data files to the target Oracle Analytics Cloud. 
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>
    # Local directory containing the data files you want to upload. For example: /tmp/mydatafiledir
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>

Ejecute el archivo migrate-oac-data.jar en su entorno local.
Sintaxis:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Dónde:
- -config configfile: Nombre del archivo config.properties
- -d: Descarga los datos de manera local y utiliza la información en config.properties
- -help : muestra la ayuda
- -m : Migra datos utilizando la información de origen y destino del archivo config.properties.
- -m : Carga datos utilizando la información presente en el archivo config.properties.
Por ejemplo, para migrar archivos de datos en un único paso:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Por ejemplo, para descargar archivos de datos localmente:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Por ejemplo, para cargar archivos de datos:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Conéctese al Oracle Analytics Cloud de destino.
Para mostrar los archivos de datos en Oracle Analytics Cloud, debe restaurar la instantánea que ha utilizado para migrar el resto del contenido por segunda vez. En esta ocasión, debe seleccionar la opción de restauración Personalizado.
1. Abra la consola y haga clic en Gestionar instantáneas.
2. Seleccione la instantánea que contiene los archivos de datos
3. Seleccione la opción de restauración Personalizada y, a continuación, seleccione la opción Datos basados en archivos.
  Anule la selección de todas las demás opciones.
4. Haga clic en Restaurar.
Verifique que los archivos de datos están disponibles.