This tutorial covers installation and configuration of Financial Close Management 11.1.2.
Approximately 6 hours
In this tutorial, you install and configure the components required for Financial Close Management.11.1.2.
Before starting this tutorial, you should:
1. |
Have access with sysdba privileges to an Oracle 11g ( 11.1.0.7) database. |
---|---|
2 . |
Have access with administrative rights to an external authentication provider, such as Oracle Internet Directory or Microsoft Active Directory. |
3. |
Have access to the installation files for the following software:
|
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.
Sequence One
If you do not have an existing WebLogic installation, you may choose to install the EPM components first, because their install installs WebLogic automatically if it is not already present. Use the following installation and configuration sequence:
Sequence Two
If you have an existing WebLogic installation, you use the following installation and configuration sequence:
In this tutorial, we are going to follow installation and configuration sequence one.
You can install Financial Close Management in either a single-node or a multi-node configuration. In a single-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 shows an example of an installation for a single-node configuration. For more Information on mutli-node configurations, see the Oracle Hyperion Enterprise Performance Management Installation and Configuration Guide.
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 SOA Suite.
1. |
Navigate to the installation folder for the Hyperion software and click installtool.cmd.
|
---|---|
2 . |
On the Welcome screen, click Next.
|
3 . |
On the Destination screen, select the location for the Middleware Home directory, and click Next. The default directory is c:\oracle\middleware.
|
4 . |
On the Product Selection screen, select Foundation Services and Financial Close, and click Next.
|
5. |
On the Confirmation screen, click Next.
|
6. |
On the Summary screen, click Finish.
|
Installing and configuring SOA Suite requires you to perform the following tasks:
1 . |
In the folder to which you unzipped the utility, navigate to the rcuHome\bin folder and click rcu.bat.
|
---|---|
2 . |
On the Welcome screen, click Next.
|
3 . |
On the Create Repository screen, select Create and click Next.
|
4 . |
On the Database Connection Details screen, enter the database connection details. Be sure to select SYSDBA as the role.
|
5 . |
At the prerequisites confirmation prompt, click OK. If a warning prompt regarding the character set is displayed, click Ignore.
|
6 . |
On the Select Components screen, In the Create a new prefix text box, enter a prefix for the schema tables.
|
7 . |
In the Component list, select Metadata Services, SOA Infrastructure, and User Messaging Service, and click Next.
|
8 . |
At the prerequisites confirmation prompt, click OK.
|
9 . |
On the Schema Passwords screen, select Use same passwords for all schemas, enter a password, and click Next.
|
10 . |
On the Map Tablespace screen, leave the default tablespace names and click Next.
|
11 . |
At the confirmation prompt, click OK.
|
12 . |
At the completion prompt, click OK.
|
13 . |
On the Summary screen, click Create.
|
14 . |
On the Completion Summary screen, click Close.
|
When you install SOA Suite, select the same Middleware Home directory that you specified for Financial Close Management. The Middleware Home directory contains the WebLogic installation, which is required for installing SOA Suite.
1 . |
Navigate to the Disk1 folder in the SOA Suite installation directory, and click Setup.exe.
|
---|---|
2 . |
At the JRE/JDK location prompt, enter c:\oracle\middleware\jdk160_11\jre. The default location for the Java run-time environment is c:\oracle\middleware\JDK160_11\JRE. The default location for the JRE is c:\oracle\middleware\JDK160_11\JRE.
|
3 . |
On the Welcome screen, click Next.
|
4 . |
On the Prerequisites screen, click Next.
|
5 . |
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.
|
6 . |
On the Installation Summary screen, click Install. During the installation process, you may be prompted to browse to the Disk2 and the Disk3 folders to continue the installation.
|
7 . |
On the Installation Progress screen, when the Installation Successful message is displayed, click Next.
|
8 . |
On the Installation Complete screen, click Finish.
|
After installing SOA and running the Repository Creation Utility, you configure SOA and create a WebLogic domain. You later extend this WebLogic domain for Financial Close Management.
1. |
Select Start, then Programs, then Oracle SOA 11g - Home1, and then Configure Application Server.
|
---|---|
2. |
Select Create a new WebLogic domain, and click Next.
|
3 . |
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.
|
4 . |
On the Specify Domain Name and Location screen, enter a domain name and accept the default locations. You must use the same domain name when you configure the EPM components. In this example, the domain name is close_domain.
|
5 . |
On the Configure User Name and Password screen, enter a user name and password for the WebLogic domain administrator. You use this domain administrator name and password for the EPM components as well. In this example, the domain administrator name is weblogic.
|
6 . |
On the WebLogic Domain Startup Mode screen, select Production Mode, then select the Jrockit location, and click Next.
|
7 . |
On the Configure JDBC Component Schema screen, select each component schema and provide the database connection, using the schema password that you entered in the Repository Creation Utility. When finished, click Next.
|
8 . |
On the Test Component Schemas screen, verify that the connections to your data sources are successful, and click Next.
|
9 . |
On the Select Optional Configuration screen, leave the default settings and click Next.
|
10 . |
On the Configuration Summary screen, click Create.
|
11 . |
On the Creating Domain screen, when the process is complete, click Done.
|
After configuring SOA Suite, you create boot.properties files for the Web Logic Admin Server and SOA Server. The boot.properties files enable you to start the services without having to enter a name and password each time. The user name and password stored in boot.properties are encrypted after the first use.
1 . |
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 domain you created in the SOA configuration tool. Enter the Web Logic admin user name and password when prompted. |
---|---|
2 . |
To start the SOA managed server, enter the following command at a DOS prompt: Enter the Web Logic admin user name and password when prompted.
|
3 . |
In Windows explorer, create a directory named security as a subdirectory of c:\oracle\middleware\user_projects\domains\<domain>\servers\AdminServer,
|
4 . |
In a text editor such as Notepad, create a file named boot.properties with the following content: username=<Web Logic admin user> where <Web Logic admin user> is the admin user for Web Logic and <Web Logic admin password> is the password.
|
5 . |
Save boot.properites in c:\oracle\middleware\user_projects\domains\<domain>\servers\AdminServer\security,
|
6 . |
In Windows explorer, create a directory named security as a subdirectory of c:\oracle\middleware\user_projects\domains\<domain>\servers\soa_server1.
|
7 . |
In a text editor such as Notepad, create a file named boot.properties with the following content: username=<Web Logic admin user> where <Web Logic admin user> is the admin user for Web Logic and <Web Logic admin password> is the password.
|
8 . |
Save boot.properties in c:\oracle\middleware\user_projects\domains\<domain>\servers\soa_server1\security.
|
After configuring SOA Suite, you must install the Fusion Middleware patches. You must stop the WebLogic Admin server and the SOA managed server before installing the patches.
1 . |
To stopt the WebLogic Admin Server, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Stop Admin Server, where <domain> is the domain you created in the SOA configuration tool.
|
---|---|
2 . |
To stop the SOA managed server, enter the following command at a DOS prompt:
|
3 . |
Download and follow the instructions for Installing the following patches, which are available from My Oracle Support at http://metalink.oracle.com.:
Note: For Patch 9201797 and 10225883, set ORACLE_HOME to ../ Oracle/Middleware/Oracle_SOA1. For Patch 9538640, set ORACLE_HOME to ../ Oracle/Middleware/oracle_common. |
You must stop the WebLogic Admin server and SOA managed server before you configure the EPM components. The database schemas for the EPM components are created during the configuration process. During the configuration process you must provide valid Oracle database user names and passwords under which to create the schemas. You perform the Deploy to SOA configuration task after you restart WebLogic Server.
1. |
From the Windows Start menu, select Programs, then Oracle EPM System, then Foundation Services, and then EPM System Configurator.
|
---|---|
2 . |
Select all available options under Hyperion Foundation, then select all tasks under Financial Close Management except Deploy to SOA, and click Next.
|
3 . |
Enter the database connection details for the Shared Service database.
|
4 . |
Select Create Windows Services for configured components, and click Next.
|
5 . |
Select Perform 1st-time configuration of database, enter the connection details for the Financial Close Management database, and click Next.
|
6 . |
Select Deploy web applications to an existing domain and enter the information for the WebLogic domain that you created when you configured SOA, and click Next.
|
7 . |
Accept the default application server deployment settings, and click Next.
|
8 . |
Accept the default Configure Web Server settings, and click Next.
|
9 . |
Provide the necessary information if you want to be informed of security updates by email, otherwise click Next and answer Yes at the confirmation prompt.
|
10 . |
In the Password and Re-type Password text boxes, enter a password, and click Next.
|
11 . |
If you want to integrate Oracle Content Management with your Financial Close Management application, enter the URL for Oracle Content Management, and click Next.
|
12 . |
Review your selections, and click Next to launch the configuration.
|
13 . |
When the configuration is complete, click Finish.
|
14 . |
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.
|
15 . |
To start the SOA managed server, enter the following command at a DOS prompt:
|
16 . |
From the Windows Start menu, select Programs, then Oracle EPM System, then Foundation Services, and then EPM System Configurator. . |
17 . |
Expand Financial Close, select Deploy to SOA, and click Next.
|
18 . |
On the Deploy to SOA screen, click Next.
|
19 . |
On the Confirmation screen, click Next to launch the configuration.
|
20 . |
When the configuration is complete, click Finish.
|
You perform the manual configuration tasks after installing and configuring SOA Suite and the EPM components.
To send notifications, you must enable the SOA managed server to communicate with the Financial Close Management server, which is require for sending notifications. The following notification EAR files must be deployed:
Note: You do not need to deploy the FinancialClose EAR file.
1 . |
In 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.
|
---|---|
2 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then<domain>, and then Admin Server Console
|
3 . |
Log on using the WebLogic administrator name and password that you specified for the domain.
|
4 . |
In the WebLogic Server Administration Console, under Domain Structure, click Deployments.
|
5 . |
In the Deployments area, click Install.
|
6 . |
In the Current Location field, browse to c:\Oracle\Middleware\EPMSystem11R1\products\FinancialClose\AppServer\InstallableApps\common. |
7 . |
Select FCCAlertNotification.ear, and click Next.
|
8 . |
Select Install this deployment as an application, and click Next.
|
9 . |
Under Available targets for FCCAlertNotification, select soa_server1, and click Next. Do not target the notification EAR files to any servers other than soa_server1.
|
10 . |
On the Optional Settings screen, under Source accessibility, select Copy this application onto every target for me, and click Next.
|
11 . |
Click Finish.
|
12 . |
Repeat steps 6 to 11 to install FCCNotification.ear and FCCTaskNotification.ear.
|
1 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
|
---|---|
2 . |
In the Domain Structure area, select Services, then JDBC, and then DataSources.
|
3 . |
Click New.
|
4 . |
In the Name text box, enter EDNLocalTxSource, and in the JNDI Name text box enter jdbc/EDNLocalTxSource.
|
5 . |
In the Database Driver list, select Oracle's Driver (Thin) for Service Connections, and click Next.
|
6 . |
On the Transaction Options screen, clear the Supports Global Transactions check box, and click Next.
|
7 . |
Enter your database connection information for the soa_infra schema (you created this schema earlier in the Repository Creation Utility), and click Next.
|
8 . |
Click Test Connection, and when the connection is verified, click Next.
|
9 . |
In the Cluster area, select Financial Close, and click Finish.
|
10 . |
In the Data Source list, click New.
|
11 . |
In the Name text box enter EDNSource, and in the JNDI Name text box, enter jdbc/EDNSource.
|
12 . |
In the Database Driver list, select Oracle's Driver (Thin XA) for Service Connections, and click Next.
|
13 . |
On the Transaction Options screen, leave the default settings, and click Next.
|
14 . |
Enter your database connection information for the soa_infra schema (you created this schema earlier in the Repository Creation Utility), and click Next.
|
15 . |
Click Test Connection, and when the connection is verified, click Next.
|
16 . |
In the Clusters area, select Financial Close, then click Finish..
|
1 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
|
---|---|
2 . |
In the Domain Structure area, select Services, then JDBC, and then DataSources.
|
3 . |
Click finacialclose_datasource.
|
4 . |
Select the Targets tab.
|
5 . |
Select soa_server1, and click Save.
|
1 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
|
---|---|
2 . |
Expand Environment, and then Servers.
|
3 . |
Click soa_server1.
|
4 . |
In the Listen Address text box, enter the host name for the SOA server, and click Save.
|
5 . |
Expand Environment, then Machines, and click Local Machine..
|
6 . |
Select the Node Manager tab.
|
7 . |
In the Listen Address text box, enter the host name for the SOA server, and click Save.
|
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.
1 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
|
---|---|
2 . |
In the Domains Structure area, click Security Realms.
|
3 . |
Click myrealm.
|
4 . |
Select the Providers tab..
|
5 . |
Click New.
|
6 . |
For Oracle Internet Directory, in the Name text box enter OID, and select Oracle Internet Directory Authenticator from the Type list.For Oracle Active Directory, in the Name text box enter MSAD, and select ActiveDirectoryAuthenticator from the Type list.
|
7 . |
Click OK.
|
8 . |
In the Authentication Providers list, click OID or MSAD.
|
9 . |
Select the Provider Specific tab.
|
10 . |
Enter the principal user and credentials, and modify any other settings as required for the provider.
|
11 . |
Click Save.
|
12 . |
In the Domain Structure area, click Security Realms, and then myrealm.
|
13 . |
Select the Providers tab.
|
14 . |
Click Reorder.
|
15 . |
Move OID or MSAD to the second position in the list (after DefaultAuthenticator).
|
16 . |
Click OK.
|
17 . |
In the Authentication Providers list, click OID or MSAD.
|
18 . |
In the Control Flag list, select Sufficient.
|
19 . |
Click Save.
|
20 . |
Click Logout.
|
21 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Stop Admin Server.
|
22 . |
Navigate to the folder c:\oracle\middleware\user_projects\<domain>\<domain>\config\fmwconfig.
|
23 . |
Create a backup of the jps-config.xml file.
|
24 . |
Open the jps-config.xml file in a text editor.
|
25 . |
Add an entry for the service instance provider to the serviceinstances tag, replacing the text in italics with the information for your provider For Oracle Internet Directory: <serviceInstance provider="idstore.ldap.provider" name="idstore.OID"> For Active Directory: <serviceInstance provider="idstore.ldap.provider" name="idstore.AD">
|
26 . |
Add a reference to your newly defined service instance to the <jpsContext name="default"> tag, as in the following example: <jpsContext name="default">
|
27 . |
Save the file.
|
28 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server.
|
1 . |
Enter the following URL to start Oracle Enterprise Manager, replacing <host> with your host name: http://<host>:7001/em . |
---|---|
2 . |
When prompted, enter the WebLogic administrator ID and password.
|
3 . |
Expand User Messaging Service.
|
4 . |
Right-click usermessagingdriver-email(soa_server1) and select Email Driver Properties.
|
5 . |
Enter the information for you email server, and select Clear Text for the password type.
|
6 . |
Click Apply.
|
7 . |
In the left panel, expand the SOA folder, right-click soa-infra (soa-server1), click SOA Administration,
|
8 . |
In the Notification Mode list, select Email.
|
9 . |
In the Email:From Address text box, enter a valid e-mail address.
|
10 . |
Click Apply.
|
11 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Stop Admin Server.
|
12 . |
Select Start, then Programs, then WebLogic, then User Projects, then <domain>, and then Start Admin Server.
|
In a distributed environment, perform steps 2, 3, and 4 on each machine.
1 . |
Stop all managed servers that are running(all Web applications that you deployed, including
|
---|---|
2 . |
Make a backup copy of setDomainEnv.cmd, which is in the BIN folder of the WebLogic domain folder that you created.
|
3 . |
Open setDomainEnv.cmd in a text editor and add the following entries after the LONG_DOMAIN_HOME environment variable. Insert a For example: set LONG_DOMAIN_HOME=C:\Oracle\Middleware\user_projects\domains\<domain> set EPM_ORACLE_HOME=C:\Oracle\Middleware\EPMSystem11R1 set EPM_ORACLE_INSTANCE=C:\Oracle\Middleware\user_projects\epmsystem1
|
4 . |
In setDomainEnv.cmd, after the last instance
that sets POST_CLASSPATH, add epm.jar to the POST_CLASSPATH as follows:
|
5 . |
Save and close setDomainEnv.cmd.
|
6 . |
Copy EPMIdentityAsserter.jar from EPM_ORACLE_HOME/common/SharedServices/ In a distributed environment, perform this step on each machine.
|
7 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server.
|
8 . |
Select Start, then Programs, then WebLogic,then User Projects, then <domain>, and then Admin Server Console.
|
9 . |
In the Domain Structure area, click Security Realms.
|
10 . |
Click myrealm.
|
11 . |
Select the Providers tab.
|
12 . |
Click New.
|
13 . |
Enter EPMAsserter in the Name text box, and select EPMIdentityAsserter from the Type list.
|
14 . |
Click OK.
|
15 . |
Reorder the providers list so that EPMAsserter is in the third position. |
16 . |
In the providers list, click Default Authenticator.
|
17 . |
In the Control Flag list, select Sufficient.
|
18 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Stop Admin Server.
|
19 . |
Select Start, then Programs, then WebLogic, then User Projects, then <domain>, and then Start Admin Server.
|
1 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
|
---|---|
2 . |
In the Domain Structure area, click Security Realms.
|
3 . |
From the Available Realms list, click myrealm.
|
4 . |
Select the Roles and Policies tab.
|
5 . |
In the Available Role list, expand Global Roles, and click Roles. |
6 . |
Click New.
|
7 . |
Enter valid_users for the role name.
|
8 . |
Click OK.
|
9 . |
In the Global Roles list, click valid_users.
|
10 . |
In the Role Conditions area, click Add Conditions.
|
11 . |
In Predicate List, select Allow access to everyone.
|
12 . |
Click Finish, and then Save
|
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:
1 . |
At a dos prompt, enter the following command to add the JDK to the path: set PATH=%PATH%;C:\Oracle\Middleware\jdk160_11\bin\ The JDK must be included in the path in order to run the Java keystore utility. |
---|---|
2 . |
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 entering the following command: This command creates a keystore with the name default-keystore.jks if it does not You can change the alias, password, and domain name as needed in the
|
3 . |
Enter the following URL to start Oracle Enterprise Manager, replacing <host> with your host name: http://<host>:7001/em . |
4 . |
Enter your Weblogic adminstrator name and password to login.
|
5 . |
In the navigation pane, select Weblogic Domain, then select the WebLogic domain you created in the SOA configuration tool.
|
6 . |
Select WebLogic Domain, then Security, and then Security Provider Configuration.
|
7 . |
In the Keystore section at the bottom of the page, click Configure.
|
8 . |
In the Keystore Path text box, enter the path and name for the keystore you created.
|
9 . |
In the Signature Key and Encryption key text boxes, enter an alias and password for the signature and encryption keys.
|
10 . |
Click OK. For a distributed environment, the keystore (default-keystore.jks) and the cwallet.sso files must be copied to each Web application server within the environment. Copy these file to the <domain>/config/fmwconfig folder, where <domain> is the domain you created using the SOA configuration tool. |
1 . |
Select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Admin Server Console.
|
---|---|
2 . |
In the Domain Structure area, expand Environment, then Services, then JDBC, and then Datasources.
|
3 . |
In the Name list, click EDNSource.
|
4 . |
Select the Connection Pool tab.
|
5 . |
In the Maximum Capacity text box, enter 150.
|
6 . |
Click Save.
|
7 . |
In the Domain Structure area, click Data Sources to return to the list of data sources.
|
8 . |
Repeat steps 3 to 6 to increase the connection pools for the EDNLocalTxSource and financialclose_datasource services to 150.
|
9 . |
In the Name list, click SOADataSource.
|
10 . |
Select the Transaction tab.
|
11 . |
Select Set XA Transaction Timeout and verify that the XA Transaction Timeout value is 0.
|
12 . |
Click Save.
|
You must start the servers required for Financial Close Management in the following order:
1 . |
To start the WebLogic Admin server, select Start, then Programs, then Oracle WebLogic, then User Projects, then <domain>, and then Start Admin Server.
|
---|---|
2 . |
To start Foundation Services, select Start, then Programs, then Oracle EPM System, then Foundation Services, and then Start FoundationServices.
|
3 . |
To start the Oracle HTTP server, select Start, then Programs, then Oracle Web Tier Instance, and then Start Oracle HTTP server.
|
4 . |
To start the SOA managed server, enter the following command at a DOS prompt:
|
5 . |
To start Foundation Services, select Start, then Programs, then Oracle EPM System, then Financial Close, then Start FinancialClose.
|
In this tutorial, you have learned how to:
![]() |
About
Oracle | ![]() |