Oracle Enterprise Performance Management Cloud URL 的啟動參數,以及 EPM 整合代理程式的 EPM Cloud 網域,都是在 agentparams.ini
檔案中定義的。
註:
請在定義 EPM 整合代理程式的啟動參數之前,先執行 createAppFolder.bat
,這會建立包含已填入參數值之 EPM_AGENT_HOME
和 EPM_APP_DATA_HOME
的 INI 檔案。如需詳細資訊,請參閱建立應用程式資料夾。
如要為 EPM Cloud 使用者所用的密碼加密,您必須執行 ecryptpassword.bat
。如需詳細資訊,請參閱為 EPM Cloud 使用者密碼加密。
如何設定 EPM 整合代理程式所用的啟動參數:
前往 C:\EPMAgentData\config
目錄。
按兩下 agentparams.ini
檔案,以便用文字編輯器 (例如 Notepad) 開啟該檔案。
agentparams.ini
檔案會開啟成文字檔:
EPM_AGENT_HOME
是代理程式的主目錄名稱。這個資料夾包含 bin 和 lib 資料夾。
當您執行 createappfolder.bat
時,指令碼會自動建立已填入參數值的 EPM_AGENT_HOME
參數。
如果您變更資料夾的名稱,代理程式會在新的位置執行,並在新的 EPM_APP_DATA_HOME
資料夾中建立檔案。
EPM_APP_DATA_HOME
是應用程式資料夾的名稱,而該資料夾包含 config、log 及 script 資料夾。而 config 資料夾還包含一個空的憑證資料夾,目前並未使用該資料夾。
當您執行 createappfolder.bat
時,指令碼會建立 INI 檔案,其中包含已填入參數值的 EPM_APP_DATA_HOME
參數。
在 AGENT_NAME 中,指定 EPM 整合代理程式的唯一名稱。
您只能在該名稱中使用字元和數字。AGENT_NAME
無法包含任何符號和空格。
在 CLUSTER 中,指定代理程式所屬的叢集名稱。
您只能在該名稱中使用英數字元。請勿使用特殊字元,例如 @ 符號或 & 符號。叢集建立之後,您就無法再編輯該叢集的名稱。
預設的叢集名稱是 EPMCLUSTER。
註:
您必須先在資料整合中定義叢集的名稱,才能在這裡參照該叢集。如需詳細資訊,請參閱新增叢集。
此參數為必填參數。
在 PORT 中,指定 EPM 整合代理程式執行之處的連接埠號碼。
此參數為必填參數。
在 CLOUD_URL 中,指定用來驗證及啟動代理程式的 EPM Cloud URL。
這就是與代理程式相關聯之 EPM 例項的 URL:
https://example-pbcs.us1.oraclecloud.com
註:
請確保不要在 Cloud_URL 的結尾使用「epmcloud」或「HyperionPlanning」。此參數為必填參數。
在 CLOUD_DOMAIN 中,指定 EPM Cloud URL 的唯一名稱。
識別網域控制需存取服務例項之使用者的科目。它還控制授權使用者可存取的功能。服務例項屬於識別網域。
管理員可更新呈現在使用者面前的網域名稱,但資料管理需要當客戶註冊服務時提供的原始網域名稱。從資料管理設定 EPM Cloud 連線時,無法使用別名網域名稱。
註:
除了任何一個 Gen 2 資料中心以外,皆需有 CLOUD_DOMAIN 參數。在 CLOUD_USER_NAME 中,指定 EPM Cloud 環境中的管理員使用者名稱。
該使用者名稱必須是原生使用者,而不是 SSO 使用者名稱。
此參數為必填參數。
在 CLOUD_PASSWORD 中,指定管理員使用者的加密密碼字串。
您可以將 EPM Cloud 使用者的密碼加密,只要執行 encryptpassword.bat
(Windows 適用) 或 ecryptpassword.sh
(Linux 適用) 就能取得加密密碼字串。如需詳細資訊,請參閱為 EPM Cloud 使用者密碼加密。
此參數為必填參數。
在 LOG_LEVEL 中,指定本機 EPM 整合代理程式的日誌層級。
有效的日誌層級包括:
系統會把所有日誌寫入 APPDATA_HOME\logs
資料夾中的檔案。
此參數為選擇性參數。All 是預設的日誌層級。
在 POLL_INTERVAL 中,指定在採用非同步模式時,系統要等待並輪詢的時間間隔。
時間間隔是以秒數來指定的,預設的時間間隔是 120 秒。
在 REGISTER_WITH_IP 中,指定 N 以使用主機名稱來登錄代理程式。指定 Y 即可使用 IP 位址來登錄代理程式。
此參數為選擇性參數。
在 EXECUTION_POOL_SIZE 中,指定可以平行執行的工作數量。
預設的執行集區大小是 2。
此參數為選擇性參數。
在 JYTHON_HOME 中,指定 Jython 安裝所在的頂端目錄。
如果您要用 Jython 程式語言來編寫指令碼,這就是必要的參數。
在 GROOVY_HOME 中,指定 Groovy 安裝所在的頂端目錄。
如果您要用 Groovy 程式語言來編寫指令碼,這就是必要的參數。
在 CUSTOM_MEM_ARGS 中指定變數,以便覆寫要傳遞到有自訂記憶體引數之 Java 的標準記憶體引數。
例如,在參數 CUSTOM_MEM_ARGS=-Xms128m -Xmx4096m
中,128 MB 是起始記憶體大小的下限,而 4096 MB 是記憶體大小的上限。
此參數為選擇性參數。
在 CUSTOM_JAVA_OPTIONS 中,指定任何其他的 Java 執行時期參數。
CUSTOM_JAVA_OPTIONS 設定值也可以設定成讓「EPM 整合代理程式」使用 Proxy 驗證方法。
系統支援下列驗證方法:
如果您使用 Proxy 驗證方法,請根據該方法在此欄位中指定 Proxy 主機名稱、Proxy 連接埠、Proxy 使用者名稱及加密密碼。
如果 Proxy 使用基本驗證,則將 CUSTOM_JAVA_OPTIONS 設為:
-Djdk.http.auth.tunneling.disabledSchemes=""
註:
當您將 Basic 新增到 jdk.http.auth.tunneling.disabledSchemes 網路特性中時,系統預設會停用 Oracle Java Runtime 中的基本驗證配置。因此,當您為 HTTPS 設定通道時,需要基本驗證的 Proxy 將不再預設成功。如果您需要重新啟動此驗證配置,只要把它從 jdk.HTTP.auth.tunneling.disabledSchemes 網路特性中移除即可。
簡單 Proxy 驗證方法:
若要啟用簡單 Proxy 驗證,請將上方的 NTLM_PROXY_AUTH 欄位設為 N,然後在 CUSTOM_JAVA_OPTIONS 中包含下列參數:
若是 HTTP,指定:-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=80
若是 HTTPS,指定:-Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=443
基本或摘要 Proxy 驗證方法:
若要啟用基本或摘要 Proxy 驗證,請將上方的 NTLM_PROXY_AUTH 欄位設為 N,然後在 CUSTOM_JAVA_OPTIONS 中包含下列參數:
-DproxyHost=proxy.example.com -DproxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword
NTLM Proxy 驗證方法:
若要啟用 NTML Proxy 驗證,請將 NTLM_PROXY_AUTH 設為 Y,然後在 CUSTOM_JAVA_OPTIONS 中包含下列參數:
-DproxyHost=proxy.example.com -DproxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword -DproxyDomain=domain
在 CUSTOM_INTERFACE_CLASS_NAME 中,指定在實作 EpmAgentInterface
的 custom.jar
中,類型的完整名稱。
例如,您可以指定:com.mycompany.agent.implementation.MyImplementation
。
此參數為選擇性參數。
在 CUSTOM_CLASS_PATH 中,指定 jar 檔案的完整路徑和名稱 (例如 C:\AgentDeployment\agenthome\myJarFolder\custom.jar
。
此參數為選擇性參數。
如果您要在 EPM 整合代理程式中,使用 Microsoft Java Database Connectivity (JDBC) 驅動程式來連線至 SQL Server,請參閱在 EPM 整合代理程式中設定 SQL Server 適用的 Microsoft JDBC 驅動程式。
在 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。
在 AMW_IDLE_TIME 中,指定在「自動維護時段 (AMW)」停機時間或未排定維護期間,以非同步模式執行之代理程式的閒置時間值。
AMW_IDLE_TIME 參數值是以分鐘設定,預設值為 15 分鐘。客戶可以定義較長的閒置時間,但不應指定少於 15 分鐘的閒置時間值。AMW 停機時間是對商業程序執行自動維護任務的連續時間間隔。
在 Client_ID 中,輸入「識別網域管理員」設定 OAuth 的行動應用程式時產生的用戶端 ID。它會顯示於一般資訊底下的應用程式「組態」頁籤中。如需詳細資訊,請參閱啟用 EPM 整合代理程式中的 OAUTH 選項。
「識別網域管理員」設定 OAuth 的行動應用程式時會產生用戶端 ID。它會顯示於一般資訊底下的應用程式「組態」頁籤中。
在 ENABLE_AUTO_COMMIT 中,指定自動認可行為。
ENABLE_AUTO_COMMIT 參數能決定每個資料庫作業是否為執行時便認可的交易。此參數能解決部分 JDBC 驅動程式版本 (例如 IBM DB2) 中,代理程式處理期間可能會發生的錯誤,此類驅動程式預設會執行自動認可。
預設值為 N。
在 RETRY_INTERVAL 中,指定一定秒數過後的重試邏輯期間。
預設值為 10 (秒)。
在 FILE_UPLOAD_SIZE 中,依選取的 MB 值指定重複上傳檔案大小。
預設的檔案上傳大小為 50 (MB)。
儲存對 agentparamas.ini
檔案的任何變更。
當您定義了啟動參數時,可以在診斷模式中執行 EPM 整合代理程式,這個方法可讓您在代理程式無法啟動時,識別 EPM 整合代理程式啟動參數或網路連線的任何問題。如需詳細資訊,請參閱在診斷模式中執行 EPM 整合代理程式。