AuraPlayerSupportTeamVersion22/7/2011

InstallationGuideInstallingAuraPlayerComponents

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

InstallationRequirements

1. Pre-requisitesPermissions……………………..……………………………...............………..4

2. AuraPlayerInstallationFiles………………………………….................……………………….4

InstallationProcess

1. InstallingAuraPlayer:TheSteps……………………..…………………………….............……5

2. InstallingtheAuraPlayerRecordingAgentontheOracleFormsServer…..…….5

3. InstallingServiceManager:AuraPlayerWARfileInstallationinWeblogic……….6

LaunchingtheServiceManager

1. StartingtheServiceManagerServiceinWeblogic……………...…..…………….........12

2. AccessingtheServiceManagerConsole……………..………………………...................13

BrowserSecurityConfiguration

1.SetcertificateonJavaconsoleonclientmachine....……….....……...................13

OptionalConfigurationInstructions

1. AddingNewUsersforServiceManagerAuthentication.................………..…….…..........15

2. EditingFormsWebConfigurationusingEnterpriseManager…................………………….19

3|P a g e C o n f i d e n t i a l

InstallationRequirements

Installationpre-requisitesandpermissionsPre-Requisites:PleaseseetheAuraPlayerpre-requisitesdocumentforfulldetails

1. OracleFormsserverversion9ianduporEBSversion12.Xandup2. OracleFormsservermachinewithWeblogic10.xinstalled

Permissionsto:

1. AddajarfileandapropertiesfiletotheJavafolderofOracleFormsserver2. Edittheformsweb.cfgfileontheOracleFormsServermachine3. RestarttheOracleFormsserverinordertocompleteinstallation(ifitisonversion11g)

InstallationfilesThefollowingfileswillbesenttoyouuponinstallation:

1. AuraPlayerAgent.jar2. Auraplayer.properties3. ServiceManager.war4. AuraPlayerCertificate.p12

InstallationProcess

1.InstallingAuraPlayer-Thesteps

1. CopyAuraPlayerAgent.jarandpropertiesfilestothejavafolderoftheOracleFormsServer2. SetthearchivepathoftheOracleFormsservertopointtothenewjar(OraPlayerAgent.jar)file

thatwascopied3. RestartOracleFormsserver4. DeployAuraPlayer'sServiceManager.waronweblogicserver(maybeinstalledonthesame

serverasthejarfile).5. Installcertificate(AuraPlayerCertificate.p12)ontheclientmachineandrunServiceManager.war

(requiredonlyontherecordingmachine)

2. InstallingtheRecordingAgent

1. CopytheOraPlayerAgent.jarandtheauraplayer.propertiesfilestothejavahomedirectoryontheOracleFormsservermachine:Forms11gR2-<MiddlewareHome>\FRMHome\forms\javaExample:C:\Oracle\Middleware\FRMHome\forms\java

2. Inordertoavoidsecuritycollisions,ifyouhaveotherjarfilesintheOracleFormsenvironmentthatyousignaspartofyourOracleFormsdeploymentprocess,suchasWebUtils,youhavetosignAuraPlayerAgent.jaraswellwiththesamecertificate.

4|P a g e C o n f i d e n t i a l

3. Makeabackupoftheformsweb.cfgfile.AddtheAuraPlayerAgent.jarfiletoOracleForms'classpath.ThiscanbedoneeitherbyeditingtheFormsconfigurationsectionofyourOracleFormorbycreatinganewconfigurationsectionforAuraPlayer.

YoucandobothbyeditingtheFormsconfigurationinweblogic'sEnterpriseManagerinSection1,orbyeditingtheformsweb.cfgdirectly.

Thelocationofformsweb.cfgis:

Forms11gR2–<FormsHomeconfig>\applications\formsapp_11.1.2\config

Forexample:C:\Oracle\Middleware\user_projects\domains\FRMDomain\config\fmwconfig\servers\WLS_FORMS\applications\formsapp_11.1.2\config

Youmustedittheformsweb.cfgfileinnotepad++andaddtheOraPlayerAgent.jartothearchiveparameter,asfollows:Find“archive_”andaddAuraPlayerAgent.jartotheendoftheline.

Forexample:

archive_jini=AuraPlayerAgent.jar,frmall_jinit.jararchive=AuraPlayerAgent.jar,frmall.jar

4. Intheformsweb.cfgfile,makesurethatparameter"otherparams"therecordparameteris%record%

Forexample:otherparams=record=%record%

5. RestartweblogicFormsServer-WLS_FORMStocompletetheinstallation

3. InstallingServiceManager:AuraPlayerWARfileInstallationinWeblogic

1. LogintotheOracleWeblogicconsole

http://<hostname>.<domain>:<port>/console-Defaultportisusually7001

5|P a g e C o n f i d e n t i a l

2. Ontheleftmiddlepane,“DomainStructure”press"Deployment"

3. Onthelefttoppaneinthe“ChangeCenter”sectionclickonthe“Lock&Edit”button.Itwillbecomedisabled(greyedout),and“ReleaseChanged”willbecomeactive.

4. ClickontheControltabandintheDeploymentsectionandclickthe“Install”button5. Clickthe“uploadyourfiles”linkfoundabovethePathvariables

6|P a g e C o n f i d e n t i a l

6. Inthe“DeploymentArchive”sectionpressthe“choosefile”button

7. Choosethe"ServiceManager.war"file(foundinthefolderitwasdownloadedinto).Clickthe“Open”buttonandthenthe“Next”buttonofthewizard

7|P a g e C o n f i d e n t i a l

8. Thefilewillbeuploadedtotheserver.Youcanseetheprogressoftheuploadonthestatusbar

atthebottom.9. KeepthedefaultsandClickonthe“Next”button

10. KeepthedefaultsandClickonthe“Next”button

8|P a g e C o n f i d e n t i a l

11. SelecttheDeploymentservertarget:

a. SelecttheServertoinstalltheServiceManageron.ItcanbeinstalledontheAdminServerfortestorPOCenvironments.However,wesuggestyouinstallitonadifferentServerforAuraPlayerproductionenvironments.creatingnewmanagedserverisexplainedonthefollowinglink:http://docs.oracle.com/cd/E13222_01/wls/docs90/ConsoleHelp/taskhelp/domainconfig/CreateManagedServers.html

12. Aftermakingyourserverselectionclick“Next”

9|P a g e C o n f i d e n t i a l

13. Keepthedefaultvalescheckedandclick“Finish”toFinalizedeployment

14. Afteryouhavecompletedthestepyoumustcommitthechangestotherepositoryforittotakeeffect.Onthetopleftpane,press“ActivateChanges”button.

15. YouhavenowdeployedServiceManagertoweblogicsuccessfully

10|P a g e C o n f i d e n t i a l

LaunchingtheServiceManagerStartingtheServiceManagerServiceinWeblogic

InthecontroltaboftheServer,checkthecheckboxnexttotheServiceManager.Click"Start"onthetoptoolbarandselect"ServicingAllrequests"fromthedropdownlistandchoose"Yes"tostarttheServiceManagerdeployment.

11|P a g e C o n f i d e n t i a l

AccessingtheServiceManagerConsoleYoucanaccesstheServiceManger,byenteringtheserver'sURLandadding"/ServiceManager"

Example:http://<weblogicServer>:<port>/ServiceManager

Enteryourweblogicadminpassword.Onceyoulogin,theServiceManagermainscreenwillappear

Pleaserefertothe"ServiceManagerUserGuide"formoreinformationabouttheServiceManager.

12|P a g e C o n f i d e n t i a l

SetcertificateforJavaconsoleonclientmachine1. OpenJavaConsolefromStart->ControlPanel->Java2. ClicktheSecuritytab3. Click"EditSiteList…"

4. Click"Add"toaddthehostandportofyourOracleFormsserverInthisexample:http://ec2-54-203-157-52.us-west-2.compute.ama:9001/,wheretheformsURLison: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"ManageCertificates…"

14|P a g e C o n f i d e n t i a l

6. SelectCertificateType:"TrustedCertificates"7. Click"Import"8. Selectthe"AuraPlayerCertificate.p12"file.MakesureyouseeOraPlayerLTDonthe"IssuedTo"table

9. Choose"SignerCA"from"Certificates"10. Clickthe"Import"button11. SelectAuraPlayerCertificate.p12filefromthedirectorywhereyoucopiedtheAuraPlayerinstallfiles.

ThiscertificatecomeswithyourAuraPlayerinstallfiles.12. Makesureyou'llseeOraPlayerLTDonthe"IssuedTo"table.

15|P a g e C o n f i d e n t i a l

CreatingNewUsersforServiceManagerManagement(Optional)AuraPlayer'sServiceManagerusesWebLogic'susermanagementsystemforauthentication.

ServiceManager'sdefaultconfigurationgrantsfullaccesspermissionstogroupmembersoftheAdministratorsgroup,andlimitedaccesstogroupmembersoftheOperatorsgroup.

AdditionallyServiceManagerhaspre-configuredrolesoftwocustomsecurityGroups

• ServiceManagerAdmins–memberscanfullyadministertheServiceManager• ServiceManagerUsers–membershavelimitedaccessibility

Inordertousetheseroles,theymustbecreatedinWebLogic'sadministrationconsole,andthenoptionallycreatenewusersoruseexistinguserstobeassociatedwiththesegroups.

CreatingGroupsinWebLogic'sAdministrationconsole 1. LogintoWebLogic'sAdministrationconsole2. Ontheleftpane,click"SecurityRealms"3. Chooseyourrealm

4. Click"Usersandgroups"5. Click"New"tocreateanewgroup

16|P a g e C o n f i d e n t i a l

6. Enterthenameofthegroup,inthisexample:"ServiceManagerAdmins"7. Click"OK"

8. Repeatthisprocessandcreate"ServiceManagerUsers"

17|P a g e C o n f i d e n t i a l

CreatinganewUserinWebLogic'sAdministrationconsole1. IntheUsersandGroupsconfigurationpage,click"Users"2. Click"New"tocreateanewuser

3. EnternameandpasswordandclickOK

18|P a g e C o n f i d e n t i a l

AssociateaUserwithGroupinWebLogic'sAdministrationconsole1. Clickontheusertobeconfigured

2. Click"Groups"fromthetopmenu3. Choosethedesiredgroupfromthelist(e.g.ServiceManagerAdmins)4. ClickthetoprightarrowtomovegroupfromtheAvailablelisttotheChosenlist5. ClickSave6. Usernowhasgrouppermissions,repeatasneeded,restartisnotrequired.

19|P a g e C o n f i d e n t i a l

EditOracleFormswebconfigurationinweblogic

1. OpenEnterprisemanager(http://<weblogic>:<port>/em)2. Ontheleftpaneclick"Farm_<domain>"->"Forms"->"forms"3. Onthedropdownatthetop,"Forms"->select"WebConfiguration"

20|P a g e C o n f i d e n t i a l

4. Click"CreateLike"onthetopmenu5. Selectthesectiontoduplicate(forexamplesummit),andgiveitanewsectionname(for

example:summit_auraplayer).Andclick"Create".

6. Inthe"Section"area,openthe"Show"dropdownandselect"plugin"7. Inthe"archive"property,add"OraPlayerAgent.jar,"atthebeginningofthevalueline(add

comma,nospace)

21|P a g e C o n f i d e n t i a l

8. Inthe"Section"area,fromthe"Show"dropdown,select"advanced"9. Ontheproperty"otherparams"makesure"record=%record%"(onespacebeforeandafter

it)10. Click"Apply"11. Norestartisrequired