cloneEnvironment

Clone el entorno actual y, opcionalmente, los artefactos del dominio de identidad (asignaciones de usuarios y roles predefinidos), los registros de Data Management, los registros de auditoría, los registros de la consola de trabajos, el contenido del buzón y de la bandeja de salida y las instantáneas almacenadas. Este comando es una alternativa al uso de la función Clonar entorno en Migración.

Note:

Account Reconciliation: después de la clonación, la aplicación Account Reconciliation de destino se restablecerá a sus valores predeterminados. Si desea conservar los valores de la aplicación de destino, expórtelos desde el entorno de origen mediante el comando exportARApplicationProperties. A continuación, una vez completada la clonación, importe las propiedades de la aplicación en el entorno de destino mediante el comando importARApplicationProperties.
Data Management: la clonación de registros de Data Management puede tardar mucho tiempo si las tablas temporales contienen una gran cantidad de registros. Del mismo modo, la clonación del contenido del buzón y de la bandeja de salida, así como de las instantáneas almacenadas, puede llevar mucho tiempo, especialmente si contienen una gran cantidad de datos.
Entornos heredados: la clonación mantiene la versión actual de Oracle Essbase como se describe en estos escenarios:
- Escenario 1: está clonando un entorno heredado de origen que usa una versión de Essbase que no soporta cubos híbridos para un entorno heredado de destino que usa una versión de Essbase que sí soporta cubos híbridos. En este caso, la versión de Essbase en el entorno de destino se devuelve a una versión anterior para que coincida con la versión del entorno de origen.
- Escenario 2: está clonando un entorno heredado de origen que usa una versión de Essbase que sí soporta cubos híbridos para un entorno heredado de destino que usa una versión de Essbase que no soporta cubos híbridos. En este caso, la versión de Essbase en el entorno de destino se actualiza a una versión posterior para que coincida con la versión del entorno de origen.
- Escenario 3: está clonando un entorno heredado de origen que usa una versión de Essbase que no soporta cubos híbridos para un entorno de EPM Standard Cloud Service o EPM Enterprise Cloud Service de destino que usa una versión de Essbase que sí soporta cubos híbridos de manera predeterminada. En este caso, la versión de Essbase en el entorno de destino no se devuelve a una versión anterior para que coincida con la versión del entorno de origen.
Planning: la clonación puede fallar si el proceso de negocio de Planning contiene un miembro de período definido cuyo nombre se ha cambiado que se ha suplantado por un miembro de período personalizado. Por ejemplo, si ha cambiado el nombre del miembro de período YearTotal definido a unused_YearTotal y, a continuación, ha agregado, un miembro de período de tipo alternativo con el nombre de miembro definido original (YearTotal en este ejemplo). En este escenario, la clonación del entorno puede fallar.
Cuándo ejecutar este comando: ejecute este comando después del mantenimiento diario programado de los entornos de origen y destino.
El mantenimiento diario tanto del entorno de origen como del de destino no puede empezar mientras se esté ejecutando el proceso de clonación. El mantenimiento diario se ejecuta en la próxima hora programada cuando finalice o termine el proceso de clonación tras 36 horas.

Si este comando se ejecuta mientras se está generando la instantánea del entorno de origen; por ejemplo, durante el mantenimiento diario, verá el error File not found.

Para obtener información detallada sobre estos temas, consulte Clonación de entornos de EPM Cloud en Administración de migración de Oracle Enterprise Performance Management Cloud.

Se aplica a

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Narrative Reporting, Sales Planning y Strategic Workforce Planning.

Roles necesarios

Administrador del servicio

Se necesita el rol Administrador de dominio de identidad para clonar usuarios y roles predefinidos.

Sintaxis

Note:

El parámetro dataManagement no se aplica a entornos de Oracle Enterprise Data Management Cloud ni a Narrative Reporting.
Clone los registros de Data Management solo si tanto el entorno de origen como el de destino están en la misma actualización mensual o el entorno de destino está en una actualización más actual que el entorno de origen. Por ejemplo, puede clonar registros del entorno 22.01 de Data Management a otro entorno 22.01 o solo a un entorno de 22.02.
El parámetro jobConsole solo se aplica a Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Enterprise Profitability and Cost Management, Sales Planning y Strategic Workforce Planning.
El parámetro appAudit solo se aplica a Planning, Planning Modules, FreeForm, Enterprise Profitability and Cost Management, Sales Planning y Strategic Workforce Planning.
La información de auditoría para Financial Consolidation and Close y Tax Reporting está, de forma predeterminada, incluida en la instantánea.
Si el parámetro dataManagement, jobConsole o appAudit no se puede aplicar a un entorno, EPM Automate ignora el valor que especifique.

TARGET_USERNAME es el ID de un administrador del servicio del entorno de destino. Debe utilizar el nombre de usuario del dominio de identidad de destino (no el nombre de usuario de inicio de sesión único). Si tiene previsto clonar las asignaciones de usuarios y roles en el entorno de destino, este usuario debe tener también el rol de administrador del dominio de identidad.
TARGET_PASSWORD es la ubicación del archivo de contraseña cifrado del usuario identificado con TARGET_USERNAME.
TARGET_URL es la URL del entorno que se convertirá en el entorno clonado.
SnapshotName, opcionalmente, es el nombre de una instantánea que se debe usar para la clonación. Esta instantánea debe estar presente en el entorno de origen. El valor predeterminado es Artifact Snapshot, que usa la última instantánea de mantenimiento para clonar el entorno.
UsersAndPreDefinedRoles, opcionalmente, identifica si se va a clonar a usuario y sus asignaciones de rol predefinido (los grupos de Control de acceso siempre se clonan). El valor predeterminado es false.
Para que esta opción funcione, el usuario identificado con TARGET_USER_NAME debe tener el rol de administrador del dominio de identidad del entorno de destino.
La importación de usuarios y sus roles predefinidos fallará si un usuario que no es un Administrador de dominio de identidad clona un entorno después de seleccionar esta casilla de verificación. Se registrará el siguiente error en el Informe de estado de la migración: Error al importar el artefacto del directorio externo <nombre_artefacto>. El usuario <nombre_usuario> no tiene autorización para realizar esta operación. El usuario debe tener el rol de administrador de dominio de identidad para realizar esta operación.
- Si no importa los usuarios y un usuario de la instantánea de origen no está asignado a un rol predefinido en el entorno de destino, se muestra un error (EPMIE-00070: Error al buscar el usuario durante la importación de las funciones asignadas).
- La asignación del rol Administrador de dominio de identidad no se clona. Los usuarios que solo tienen la asignación del rol Administrador de dominio de identidad no se clonan en el entorno de destino.
  Se clonan los usuarios asignados a una combinación del rol Administrador de dominio de identidad y los roles predefinidos en el entorno de origen, pero se asignan solo a los roles predefinidos respectivos en el entorno de destino. Estos usuarios no tendrán el rol Administrador de dominio de identidad en el entorno de destino.
- Los cambios en los roles predefinidos del usuario se actualizarán en función de los roles asignados en la instantánea de origen. Sin embargo, las asignaciones de roles del destino no se eliminarán para que coincidan con las de la instantánea de origen. Por ejemplo, asuma que a jdoe se le ha asignado el rol predefinido Usuario avanzado en el entorno de destino, pero solo tiene el rol Usuario en la instantánea de origen. En esta situación, este comando asigna a jdoe el rol Usuario y no elimina la asignación de rol Usuario avanzado en el entorno de destino.
- Con este comando no se suprimen los usuarios existentes del entorno de destino si no existen en la instantánea de origen. Por ejemplo, jdoe tiene una cuenta en el entorno de destino, pero esta cuenta no está en la instantánea de origen. En esta situación, la cuenta de jdoe en el entorno de destino no se suprime.
- Con este comando se agregan usuarios que no existan en el entorno de destino; no se actualizan las propiedades del usuario actual en el entorno de destino, incluso aunque sean distintos en la instantánea de origen. Por ejemplo, si el apellido de jdoe en la instantánea de origen está escrito de forma distinta en el entorno de destino, el cambio no se realizará en el entorno de destino. Se asigna una contraseña aleatoria a los nuevos usuarios del entorno de destino. Los usuarios nuevos recibirán mensajes de correo electrónico de activación de la cuenta en que se les solicite que cambien las contraseñas.
- Con este comando no se cambian las contraseñas de los usuarios existentes en el entorno de destino, incluso aunque sean diferentes en las instantáneas de origen.
dataManagement=true|false, opcionalmente, clona registros de Data Management del entorno de origen en el entorno de destino. El valor predeterminado es true, que clona los registros de Data Management. Establezca este valor en false si no desea clonar registros de Data Management.
appAudit=true|false, opcionalmente, clona los registros de auditoría del entorno de origen en el entorno de destino. El valor predeterminado es true, que clona los datos de auditoría de la aplicación. Establezca este valor en false si no desea clonar los datos de auditoría de la aplicación en el entorno de destino.
Con jobConsole=true|false, opcionalmente, se clonan los registros de auditoría del entorno de origen en el entorno de destino El valor predeterminado es true. Establezca este valor en false si no desea clonar registros de la consola de trabajos.
Con storedSnapshotsAndFiles, opcionalmente, se identifica si el comando debe clonar el contenido del buzón y de la bandeja de salida y las instantáneas almacenadas. El valor predeterminado es false.

Note:
Solo se clonan las carpetas de nivel superior de la bandeja de entrada y el buzón de salida; no las subcarpetas. Si necesita conservar el contenido de las subcarpetas, realice una copia de seguridad de estas en un equipo local y, a continuación, cárguelas en el entorno de destino.
Con DailyMaintenanceStartTime, opcionalmente, se restablece la hora de inicio del mantenimiento del entorno de destino clonado en la del entorno de origen. El valor predeterminado es true. Para mantener la hora de inicio del mantenimiento del entorno de destino, establezca este valor en false.

Ejemplos

Clone el entorno, las asignaciones de usuarios y roles predefinidos, los datos de auditoría, los registros de la consola de trabajos y los registros de Data Management. Cambie también la hora de inicio del mantenimiento del entorno de destino para que coincida con la del entorno de origen:
epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true
Clone el entorno, incluido el contenido del buzón y de la bandeja de salida, las instantáneas almacenadas, pero no las asignaciones de usuarios y roles predefinidos, los registros de Data Management, los datos de auditoría y los registros de la consola de trabajos, sin cambiar la hora de inicio del mantenimiento del entorno de destino:
epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com DataManagement=false appAudit=false jobConsole=false storedSnapshotsAndFiles=true DailyMaintenanceStartTime=false
Clone el entorno completo (asignaciones de usuarios y roles predefinidos, los registros de la consola de trabajos, el contenido del buzón y la bandeja de salida, las instantáneas almacenadas y los registros de Data Management) con una instantánea personalizada. Cambie también la hora de inicio del mantenimiento del entorno de destino para que coincida con la del entorno de origen:
epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true storedSnapshotsAndFiles=true SnapshotName=SampleSnapshot