設定 EPM 整合代理程式的啟動參數

Oracle Enterprise Performance Management Cloud URL 的啟動參數,以及 EPM 整合代理程式的 EPM Cloud 網域,都是在 agentparams.ini 檔案中定義的。

註:

請在定義 EPM 整合代理程式的啟動參數之前,先執行 createAppFolder.bat,這會建立包含已植入參數值之 EPM_AGENT_HOMEEPM_APP_DATA_HOME 的 INI 檔案。如需詳細資訊,請參閱建立應用程式資料夾

如要為 EPM Cloud 使用者所用的密碼加密,您必須執行 ecryptpassword.bat。如需詳細資訊,請參閱為 EPM Cloud 使用者密碼加密

如何設定 EPM 整合代理程式所用的啟動參數:

  1. 前往 C:\EPMAgentData\config 目錄。

  2. 按兩下 agentparams.ini 檔案,以便用文字編輯器 (例如 Notepad) 開啟該檔案。

    agentparams.ini 檔案會開啟成文字檔:

    agentparamas 檔案

  3. EPM_AGENT_HOME 是代理程式的主目錄名稱。這個資料夾包含 bin 和 lib 資料夾。

    當您執行 createappfolder.bat 時,指令碼會自動建立已植入參數值的 EPM_AGENT_HOME 參數。

    如果您變更資料夾的名稱,代理程式會在新的位置執行,並在新的 EPM_APP_DATA_HOME 資料夾中建立檔案。

  4. EPM_APP_DATA_HOME 是應用程式資料夾的名稱,而該資料夾包含 config、log 及 script 資料夾。而 config 資料夾也包含用來存放 SSL 憑證的憑證資料夾。

    當您執行 createappfolder.bat 時,指令碼會建立 INI 檔案,其中包含已植入參數值的 EPM_APP_DATA_HOME 參數。

  5. AGENT_NAME 中,指定 EPM 整合代理程式的唯一名稱。

    您只能在該名稱中使用字元和數字。 AGENT_NAME 無法包含任何符號和空格。

  6. CLUSTER 中,指定代理程式所屬的叢集名稱。

    您只能在該名稱中使用英數字元。請勿使用特殊字元,例如 @ 符號或 & 符號。叢集建立之後,您就無法再編輯該叢集的名稱。

    預設的叢集名稱是 EPMCLUSTER

    註:

    您必須先在資料整合中定義叢集的名稱,才能在這裡參照該叢集。如需詳細資訊,請參閱新增叢集

    此參數為必填參數。

  7. PORT 中,指定 EPM 整合代理程式執行之處的連接埠號碼。

    此參數為必填參數。

  8. CLOUD_URL 中,指定用來驗證及啟動代理程式的 EPM Cloud URL。

    這就是與代理程式相關聯之 EPM 例項的 URL:

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

    註:

    請確保不要在 Cloud_URL 的結尾使用「epmcloud」或「HyperionPlanning」。

    此參數為必填參數。

  9. CLOUD_DOMAIN 中,指定 EPM Cloud URL 的唯一名稱。

    識別網域控制需存取服務例項之使用者的科目。它還控制授權使用者可存取的功能。服務例項屬於識別網域。

    管理員可更新呈現在使用者面前的網域名稱,但資料管理需要當客戶註冊服務時提供的原始網域名稱。從資料管理設定 EPM Cloud 連線時,無法使用別名網域名稱。

    此參數為必填參數。

  10. CLOUD_USER_NAME 中,指定 EPM Cloud 環境中的管理員使用者名稱。

    該使用者名稱必須是原生使用者,而不是 SSO 使用者名稱。

    此參數為必填參數。

  11. CLOUD_PASSWORD 中,指定管理員使用者的加密密碼字串。

    您可以將 EPM Cloud 使用者的密碼加密,只要執行 encryptpassword.bat (Windows 適用) 或 ecryptpassword.sh (Linux 適用) 就能取得加密密碼字串。如需詳細資訊,請參閱為 EPM Cloud 使用者密碼加密

    此參數為必填參數。

  12. LOG_LEVEL 中,指定本機 EPM 整合代理程式的日誌層級。

    有效的日誌層級包括:

    • ALL - 顯示最詳細的層級,並列印所有日誌陳述式。
    • INFO - 列印已選取的重要日誌。
    • ERROR - 執行最少量的記錄工作,只會列印嚴重錯誤。

    系統會把所有日誌寫入 APPDATA_HOME\logs 資料夾中的檔案。

    此參數為選擇性參數。All 是預設的日誌層級。

  13. POLL_INTERVAL 中,指定在採用非同步模式時,系統要等待並輪詢的時間間隔。

    時間間隔是以秒數來指定的,預設的時間間隔是 120 秒。

  14. REGISTER_WITH_IP 中,指定 N 以使用主機名稱來登錄代理程式。指定 Y 即可使用 IP 位址來登錄代理程式。

    此參數為選擇性參數。

  15. EXECUTION_POOL_SIZE 中,指定可以平行執行的工作數量。

    預設的執行集區大小是 2。

    此參數為選擇性參數。

  16. JYTHON_HOME 中,指定 Jython 安裝所在的頂端目錄。

    如果您要用 Jython 程式語言來編寫指令碼,這就是必要的參數。

  17. GROOVY_HOME 中,指定 Groovy 安裝所在的頂端目錄。

    如果您要用 Groovy 程式語言來編寫指令碼,這就是必要的參數。

  18. CUSTOM_MEM_ARGS 中指定變數,以便覆寫要傳遞到有自訂記憶體引數之 Java 的標準記憶體引數。

    例如,在參數 CUSTOM_MEM_ARGS=-Xms128m -Xmx4096m 中,128 MB 是起始記憶體大小的下限,而 4096 MB 是記憶體大小的上限。

    此參數為選擇性參數。

  19. CUSTOM_JAVA_OPTIONS 中,指定任何其他的 Java 執行時期參數。

    CUSTOM_JAVA_OPTIONS 設定值也可以設定成讓「EPM 整合代理程式」使用 Proxy 驗證方法。

    系統支援下列驗證方法:

    • 基本
    • 摘要
    • NTLM

    如果您使用 Proxy 驗證方法,則請在此欄位中指定 Proxy 主機名稱、Proxy 連接埠、Proxy 使用者名稱和加密密碼。

    若要啟用基本或摘要 Proxy 驗證,請將 NTLM_PROXY_AUTH 設為 N,並在 CUSTOM_JAVA_OPTIONS 的代理程式參數中包括下列項目:-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword

    如果未啟用 Proxy 驗證,則請將 NTLM_PROXY_AUTH 設為 N,而且不要在 CUSTOM_JAVA_OPTIONS 中新增 Proxy 參數。

    若要啟用 NTML Proxy 驗證,請將 NTLM_PROXY_AUTH 設為 Y,並在 CUSTOM_JAVA_OPTIONS 的代理程式參數中包括下列項目:-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword -DproxyDomain=Domain

  20. CUSTOM_INTERFACE_CLASS_NAME 中,指定在實作 EpmAgentInterfacecustom.jar 中,類型的完整名稱。

    例如,您可以指定:com.mycompany.agent.implementation.MyImplementation

    此參數為選擇性參數。

  21. CUSTOM_CLASS_PATH 中,指定 jar 檔案的完整路徑和名稱 (例如 C:\AgentDeployment\agenthome\myJarFolder\custom.jar

    此參數為選擇性參數。

    如果您要在 EPM 整合代理程式中,使用 Microsoft Java Database Connectivity (JDBC) 驅動程式來連線至 SQL Server,請參閱在 EPM 整合代理程式中設定 SQL Server 適用的 Microsoft JDBC 驅動程式

  22. NTLM_PROXY_AUTH 中,指定 Y 以使用 NTLM Proxy 驗證方法。

    如果您使用 NTLM Proxy 驗證,則必須在 CUSTOM_JAVA_OPTIONS 中額外指定 Proxy 參數。

    指定 N 以使用基本或摘要 Proxy 驗證,或者,如果您未使用 Proxy 驗證。

    註:

    如果您要使用 Jython 或 Groovy 來編寫指令碼,請設定 JYTHON_HOME 或 GROOVY_HOME。

    如果您要使用自訂的 Java 擴充功能,請設定 CUSTOM_JAVA_OPTIONS 和 CUSTOM_INTERFACE_CLASS。

  23. AMW_IDLE_TIME 中,指定在「自動維護時段 (AMW)」停機時間或未排定維護期間,以非同步模式執行之代理程式的閒置時間值。

    AMW_IDLE_TIME 參數值是以分鐘設定,預設值為 15 分鐘。客戶可定義較長的閒置時間,但不應指定小於 15 分鐘的閒置時間值。AMW 停機時間是對業務程序執行自動維護任務的連續時間間隔。

  24. 儲存對 agentparamas.ini 檔案的任何變更。