Startparameter für EPM Integration Agent konfigurieren

Die Startparameter für Ihre Oracle Enterprise Performance Management Cloud-URL und EPM Cloud-Domain für EPM Integration Agent werden in der Datei agentparams.ini definiert.

So konfigurieren Sie die von EPM Integration Agent verwendeten Startparameter:

1. Navigieren Sie zum Verzeichnis C:\EPMAgentData\config.

2. Doppelklicken Sie auf die Datei agentparams.ini, um sie mit einem Texteditor, wie z.B. Notepad, zu öffnen.

   Die Datei agentparams.ini wird als Textdatei geöffnet:

   

3. EPM_AGENT_HOME ist der Name des Homeverzeichnisses des Agents. Dieser Ordner enthält die Ordner "bin" und "lib".

   Wenn Sie createappfolder.bat ausführen, erstellt das Skript den aufgefüllten Parameter EPM_AGENT_HOME automatisch.

   Wenn Sie den Namen des Ordners ändern, werden die Agent-Läufe im neuen Standort und die Dateien im neuen Ordner EPM_APP_DATA_HOME gespeichert.

4. EPM_APP_DATA_HOME ist der Name des Anwendungsdatenordners, der die Ordner "config", "log" und "script" enthält. Der Ordner "config" enthält außerdem einen leeren Zertifikatsordner, der zurzeit nicht verwendet wird.

   Wenn Sie das Skript createappfolder.bat ausführen, wird eine INI-Datei mit dem aufgefüllten Parameter EPM_APP_DATA_HOME erstellt.

5. Geben Sie unter AGENT_NAME einen eindeutigen Namen für EPM Integration Agent an.

   Im Namen können nur Zeichen und Zahlen verwendet werden. Das Feld AGENT_NAME darf keine Symbole oder Leerzeichen enthalten.

6. Geben Sie unter CLUSTER den Namen des Clusters an, zu dem der Agent gehört.

   Im Namen können nur alphanumerische Zeichen verwendet werden. Verwenden Sie keine Sonderzeichen, z.B. @ oder &. Der Name kann nach dem Erstellen des Clusters nicht mehr geändert werden.

   Der standardmäßige Clustername lautet EPMCLUSTER.

   Hinweis:

   Der Clustername muss bereits in der Komponente Datenintegrationdefiniert sein, damit er hier referenziert werden kann. Weitere Informationen finden Sie unter Cluster hinzufügen.

   Dieser Parameter ist erforderlich.

7. Geben Sie unter PORT die Portnummer an, auf der EPM Integration Agent ausgeführt wird.

   Dieser Parameter ist erforderlich.

8. Geben Sie unter CLOUD_URL die EPM Cloud-URL zum Authentifizieren und Starten des Agents an.

   Dies ist die URL der EPM-Instanz, die dem Agent zugeordnet ist, z.B.:

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

   Hinweis:

   Hängen Sie keinesfalls "epmcloud" oder "HyperionPlanning" am Ende von Cloud_URL an.

   Dieser Parameter ist erforderlich.

9. Geben Sie unter CLOUD_DOMAIN den eindeutigen Namen für die EPM Cloud-URL an.

   Eine Identitätsdomain steuert die Accounts von Benutzern, die Zugriff auf Serviceinstanzen benötigen. Außerdem wird mit der Identitätsdomain gesteuert, auf welche Funktionen autorisierte Benutzer zugreifen können. Eine Serviceinstanz gehört zu einer Identitätsdomain.

   Administratoren können den Domainnamen aktualisieren, der dem Benutzer angezeigt wird. In der Komponente Datenmanagement ist jedoch der ursprüngliche Domainname erforderlich, der bei der Registrierung des Benutzers für den Service angegeben wurde. Aliasdomainnamen dürfen beim Einrichten von EPM Cloud-Verbindungen über die Komponente Datenmanagement nicht verwendet werden.

   Hinweis:

   Der CLOUD_DOMAIN-Parameter ist erforderlich, es sei denn, es handelt sich um Gen 2-Datencenter.

10. Geben Sie unter CLOUD_USER_NAME den Benutzernamen des Administrators der EPM Cloud-Umgebung an.

    Der Benutzername muss für einen nativen Benutzer stehen und darf kein SSO-Benutzername sein.

    Dieser Parameter ist erforderlich.

11. Geben Sie unter CLOUD_PASSWORD die verschlüsselte Zeichenfolge für das Kennwort des Administratorbenutzers an.

    Sie können das Kennwort für den EPM Cloud-Benutzer verschlüsseln und die Zeichenfolge für das verschlüsselte Kennwort abrufen, indem Sie encryptpassword.bat (für Windows) oder encryptpassword.sh (für Linux) ausführen. Weitere Informationen finden Sie unter EPM Cloud-Benutzerkennwörter verschlüsseln.

    Dieser Parameter ist erforderlich.

12. Geben Sie unter LOG_LEVEL die lokale Logebene für EPM Integration Agent an.

    Folgende Logebenen sind gültig:

    • ALLE - Zeigt die detaillierteste Ebene an und druckt alle Loganweisungen.
    • INFO - Druckt wichtige ausgewählte Logs.
    • FEHLER - Führt minimales Logging durch, nur schwerwiegende Fehler werden gedruckt.

    Alle Logs werden in eine Datei im Ordner APPDATA_HOME\logs geschrieben.

    Dieser Parameter ist optional. Die standardmäßige Logebene lautet Alle.

13. Geben Sie unter POLL_INTERVAL das Intervall für die Wartezeit sowie das Polling-Intervall im asynchronen Modus an.

    Das Zeitintervall wird in Sekunden angegeben. Das Standardzeitintervall liegt bei 120 Sekunden.

14. Geben Sie unter REGISTER_WITH_IP den Wert N an, um den Agent mit dem Hostnamen zu registrieren. Geben Sie Y an, um den Agent mit der IP-Adresse zu registrieren.

    Dieser Parameter ist optional.

15. Geben Sie unter EXECUTION_POOL_SIZE an, wie viele Jobs parallel ausgeführt werden können.

    Die Standardpoolgröße für die Ausführung beträgt 2.

    Dieser Parameter ist optional.

16. Geben Sie unter JYTHON_HOME das Verzeichnis der obersten Ebene an, in dem Jython installiert ist.

    Dies ist nur erforderlich, wenn Jython als Skriptsprache verwendet wird.

17. Geben Sie unter GROOVY_HOME das Verzeichnis der obersten Ebene an, in dem Groovy installiert ist.

    Dies ist nur erforderlich, wenn Groovy als Skriptsprache verwendet wird.

18. Geben Sie unter CUSTOM_MEM_ARGS die Variable zum Überschreiben des Standardspeicherarguments an, das mit einem benutzerdefinierten Speicherargument an Java übergeben wurde.

    Beispiel: Im Parameter CUSTOM_MEM_ARGS=-Xms128m -Xmx4096m liegt die initiale Mindestspeichergröße bei 128 MB, und die Höchstspeichergröße beträgt 4096 MB.

    Dieser Parameter ist optional.

19. Geben Sie unter CUSTOM_JAVA_OPTIONS zusätzliche Java Runtime-Parameter an.

    Die CUSTOM_JAVA_OPTIONS-Einstellung kann auch so konfiguriert werden, dass EPM Integration Agent eine Proxyauthentifizierungsmethode verwendet.

    Das System unterstützt die folgenden Authentifizierungsmethoden:

    • Einfach
    • Basis
    • Digest
    • NTLM

    Wenn Sie eine Proxyauthentifizierungsmethode verwenden, geben Sie den Proxyhostnamen, den Proxyport, den Proxybenutzernamen und das verschlüsselte Kennwort in diesem Feld basierend auf der Proxyauthentifizierungsmethode an.

    Wenn der Proxy eine Basisauthentifizierung verwendet, legen Sie CUSTOM_JAVA_OPTIONS wie folgt fest:

    -Djdk.http.auth.tunneling.disabledSchemes=""

    Hinweis:

    Das Basisauthentifizierungsschema wurde standardmäßig in Oracle Java Runtime deaktiviert, wenn Sie für die Netzwerkeigenschaft jdk.http.auth.tunneling.disabledSchemes die Option "Standard" hinzugefügt haben. Dies hat zur Folge, dass Proxys, die beim Einrichten eines Tunnels für HTTPS eine Basisauthentifizierung verlangen, nicht mehr standardmäßig erfolgreich sind. Bei Bedarf kann dieses Authentifizierungsschema reaktiviert werden, indem Sie es aus der Netzwerkeigenschaft "jdk.http.auth.tunneling.disabledSchemes" entfernen.

    Einfache Proxyauthentifizierungsmethode:

    Um die einfache Proxyauthentifizierungsmethode zu aktivieren, setzen Sie NTLM_PROXY_AUTH oben auf N, und fügen Sie die folgenden Parameter unter CUSTOM_JAVA_OPTIONS hinzu:

    Geben Sie für HTTP Folgendes an: -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=80

    Geben Sie für HTTPS Folgendes an: -Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=443

    Basis- oder Digest-Proxyauthentifizierungsmethode:

    Um die Basis- oder Digest-Proxyauthentifizierungsmethode zu aktivieren, setzen Sie NTLM_PROXY_AUTH oben auf N, und fügen Sie die folgenden Parameter unter CUSTOM_JAVA_OPTIONS hinzu:

    -DproxyHost=proxy.example.com -DproxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword

    NTLM-Proxyauthentifizierungsmethode:

    Um die NTML-Proxyauthentifizierungsmethode zu aktivieren, setzen Sie NTLM_PROXY_AUTH auf Y, und fügen Sie die folgenden Parameter unter CUSTOM_JAVA_OPTIONS: hinzu:

    -DproxyHost=proxy.example.com -DproxyPort=8080 -DproxyUser=username -DproxyPassword=encryptedpassword -DproxyDomain=domain

20. Geben Sie unter CUSTOM_INTERFACE_CLASS_NAME den vollqualifizierten Klassennamen der Klasse in custom.jar an, die EpmAgentInterface implementiert.

    Beispiel: Geben Sie Folgendes an: com.mycompany.agent.implementation.MyImplementation.

    Dieser Parameter ist optional.

21. Geben Sie unter CUSTOM_CLASS_PATH den vollständigen Pfad und den Namen der JAR-Datei an (z.B. C:\AgentDeployment\agenthome\myJarFolder\custom.jar).

    Dieser Parameter ist optional.

    Informationen zum Verwenden eines Microsoft Java Database Connectivity-(JDBC-)Treibers zum Verbinden mit SQL Server in EPM Integration Agent finden Sie unter Microsoft JDBC-Treiber für SQL Server in EPM Integration Agent konfigurieren.

22. Geben Sie in NTLM_PROXY_AUTH den Wert Y an, um eine NTLM-Proxyauthentifizierungsmethode zu verwenden.

    Wenn Sie eine NTLM-Proxyauthentifizierung verwenden, müssen Sie zusätzlich Proxyparameter in CUSTOM_JAVA_OPTIONS angeben.

    Geben Sie N an, um eine Basis- oder Digestproxyauthentifizierung zu verwenden bzw. wenn Sie keine Proxyauthentifizierung verwenden.

    Hinweis:

    Legen Sie JYTHON_HOME oder GROOVY_HOME fest, wenn Sie Jython oder Groovy für das Skripting verwenden möchten.

    Legen Sie CUSTOM_JAVA_OPTIONS und CUSTOM_INTERFACE_CLASS fest, wenn Sie benutzerdefiniertes Java für Ihre Erweiterungen verwenden möchten.

23. Geben Sie unter AMW_IDLE_TIME den Leerlaufzeitwert für Agents an, die während einer Ausfallzeit des automatischen Wartungsfensters (AMW, Automated Maintenance Window) oder einer ungeplanten Wartung im asynchronen Modus ausgeführt werden.

    Der Parameterwert AMW_IDLE_TIME wird in Minuten festgelegt. Die Standardeinstellung ist 15 Minuten. Kunden können eine längere Ausfallzeit definieren, sollten aber keinen Wert unter 15 Minuten angeben. Die AMW-Ausfallzeit ist ein zusammenhängendes Zeitintervall, in dem automatisierte Aufgaben für einen Geschäftsprozess ausgeführt werden.

24. Geben Sie im Feld Client_ID die Client-ID ein, die generiert wird, wenn der Identitätsdomainadministrator die App für OAuth konfiguriert. Sie kann in der Registerkarte "Konfiguration" der Anwendung unter Allgemeine Informationen angezeigt werden. Weitere Informationen finden Sie unter Die OAUTH-Option in EPM Integration Agent aktivieren.

    Die Client-ID wird bei der Konfiguration der App für OAuth durch den Identitätsdomainadministrator generiert. Sie kann in der Registerkarte "Konfiguration" der Anwendung unter Allgemeine Informationen angezeigt werden.

25. Geben Sie unter ENABLE_AUTO_COMMIT das Verhalten für automatisches Festschreiben an.

    Der Parameter ENABLE_AUTO_COMMIT bestimmt, ob es sich bei allen Datenbankvorgängen um Transaktionen handelt, die beim Ausführen festgeschrieben werden. Dieser Parameter behebt Fehler, die bei manchen Versionen des JDBC-Treibers (z.B. IBM DB2), der standardmäßig das automatische Festschreiben durchführt, während der Agent-Verarbeitung auftreten können.

    Der Standardwert ist N.

26. Geben Sie unter RETRY_INTERVAL die Wiederholungslogikperiode in Sekunden an.

    Der Standardwert ist 10 (Sekunden).

27. Geben Sie unter FILE_UPLOAD_SIZE die Größe des Dateiuploads in Iteration durch einen ausgewählten Megabyte-(MB-)Wert an.

    Die Größe des Dateiuploads ist standardmäßig 50 (MB).

28. Speichern Sie alle Änderungen in der Datei agentparamas.ini.

    Wenn Sie die Startparameter definiert haben, können Sie EPM Integration Agent im Diagnosemodus ausführen. So können Sie Probleme mit den Startparametern von EPM Integration Agent oder Probleme mit der Netzwerkkonnektivität erkennen, wenn der Agent nicht gestartet werden kann. Weitere Informationen finden Sie unter EPM Integration Agent im Diagnosemodus ausführen.