Configuración de los parámetros de inicio del Agente de integración de EPM

Los parámetros de inicio de su URL de Oracle Enterprise Performance Management Cloud y del dominio de EPM Cloud para el Agente de integración de EPM se definen en el archivo agentparams.ini.

Nota:

Antes de definir los parámetros de inicio del Agente de integración de EPM, ejecute el archivo createAppFolder.bat, el cual crea un archivo INI que contiene los parámetros rellenos EPM_AGENT_HOME y EPM_APP_DATA_HOME. Para obtener más información, consulte Creación de carpetas de aplicación.

Para cifrar la contraseña que utiliza el usuario de EPM Cloud, debe ejecutar ecryptpassword.bat. Para obtener más información, consulte Cifrado de la contraseña de usuario de EPM Cloud.

Para configurar los parámetros de inicio que utiliza el Agente de integración de EPM:

  1. Vaya al directorio C:\EPMAgentData\config.

  2. Haga doble clic en el archivo agentparams.ini para abrirlo utilizando un editor de texto como Notepad.

    El archivo agentparams.ini se abre en un archivo de texto:

    archivo agentparamas

  3. EPM_AGENT_HOME es el nombre del directorio inicial del agente. Esta carpeta contiene las carpetas bin y lib.

    Cuando se ejecuta createappfolder.bat, el script crea el parámetro relleno EPM_AGENT_HOME de forma automática.

    Si cambia el nombre de la carpeta, el agente se ejecuta desde la nueva ubicación y se crean los archivos en la nueva carpeta EPM_APP_DATA_HOME.

  4. EPM_APP_DATA_HOME es el nombre de la carpeta de datos de la aplicación, que contiene las carpetas config, log y script. La carpeta config también contiene la carpeta certificate para almacenar los certificados SSL.

    Cuando se ejecuta createappfolder.bat, el script crea un archivo INI que contiene el parámetro relleno EPM_APP_DATA_HOME.

  5. En AGENT_NAME, especifique un nombre único para el Agente de integración de EPM.

    Solo se pueden utilizar caracteres y números en el nombre. AGENT_NAME no puede contener símbolos ni espacios.

  6. En CLUSTER, especifique el nombre del cluster al que pertenece el agente.

    Solo pueden utilizarse caracteres alfanuméricos en el nombre. No utilice caracteres especiales como la arroba (@) o el ampersand (&). El nombre no se puede modificar una vez que se ha creado el cluster.

    El nombre predeterminado del cluster es EPMCLUSTER.

    Nota:

    El nombre del cluster debe estar ya definido en Data Integration para que se puede hacer referencia a él desde aquí. Para obtener más información, consulte Adición de un cluster.

    Este parámetro es obligatorio.

  7. En PORT, especifique el número de puerto en el que se ejecuta el Agente de integración de EPM.

    Este parámetro es obligatorio.

  8. En CLOUD_URL, especifique la URL de EPM Cloud utilizada para autenticar e iniciar el agente.

    Se trata de la URL de la instancia de EPM asociada al agente; por ejemplo:

    https://example-pbcs.us1.oraclecloud.com

    Nota:

    Asegúrese de no incluir "epmcloud" ni "HyperionPlanning" al final de Cloud_URL.

    Este parámetro es obligatorio.

  9. En CLOUD_DOMAIN, especifique un nombre único para la URL de EPM Cloud.

    Un dominio de identidad controla las cuentas de usuarios que necesitan acceso a las instancias de servicio. También controla las funciones a las que pueden acceder los usuarios autorizados. Una instancia de servicio pertenece a un dominio de identidad.

    Los administradores pueden actualizar el nombre de dominio que se presenta al usuario, pero Data Management necesita el nombre de dominio original que se proporcionó cuando el cliente se registró para el servicio. Los nombres del dominio de alias no se pueden usar al configurar las conexiones de EPM Cloud desde Data Management.

    Este parámetro es obligatorio.

  10. En CLOUD_USER_NAME, especifique el nombre del usuario administrador presente en el entorno de EPM Cloud.

    El nombre de usuario debe ser un usuario nativo y no un nombre de usuario de inicio de sesión único.

    Este parámetro es obligatorio.

  11. En CLOUD_PASSWORD, especifique la cadena de contraseña cifrada para el usuario administrador.

    Puede cifrar la contraseña para el usuario de EPM Cloud y obtener la cadena de contraseña cifrada mediante la ejecución de encryptpassword.bat (para Windows) o de ecryptpassword.sh (para Linux). Para obtener más información, consulte Cifrado de la contraseña de usuario de EPM Cloud.

    Este parámetro es obligatorio.

  12. En LOG_LEVEL, especifique el nivel de registro del Agente de integración de EPM local.

    Los niveles de registro válidos son los siguientes:

    • ALL: muestra el nivel más detallado e imprime todas las sentencias de registro.
    • INFO: imprime los registros seleccionados que son importantes.
    • ERROR: realiza un registro mínimo; solo se imprimen los errores graves.

    Todos los registros se escriben en un archivo dentro de la carpeta APPDATA_HOME\logs.

    Este parámetro es optativo. Todo es el nivel de registro predeterminado.

  13. En POLL_INTERVAL, especifique el intervalo de tiempo para la espera y el sondeo en el modo asíncrono.

    El intervalo de tiempo se especifica en segundos. El intervalo de tiempo predeterminado es 120 segundos.

  14. En REGISTER_WITH_IP, especifique N para registrar el agente con el nombre de host. Especifique Y para registrar el agente con la dirección IP.

    Este parámetro es optativo.

  15. En EXECUTION_POOL_SIZE, especifique cuántos trabajos se pueden ejecutar en paralelo.

    El tamaño predeterminado del pool de ejecución es 2.

    Este parámetro es optativo.

  16. En JYTHON_HOME, especifique el directorio de nivel superior donde está instalado Jython.

    Solo es necesario si utiliza Jython como lenguaje de scripts.

  17. En GROOVY_HOME, especifique el directorio de nivel superior donde está instalado Groovy.

    Solo es necesario si utiliza Groovy como lenguaje de scripts.

  18. En CUSTOM_MEM_ARGS, especifique la variable para reemplazar los argumentos de memoria estándar transferidos a Java por un argumento de memoria personalizado.

    Por ejemplo, en el parámetro CUSTOM_MEM_ARGS=-Xms128m -Xmx4096m, 128 MB es el tamaño mínimo de memoria inicial, y 4096 MB es el tamaño de memoria máximo.

    Este parámetro es optativo.

  19. En CUSTOM_JAVA_OPTIONS, especifique los parámetros de tiempo de ejecución de Java adicionales.

    La opción CUSTOM_JAVA_OPTIONS también se puede configurar para que el agente de integración de EPM utilice un método de autentificación de proxy.

    El sistema soporta los siguientes métodos de autentificación:

    • básico
    • resumen
    • NTLM

    Si utiliza un método de autentificación proxy, especifique el nombre de host proxy, el puerto proxy, el nombre de usuario proxy y la contraseña cifrada en este campo.

    Para activar la autentificación de proxy básica o de resumen, establezca NTLM_PROXY_AUTH en N e incluya lo siguiente en los parámetros del agente en CUSTOM_JAVA_OPTIONS: -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword

    Si la autentificación de proxy no está activada, establezca NTLM_PROXY_AUTH en N y no agregue parámetros de proxy en CUSTOM_JAVA_OPTIONS.

    Para activar la autentificación de proxy NTL, establezca NTLM_PROXY_AUTH en Y e incluya lo siguiente en los parámetros del agente en CUSTOM_JAVA_OPTIONS: -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword -DproxyDomain=Domain

  20. En CUSTOM_INTERFACE_CLASS_NAME, especifique el nombre de clase completo de la clase en custom.jar que implementa la EpmAgentInterface.

    Por ejemplo, especifique: com.mycompany.agent.implementation.MyImplementation.

    Este parámetro es optativo.

  21. En CUSTOM_CLASS_PATH, especifique la ruta completa y el nombre del archivo JAR (por ejemplo, C:\AgentDeployment\agenthome\myJarFolder\custom.jar

    Este parámetro es optativo.

    Si utiliza una conexión del controlador Java Database Connectivity (JDBC) de Microsoft a SQL Server en el Agente de integración de EPM, consulte Configuración del controlador JDBC de Microsoft para SQL Server en el Agente de integración de EPM.

  22. En NTLM_PROXY_AUTH, especifique Y para utilizar un método de autentificación de proxy NTLM.

    Si utiliza la autentificación de proxy NTLM, debe especificar adicionalmente parámetros de proxy en CUSTOM_JAVA_OPTIONS.

    Especifique N para utilizar la autentificación de proxy básica o de resumen o si no está usando la autentificación de proxy.

    Nota:

    Configure JYTHON_HOME o GROOVY_HOME si desea utilizar Jython o Groovy para la creación de scripts.

    Configure CUSTOM_JAVA_OPTIONS, CUSTOM_INTERFACE_CLASS si desea utilizar Java personalizado para sus extensiones.

  23. En AMW_IDLE_TIME, especifique el valor de tiempo de inactividad para los agentes que se ejecuten en modo asíncrono durante el tiempo de inactividad de la ventana de mantenimiento automatizado (AMW) o un mantenimiento no programado.

    El valor de parámetro AMW_IDLE_TIME está establecido en minutos y el valor predeterminado es 15 minutos. Los clientes pueden definir un tiempo de inactividad mayor, pero no debe especificar un valor de tiempo de inactividad inferior a 15 minutos. El tiempo de inactividad de AMW es un intervalo de tiempo contiguo durante el que se ejecutan las tareas automatizadas para un proceso de negocio.

  24. Guarde los cambios en el archivo agentparamas.ini.