Kishore Analytics Solutions: Installing and Deploying Shared Services to Oracle Application Server 10gR3

Purpose

This tutorial covers installing and configuring Hyperion Shared Services 9.3.1 and deploying Shared Services on Oracle Application Server 10gR3.

Overview

In this tutorial, you install and configure Hyperion Shared Services 9.3.1. You then manually deploy Shared Services to Oracle Application Server 10gR3 by creating and configuring an OC4J instance and deploying the WAR file.

Scenario

As an IT professional, you are tasked with installing Shared Services 9.3.1 and deploying it on Oracle Application Server 10gR3.

Prerequisites

Before starting this tutorial, you should:

1.	Have created an Oracle database for Shared Services
2.	Have the appropriate access privileges in Oracle Application Server to create a new OC4J instance

Installing and Configuring Shared Services 9.3.1

In this topic, you download the Hyperion Shared Services 9.3.1 installer. You then install and configure Shared Services.

1.	On the Oracle e-Delivery site, select to download Hyperion Shared Services Release 9.3.1.
2.	Save the ZIP file to a temporary directory.
3.	Unzip the ZIP file and double-click setup.exe to launch the installer.
4.	In the language list, select English and click OK.
5.	Review the Welcome screen and click Next.
6.	For the location, accept the default of United States and click Next.
7.	Review the license agreement, select I AGREE, and click Next.
8.	On the Hyperion Home page, accept the default directory of C:\Hyperion and click Next.
9.	On the directory name page, accept the default directory of C:\Hyperion\SharedServices\9.3.1 and click Next.
10.	For the setup type, select Custom and click Next.
11.	Select the checkboxes for Hyperion Shared Services and Hyperion Shared Services Server and click Next.
12.	Review the summary information and click Next.
13.	When the installation is completed, click Next.
14.	Click Finish to close the installer.
15.	Select Start > All Programs > Hyperion > Foundation Services > Configuration Utility.
16.	In the language list, select English and click OK.
17.	Click Next.
18.	Select the check boxes for Foundation, Hyperion Shared Services, Configure Database, and Deploy to Application Server, and click Next.
19.	For database type, select Oracle and click Next.
20.	Enter the database details for the Shared Services database and click Next.
21.	On the application server page, select Manual as the deployment type for the Generic server, and click Next.
22.	Review the Summary information and click Next.
23.	When configuration is completed, click Next.
24.	When prompted to return to the Product Selection Panel, select No and click Next.
25.	Click Finish to close the Configuration Utility.

Creating and Configuring an OC4J Instance

In this topic, you create and configure an OC4J instance by using Oracle Enterprise Manager.

Note: To prevent all deployed applications from inheriting unwanted JVM runtime settings, you must create and use a new OC4J instance. Deploying more than one web application to the same OC4J instance may yield unsuccessful results.

Creating an OC4J Instance

1.	Connect to Oracle Enterprise Manager Application Server Control (for example, http://<servername>:19000/em)
2.	Click the name of the application server.
3.	Click Create OC4J Instance.
4.	In the OC4J instance name field, enter SharedServices.
5.	Select Add to a new group with name, and in the New Group Name field, enter SharedServices. Note: OC4J group administrative settings such as environment variables are shared by all group members. The OC4J instance you create for the Web application being deployed should be assigned to a group created specifically for that application. (When an application is deployed to more than one OC4J instance, those instances can be assigned to the same group.) For example, when deploying Shared Services and Workspace, the OC4J instance created for Shared Services should be assigned to a different group than the instance created for Workspace. Refer to the Oracle Process Manager and Notification Server Administrator's Guide for more information about groups.
6.	Select Start this OC4J instance after creation and click Create.
	The OC4J instance is created and added to the SharedServices group .
7.	Click Logout to close Oracle Enterprise Manager 10g Application Server Control.

Configuring an OC4J Instance

1.	Navigate to %ORACLE_HOME%\j2ee\SharedServices\config and select global-web-application.xml.
2.	Select File > Open With > Choose Program.
3.	Select WordPad and click OK.
4.	Add the following block inside the jsp <servlet> definition:
	The complete block should resemble:
5.	Connect to Oracle Enterprise Manager Application Server Control.
6.	Click the SharedServices OC4J instance link.
7.	Click Administration.
8.	Click the . button next to Server Properties.
9.	Change the Maximum heap size to 512m, and the Initial heap size to 256m.
10.	Under Start-parameters: Java Options, click Add Another Row and append the following Java options: -Dhyperion.home=C:\hyperion -XX:PermSize=64m -XX:MaxPermSize=128m
11.	Click Apply.
12.	Click Cluster Topology.
13.	Select the checkbox for SharedServices and click Restart.
14.	Click Yes to confirm that you want to restart the instance.
	The OC4J instance is restarted.

Deploying Shared Services on Oracle Application Server 10g

In this topic, you deploy the Shared Services interop.war file on Oracle Application Server 10g.

1.	On the Cluster Topography page, click the SharedServices OC4J instance link.
2.	Click Applications.
3.	Click Deploy.
4.	Select Archive is already present on the server where Application Server Control is running, enter \Hyperion\deployments\generic\SharedServices9\config\interop.war , and click Next.
5.	In the Application Name field, enter SharedServices, and click Next.
6.	Click the button next to Configure Class Loading.
7.	In the Classpath dialog box, enter the following Java archives, separated by semi-colons, and click OK: c:/hyperion/deployments/generic/SharedServices9/config; c:/hyperion/deployments/generic/SharedServices9/config/lib; c:/hyperion/common/JDBC/DataDirect/3.6/lib/hyjdbc.jar; c:/hyperion/common/JakartaCommons/commons-collections-3.2.jar; c:/hyperion/common/JakartaCommons/commons-dbcp-1.2.1.jar; c:/hyperion/common/JakartaCommons/commons-logging-1.1.jar; c:/hyperion/common/JakartaCommons/commons-pool-1.3.jar; c:/hyperion/common/loggers/Log4j/1.2.14/lib/log4j-1.2.14.jar; c:/hyperion/common/XML/JAXP/1.2.2/xercesImpl.jar; c:/hyperion/common/SAP/lib
8.	Click Deploy.
9.	Review the confirmation screen and click Return.
10.	In the Windows Services window, select Hyperion S9 OpenLDAP and click Start if the service is not already running.
11.	Navigate to C:\Hyperion\deployments\generic\SharedServices9\config and select the CSS.xml file.
12.	Select File > Open With > Choose Program.
13.	Select WordPad and click OK.
14.	Modify the hub location with the correct hostname and port for your Oracle HTTP Server, as follows:
15.	Select File > Save to save the file, and exit Wordpad.
16.	Log on to Oracle Enterprise Manager 10g Application Server Control.
17.	Select the checkbox for SharedServices, and click Restart.
18.	Click Yes to confirm that you want to restart the service, and wait for confirmation that the service has started successfully.
19.	Open Internet Explorer, and enter http://<servername>:19000/interop in the address bar, where <servername> is the name of your Oracle Web server.
20.	Enter admin as the username and password as the password, and click Log On.
	Congratulations! You have successfully deployed Shared Services on OAS 10g.