Java Webアプリケーションの手動配置

EPM System Java Webアプリケーションを手動で配置するには:

  1. 次のコマンドを使用してEPM Systemコンフィグレータを起動し、「Webサーバーの構成」タスクを除くすべての必須構成タスクを実行します。なお、「アプリケーション・サーバーへの配置」タスクは使用できません。

    Windows:

    EPM_ORACLE_HOME/common/config/
    version_number/configtool-manual.bat

    UNIX:

    EPM_ORACLE_HOME/common/config/
    version_number/configtool-manual.sh

    このコマンドを使用してEPM Systemコンフィグレータを起動すると、Java Webアプリケーションの配置タスクが非表示になり、Shared Servicesへの製品登録タスクがスキップされます。

    新しい配置でのEPM System製品の構成を参照してください。

  2. 分散環境の各マシンで手順1を繰り返します。

  3. Fusion Middleware構成ウィザードを起動します: コマンド・ラインで、ディレクトリをMIDDLEWARE_HOME/oracle_common/common/binに変更し、config.cmd (Windows)またはconfig.sh (UNIX)を起動します。

  4. 「新しいWebLogicドメインの作成」を選択し、「次へ」をクリックします。

    注意:

    EPM System製品はすべて同じドメインに配置する必要があります。任意のEPM System製品がすでに配置されている場合、「既存のWebLogicドメインの拡張」を選択します。また、Financial Close Managementを使用している場合は、EPM SystemおよびOracle SOA Suiteを同じドメインに配置する必要があります。Oracle SOA Suiteがすでに構成されている場合、「既存のWebLogicドメインの拡張」を選択してEPM System製品を同じドメインに配置します。

    ミドルウェア・ホームにインストールされているすべてのJava Webアプリケーションがリストに表示されます。EPM System製品の場合、EPM Systemインストーラでのインストール時にインストールされた構成テンプレートからリストが生成されます。

  5. 「次の製品をサポートするために、自動的に構成されたドメインを生成する」を選択し、配置するEPM System Java Webアプリケーションを選択してから、「次へ」をクリックします。

    すべてのJava Webアプリケーションを同時に構成することをお薦めします。

  6. ドメイン名と場所を入力し、「次へ」をクリックします。

    デフォルトでは、ドメインの場所は、MIDDLEWARE_HOME/user_projects/domainsです。

  7. ドメイン管理者のユーザー名とパスワードおよびドメインの説明を入力し、「次」をクリックします。

  8. WebLogicドメインの起動モード(開発または本番)を選択し、使用するJDKを指定して、「次へ」をクリックします。

    本番モードを選択する必要があります。OracleではデフォルトのJDKを選択することをお薦めします。

  9. JDBCデータ・ソースを構成し、「次へ」をクリックします。

    Java Webアプリケーションごとに、EPM Systemコンフィグレータでのデータベース構成時に入力したデータベース接続情報を指定します。

    製品ごとに異なるデータベースを構成した場合は、Java Webアプリケーションごとに個別にデータベース接続情報を入力します。Java Webアプリケーションを選択し、接続情報を入力します。

    ヒント:

    EPMSystemRegistryはShared Servicesとレジストリ・データベースです。

    構成ウィザードにより、データベース接続がテストされます。

  10. 接続結果ログを確認し、「次へ」をクリックします。

  11. 「管理対象サーバー、クラスタ、およびマシン」「管理対象サーバーの構成」パネルで、デフォルトのリスニング・ポートを確認し、オプションでこれらを変更します。デフォルト・ポートのリストについては、ポートを参照してください。

    注意:

    ポートをデフォルトから変更する場合、MIDDLEWARE_HOME/user_projects/domains/EPMSYstem/binにある停止スクリプトのポートも変更する必要があります。

  12. 分散環境の場合、管理対象サーバー、クラスタおよびマシンマシンの構成パネルで、配置内のマシンごとにマシンを作成します。

  13. 各管理対象サーバーをマシンに割り当てます。

  14. (オプション)「管理対象サーバー、クラスタ、およびマシン」「クラスタの構成」パネルで、クラスタを設定できます。また、配置を完了した後にクラスタを設定することもできます。Java Webアプリケーション・サーバー・クラスタリングの詳細は、『Oracle Enterprise Performance Management System配置オプション・ガイド』WebLogic手動配置でのJava Webアプリケーションのクラスタリングに関する項を参照してください。

  15. 構成の要約を確認し、「作成」をクリックしてドメインを作成してから、Java Webアプリケーションを配置します。

    Java Webアプリケーションがオフライン・モードで配置されます。

  16. 分散環境の場合:

    1. 配置内の各マシンでノード・マネージャを起動します。

    2. WebLogic管理サーバー・マシンで、作成したドメインをパックします。

    3. 配置内の各マシンにパックをコピーします。

    4. 配置内の各マシンでアンパックします。

    WebLogic Serverにより、配置内の各マシンですべてのJava Webアプリケーションのアンパックが行われます。マシンごとに、マシンに関連付けられた管理対象サーバーが実行されます。

  17. 分散配置ではWebLogic管理サーバーをホストしているマシン以外の各マシンで、ドメインの場所に移動し、現在のEPM Oracleインスタンス名(epmsystem1など)を、すべてのファイル内のそのインスタンスの実際のEPM Oracleインスタンス名(epmsystem2など)に変更します。

  18. WebLogic管理サーバーをホストしているマシンで、WebLogic管理サーバーを起動してWebLogic管理コンソールに移動します。配置内の各マシンのノード・マネージャがアクセス可能であることを確認してください。それ以外の場合はnmEnrollコマンドを使用してノード・マネージャを同期化します。

  19. テキスト・エディタでMIDDLEWARE_HOME/user_projects/domains/domainName/config/fmwconfig/system-jazn-data.xmlを開き、ファイル内の最後の</grant>行の後に、次の行を追加します: (これらの変更は、EPM System製品を、別のマシンでホストされるドメインに配置し、ドメインがEPM Systemコンフィグレータを使用して作成されていない場合も必要なことに注意してください。)

    OracleではEPM_ORACLE_HOME/common/config/11.1.2.0/resources/deployment/xml/custom-jazn-data.xmlが用意されています。

    <?xml version='1.0' encoding='utf-8'?>
    <custom-jazn-data>
        <jazn-policy>
    	    <grant>
    	        <grantee>
    	            <codesource>
    	                <url>file:${EPM_ORACLE_HOME}/common/CSS/11.1.2.0/lib/css.jar</url>
    	            </codesource>
    	        </grantee>
    	        <permissions>
    	           <permission>
    	               <class>oracle.security.jps.service.policystore.PolicyStoreAccessPermission</class>
    	               <name>context=APPLICATION,name=*</name>
    	               <actions>getApplicationPolicy</actions>
    	           </permission>
    	        </permissions>
    	    </grant>
    	    <grant>
                <grantee>
                    <codesource>
                        <url>file:${EPM_ORACLE_HOME}/common/jlib/11.1.2.0/lib/registry-api.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.security.jps.service.credstore.CredentialAccessPermission</class>
                       <name>context=SYSTEM,mapName=epm_sys_reg_cred_map,keyName=*</name>
                       <actions>read,write,update,delete</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${EPM_ORACLE_HOME}/common/raframeworkrt/11.1.2.0/lib/annotation.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.security.jps.service.credstore.CredentialAccessPermission</class>
                       <name>context=SYSTEM,mapName=repository_cred_map,keyName=*</name>
                       <actions>read,write,update,delete</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${EPM_ORACLE_HOME}/products/Essbase/eas/server/lib/eascsf.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.security.jps.service.credstore.CredentialAccessPermission</class>
                       <name>context=SYSTEM,mapName=CSF_EAS_MAP,keyName=*</name>
                       <actions>read,write,update,delete</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=SHAREDSERVICES</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=SHAREDSERVICES(11.1.2.0)</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=FCCTaskExecutionComposite</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=FinancialClose</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=FINANCIALCLOSE</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=AccountReconciliation</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.wsm.security.WSIdentityPermission</class>
                       <name>resource=ACCOUNTRECONCILIATION</name>
                       <actions>assert</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${soa.oracle.home}/soa/modules/oracle.soa.workflow_11.1.1/bpm-services.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.security.jps.JpsPermission</class>
                       <name>IdentityAssertion</name>
                       <actions>*</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${soa.oracle.home}/soa/modules/oracle.soa.workflow_11.1.1/bpm-services.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.security.jps.JpsPermission</class>
                       <name>VerificationService.createInternalWorkflowContext</name>
                       <actions>read,write,update,delete</actions>
                   </permission>
                </permissions>
            </grant>
            <grant>
                <grantee>
                    <codesource>
                        <url>file:${soa.oracle.home}/soa/modules/oracle.soa.workflow_11.1.1/bpm-services.jar</url>
                    </codesource>
                </grantee>
                <permissions>
                   <permission>
                       <class>oracle.security.jps.service.credstore.CredentialAccessPermission</class>
                       <name>credstoressp.credstore.BPM-CRYPTO.BPM-CRYPTO</name>
                       <actions>read,write</actions>
                   </permission>
                </permissions>
            </grant>
    	</jazn-policy>
    </custom-jazn-data>
  20. テキスト・エディタでMIDDLEWARE_HOME/user_projects/domains/domainName/config/fmwconfig/jps-config.xmlを開き、次の変更を行います。(これらの変更は、EPM System製品を、別のマシンでホストされるドメインに配置し、ドメインがEPM Systemコンフィグレータを使用して作成されていない場合も必要なことに注意してください。)

    • このドキュメントに設定されている<serviceInstances>に、次を追加します:

      <serviceInstance provider="jaas.login.provider" name="idstore.loginmodule"> 
      		<description>Identity Store Login Module</description>
      		<property value="oracle.security.jps.internal.jaas.module.idstore.IdStoreLoginModule" name="loginModuleClassName" />
      		<property value="REQUIRED" name="jaas.login.controlFlag" /> 
      		<property value="true" name="debug" />
      		<property value="true" name="addAllRoles" />
       </serviceInstance> 
      

      virtualizeプロパティを追加するため、既存の<serviceInstances> “idstore.ldap”を変更します:

      <serviceInstance provider="idstore.ldap.provider" name="idstore.ldap"> 
      ...
       	<property name="virtualize" value="true"/>
      </serviceInstance>
      </serviceInstances> 
      
    • <jpsContexts default="default">セクションに、次を追加します:

      <serviceInstanceRef ref="idstore.loginmodule" />
  21. (オプション) WebLogicサーバーの起動を単純化するには、ドメイン内のサーバーごとにboot.propertiesファイルを編集して、ドメイン・ユーザーおよびパスワードを指定します。このファイルは、MIDDLEWARE_HOME/user_projects/domains/domainName/servers/product/securityにあります。

    Oracleではすべての管理対象サーバーの起動プロパティを生成するprocessBootProperties.*スクリプトが用意されています。

    注意:

    これらの入力内容は、サーバーが起動するまではクリア・テキストに格納され、その後はWebLogicによって暗号化されることに注意してください。

  22. 次のコマンドを使用してシンボリック・リンクを作成します:

    UNIX:

    "ln -s SOURCE_FILE TARGET_FILE"

    Windows 2008:

    "cmd /c mklink TARGET_FILE SOURCE_FILE"

    対象ファイル:

    • "EPM_ORACLE_HOME/common/SharedServices/11.1.2.0/lib/audit-client.jar"から"EPM_DOMAIN_HOME/lib/audit-client.jar"へ

    • "EPM_ORACLE_HOME/common/SharedServices/11.1.2.0/lib/wlpool.jar"から"EPM_DOMAIN_HOME/lib/wlpool.jar"へ

    • "EPM_ORACLE_HOME/common/CSS/11.1.2.0/lib/css.jar"から"EPM_DOMAIN_HOME/lib/css.jar"へ

    • "EPM_ORACLE_HOME/common/CSS/11.1.2.0/lib/ldapbp.jar"から"EPM_DOMAIN_HOME/lib/ldapbp.jar"へ

    • "EPM_ORACLE_HOME/common/jlib/11.1.2.0/registry-api.jar"から"EPM_DOMAIN_HOME/lib/registry-api.jar"へ

    • "EPM_ORACLE_HOME/common/jlib/11.1.2.0/ctg_custom.jar"から"EPM_DOMAIN_HOME/lib/ctg_custom.jar"へ

    • "EPM_ORACLE_HOME/common/misc/11.1.2.0/opencsv-1.8.jar"から"EPM_DOMAIN_HOME/lib/opencsv-1.8.jar"へ

  23. WebLogic管理コンソールを起動してから、管理対象サーバーを起動します。

    Java Webアプリケーションを手動で配置する場合は、DOMAIN_HOME/bin内の開始スクリプトを使用してください。

    Weblogic管理コンソールを使用すると、すべてのマシンのJava Webアプリケーションを起動できます。これを行うには、最初にMIDDLEWARE_HOME/oracle_common/common/bin/setNMProps.sh(cmd)を実行してnodemanager.propertiesを変更する必要があります。

    また、すべてのマシンのJava Webアプリケーションを起動するには、StartScriptEnabledtrue (StartScriptEnabled=trueなど)にMIDDLEWARE_HOME/wlserver_10.3/common/nodemanager/nodemanager.propertiesで設定する必要があります。

    管理対象サーバーの起動中に、配置したEPM System Java Webアプリケーションの値を使用してShared Servicesレジストリが更新されます。

  24. EPM System Java Webアプリケーションをすべて停止します。

  25. Financial Close Managementの手動手順を実行します:

    EPM_ORACLE_INSTANCE/binに移動し、次のコマンドを実行します:

    epmsys_registry.bat addproperty #APP_SERVER_ID/@adminUser ADMIN_USER
    epmsys_registry.bat addencryptedproperty #APP_SERVER_ID/@adminPassword ADMIN_PASSWORD
    

    APP_SERVER_IDは、Shared ServicesレジストリのWebLogic AppServerコンポーネントのIDです。

    Shared Servicesレジストリの編集の詳細は、『Oracle Enterprise Performance Management System配置オプション・ガイド』Shared Servicesレジストリの更新に関する項を参照してください。

  26. 次のコマンドを使用してEPM Systemコンフィグレータを起動し、「Webサーバーの構成」タスクを選択します。

    Windows:

    EPM_ORACLE_HOME/common/config/
    version_number/configtool-manual.bat

    UNIX:

    EPM_ORACLE_HOME/common/config/
    version_number/configtool-manual.sh

    EPM Systemコンフィグレータにより、Shared Servicesへの登録タスクおよび「Webサーバーの構成」タスクが実行されます。

    Java Webアプリケーションを手動で配置する際にEssbaseも構成する場合、configtool-manual.shの初回実行時には「Essbaseサーバーの構成」タスクを選択できませんでした。これは、この構成の第2段階で使用可能であるため、必要な場合はここで選択してください。

  27. Financial Close Managementの場合: WebLogic管理サーバーを起動してから、SOA管理対象サーバーを起動します。次に、EPM Systemコンフィグレータを起動し、Close Managerの場合は「SOAに配置」を選択し、Account Reconciliation Managerの場合は「SOAに配置」および「FDM EEのSOAに配置」を選択します。

  28. FDMEEを使用している場合、追加の手動手順を実行します。FDMEEの追加の配置後手順を参照してください。

  29. Oracle Web Services Managerを使用している場合、追加の手動手順を実行します。JMSサーバーの構成を参照してください。

  30. すべてのEPM SystemサービスおよびJava Webアプリケーションを起動します。Java Webアプリケーションを手動で配置する場合は、DOMAIN_HOME/bin内の開始スクリプトを使用します。

    ヒント:

    また、Weblogic管理コンソールを使用すると、すべてマシンのJava Webアプリケーションを起動できます。これを行うには、最初にMIDDLEWARE_HOME/oracle_common/common/bin/setNMProps.sh(cmd)を実行してnodemanager.propertiesを変更する必要があります。

    インストールを検証し、配置を確認するには、インストールの検証と配置の確認を参照してください。

    クラスタリングについては、『Oracle Enterprise Performance Management System配置オプション・ガイド』WebLogic手動配置でのJava Webアプリケーションのクラスタリングに関する項を参照してください。

ヒント:

正常に配置した後にJava Webアプリケーションを再配置する必要がある場合、EARファイルを置き換え、管理対象サーバーのtmpフォルダを削除してから、アプリケーションを起動します。

手動配置でのJava Webアプリケーションのクラスタリングの詳細は、Oracle Enterprise Performance Management System配置オプション・ガイドを参照してください。