Installing and Configuring Oracle® Hyperion Financial Close Management 11.1.2.4.000 in a Multi Node Environment
Overview
Purpose
This tutorial covers installation and configuration of Financial Close Management 11.1.2.4.000.
Time to Complete
Approximately 8 hours.
Introduction
In this tutorial, you install and configure the components required for Financial Close Management 11.1.2.4.000.
Prerequisites
Before starting this tutorial, you should:
- Ensure Windows Firewall is turned off - Appendix: Turn Off Windows Firewall.
- Ensure IPv6 Network is properly working if this feature in enabled on your machines -see Appendix D: IPv6 Network.
- Have access (with sysdba privileges) to an Oracle 11g ( 11.1.0.7 or higher) database or MS SQLServer 2008.
- Have access (with administrative rights) to an external authentication provider, such as Oracle Internet Directory, Microsoft Active Directory, or SunOne.
- Have access to the installation files for the following software:
- Oracle Hyperion Enterprise Performance Management System Installer Release 11.1.2.4.000
- Oracle Hyperion Foundation Services Release 11.1.2.4.000
- Oracle Hyperion Financial Close Management Release 11.1.2.4.000
- Oracle SOA Suite 11g (11.1.1.7.0)
- Oracle Repository Creation Utility 11g (11.1.1.7.0)
- Have access to below SOA patches:
- 17014142
- 17440113 - download patch for SOA version 11.1.1.7.1
Installation Types
You can install Financial Close Management in either a single-node or a multi-node configuration. In a multi-node configuration, the EPM components and SOA Suite run on the same machine. In a multi-node configuration, the Financial Close Management server and the SOA Suite run on different machines. This tutorial is an example of an installation for a multi-node configuration. For more Information on multi-node configurations, see the Oracle Hyperion Enterprise Performance Management Installation and Configuration Guide.
Installation and Configuration Sequence
WebLogic is required as the Web application server for both the Enterprise Performance Management (EPM) components and Service Oriented Architecture (SOA) Suite. Your installation and configuration sequence may vary based on whether or not you have an existing WebLogic installation.
Distributed Install Scenario
Machine A will be hosting Admin Server, SOA Server, and Foundation Services. Machine B will be hosting Financial Close Management and FDMEE.
Use the following installation and configuration sequence:
Machine A and B
- Install EPM components (Foundation Services, Financial Close Management and FDMEE required).
- Install SOA Suite & applying SOA patches
Machine A
- Run the Repository Creation Utility.
- Configure SOA Suite.
- Configure Foundation Services Components.
Machine B
- Configure Financial Close Management and FDM.
- Deploying to SOA
Machine A
- Re-configure the Foundation Services Web server.
- Perform Post-Installation Manual Configuration Tasks.
Note: For Linux version of commands refer:Appendix E: Linux Machine
Installing EPM Components on Machine A and Machine B
To install the EPM components, you run the Oracle Hyperion Enterprise Performance Management System Installer. Foundation Services and Financial Close Management are required components. If it is not already present, WebLogic is installed as part of the Foundation Services installation. You configure EPM components after you install and configure the SOA Suite. This has to be performed on both Machine A and Machine B.
- Navigate to the installation folder for the EPM software and run installtool.cmd.
-
Select a language, and click OK.
On the Welcome screen, click Next.
On the Destination screen, select the location for the Middleware Home directory, and click Next. The default directory is c:\oracle\middleware.
-
On the Installation Type screen, select New installation type, and click Next.
-
On the Product Selection screen:
- Clear Uncheck All.
- Under Foundation Services, select Foundation Components, select Oracle Database Client 32-bit & Oracle Database Client 64-bit.
- Select Financial Close Management.
- Select FDM Enterprise Edition (Financial Management SDK under Financial Management will be auto-selected)
Note: This example is for installing Foundation Services, Financial Close Management, and FDM Enterprise Edition only.
If you are installing other EPM products in distributed environment then you must install all of them to Machine A where WebLogic Admin server will be running because it is required that machine which hosts WebLogic Admin server should have all the binary files for every products configured in distributed environment. On the Confirmation screen, click Next.
On the Summary screen, click Finish.
Database User Creation
Depending on the database, follow the steps given in the appendices.
- For Oracle: Appendix: Create Oracle Database User.
- For MS SQLServer: Appendix: Configuring Microsoft SQL Server.
Installing and Configuring SOA Suite
Installing and configuring SOA Suite requires you to perform the following tasks:
Running the Repository Creation Utility on Machine A
In the folder to which you unzipped the utility, navigate to the rcuHome\bin folder and run rcu.bat.
-
On the Welcome screen, click Next.
-
On the Create Repository screen, select Create, and then click Next.
-
On the Database Connection Details screen, enter the database connection details, you wish to configure SOA. Be sure to enter user with DBA or SYSDBA privileges and select SYSDBA as the role. Click Next to continue.
Example for Oracle Database:
Example for MS SQLServer Database:
At the prerequisites confirmation prompt, click OK. If a warning prompt regarding the character set is displayed, click Ignore.
On the Select Components screen, in Create a new Prefix, enter a prefix for the schema tables.
In the Component list: Under SOA and BPM Infrastructure, select SOA Infrastructure and click Next.
You will see that, User Messaging Service under SOA and BPM Infrastructure and Metadata Services under AS Common Schemas get selected automatically when you selected SOA Infrastructure.
At the prerequisites confirmation prompt, click OK.
On the Schema Passwords screen, select Use the same password for all schemas, enter a password, and click Next.
On the Map Tablespace screen, leave the default tablespace names and click Next.
The following screen is shown for Oracle
At the confirmation prompt, click OK.
This screen is shown for Oracle.
At the completion prompt, click OK.
This screen is shown for Oracle.
On the Summary screen, click Create. This may take a while.
-
On the Completion Summary screen, click Close.
Installing SOA Suite & Applying SOA Patches on Both Machine A and Machine B
When you install SOA Suite, select the same Middleware Home directory that you specified for installing EPM Components. The Middleware Home directory contains the WebLogic installation, which is required for installing SOA Suite. SOA Suite has to be installed on both Machine A and Machine B.
-
Open Command prompt and Navigate to the Disk1 folder under SOA Suite installation directory and provide following command.
Setup.exe -jreLoc <jre location>
-
On the Welcome screen, click Next.
-
Select Skip Software Updates and click Next.
-
On the Prerequisites screen, click Next.
-
On the Specify Installation Location screen, verify that the Middleware Home directory is the directory that you selected when you installed the EPM Components, and click Next.
Please ensure to modify the Middleware Home that is defaulted. -
On the Application Server screen, verify that the WebLogic Server is selected, and click Next.
-
On the Installation Summary screen, click Install.
-
On the Installation Progress screen, when the Installation Successful message is displayed, click Next.
-
On the Installation Complete screen, click Finish.
Apply SOA patch 17014142 (on both the machines)
NOTE: This patch upgrades SOA to level 11.1.1.7.1
To apply the patch follow instructions given in the readme file of the patch.
Apply SOA patch 17440113 (on both the machines)
NOTE: This patch fixes a SOA bug. Please make sure that you downloaded patch for SOA version 11.1.1.7.1
To apply the patch follow instructions given in the readme file of the patch.
Configuring SOA Suite on Machine A
After installing SOA Suite and running the Repository Creation Utility, you configure SOA Suite and create a WebLogic domain. You later extend this WebLogic domain for Financial Close Management.
-
Select Start, then Programs, then Oracle SOA 11g - Home1, and then Configure Application Server.
(You can also start it with config.cmd. For example: C:\Oracle\Middleware\Oracle_SOA1\common\bin\config.cmd). -
Select Create a new WebLogic domain, and click Next.
-
On the Select Domain Source screen, select Generate a domain configured automatically to support the following products, then select Oracle SOA Suite, Oracle Enterprise Manager, Oracle WSM Policy Manager, Oracle JRF Webservices Asynchronous Services, and Oracle JRF, and click Next.
You will see that, Oracle WSM Policy Manager and Oracle JRF get selected automatically when you selected Oracle SOA Suite. -
On the Specify Domain Name and Location screen, enter a domain name and accept the default locations, and click Next.
You must use the same domain name when you configure the EPM components. In this example, the domain name is base_domain. -
On the Configure User Name and Password screen, enter a user name and password for the WebLogic domain administrator, and click Next.
You use this domain administrator name and password for the EPM components as well. In this example, the domain administrator name is weblogic. -
On the WebLogic Domain Startup Mode screen, change the mode to Production Mode if the default is Development Mode. Then select the Jrockit location, and click Next.
-
On the Configure JDBC Component Schema screen, select each component schema and provide the database connection information, using the prefix and schema password that you entered in the Repository Creation Utility. When finished, click Next.
Example for Oracle Database:
Example for MS SQLServer Database:
-
On the Test Component Schemas screen, verify that the connections to your data sources are successful, and click Next.
-
On the Select Optional Configuration screen, leave the default settings and click Next.
-
On the Configuration Summary screen, click Create.
-
On the Creating Domain screen, when the process is complete, click Done.
Configuring EPM Components
The database schemas for the EPM components are created during the configuration process.
During the configuration process you must provide valid Oracle/ MS SQLServer database user names and passwords under which to create the schemas.
Configuring Foundation Services on Machine A
From the Windows Start menu, select Programs, then Oracle EPM System, and then EPM System Configurator (all instances).
(You can also start it with configtool.bat. For example: C:\Oracle\Middleware\EPMSystem11R1\common\config\11.1.2.0\configtool.bat).
-
Accept the defaults, and click Next.
-
Select Perform first -time configuration of Shared Services database, enter the database connection details for the Shared Service database, and click Next. This might take several minutes.
Example for Oracle Database:
- Server: Enter demoserver.example.com. Replace example.com with the fully qualified domain name.
- Port: 1521;
- Service Name or SID: The database service name that you must use is available in C:\app\<user>\product\11.2.0\dbhome_1\NETWORK\ADMIN\tnsnames.ora;
- User Name: fcm
- Password: welcome1
Example for MS SQLServer Database:
- Server: Enter demoserver.example.com. Replace example.com with the fully qualified domain name.
- Port: 1433;
- Service Name or SID: FCMdb
- User Name: fcm
- Password: welcome1
Expand Hyperion Foundation and accept the default options. Make sure to select Deploy to Application Server and Configure Web Server if not selected. Deselect the top-level nodes of FDM Enterprise Edition & Financial Close Management. Click Next.
-
Select Create Windows Services for configured components, Enter Email Configuration details and click Next.
Select Deploy Java web applications to an existing domain, enter the information for the WebLogic domain that you created when you configured SOA, and click Next.
Administrator User/Password: use the WebLogic administrator username and password created from SOA configurator.
Domain Name: base_domain (use the existing domain that was created from SOA configuration)If there is a warning about password validation, press OK.
-
Uncheck the deploy the Java web applications to a single managed Server and accept the default application server deployment settings, and click Next.
Accept the default Configure Web server settings, and click Next.
In the Password and Re-type Password text boxes, enter a password, and click Next.
Review your selections, and click Next to launch the configuration.
When the configuration is complete, click Finish.
Configuring Financial Close Management and FDMEE on Machine B
-
Ensure that admin server is running on Machine A before running the EPM configurator.
To start the WebLogic Admin Server, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server, where <domain is the WebLogic domain you created with the SOA configuration tool.
(You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd).
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box. -
From the Windows Start menu, select Programs, then Oracle EPM System, then Foundation Services, and then EPM System Configurator.
(You can also start it with configtool.bat. For example: C:\Oracle\Middleware\EPMSystem11R1\common\config\11.1.2.0\configtool.bat). -
Accept the defaults and click Next.
-
Enter the database connection details for the Shared Service database.
Ensure Connect to a previously configured Shared Service database is chosen.
The credentials should be same as entered when configuring Shared Services on Machine AExample for Oracle Database:
Example for MS SQLServer Database:
-
Expand Hyperion Foundation and ensure that only Configure Common Settings and Configure Database are selected and grayed out. Deselect any items that were selected by default.
Expand FDM Enterprise Edition and select Configure Database and Deploy to Application Server.
Select Financial Management if not selected.
Expand Financial Close Management and select Deploy to application server and Configure Database. Do not select Deploy to SOA. Select Configure Content Management System location only if you are using a content management system.Click Next.
-
You will see the database connection details that were provided in Shared Services database connection details screen. Verify the connection details for the Financial Close Management and FDM Enterprise Edition, and click Next.
Example for Oracle Database:
Example for MS SQLServer Database:
-
Select Deploy Java web applications to an existing domain, enter the information for the WebLogic domain that you created when you configured SOA on Machine A and click Next.
-
Ensure that Deploy the Java web applications to a single managed Server is unchecked and grayed out. Accept the default application server deployment settings, and click Next.
-
If earlier you chose to integrate Oracle Enterprise Content Management with your Financial Close Management application you will see this screen, otherwise skip to the next section.
-
Review your selections, and click Next to launch the configuration.
-
When the configuration is complete, click Finish.
Deploying to SOA on Machine B
-
Ensure that both Admin and SOA server are running on Machine A before running the EPM configurator.
To start the WebLogic Admin Server, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server for Weblogic, where <domain> is the WebLogic domain you created with the SOA configuration tool.
(You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd).
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box.To start the SOA managed server, enter the following command at a Command Prompt:
c:\oracle\middleware\user_projects\domains\<domain>\bin\startmanagedweblogic.cmd soa_server1,
where <domain> is the WebLogic domain you created with the SOA configuration tool.
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box. -
After configuring EPM products, you need to run the EPM System Configurator again to deploy to SOA.
On Machine B, from the Windows Start menu, select Programs, then Oracle EPM System, and then EPM System Configurator.
(You can also start it with configtool.bat. For example: C:\Oracle\Middleware\EPMSystem11R1\common\config\11.1.2.0\configtool.bat). -
Select EPM Oracle instance to which this configuration would be applied, and click Next.
-
Ensure that none of the options under Hyperion Foundation are selected.
Expand Financial Close Management and select Deploy to SOA and click Next -
On the Confirmation screen, click Next to launch the configuration.
-
When the configuration is complete, click Finish.
Reconfiguring Web Server on Machine A (Where Foundation Services are Configured)
Before reconfiguring the Web server, shutdown both Admin and SOA Servers.
- To stop the WebLogic Admin Server:
- Press and hold Ctrl + C in the command window where WebLogic Admin server has been started.
- When prompted to terminate the batch job, type 'Y' and hit the enter key.
- To stop the SOA managed server:
- Press and hold Ctrl + C in the command window where SOA managed server has been started.
- When prompted to terminate the batch job, type 'Y' and hit the enter key.
-
From the Windows Start menu, select Programs, then Oracle EPM System, then Foundation Services, and then EPM System Configurator.
-
Accept the defaults and click Next.
-
Uncheck “Check All” option.
-
Expand Hyperion Foundation and select only Configure Web Server. Click Next.
-
Accept the default Configure Web Server settings. Ensure ‘Set the logical web address for the web applications to this web server’ is selected. Select it if not already selected, click Next.
-
Review your selections, and click Next to launch the configuration.
-
When the configuration is complete, click Finish.
Performing Post-Installation Manual Configuration Tasks on Machine A
You perform the manual configuration tasks after installing and configuring SOA Suite and the EPM components.
Starting Admin Server
Start the Admin Server before you start with the instructions.
-
To start the WebLogic Admin Server, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server, where <domain> is the WebLogic domain you created with the SOA configuration tool.
(You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd). - When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box.
Connecting External Authentication Providers to the Weblogic Server
To communicate with an external authentication provider, such as Oracle Internet Directory or Microsoft Active Directory, you must configure WebLogic. You must configure Shared Services to use the same external authentication provider. For more information on configuring Shared Services, see the Oracle Enterprise Performance Management System User and Role Security Guide.
The following instructions show an example of how to configure MSAD as the authentication provider.
-
Connect to Weblogic Console http://host:7001/console where host is the name of the Machine.
-
Log on using the WebLogic administrator name and password that you specified for the domain.
-
Click on Lock & Edit.
-
In the Domain Structure area, click Security Realms.
-
Click myrealm.
-
Select the Providers tab.
-
Click New.
-
Configure your authentication provider:
For Microsoft Active Directory, in the Name text box enter MSAD, and select ActiveDirectoryAuthenticator from the Type list.
-
Click OK.
-
In the Authentication Providers list, click MSAD.
-
Select the Provider Specific tab. Enter the principal user name and credentials, and modify any other settings as required for your provider.
-
Ensure to provide SAMAccountName as User Name Attribute and in User From Name Filter for MSAD instead of cn.
-
Click Save.
-
In the Domain Structure area, click Security Realms, and then myrealm.
-
Select the Providers tab.
-
In the Authentication Providers list, click MSAD.
-
In the Control Flag list, select Sufficient.
-
Click Save.
-
Click Activate Changes.
-
Click Logout.
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Stop Admin Server.
(You can also stop it with stopWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\stopWebLogic.cmd).-
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server.
(You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd).
When prompted, enter the Web Logic admin user name and password. The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box.
Configuring the External Provider with Shared Services
-
Start Foundation Services and Oracle Process Manager (OHS) from windows Services of Machine A.
-
Connect to Shared Service Console http://host:port/interop/index.jsp where host is the name of the Machine and port is Listen port of FoundationServices0 managed Server in weblogic console.
-
Login as admin.
-
Click on Administration and Select Configure User Directories.
-
Click New and choose the Directory Type as MSAD and click Next.
-
Enter the following in Server information Tab.
- Host
- Port
- Base DN
- User DN
- Credential
-
Click “Next” to navigate to MSAD User Configuration Tab and enter user information.
Click “Next” to navigate to MSAD Group Configuration Tab and enter group information.
-
Click Save and Logout.
-
Restart the FoundationServices0 Managed Server.
Configuring the Keystore for Oracle Web Services Manager
You must set up the Keystore for message protection and configure the Credential Store Provider. The Financial Close Management client and the Oracle Hyperion Financial Management Web service use the following policies:
- wss11_saml_token_with_message_protection_client_policy
- wss11_saml_token_with_message_protection_service_policy
-
At a Command Prompt (on machine where WebLogic Admin Server is running (Machine A)), enter the following command to add the JDK to the path:
set PATH=%PATH%;C:\Oracle\Middleware\jdk160_35\bin\
(where C:\Oracle\Middleware\jdk160_35\bin has to be your JDK path).
The JDK must be included in the path in order to run the Java keystore utility. -
Use the Oracle keystore utility to create a keystore on the Weblogic Admin server hosting your EPM System domain by navigating to c:\oracle\middleware\user_projects\domains\<domain>\config\fmwconfig (where <domain> is the WebLogic domain you created with SOA configuration tool), and enter the following command:
keytool -genkey -keyalg RSA -alias orakey -keypass welcome1 -keystore default-keystore.jks -storepass welcome1 -validity 3600
This command creates a keystore with the name default-keystore.jks if it does not already exist and adds a new private key entry with alias 'orakey' and password welcome1 to it. You will be prompted for additional information regarding your authentication provider.
You can change the alias, password, and domain name as needed in the command.
-
Enter the following URL to start Oracle Enterprise Manager, replacing <host> with your host name: http://<host>:7001/em.
- Enter your Weblogic administrator name and password to login.
-
In the navigation pane, expand WebLogic Domain, and then select the WebLogic domain you created in the SOA configuration tool.
-
Click on WebLogic Domain, then Security, and then Security Provider Configuration.
-
In the Keystore section, click Configure.
-
In the Keystore Path text box, enter the path name for the keystore you created, and enter the keystore password in the password fields. In the Signature Key and Encryption key text boxes, enter the alias and password for the signature and encryption keys.
It should be noted that the "Keystore Path" requested by EM is relative to "C:\Oracle\Middleware\user_projects\domains\<domain>\config\fmwconfig" so it should be ./default-keystore.jks.
-
Click OK.
Deleting Data Sources (Only for MS SQLServer)
After you install and configure SOA, you delete the EDNDataSource and EDNLocalTxDataSource data sources.
-
If the WebLogic Admin server is not already running, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server.
(You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd).
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box. -
Select Start, then Programs, then Oracle WebLogic, then User Projects, then<domain>, and then Admin Server Console.
-
Log on using the WebLogic administrator name and password that you specified for the domain.
-
Click on Lock & Edit.
-
In the Domain Structure area, expand Services and select Data Sources.
-
In the Data Sources table, delete EDNDataSource and EDNLocalTxDataSource.
-
Click Activate Changes.
-
Click Logout.
Manually Configuring Oracle HTTP Server
If FCM is configured on different machine from Oracle HTTP Server (which is true for this document case) then you have to do the following steps to manually configure mod_wl_ohs.conf for SOA and WebLogic Admin servers.
-
On the Machine A (Oracle HTTP Server box), make copy of the autogenerated mod_wl_ohs.conf file under EPM_ORACLE_INSTANCE/httpConfig/autogenerated/soa/ folder and rename it to mod_wl_soa_ohs.conf.
-
Open the copied mod_wl_soa_ohs.conf in a text editor and replace soa_server_host:soa_server_port and admin_server_host:admin_server_port with the actual values for the SOA host and port and WebLogic Admin server host and port.
For example change the following section:
<LocationMatch ^/soa-infra>
SetHandler weblogic-handler
WeblogicCluster soa_server_host:soa_server_port
WLProxySSL ON
WLProxySSLPassThrough ON
</LocationMatch>
……
……
<LocationMatch ^/console>
SetHandler weblogic-handler
WeblogicCluster admin_server_host:admin_server_port
</LocationMatch>to this:
<LocationMatch ^/soa-infra>
SetHandler weblogic-handler
WeblogicCluster demoserverA:8001
WLProxySSL ON
WLProxySSLPassThrough ON
</LocationMatch>
……
……
<LocationMatch ^/console>
SetHandler weblogic-handler
WeblogicCluster demoserverA:7001
</LocationMatch>Do the same change for all the places where soa_server_host:soa_server_port and admin_server_host:admin_server_port are presented.
-
Copy the modified mod_wl_soa_ohs.conf to EPM_ORACLE_INSTANCE/httpConfig/ohs/config/OHS/ohs_component folder.
-
Open httpd.conf under EPM_ORACLE_INSTANCE/httpConfig/ohs/config/OHS/ohs_component folder in a text editor and add the following line inside of <VirtualHost> tag: Include “conf/mod_wl_soa_ohs.conf”.
Example:
<VirtualHost *:19000>
include "conf/mod_wl_ohs.conf"
Include "conf/epm_online_help.conf"
Include "conf/epm_rewrite_rules.conf"
Include "conf/epm.conf"
Include "conf/mod_wl_soa_ohs.conf"
</VirtualHost> -
Restart OHS instance. You can restart it from Window services such as “Oracle Process Manager (ohsInstance3193331783)”.
Raising the Maximums for Connection Pools
-
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
-
Log on using the WebLogic administrator name and password that you specified for the domain.
-
Click on Lock & Edit.
-
In the Domain Structure area, expand Services and then click on Data Sources.
Note: For SQL Server Only
Skip “Raising the Maximums for Connection Pools” for the deleted data sources (i.e. for EDNDataSource and EDNLocalTxDataSource). -
In the Name list, click EDNDataSource.
-
Select the Connection Pool tab.
-
In the Maximum Capacity text box, enter 150.
-
Click Save.
-
In the Domain Structure area, click Data Sources to return to the list of data sources.
-
Repeat steps to increase the connection pools for the EDNLocalTxDataSource to 150.
If you receive resource errors specific to any of the following data sources, use the above procedure to increase their connection pools:
- mds-owm
- mds-soa
- EPMSystemRegistry
- OraSDPMDataSource
- SOADataSource
- SOALocalTxDataSource
-
Click Activate Changes.
-
Click Logout.
Raising the StuckThreadMaxTime
-
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
-
Log on using the WebLogic administrator name and password that you specified for the domain.
-
Click on Lock & Edit.
-
In the Domain Structure area, expand Environment and then click on Servers.
-
In the Servers list, click ErpIntegrator0.
-
Select the Tuning tab.
-
In the Stuck Thread Max Time text box, enter 6000.
-
Click Save.
-
In the Domain Structure area, click Servers to return to the list of servers.
-
Repeat steps to increase the Stuck Thread Max Time for the soa_server1 and FinancialClose0.
-
Click Activate Changes.
-
Click Logout.
Stop Foundation Services from Windows Services.
To stop the WebLogic Admin Server:
- Press and hold Ctrl + C in the command window where WebLogic Admin server has been started. Type 'Y' and hit the enter key when prompted to terminate the batch job.
To stop the SOA managed server:
- Press and hold Ctrl + C in the command window where SOA managed server has been started. Type 'Y' and hit the enter key when prompted to terminate the batch job.
Starting the Servers
You must start the servers required for Financial Close Management in the following order:
- WebLogic Admin Server (Machine A)
- Foundation Services managed server (Machine A)
- Oracle HTTP Server (Machine A)
- Optional: Managed servers for integration products (for example: FDM Enterprise Edition, Financial Management or Financial Reporting) (Machine B)
- SOA managed server (Machine A)
- Financial Close Management Managed server (Machine B)
Note: Wait until each server status changes to RUNNING state to go to next server in the sequence.
Refresh the page to get the server started status.
In the Domain Structure area, click Environment then Servers to return to the list of servers.
The List of servers to be started:
To start the WebLogic Admin server, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server.
(You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd).
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box.To start Foundation Services, select Start, then Programs, then Oracle EPM System, then epmsystem1, then Foundation Services, and then Start FoundationServices.
(You can also start it with startFoundationServices.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\startFoundationServices.bat).-
To start the Oracle HTTP server, enter the following command at a Command Prompt: C:\Oracle\Middleware\user_projects\epmsystem1\httpConfig\ohs\bin\opmnctl.bat startall
-
Start Oracle Hyperion FDM Enterprise Edition service from Windows Services.
-
To start the SOA managed server on Machine A, enter the following command at a Command Prompt:
c:\oracle\middleware\user_projects\domains\<domain>\bin\startmanagedweblogic.cmd soa_server1
where <domain> is the domain you created using the SOA configuration utility.
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box. -
To start Financial Close Management Services on Machine B, select Start, then Programs, then Oracle EPM System, then epmsystem1, then Financial Close, then Start FinancialClose.
(You can also start it with startFinancialClose.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\startFinancialClose.bat).
Running Validation Tool to verify EPM Configuration on Machine B
Perform the procedures below to validate the EPM configuration.
The EPM validator tool can be launched by running (double click) the following bat script;
%EPM_ORACLE_INSTANCE%\bin\validate.bat
For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\validate.bat
It will launch new browser with status of validation for every EPM components as following (All should be passed as following).-
You can also run EPM report by running the following bat script:
%EPM_ORACLE_INSTANCE%\bin\epmsys_registry.bat report deploymentIt will launch new browser with report information as following:
-
Scroll down to the end of the report and you should see all passed and nothing failed as following:
Running the Validation Tool to Verify Close Manager and Account Reconciliation Manager Configuration on Machine B
Perform the procedures below to validate the configuration for:
- Close Manger
- Account Reconciliation Manager
Validating Close Manager Configuration
-
Launch the validator tool from a web browser using this URL:
http://<FCMHOST>:<FCMPORT>/fcc/faces/oracle/apps/epm/fcc/ui/page/FCCValidation.jspx- Where FCMHOST is the name of the machine where FinancialClose0 managed server is configured.
- Where FCMPORT is the Listening port of FinancialClose0 managed Server in the WebLogic console.
-
Log on to Close Manager with Shared Services administrator credentials.
Note: If an external provider is configured, the login can also be done with a user from the external provider. But if there are issues with external provider configuration, the login may not succeed. In such cases, you can log on with any seeded user (seeded both on WLS and HSS native directory) and run the tool to identify issues with external provider configuration.
Example to seed “admin” user (who is the default administrator in Shared Services) in WebLogic (this way, you can use the admin user to login to the validator):- Log on to WebLogic admin console (http://localhost:7001/console)
- Click on Lock & Edit
-
Go to Domain Structure area and click Security Realms
-
Click on myrealm link.
- Go to Users and Groups tab and click New under the Users tab.
- Enter admin for Name field and enter admin user’s password for Password/Confirm Password fields (or simply enter welcome1 for the password)
- Click OK
- Click Activate Changes
After successfully logging on the following screen is displayed.
-
To validate the close manager configuration, click on “Validate Close Manager Configuration” button.
After validation, the configuration information will be displayed in a tabular form. See the following table for more information on the results.
Below is the list of things that will be displayed in a tabular form:
-
Validate the test schedule:
The second half of the page has a utility that will generate a test Main Orchestration Process, deploys it to soa server and start a test task. The status for each task is displayed in a table below it and should there be any errors – the possible cause of the error and the way to fix it will be displayed in the last column.
If you are running this part, make sure the user logged into the Diagnostic tool with a user that is also present in HSS.
Click on Validate Test Scheduler.
Note: The button to run this test is enabled only if all the required configuration from the above table is in place; marked with check marks instead of X.
After validation, the configuration information is displayed in a tabular form:
Below is the list of things that is displayed in a tabular form:
SOA Composite Deployment
Tells if the composite deployment to soa server is successful.
a (Green)/r (red)
Messages describing the steps to fix in case of r (red)
Business Event
Tells if the business event if fired successfully.
Composite Instance
Tells if the business event is able to start a Task correctly or not.
FCM Basic Task
Tells if the basic task is started and successfully set to Running Status.
Humanworkflow
The above task is submitted internally to confirm if Humanworkflow is working fine.
Validating Account Reconciliation Manager Configuration
-
Launch the validator tool from a web browser using this URL:
http://<FCMHOST>:<FCMPORT>/arm/faces/oracle/apps/epm/arm/ui/page/common/ARMValidation.jspx
- Where FCMHOST is the name of the machine where FinancialClose0 managed server is configured.
- Where FCMPORT is Listening port of FinancialClose0 managed Server in the WebLogic console.
-
Log on with Shared Services administrator credentials.
-
After successful logging in the following screen is displayed.
-
To validate the account reconciliation manager configuration, click on the Validate Account Reconciliation Manager Configuration button.
-
After validation, the configuration information is displayed in a tabular form. See the following table for more information on the results.
Below is the list of things that will be displayed in a tabular form:
Admin Server
Host
Port
Status (running/shutdown)a (Green)/r (red)
Messages describing the steps to fix in case of r (red)
Foundation Server
Host
Port
Status
DataSources targetedFCM Managed Server
Host
Port
Status
DataSources targetedSOA Server
Host
Port
Status
DataSources targetedACCOUNTRECONCILIATION Web Application
Version:
Status:
DB TypeFINANCIALCLOSETAXOPCOMMON Web Application
Version:
Status:
DB TypeEPM-FCM-LIBRARIES library
Version:
Status:
DB TypeAuthentication Providers
Provider configured/ not
Control Flag (Sufficient/Not)External Authenticators
Lists the Authentication Providers
SOA Composites
Check whether SOA composites Active/Not
Foreign JNDI
EDN JMS (in case of sql server)
SOA JMSOWSM KeyStore
Lists the external Identity store configuration. The tool only lists the values used for the configuration. It is the responsibility of the customer to make sure that the entered values are correct.
Warning can be ignored.
-
Validating Test Scheduler
The second half of the page has a utility that will generate a test Main Orchestration Process, deploys it to soa server and start a test task. The status for each task is displayed in a table below it and should there be any errors – the possible cause of the error and the way to fix it will be displayed in the last column.
If you are running this part, make sure the user logged into the Diagnostic tool with a user that is also present in HSS.
Click on Validate Test Scheduler.
Note: The button to run this test is enabled only if all the required configuration from the above table is in place – marked with check marks instead of an X.
After validation, the configuration information is displayed in a tabular form:
Below is the list of things that is displayed in a tabular form:
Scheduler for Period |
Tells if the scheduler for period started successfully. |
a (Green)/r (red) |
Messages describing the steps to fix in case of r (red) |
Appendix A: Turning off Windows Firewall
It is required to turn off Windows Firewall from machines you are going to install EPM products before you start EPM installation. This appendix contains information for turning off Windows Firewall in Windows 2008 OS.
Please refer to your Windows OS help to find out how to turn off firewall if your environment is different than this example.
Click Start, then Administrative Tools, and then Windows Firewall with Advanced Security. Click on Properties.
Turn off firewall for Domain, Private, and Public tabs.
-
Check if IPsec tab is set as follows.
Appendix B: Creating an Oracle Database User
This procedure explains how to create an Oracle database user.
-
To open SQLPlus window, select Start, then All Programs, then Oracle - OraDb 11g_home1, then Application Development, and then SQL Plus.
-
Login to SQLPlus as sys user and run the following:
- create user fcm identified by welcome1
- grant RESOURCE,CONNECT,CREATE SESSION,CREATE VIEW to fcm;
Appendix C: Configuring Microsoft SQL Server
This appendix contains information for using Microsoft SQL Server as the database.
Creating the Required Databases (on any one Machine A/B)
You must create databases in SQL Server and run the Repository Creation Utility before you install and configure SOA Suite.
-
Install SQL Server and log on to Microsoft SQL Server Management Studio with sa user;
-
Create a login with the db_owner role.
- Go to the Object Explorer window. Navigate to the Security folder and right click on Login, then click on New Logins.
-
In the General tab, select SQL Server authentication, enter the Login Name, password and Confirm password..
- Go to the Object Explorer window. Navigate to the Security folder and right click on Login, then click on New Logins.
-
Select the Server Roles tab and select the dbcreator and sysadmin Server roles.
Click OK to create the user.
-
Create two databases: one for SOA, and another for Financial Close Management and HSS. Set the login created earlier as the owner of the two databases.
- Right click on Database and select “New Database…”
-
Enter the Database name and Owner.
- Click OK to create the database.
- Right click on Database and select “New Database…”
Modify the properties of the database for SOA by using the following commands:
- Click on New Query in the upper left and choose master database from the dropdown just below it.
- Enter the below commands and replace <database name> with the SOA Database.
ALTER database <database name> SET READ_COMMITTED_SNAPSHOT ON
ALTER database <database name> COLLATE SQL_Latin1_General_CP1_CS_AS - Click on the ‘Execute’ button to run the commands.
- Modify the properties of the database for Financial Close Management by using the following command:
ALTER database <database name> SET ALLOW_SNAPSHOT_ISOLATION ON
Enabling XA Transactions
You must Enable XA transactions for SQL Server in both SQL Server and at the operating system level. You should perform these procedures before you install and configure SOA Suite.
-
Copy instjdbc.sql from C:\Oracle\Middleware\wlserver_10.3\server\lib into:
C:\Program Files\Microsoft SQL Server\MSSQL10.<INSTANCE_NAME>\MSSQL\Binn for SQL Server 2008.
-
Copy one of the following:
sqljdbc.dll(for 32 bit OS)
64sqljdbc.dll (for 64 bit OS Titanium based)
x64sqljdbc.dll(for 64 bit OS Intel based)
from C:\Oracle\Middleware\wlserver_10.3\server\lib into
C:\Program Files\Microsoft SQL Server\MSSQL10.<INSTANCE_NAME>\MSSQL\Binn for SQL Server 2008. -
After copying the file, rename the 64sqljdbc.dll or x64sqljdbc.dll to sqljdbc.dll.
-
Run the following command from the command prompt:
SQLCMD.EXE -S <SERVER NAME> -U SA -P SA_PASSWORD -i “C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Binn\instjdbc.sql” -o log.txtSQLCMD.EXE is located at C:\Program Files\Microsoft SQL Server\100\Tools\Binn\ for SQLServer 2008.
In the above command "SERVER NAME" is the server name used to connect SQLServer using SQL Server Studio.
Example for SQL Server 2008:
-
Look for the messages creating JDBC XA procedures and instxa.sql completed successfully in the log. If the messages are present then the SQL ran fine and you can ignore any other messages in the log.
-
For Windows 2008:
- Select Start, then Programs, then Administrative Tools, then Component Services, and Computers, and expand My Computer and Distributed Transaction Coordinator.
- Right Click Local DTC and select Properties
- Select the Security Tab, and then select Enable XA Transactions.
- Click OK.
Note: Click OK through the warning dialogs about service restarting.
-
For Windows 2003:
- Select Start, then Programs, then Administrative Tools, then Component Services, and then Computers.
-
Right click on My Computer and select Properties.
-
Select the MSDTC tab and click Security Configuration.
- Select Enable XA Transactions
- Click OK
-
Restart SQL Server (MSSQLSERVER) from Windows Services.
Appendix D: IPv6 Network
This appendix contains information for testing IPv6 Network on your environment. If your machines have IPv6 turned on then you have to make sure IPv6 routing is properly working in your network. If your network doesn't support IPv6 then you have to turn off IPv6 device(s) before you start EPM installation.
Testing IPv6 Network
-
Run ipconfig /all from Command Prompt on Machine A.
If there is any device using IPv6 such as the following example then you need to test IPv6 connection from other remote machine.
- From Machine B ping Machine A from a Command Prompt as follows:
ping -6 <Machine A> where <Machine A> is the name or IP Address of Machine A. -
If ping returns Ping request could not find host <Machine A> then your network doesn't support IPv6 and you must turn off IPv6 before you start EPM installation.
Turning Off IPv6
- From Local Area Connection Properties, unchecked IPv6:
- From the Start menu, right click on Network and click on Properties.
- From Network and Sharing Center screen, click on Local Area Connection.
-
From Local Area Connection Properties, deselect IPv6.
-
From Command Prompt, run ipconfig /all and check if there is no process using IPv6 (this check has to done every time you restart the machine).
For example the following illustrates Teredo is still using IPv6.
-
To disable devices using IPv6 do the following:
- From the Start menu, click Administrative Tools, and then Computer Management
- Go to Device Manager
- Form View menu, click Show hidden devices
- Expand Network adapters
- Right click on Teredo Tunneling Pseudo-Interface (or any other device that is using IPv6) and disable it
- Run ipconfig /all again from the Command Prompt to make sure there are no longer any devices using IPv6. If you find more then repeat above steps to turn it off until there is no device using IPv6.
Appendix E: Linux Commands
To launch the EPM System installer: Execute
/installTool.shTo launch the SOA Installer: Execute
/runInstaller –jreLoc /oracle/middleware/jdk160_35To launch the SOA Configurator: Run
/oracle_soa1/common/bin/config.sh To launch the EPM System Configurator: Run
/common/config/version_number/configtool.sh To start weblogic server: Run
/user_projects/domains/ /bin/startWebLogic.sh To start SOA server : Execute
/user_projects/domains/ /bin/startManagedWebLogic.sh soa_server1 To start Foundation Services: Run
/user_projects/epmsystem1/bin/startFoundationServices.sh To start OHS: Run
/user_projects/epmsystem1/bin/startOHS.sh To stop Foundation Services: Run
/user_projects/epmsystem1/bin/stopFoundationServices.sh To launch ERP Integrator: Run
/user_projects/epmsystem1/bin/startErpIntegrator.sh To start Financial Close Services: Run
/user_projects/epmsystem1/bin/startFinancialClose.sh To stop Financial Close Services: Run
/user_projects/epmsystem1/bin/stopFinancialClose.sh To start epmsystem Services: Run
/user_projects/epmsystem1/bin/start.sh To stop epmsystem Services: Run
/user_projects/epmsystem1/bin/stop.sh
Appendix F: Stopping and Restarting the Servers
Stopping the Servers
-
To stop the WebLogic Admin Server on Machine A:
- Press and hold Ctrl + C in the command window where WebLogic Admin server has been started.
- When prompted to terminate the batch job, type 'Y' and hit the enter key (You can also stop it with stopWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\stopWebLogic.cmd).
-
To stop the SOA managed server on Machine A:
- Press and hold Ctrl + C in the command window where SOA managed server has been started.
- When prompted to terminate the batch job, type 'Y' and hit the enter key.
-
Stop Foundation Services from windows Services on Machine A.
- To stop Financial Close Management Services on Machine B, select Start, then Programs, then Oracle EPM System, then epmsystem1, then Financial Close, then Stop Financial Close. (You can also stop it with stopFinancialClose.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\stopFinancialClose.bat).
- To stop FDMEE Services on Machine B, select Start, then Programs, then Oracle EPM System, then epmsystem1, then FDM Enterprise Edition, and then Stop ERPIntegrator. (You can also stop it with stopErpIntegrator.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\stopErpIntegrator.bat)
Starting the Servers
You must start the servers required for Financial Close Management in the following order:
- WebLogic Admin Server (Machine A)
- Foundation Services managed server (Machine A)
- Optional: Managed servers for integration products (for example: FDM Enterprise Edition, Financial Management or Financial Reporting) (Machine B)
- SOA managed server (Machine A)
- Financial Close Management Managed server (Machine B)
Note: Wait until each server status changes to RUNNING state to go to next server in the sequence. Refresh the page to get the server started status.
-
To start the WebLogic Admin server, select Start, then Programs, then Oracle WebLogic, then User Projects, then
, and then Start Admin Server. (You can also start it with startWebLogic.cmd. For example: C:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd).
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box. -
To start Foundation Services, select Start, then Programs, then Oracle EPM System, then epmsystem1, then Foundation Services, and then Start FoundationServices.
(You can also start it with startFoundationServices.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\startFoundationServices.bat)
-
To start FDMEE Services on Machine B, select Start, then Programs, then Oracle EPM System, then epmsystem1, then FDM Enterprise Edition, and then Start ERPIntegrator.
(You can also start it with startErpIntegrator.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\startErpIntegrator.bat)
-
To start the SOA managed server on Machine A, enter the following command at a Command Prompt: c:\oracle\middleware\user_projects\domains\
\bin\startmanagedweblogic.cmd soa_server1 where <domain> is the domain you created using the SOA configuration utility.
When prompted, enter the Web Logic admin user name and password.
The process will take few minutes and is complete when you see '<Server started in RUNNING mode>' in the Command Prompt box. -
To start Financial Close Management Services on Machine B, select Start, then Programs, then Oracle EPM System, then epmsystem1, then Financial Close, then Start FinancialClose.
(You can also start it with startFinancialClose.bat. For example: C:\Oracle\Middleware\user_projects\epmsystem1\bin\startFinancialClose.bat)
Summary
In this tutorial, you have learned how to:
- Install and configure SOA Suite
- Install and Configure EPM Components for Financial Close Management
- Performing post-installation manual configuration tasks.
Resources
Credits
- Lead Curriculum Developer: Syed Khairulla
- Other Contributors: Mark Mitsock
To navigate this Oracle by Example tutorial, note the following:
- Topic List:
- Click a topic to navigate to that section.
- Expand All Topics:
- Click the button to show or hide the details for the sections. By default, all topics are collapsed.
- Hide All Images:
- Click the button to show or hide the screenshots. By default, all images are displayed.
- Print:
- Click the button to print the content. The content that is currently displayed or hidden is printed.
To navigate to a particular section in this tutorial, select the topic from the list.