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

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 整合代理程式的日誌層級。

有效的日誌層級包括：
- ALL - 顯示最詳細的層級，並列印所有日誌陳述式。
- INFO - 列印已選取的重要日誌。
- ERROR - 執行最少量的記錄工作，只會列印嚴重錯誤。
系統會把所有日誌寫入 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 驗證方法。

系統支援下列驗證方法：
- 簡單
- 基本
- 摘要
- NTLM
如果您使用 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 整合代理程式。