Windows上のEssbaseの構成

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

前提条件と注意事項

• Fusion Middlewareがすでにインストールされ、同じOracleホーム・ディレクトリにOracle Essbaseがインストールされている必要があります。「Fusion Middlewareのインストール」を参照してください。
• インストールの前提条件に記載されているように、サポート対象のリレーショナル・データベースがインストールされている必要があります。「リレーショナル・データベースのインストール」を参照してください。
• EPM Shared Services認証を使用する場合は、サポート対象バージョンのEPMがすでにインストールされており、EPMユーザーによってEPM Shared Servicesが作成され構成されており、OracleホームとEPMインスタンスの詳細を把握している必要があります。
  • EPM Shared Services認証を使用する場合は、Essbase構成の間にそれが実行されている必要があります。EPM Shared Servicesが実行されていない場合は、一部のポート番号を、ポートの競合を回避するように手動で構成する必要があります。Essbaseを構成するときは、このホスト上のEPMサービスによってすでに使用されているポートに注意する必要があり、このホスト上のサービスまたはアプリケーションによって使用されていない有効なポートのみを選択し使用する必要があります。これらの未使用のポート番号は、ユーザー・インタフェースまたはレスポンス・ファイル内でも適宜設定する必要があります。
  • 21.2.1より前のEssbase 21cバージョンを使用している場合は、本番のEPMインスタンスから分離されている空のEPM Foundation Servicesインスタンスを使用してください。Essbaseの構成と実行を行う際、EPMサーバーが実行されている必要があります。ユーザー管理ディレクトリ・サービスを両方のFoundation Shared Servicesデプロイメントに接続できます。また、両方のShared Servicesインスタンスでアプリケーションのプロビジョニングを管理する必要があります。
  • Essbase 21.2.1よりも前のバージョンでは、個別のEPM Foundationのインストールが必要でした。
  • Essbase 21.2.1以降のバージョンの場合は、既存のEPM 11.2.x (11.2.x Essbaseを含む)をインストールするか再利用して21.2.xで構成します。
• 構成でMicrosoft SQL Server (MSSQL)を使用する場合は、データベースを変更し、適切な照合順序を適用し、スキーマの考慮事項に対応するプロセスを実行する必要があります。「メタデータ・サービス・スキーマ用のMicrosoft SQL Serverデータベースの構成」を参照してください。
• Essbase用のRCUスキーマの事前作成では、RCUスキーマを構成ツールに作成させるのではなく、構成前に自分で作成することを選択した場合のプロセについて説明しています。スキーマを事前作成する場合の一例としては、ウォレットを使用してセキュアなHTTPS接続を採用する場合です。
• Windowsで、「コントロール パネル」→「時計と地域」→「地域」から「管理」タブを選択します。「システム ロケールの変更」をクリックして、「ベータ: ワールドワイド言語サポートでUnicode UTF-8を使用」チェック・ボックスを選択します。
• Windows上のEssbaseは、同一ホストに複数の構成またはインスタンスを保持できません。

• RCUスキーマを作成する前に、事前作成するスキーマを使用するかどうかを問わず、Oracleホームで次のパッチを適用する必要があります。独立デプロイメント用の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\user_projects\domains

      追加のEssbaseインスタンスをインストールする場合は、それぞれに別のドメイン・ルートを使用します。
   3. デフォルト値をそのまま使用するか、アプリケーション・ディレクトリを入力します。次に例を示します。

      C:\Oracle_home\dist\user_projects\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. 新しいスキーマを今すぐ作成するか、事前作成したスキーマ(事前構成ワークフロー・タスクとして、Essbase用のRCUスキーマの事前作成でFusion MiddlewareのRCUユーティリティを使用して作成したもの)を使用するかを選択します。構成でMicrosoft SQL Server (MSSQL)を使用している場合は、上述の関連する前提条件を参照してください。
   4. スキーマの接頭辞を入力します。たとえば、ESS21Cなどです。これは新しい固有の文字列にする必要があります。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)を使用することをお薦めします。
   2. Essbase Administration Servicesを使用してアプリケーションを管理するには、EASの有効化 | Enable EASを選択します。デフォルトでは、EASサーバー・ポート | EAS Server Portが9100、EASサーバー・セキュア・ポート | EAS Server Secure Portが9101です。EASの入力フィールドは、EASの有効化 | Enable EASが選択されている場合に使用できます。
   3. [オプション]アクセスの対象を特定のホストに制限するには、ドメインを指定または選択します(複数ホーム環境の場合)。たとえば、リスニング・アドレスのフィールドにlocalhostを指定します。リスニング・アドレスの値を選択または入力しない場合、リスニング・アドレスはすべてのインタフェースとアドレスに適用され、マッピングされたすべてのホストがアクセスできるようになります。
   4. 「次」をクリックします。
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 OracleホームとOracleインスタンスの場所を確認または指定するためEPMフィールドが使用できるようになります。これらについて詳しくは、ミドルウェア・ホーム、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'

       変更後:

       -DODBC_URL='OCI;SERVICE='adwsql_low'

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