Upload
others
View
16
Download
0
Embed Size (px)
Citation preview
AuraPlayer Support Team Version 2 2/7/2011
Installation Guide Installing AuraPlayer Components
This document is the sole property of AuraPlayer Ltd., it cannot be communicated to third parties and/or
reproduced without the written authorization from AuraPlayer Ltd.
2 | P a g e C o n f i d e n t i a l
Installation Requirements
1. Pre-requisites Permissions……………………..……………………………...............………..4
2. AuraPlayer Installation Files………………………………….................……………………….4
Installation Process
1. Installing AuraPlayer: The Steps……………………..…………………………….............……5
2. Installing the AuraPlayer Recording Agent on the Oracle Forms Server…..…….5
3. Installing ServiceManager: AuraPlayer WAR file Installation in Weblogic……….6
Launching the Service Manager
1. Starting the Service Manager Service in Weblogic……………...…..…………….........12
2. Accessing the Service Manager Console……………..………………………...................13
Browser Security Configuration
1. Set certificate on Java console on client machine ....……….....……...................13
Optional Configuration Instructions
1. Adding New Users for Service Manager Authentication.................………..…….…..........15
2. Editing Forms Web Configuration using Enterprise Manager…................………………….19
3 | P a g e C o n f i d e n t i a l
Installation Requirements
Installation pre-requisites and permissions Pre-Requisites: Please see the AuraPlayer pre-requisites document for full details
1. Oracle Forms server version 9i and up or EBS version 12.X and up
2. Oracle Forms server machine with Weblogic 10.x installed
Permissions to:
1. Add a jar file and a properties file to the Java folder of Oracle Forms server
2. Edit the formsweb.cfg file on the Oracle Forms Server machine
3. Restart the Oracle Forms server in order to complete installation (if it is on version 11g)
Installation files The following files will be sent to you upon installation:
1. AuraPlayerAgent.jar
2. Auraplayer.properties
3. ServiceManager.war
4. AuraPlayerCertificate.p12
Installation Process
1. Installing AuraPlayer - The steps
1. Copy AuraPlayerAgent.jar and properties files to the java folder of the Oracle Forms Server
2. Set the archive path of the Oracle Forms server to point to the new jar (AuraPlayerAgent.jar) file
that was copied
3. Restart Oracle Forms server
4. Deploy AuraPlayer's ServiceManager.war on weblogic server (may be installed on the same
server as the jar file).
5. Install certificate (AuraPlayerCertificate.p12) on the client machine and run ServiceManager.war
(required only on the recording machine)
2. Installing the Recording Agent
1. Copy the AuraPlayerAgent.jar and the auraplayer.properties files to the java home directory on
the Oracle Forms server machine: Forms 11g R2 - <Middleware Home>\FRMHome\forms\java
Example: C:\Oracle\Middleware\FRMHome\forms\java
2. In order to avoid security collisions, if you have other jar files in the Oracle Forms environment
that you sign as part of your Oracle Forms deployment process, such as WebUtils, you have to
sign AuraPlayerAgent.jar as well with the same certificate.
4 | P a g e C o n f i d e n t i a l
3. Make a backup of the formsweb.cfg file. Add the AuraPlayerAgent.jar file to Oracle Forms'
classpath. This can be done either by editing the Forms configuration section of your Oracle Form
or by creating a new configuration section for AuraPlayer.
You can do both by editing the Forms configuration in weblogic's Enterprise Manager in Section
1, or by editing the formsweb.cfg directly.
The location of formsweb.cfg is:
Forms 11g R2 – <Forms Home config>\applications\formsapp_11.1.2\config
For example:
C:\Oracle\Middleware\user_projects\domains\FRMDomain\config\fmwconfig\servers\WLS_FOR
MS\applications\formsapp_11.1.2\config
You must edit the formsweb.cfg file in notepad++ and add the AuraPlayerAgent.jar to the
archive parameter, as follows:Find “archive_” and add AuraPlayerAgent.jar to the end of the
line.
For example:
archive_jini= AuraPlayerAgent.jar ,frmall_jinit.jar
archive= AuraPlayerAgent.jar,frmall.jar
4. In the web.cfg file, make sure that parameter "otherparams" the record parameter is %record%
For example: otherparams=record=%record%
5. Restart weblogic Forms Server - WLS_FORMS to complete the installation
3. Installing ServiceManager:
AuraPlayer WAR file Installation in Weblogic
1. Login to the Oracle Weblogic console
http://<hostname>.<domain>:<port>/console - Default port is usually 7001
5 | P a g e C o n f i d e n t i a l
2. On the left middle pane, “Domain Structure” press "Deployment"
3. On the left top pane in the “Change Center” section click on the “Lock & Edit” button. It will
become disabled (greyed out), and “Release Changed” will become active.
4. Click on the Control tab and in the Deployment section and click the “Install” button
5. Click the “upload your files” link found above the Path variables
6 | P a g e C o n f i d e n t i a l
6. In the “Deployment Archive” section press the “choose file” button
7. Choose the "ServiceManager.war" file (found in the folder it was downloaded into). Click the
“Open” button and then the “Next” button of the wizard
7 | P a g e C o n f i d e n t i a l
8. The file will be uploaded to the server. You can see the progress of the upload on the status bar
at the bottom.
9. Keep the defaults and Click on the “Next” button
10. Keep the defaults and Click on the “Next” button
8 | P a g e C o n f i d e n t i a l
11. Select the Deployment server target:
a. Select the Server to install the ServiceManager on. It can be installed on the Admin
Server for test or POC environments.
However, we suggest you install it on a different Server for AuraPlayer production
environments.
creating new managed server is explained on the following link:
http://docs.oracle.com/cd/E13222_01/wls/docs90/ConsoleHelp/taskhelp/domainconfig
/CreateManagedServers.html
12. After making your server selection click “Next”
9 | P a g e C o n f i d e n t i a l
13. Keep the default vales checked and click “Finish” to Finalize deployment
14. After you have completed the step you must commit the changes to the repository for it to take
effect. On the top left pane, press “Activate Changes” button.
15. You have now deployed ServiceManager to weblogic successfully
10 | P a g e C o n f i d e n t i a l
Launching the Service Manager
Starting the ServiceManager Service in Weblogic
In the control tab of the Server, check the checkbox next to the ServiceManager. Click "Start" on
the top toolbar and select "Servicing All requests" from the drop down list and choose "Yes" to
start the ServiceManager deployment.
11 | P a g e C o n f i d e n t i a l
Accessing the Service Manager Console You can access the ServiceManger, by entering the server's URL below
Example: http://ec2-54-184-135-202.us-west-
2.compute.amazonaws.com:8080/ServiceManager/www/auraplayer/index.html#/login
Enter your weblogic admin password. Once you log in, the Service Manager main screen will appear
Please refer to the "Service Manager User Guide" for more information about the Service
Manager.
12 | P a g e C o n f i d e n t i a l
Set certificate for Java console on client machine 1. Open Java Console from Start-> Control Panel ->Java
2. Click the Security tab
3. Click "Edit Site List…"
4. Click "Add" to add the host and port of your Oracle Forms server
In this example: http://ec2-54-203-157-52.us-west-2.compute.ama:9001/, where the forms URL is
on: http://ec2-54-203-157-52.us-west-
2.compute.ama:9001/forms/frmservlet?config=ComplexScenario
13 | P a g e C o n f i d e n t i a l
5. Click "Manage Certificates…"
14 | P a g e C o n f i d e n t i a l
6. Select Certificate Type: "Trusted Certificates"
7. Click "Import"
8. Select the "AuraPlayerCertificate.p12" file. Make sure you see OraPlayer LTD on the "Issued To" table
9. Choose "Signer CA" from "Certificates"
10. Click the "Import" button
11. Select AuraPlayerCertificate.p12 file from the directory where you copied the AuraPlayer install files.
This certificate comes with your AuraPlayer install files.
12. Make sure you'll see OraPlayer LTD on the "Issued To" table.
15 | P a g e C o n f i d e n t i a l
Creating New Users for Service Manager Management (Optional) AuraPlayer's Service Manager uses WebLogic's user management system for authentication.
Service Manager's default configuration grants full access permissions to group members of the
Administrators group, and limited access to group members of the Operators group.
Additionally Service Manager has pre-configured roles of two custom security Groups
ServiceManagerAdmins – members can fully administer the Service Manager
ServiceManagerUsers – members have limited accessibility
In order to use these roles, they must be created in WebLogic's administration console, and then
optionally create new users or use existing users to be associated with these groups.
Creating Groups in WebLogic's Administration console 1. Log in to WebLogic's Administration console
2. On the left pane, click "Security Realms"
3. Choose your realm
4. Click "Users and groups"
5. Click "New" to create a new group
16 | P a g e C o n f i d e n t i a l
6. Enter the name of the group, in this example: "ServiceManagerAdmins"
7. Click "OK"
8. Repeat this process and create "ServiceManagerUsers"
17 | P a g e C o n f i d e n t i a l
Creating a new User in WebLogic's Administration console 1. In the Users and Groups configuration page, click "Users"
2. Click "New" to create a new user
3. Enter name and password and click OK
18 | P a g e C o n f i d e n t i a l
Associate a User with Group in WebLogic's Administration console 1. Click on the user to be configured
2. Click "Groups" from the top menu
3. Choose the desired group from the list (e.g. ServiceManagerAdmins )
4. Click the top right arrow to move group from the Available list to the Chosen list
5. Click Save
6. User now has group permissions, repeat as needed, restart is not required.
19 | P a g e C o n f i d e n t i a l
Edit Oracle Forms web configuration in weblogic
1. Open Enterprise manager (http://<weblogic>:<port>/em)
2. On the left pane click "Farm_<domain>"-> "Forms"-> "forms"
3. On the drop down at the top, "Forms" -> select "Web Configuration"
20 | P a g e C o n f i d e n t i a l
4. Click "Create Like" on the top menu
5. Select the section to duplicate (for example summit), and give it a new section name (for
example: summit_auraplayer). And click "Create".
6. In the "Section" area, open the "Show" drop down and select "plugin"
7. In the "archive" property, add "AuraPlayerAgent.jar," at the beginning of the value line (add
comma, no space)
21 | P a g e C o n f i d e n t i a l
8. In the "Section" area, from the "Show" drop down, select "advanced"
9. On the property "otherparams" make sure " record=%record% " (one space before and after
it)
10. Click "Apply"
11. No restart is required