Windows上のEssbaseの構成

Windows上のEssbaseは、インストール後に構成ツールを使用して構成できます。

前提条件およびノート

• Fusion Middlewareがすでにインストールされ、同じOracleホーム・ディレクトリにOracle Essbaseがインストールされている必要があります。「Fusion Middlewareのインストール」を参照してください。
• インストールの前提条件に記載されているように、サポート対象のリレーショナル・データベースがインストールされている必要があります。「リレーショナル・データベースのインストール」を参照してください。
• EPM Shared Services認証を使用している場合は、EPMユーザーShared Servicesを作成して構成し、Oracle HomeおよびEPMインスタンスの詳細を確認して、サポートされているバージョンのEPMがすでにインストールされている必要があります。
  • EPM Shared Services認証を使用する場合は、Essbaseの構成時に実行する必要があります。EPM Shared Servicesが実行されていない場合は、ポートの競合を回避するために、いくつかのポート番号を手動で構成する必要があります。Essbaseを構成する場合、このホスト上の任意のEPMサービスによってすでに使用されているポートに注意し、このホスト上のサービスまたはアプリケーションによって使用されていない有効なポートのみを選択および使用する必要があります。また、これらの未使用のポート番号は、ユーザー・インタフェースまたはレスポンス・ファイルで適切に設定する必要があります。
• Microsoft SQL Server (MSSQL)をEssbaseリポジトリ(RCU)スキーマのデータベースとして使用している場合は、Essbase構成ツールを実行する前に、プロセスを実行してデータベースを変更し、正しい照合を適用し、スキーマに関する考慮事項に対処する必要があります。詳細は、「Essbaseスキーマのリポジトリ・データベースとしてのMicrosoft SQL Serverの構成」を参照してください。
• Essbase用のRCUスキーマの事前作成では、構成前にRCUスキーマを事前作成することを選択し、構成ツールで自分で作成することを選択した場合のプロセスについて説明しています。スキーマを事前作成する場合の一例としては、ウォレットを使用してセキュアなHTTPS接続を採用する場合です。
• Windowsで、「コントロール パネル」→「時計と地域」→「地域」から「管理」タブを選択します。「システム ロケールの変更」をクリックして、「ベータ: ワールドワイド言語サポートでUnicode UTF-8を使用」チェック・ボックスを選択します。
• Windows上のEssbaseは、同一ホストに複数の構成またはインスタンスを保持できません。

• RCUスキーマを作成する前に、事前作成されたスキーマを使用するかどうかに関係なく、Oracle Homeに次のパッチを適用する必要があります。独立デプロイメントのEssbaseリリース・ノート・セクションで最新のパッチを確認するか、サポートに連絡して適切なパッチ・バージョンを確認してください。

  • 28186730 - FMW/WLSのOPatch 13.9.4.2.xの最新バージョン
  • 31676526 - パッチ12.2.1.4.0 (TNS_ADMIN RCUの警告用)
  • 30540494 - パッチ12.2.1.4.0(RAC RCUバグ用)
  • 30754186 - パッチ12.2.1.4.0(RAC RCUバグ用)
• すべてのポートはエフェメラル・ポートの範囲内であり、他の実行中ソフトウェアによって使用されていない必要があります。ポート競合の回避を参照してください。
• 各管理対象サーバーは、1つ以上のサーバー・インスタンスをホストするコンピュータを論理的に表現したマシンに割り当てられている必要があります。マシン名は、ドメイン内の他の構成可能リソースの間で固有である必要があります。
• フェイルオーバーをサポートするために、複数のEssbase On-Premiseインスタンスをインストールおよび構成することを計画している場合は、フロントエンドのロード・バランサが必要であり、インスタンスは別々のホストで構成する必要があります。前述したように、Windows上のEssbaseは、同一ホストに複数の構成またはインスタンスを保持できません。フェイルオーバーをサポートするためのロード・バランサの構成を参照してください。
• Essbase WindowsサービスとしてEssbaseサービスを構成する場合や使用可能にする場合は、Essbaseサービスの開始および停止のために、PATH環境変数にPowerShellが含まれている必要があります。また、Windowsサービスをインストールするには、構成時にEssbase Windowsサービスを有効にすることも必要です。
• /aps/SmartViewというURLを使用してSmart View経由で接続する場合は、このURLを変更する必要があります。新しいEssbase Smart View接続URLへのリダイレクトを参照してください。あるいは、Webサーバーで新規URLへのリダイレクトを構成できます。Oracle HTTP Server (OHS)またはHTTPDサーバーを使用する場合は、前項に記載されているように、Oracle HTTP Server構成の変更時にURLがリダイレクトされます。
• レスポンス・ファイルにアクセスして使用する場合は、次のようにして、ユーザーのTEMP環境変数とTMP変数を設定する必要があります。
  1. Windowsのタスク・バーで、Windowsアイコンを右クリックして「システム」を選択します。
  2. 「設定」ページの右側にある「関連設定」ヘッダーの下で、「システム情報」をクリックし、「システムの詳細設定」をクリックします。
  3. 「環境変数」を選択します。
  4. 「新規」をクリックして新しい環境変数TEMPおよびTMPを作成するか、「編集」をクリックして既存の環境変数TEMPおよびTMPを目的のユーザー変数の値に変更します。どちらにも同じ値を使用できます。
  5. 設定後に、新しいcmdまたはコマンド・プロンプトを開いて、新しい変数のセットを反映させます。

設定ツールを実行

1. インストールの最後に続けて構成を行わなかった場合は、構成ツールを起動します。
   1. EssbaseとFusion MiddlewareがインストールされているOracleホーム・ディレクトリで、\essbase\binのターミナルを開きます。たとえば、<Oracle_Home>\essbase\binのターミナルを開きます。
   2. config.cmdコマンド・スクリプトを使用して、構成ツールを起動します。

      config.cmd

      このスクリプトは、パラメータ(-mode、-log、-log priority、-responseFileなど)を指定して実行できます。responseFileパラメータを使用する場合、パスワードを除くすべてのフィールドに以前の構成エントリが入力されます。構成スクリプトのオプションについて調べるには、config.cmd -helpを実行します。
2. ようこそページで「次へ」をクリックします。
3. ドメインの詳細 | Domain Detailsページで、次の操作を行います。
   1. デフォルト値をそのまま使用する(正しい場合)か、ドメイン名を入力します。たとえば、essbase_domainと入力します。
   2. デフォルト値をそのまま使用する(正しい場合)か、ドメインのルート・パスを入力します。次に例を示します。

      C:\Oracle_home\dist\domains

   3. デフォルト値を受け入れるか、アプリケーション・ディレクトリを入力します。次に例を示します。

      C:\Oracle_home\dist\applications\essbase

      アプリケーション・ディレクトリは構成ファイルとは別個にすることをお薦めします。
   4. Essbaseとミドルウェア・サーバーの管理に使用するWebLogic管理者アカウントの名前とパスワードを入力します。
      • WebLogic組込みLDAPを使用する場合、この管理者にはEssbaseサービス管理者ロールも付与されます。
      • EPM Shared Servicesを使用する場合、この管理者はEssbaseドメインのWebLogicインスタンス専用です。EPM Shared Services管理者ユーザーは、Essbaseユーザー・ロール「サービス管理者」でプロビジョニングされます。
   5. 「次へ」をクリックしてください。
4. 「データベース接続」ページで、次の操作を行います。
   1. デフォルト値をそのまま使用するか、データベース・タイプを入力します。これはサポート対象のリレーショナル・データベースです。たとえば、Oracle Databaseなどです。
   2. たとえば、接続文字列を入力します。

      myhost.example.com:1521/orcl

      接続文字列の形式を参照してください。
   3. Choose whether to create new schemas now, or use pre-created schemas that you built using Fusion Middleware RCU utility in Pre-create RCU Schemas for Essbase, as a pre-configuration workflow task. 構成でMicrosoft SQL Server (MSSQL)を使用している場合は、上述の関連する前提条件を参照してください。
   4. スキーマの接頭辞を入力します。たとえば、ESS26AIなどです。これは新しい固有の文字列にする必要があります。1-12文字の英数字を含め、始まりは文字からにします。
   5. スキーマのパスワードを入力します。このパスワードは、すべての新しいスキーマに共有されます。
   6. 管理者のユーザー名とパスワードに、Oracle Databaseのsysdbaロールが付与されている任意のユーザーの資格証明を入力します。これはデフォルトのsysユーザーか、Microsoftのデータベース管理者にすることができます。ユーザー名は文字で始まる必要があり、5から128字の英数字を含めます。パスワードには、文字で始まり、8から30文字の間の長さ、少なくとも1つの数字、およびオプションで任意の数の特殊文字($ # _)が含まれている必要があります。
   7. 「次へ」をクリックしてください。
5. 「ノード・マネージャ」構成ページで、次の操作を行います。
   1. デフォルト値をそのまま使用するか、クラスタを管理するノード・マネージャのマシン名の文字列を入力します。すべてのポートはエフェメラル・ポートの範囲内であり、他の実行中ソフトウェアによって使用されていない必要があります。ポート競合の回避を参照してください。
   2. 「ノード・マネージャ・リスニング・アドレス」では、ホスト(Fusion MiddlewareのインストールとともにWebLogicがインストールされている場所)の完全修飾名を入力または選択できます。オペレーティング・システムのアドレスにすることもできます。参考資料については、リスニング・アドレスの構成を参照してください。
   3. 「次へ」をクリックしてください。
6. WebLogicサーバー・ポート | WebLogic Server Ports構成ページで、インストール時の選択に応じて構成します。
   デフォルト値を受け入れるか、値を入力します。前述の画面の値は単なる例です。それぞれのサーバーにクリア・ポートとセキュア・ポートを指定します。サーバー構成のオプションを参照してください。すべてのポートはエフェメラル・ポートの範囲内であり、他の実行中ソフトウェアによって使用されていない必要があります。ポート競合の回避を参照してください。
   1. Transport Layer Security (TLS Everywhere)を使用して接続を保護するには、セキュア接続モード | Secure Connection Modeのチェック・ボックスを選択します。すると、自己署名証明書が認識されます。まだの場合は、通信とネットワークの保護についてのトピックを確認してください。TLSセキュリティがデプロイされている場合、デフォルト・ポートは管理対象サーバー・セキュア・ポートです。デフォルトのポート値は、非セキュアの場合は9000、セキュアの場合は9001です。保護されている(9001)ことをお薦めします。

      Oracle以外のリレーショナル・データベースをRCUリポジトリ・データベースとして使用するようにEssbaseを構成する場合、Essbaseのデプロイメントの完了後に、システムのODBCドライバを構成してセキュア/TLS暗号化をサポートするように追加のステップを実行する必要がある場合があります。データベース・ドライバの構成手順を参照してください。

   2. [オプション]アクセスの対象を特定のホストに制限するには、ドメインを指定または選択します(複数ホーム環境の場合)。たとえば、リスニング・アドレスのフィールドにlocalhostを指定します。リスニング・アドレスの値を選択または入力しない場合、リスニング・アドレスはすべてのインタフェースとアドレスに適用され、マッピングされたすべてのホストがアクセスできるようになります。
   3. 「次へ」をクリックしてください。
7. Essbaseポート | Essbase Ports構成ページで、次の操作を行います。
   1. デフォルト値をそのまま使用するか、エージェント・ポート、エージェント・セキュア・ポート(TLSを使用したセキュア通信に使用)、およびEssbaseアプリケーション・サーバーの最小ポートと最大ポートを入力します。
      • 「エージェント・ポート」はEssbaseエージェントのポートを指定します。デフォルト値は1423です。
      • エージェント・セキュア・ポート | Agent Secure Portは、Transport Layer Security (TLS)によるセキュア接続モードの場合にEssbaseエージェントがセキュア通信のために使用するポートを指定します。デフォルトは6423です。
      • 1つのホストに複数のEssbaseサーバー・インスタンスがインストールされている場合は、インスタンスごとに固有のポート番号を指定する必要があります。
      • すべてのポートはエフェメラル・ポートの範囲内であり、他の実行中ソフトウェアによって使用されてはなりません。ポート競合の回避を参照してください。
      • 最小ポートと最大ポートとの範囲は、使用量に応じて少なくとも1000は必要があります。
   2. 「次へ」をクリックしてください。
8. アイデンティティ・プロバイダ | Identity Provider構成ページで、次の操作を行います。
   1. まだの場合は、認証プロバイダの選択のトピックを確認してください。
   2. WebLogicがデフォルトです。現在、EPM Shared Servicesを使用していて、引き続き使用する必要がある場合は、EPM Shared Servicesアイデンティティ・プロバイダの有効化 | Enable EPM Shared Services Identity Providerチェック・ボックスを選択します。上のウィンドウの例では、EPMプロバイダが選択されています。有効にすると、EPMフィールドを使用して、EPM Oracle HomeおよびOracle Instanceの場所を確認または指定できます。これらについて詳しくは、ミドルウェア・ホーム、EPM OracleホームおよびEPM Oracleインスタンスについてを参照してください。
   3. Essbase Windowsサービスを構成する場合や使用可能にする場合は、Essbaseサービスを開始および停止するために、環境変数PATHにPowerShellが含まれている必要があります。また、Windowsサービスをインストールするには、構成時にEssbase Windowsサービスを有効にすることも必要です。この機能を使用するには、Windowsサービスをインストールするために、このページでEssbase Windowsサービスを有効にするを選択する必要があります。Essbase Windowsサービスの開始および停止には、Windows SCMを使用します。
   4. 「次へ」をクリックしてください。
9. 「構成のサマリー」ページを確認します。ログ・ファイルの場所(表示されている場合)とレスポンス・ファイルの場所をメモに取ります。このウィンドウの例は、選択したエントリや値に応じて異なります。 レスポンス・ファイル(.rsp)は、構成の選択内容を保存し、今後のUIベースでの構成やサイレント・モードでの構成で同じフィールド値(パスワードを除く)を入力するために使用できます。今後の構成を.rspファイルを使用して実行する場合は、構成をサマリー・ページまで実行し、「構成」ではなく「取消」をクリックして、後で応答ファイルを再利用することもできます。.rspファイルは、サマリーに「レスポンス・ファイルの場所」として記載されている一時的な場所に保存されています。今後の構成の自動化に使用する予定がある場合、tmpディレクトリは定期的にクリーン・アウトされる可能性があるため、より永続的な場所に保存してください。サンプル応答ファイルとパラメータを参照してください。
10. 「構成」をクリックします「構成の進行状況」ページでは、構成ツールのプロセスの終わり近くに、Essbaseプラットフォーム・コンポーネントが起動されます。進行状況が100%に達したら、「次へ」をクリックします。
11. 構成の完了 | Configuration Completeページで、詳細を確認し、「終了」をクリックします。このウィンドウの例は、ユーザーが選択したエントリや値を反映しているわけでないのでご注意ください。この時点で、Essbaseにログインできます。ログインURLについては、Essbase、RESTおよびSmart ViewのクライアントのURLを参照してください。

    ノート:

    TNS_ADMIN別名(adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWSなど)を使用して外部データベースでEssbaseを安全に構成した場合は、Essbaseサーバーで接続を処理できるように、次の操作を実行する必要があります。

    1. 編集:

       <DOMAIN_HOME>\bin\setStartupEnv.cmd

    2. -DODBC_URL=の使用前に、起動スクリプトに次の行を追加します。

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

    3. 以下の行を変更します。

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

       to

       -DODBC_URL='OCI;SERVICE='adwsql_low'

詳細設定や構成後のオプションやタスクは、詳細構成のトピックで確認できます。RCUスキーマの削除やEssbaseおよびOracle HTTPサーバーの構成などのトピックがあります。