Essbase unter Windows konfigurieren

Nach der Installation müssen Sie Essbase unter Windows mit dem Konfigurationstool konfigurieren.

Voraussetzungen und Hinweise

• Fusion Middleware muss bereits installiert sein, und Oracle Essbase muss im selben Oracle Home-Verzeichnis installiert sein. Siehe Fusions-Middleware installieren.
• Die unterstützte relationale Datenbank muss installiert werden, wie in den Installationsvoraussetzungen angegeben. Siehe Relationale Datenbank installieren.
• Wenn Sie die EPM Shared Services-Authentifizierung verwenden, muss bereits eine unterstützte Version von EPM installiert sein, wobei EPM-Benutzer Shared Services erstellt und konfiguriert sind und Ihre Details zu Oracle Home- und EPM-Instanz kennen.
  • Wenn Sie die EPM Shared Services-Authentifizierung verwenden, muss diese während der Essbase-Konfiguration ausgeführt werden. Wenn EPM Shared Services nicht ausgeführt wird, müssen einige Portnummern manuell konfiguriert werden, um Portkonflikte zu vermeiden. Wenn Sie Essbase konfigurieren, müssen Sie sich der Ports bewusst sein, die bereits von EPM-Services auf diesem Host verwendet werden. Außerdem müssen Sie nur gültige Ports auswählen und verwenden, die nicht von einem Service oder einer Anwendung auf diesem Host verwendet werden. Sie müssen diese nicht verwendeten Portnummern auch entsprechend in der Benutzeroberfläche oder in der Antwortdatei festlegen.
• Wenn Sie Microsoft SQL Server (MSSQL) als Datenbank für Essbase-Repository-(RCU-)Schemas verwenden, müssen Sie den Prozess zum Ändern der Datenbank und zum Anwenden der korrekten Sortierung und Adressschemas ausführen, bevor Sie das Essbase-Konfigurationstool ausführen. Weitere Informationen finden Sie unter Microsoft SQL Server als Repository-Datenbank für Essbase-Schemas konfigurieren.
• Unter RCU-Schemas für Essbase vorab erstellen wird der Prozess erläutert, wenn Sie RCU-Schemas vor der Konfiguration erstellen, anstatt sie vom Konfigurationstool für Sie erstellen zu lassen. Ein Anwendungsfall für die Voraberstellung von Schemas ist, wenn Sie eine sichere HTTPS-Verbindung mit einem Wallet verwenden.
• Wählen Sie in der Windows-Systemsteuerung > Uhr und Region > Region die Registerkarte Administrativ aus. Klicken Sie auf Gebietsschema des Systems ändern, und wählen Sie das Kontrollkästchen Beta: Unicode UTF-8 für den Support weltweiter Sprachen verwenden.
• Essbase unter Windows kann nicht mehrere Konfigurationen oder Instanzen auf demselben Host haben.

• Sie müssen die folgenden Patches auf dem Oracle Home einspielen, bevor Sie RCU-Schemas erstellen, unabhängig davon, ob Sie vorab erstellte Schemas verwenden. Prüfen Sie die neuesten Patches im Abschnitt "Essbase-Versionshinweise" auf Unabhängiges Deployment, oder wenden Sie sich an den Support, um die entsprechenden Patchversionen zu prüfen.

  • 28186730 - neueste Version von OPatch 13.9.4.2.x für FMW/WLS
  • 31676526 - Patch 12.2.1.4.0 für TNS_ADMIN RCU-Warnung
  • 30540494 - Patch 12.2.1.4.0 für RAC RCU-Bug
  • 30754186 - Patch 12.2.1.4.0 für RAC RCU-Bug
• Alle Ports dürfen sich nicht innerhalb des flüchtigen Portbereichs befinden und dürfen nicht von anderer laufender Software verwendet werden. Siehe Portkonflikte vermeiden.
• Jeder Managed Server muss einem Rechner zugewiesen werden, der logischen Darstellung des Rechners, der eine oder mehrere Serverinstanzen hostet. Der Rechnername muss in Bezug auf andere konfigurierbare Ressourcen in der Domain eindeutig sein.
• Wenn Sie mehrere Essbase-On-Premise-Instanzen installieren und konfigurieren möchten, um Failover zu unterstützen, benötigen Sie einen Frontend-Load Balancer. Die Instanzen müssen auf verschiedenen Hosts konfiguriert werden. Wie bereits erwähnt, kann Essbase unter Windows nicht mehrere Konfigurationen oder Instanzen auf demselben Host haben. Siehe Load Balancer zur Unterstützung von Failover konfigurieren.
• Wenn der Essbase-Service als Essbase-Windows-Service konfiguriert oder verfügbar sein soll, muss sich PowerShell in der PATH-Variablen der Umgebung befinden, um den Essbase-Service zu starten und zu stoppen. Sie müssen auch Essbase Windows Service während der Konfiguration aktivieren, um den Windows Service zu installieren.
• Wenn Sie eine Verbindung über Smart View herstellen und die URL /aps/SmartView verwenden, müssen Sie die URL ändern. Siehe Umleiten zu neuer Essbase Smart View-Verbindungs-URL. Alternativ können Sie die Umleitung zur neuen URL auf dem Webserver konfigurieren. Wenn Sie Oracle HTTP Server (OHS) oder HTTPD Server verwenden, leiten Sie die URL um, während Sie die Oracle HTTP Server-Konfiguration ändern, wie in der vorherigen Aufzählung angegeben.
• Für den Zugriff auf die Antwortdatei und deren Verwendung müssen Sie TEMP- und TMP-Umgebungsvariablen für den Benutzer wie folgt festlegen:
  1. Klicken Sie in der Windows-Taskleiste mit der rechten Maustaste auf das Windows-Symbol, und wählen Sie System aus.
  2. Klicken Sie auf der Seite "Einstellungen" unter dem Header "Zugehörige Einstellungen" auf der rechten Seite auf Systeminformationen, Erweiterte Systemeinstellungen.
  3. Wählen Sie Umgebungsvariablen aus.
  4. Klicken Sie entweder auf Neu, um neue Umgebungsvariablen TEMP und TMP zu erstellen, oder auf Bearbeiten, um vorhandene Umgebungsvariablen TEMP und TMP mit Ihren Benutzervariablenwerten zu ändern. Sie können denselben Wert für beide verwenden.
  5. Öffnen Sie nach dem Festlegen einen neuen Befehl oder eine neue Eingabeaufforderung, um das neue Variablensatz widerzuspiegeln.

Konfigurationstool ausführen

1. Wenn Sie die Konfiguration am Ende der Installation nicht fortgesetzt haben, starten Sie das Konfigurationstool.
   1. Öffnen Sie im Oracle Home-Verzeichnis, in dem Essbase und Fusion Middleware installiert sind, ein Terminal in \essbase\bin. Beispiel: Öffnen Sie ein Terminal in <Oracle_Home>\essbase\bin.
   2. Starten Sie das Konfigurationstool mit dem Befehlsskript config.cmd.

      config.cmd

      Das Skript kann mit Parametern (wie -mode, -log, -log priority, -responseFile) ausgeführt werden. Wenn Sie den Parameter responseFile verwenden, werden alle Felder mit vorherigen Konfigurationseinträgen gefüllt, mit Ausnahme von Kennwörtern. Um mehr über Konfigurationsskriptoptionen zu erfahren, führen Sie config.cmd -help aus.
2. Klicken Sie in der Willkommensseite auf Weiter.
3. Führen Sie auf der Seite "Domaindetails" die folgenden Schritte aus.
   1. Übernehmen Sie die Standardeinstellung (falls korrekt), oder geben Sie Ihren Domainnamen ein. Beispiel: essbase_domain.
   2. Übernehmen Sie den Standardwert (falls zutreffend), oder geben Sie Ihren Domain-Root-Pfad ein. Beispiel:

      C:\Oracle_home\dist\domains

   3. Übernehmen Sie den Standardwert, oder geben Sie das Anwendungsverzeichnis ein. Beispiel:

      C:\Oracle_home\dist\applications\essbase

      Es wird empfohlen, dass das Anwendungsverzeichnis von den Konfigurationsdateien getrennt ist.
   4. Geben Sie den Namen und das Kennwort eines WebLogic-Administratoraccounts ein, den Sie für die Verwaltung von Essbase- und Middleware-Servern verwenden.
      • Wenn Sie WebLogic Embedded LDAP verwenden, erhält dieser Administrator auch eine Essbase-Serviceadministratorrolle.
      • Wenn Sie EPM Shared Services verwenden, gilt dieser Administrator nur für die Essbase-Domaininstanz WebLogic. Dem EPM Shared Services-Admin-Benutzer wird die Essbase-Benutzerrolle "Serviceadministrator" zugewiesen.
   5. Klicken Sie auf Weiter.
4. Führen Sie auf der Seite "Datenbankverbindung" die folgenden Schritte aus.
   1. Akzeptieren Sie den Standardwert, oder geben Sie den Datenbanktyp ein. Dies ist die unterstützte relationale Datenbank, z.B. Oracle Database.
   2. Geben Sie die Verbindungszeichenfolge ein. Beispiel:

      myhost.example.com:1521/orcl

      Siehe Verbindungszeichenfolgenformate.
   3. Wählen Sie aus, ob Sie jetzt neue Schemas erstellen oder vorab erstellte Schemas verwenden möchten, die Sie mit dem RCU-Utility Fusion Middleware in RCU-Schemas für Essbase vorab erstellen als Workflowaufgabe für die Vorkonfiguration erstellt haben. Informationen zur Verwendung von Microsoft SQL Server (MSSQL) in der Konfiguration finden Sie oben in den entsprechenden Voraussetzungen.
   4. Geben Sie ein Schemapräfix ein. Beispiel: ESS26AI. Dies muss eine neue, eindeutige Zeichenfolge sein, die 1-12 alphanumerische Zeichen enthält und mit einem Buchstaben beginnt.
   5. Geben Sie ein Schemakennwort ein, das für alle neuen Schemas freigegeben wird.
   6. Geben Sie als Administratorbenutzernamen und -kennwort die Zugangsdaten aller Benutzer ein, denen eine Sysdba-Rolle für Oracle Database erteilt wurde. Dies kann der standardmäßige sys-Benutzer oder der Microsoft-Datenbankadministrator sein. Der Benutzername muss mit einem Buchstaben beginnen und zwischen 5 und 128 alphanumerische Zeichen enthalten. Das Passwort muss mit einem Buchstaben beginnen, zwischen 8 und 30 Zeichen lang und mindestens eine Zahl und optional einer beliebigen Anzahl an Sonderzeichen ($ # _) enthalten.
   7. Klicken Sie auf Weiter.
5. Führen Sie auf der Seite "Konfiguration von Node Manager" die folgenden Schritte aus.
   1. Akzeptieren Sie die Standardwerte, oder geben Sie die Zeichenfolge für den Node Manager-Rechnernamen ein, der Cluster verarbeitet. Alle Ports dürfen sich nicht innerhalb des flüchtigen Portbereichs befinden und dürfen nicht von anderer laufender Software verwendet werden. Siehe Portkonflikte vermeiden.
   2. Bei der Listening-Adresse von Node Manager können Sie Ihren vollqualifizierten Hostnamen eingeben oder auswählen (wobei WebLogic zusammen mit Ihrer Fusion Middleware-Installation installiert ist). Es kann auch eine Betriebssystemadresse sein. Weitere Informationen finden Sie unter Listening-Adressen konfigurieren.
   3. Klicken Sie auf Weiter.
6. Konfigurieren Sie auf der Seite "Konfiguration von WebLogic-Serverports" entsprechend den Auswahlen, die Sie während der Installation getroffen haben.
   Übernehmen Sie die Standardwerte, oder geben Sie Werte ein. Die Werte im obigen Bildschirm sind nur Beispiele. Geben Sie klare und sichere Ports für jeden Server an. Siehe Serverkonfigurationsoptionen. Alle Ports dürfen sich nicht innerhalb des flüchtigen Portbereichs befinden und dürfen nicht von anderer laufender Software verwendet werden. Siehe Portkonflikte vermeiden.
   1. Um Verbindungen mit Transport Layer Security (TLS Everywhere) zu sichern, aktivieren Sie das Kontrollkästchen Sicherer Verbindungsmodus. Ihr selbstsigniertes Zertifikat wird dann erkannt. Wenn noch nicht geschehen, lesen Sie dieses Thema: Informationen zum Sichern Ihrer Kommunikation und Ihres Netzwerks. Wenn die TLS-Sicherheit bereitgestellt wird, ist der Standardport der sichere Managed Server-Port. Der Standardportwert ist 9000 für nicht gesicherte und 9001 für gesicherte Ports. Es wird empfohlen, "Gesichert" (9001) zu verwenden.

      Wenn Sie Essbase so konfigurieren, dass eine nicht von Oracle stammende relationale Datenbank als RCU-Repository-Datenbank verwendet wird, müssen Sie möglicherweise nach Abschluss des Essbase-Deployments zusätzliche Schritte ausführen, um die ODBC-Treiber Ihres Systems zur Unterstützung der sicheren/TLS-Verschlüsselung zu konfigurieren. Weitere Informationen finden Sie in den Konfigurationsanweisungen für den Datenbanktreiber.

   2. [Optional] Um den Zugriff auf bestimmte Hosts (für Multi-Home-Umgebungen) zu begrenzen, geben Sie in den Listening-Adressfeldern eine Domain an, oder wählen Sie sie aus. Beispiel: localhost. Wenn Sie keine Listening-Adresswerte auswählen/eingeben, gelten die Listening-Adressen für alle Schnittstellen und Adressen, und alle zugeordneten Hosts sind zugänglich.
   3. Klicken Sie auf Weiter.
7. Führen Sie auf der Seite "Konfiguration von Essbase-Ports" die folgenden Schritte aus.
   1. Akzeptieren Sie die Standardwerte, oder geben Sie Werte für den Agent-Port, den sicheren Agent-Port (für sichere Kommunikation mit TLS) und die minimalen und maximalen Ports für Essbase-Anwendungsserver ein.
      • Agent-Port gibt den Port für den Essbase-Agent an. Der Standardwert ist 1423.
      • Der sichere Agent-Port gibt den Port an, den der Essbase-Agent für die sichere Kommunikation verwendet, wenn er sich im sicheren Verbindungsmodus mit Transport Layer Security (TLS) befindet. Der Standardwert ist 6423.
      • Wenn mehrere Essbase Server-Instanzen auf einem Host installiert sind, müssen Sie für jede Instanz eine einmalige Portnummer festlegen.
      • Alle Ports dürfen sich nicht innerhalb des flüchtigen Portbereichs befinden und dürfen nicht von einer anderen laufenden Software verwendet werden. Siehe Portkonflikte vermeiden.
      • Der Bereich zwischen Min- und Max-Ports muss je nach verwendeter Menge mindestens 1000 betragen.
   2. Klicken Sie auf Weiter.
8. Führen Sie auf der Seite "Identitätsprovider-Konfiguration" die folgenden Schritte aus.
   1. Wenn noch nicht geschehen, lesen Sie das Thema Authentifizierungsprovider auswählen.
   2. WebLogic ist die Standardeinstellung. Wenn Sie derzeit EPM Shared Services verwenden und fortfahren möchten, aktivieren Sie das Kontrollkästchen Identitätsprovider für EPM Shared Services aktivieren. Das Fensterbeispiel zeigt den ausgewählten EPM-Provider. Wenn diese Option aktiviert ist, stehen EPM-Felder zur Bestätigung oder Angabe von EPM Oracle Home- und Oracle-Instanz-Verzeichnissen zur Verfügung. Details zu diesen Informationen finden Sie unter Informationen zu Middleware Home, EPM Oracle Home und EPM Oracle-Instanz.
   3. Damit der Essbase-Windows-Service konfiguriert oder verfügbar ist, muss PowerShell in der Umgebungsvariablen PATH enthalten sein, um den Essbase-Service zu starten und zu stoppen. Sie müssen auch Essbase Windows Service während der Konfiguration aktivieren, um den Windows Service zu installieren. Um dieses Feature verwenden zu können, müssen Sie auf dieser Seite Essbase Windows Service aktivieren auswählen, um den Windows-Service zu installieren. Start und Stopp des Essbase-Windows-Service werden mit Windows SCM ausgeführt.
   4. Klicken Sie auf Weiter.
9. Prüfen Sie die Seite "Konfigurationsübersicht". Notieren Sie sich den Speicherort der Logdatei (sofern angezeigt) und den Speicherort der Antwortdatei. Dieses Fensterbeispiel kann von den ausgewählten Einträgen oder Werten abweichen. Mit der Antwortdatei (.rsp) können Sie Ihre Konfigurationsoptionen speichern und dieselben Feldwerte (ohne Kennwörter) in einer zukünftigen UI-basierten oder Silent-Moduskonfiguration eingeben. Wenn Sie eine zukünftige Konfiguration mit einer .rsp-Datei ausführen möchten, können Sie die Konfiguration auch bis zur Übersichtsseite ausführen, auf Abbrechen anstelle von Konfigurieren klicken und die Antwortdatei später wiederverwenden. Die .rsp-Datei wird am temporären Speicherort gespeichert, der in der Zusammenfassung als Speicherort der Antwortdatei aufgeführt ist. Wenn Sie es für die Automatisierung einer zukünftigen Konfiguration verwenden möchten, speichern Sie es an einem dauerhafteren Ort, da tmp-Verzeichnisse routinemäßig bereinigt werden können. Siehe Beispielantwortdatei und -parameter.
10. Klicken Sie auf Konfigurieren. Auf der Seite "Konfigurationsfortschritt" werden am Ende der Verarbeitung des Konfigurationstools die Essbase-Plattformkomponenten gestartet. Wenn der Fortschritt 100% erreicht, klicken Sie auf Weiter.
11. Prüfen Sie auf der Seite "Konfiguration abgeschlossen" die Details, und klicken Sie auf Fertigstellen. Beachten Sie, dass dieses Fensterbeispiel nicht unbedingt Ihre ausgewählten Einträge oder Werte widerspiegelt. Sie können sich jetzt bei Essbase anmelden. Anmelde-URLs finden Sie unter Essbase-, REST- und Smart View-Client-URLs.

    Hinweis:

    Wenn Sie Essbase sicher mit einer externen Datenbank mit einem TNS_ADMIN-Alias konfiguriert haben, z.B. adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS, müssen Sie die folgenden Schritte ausführen, damit die Verbindung vom Essbase-Server verarbeitet werden kann:

    1. Symbol Bearbeiten:

       <DOMAIN_HOME>\bin\setStartupEnv.cmd

    2. Fügen Sie dem Startskript die folgende Zeile vor der Verwendung von -DODBC_URL= hinzu:

       set TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS

    3. Ändern Sie die folgende Zeile:

       -DODBC_URL='OCI;SERVICE=adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS'

       bis

       -DODBC_URL='OCI;SERVICE='adwsql_low'

Erweiterte Optionen und Aufgaben nach der Konfiguration können unter Erweiterte Konfigurationsthemen geprüft werden. Dazu gehören Themen zum Löschen von RCU-Schemas, zum Konfigurieren von Essbase und Oracle HTTP-Server usw.