Installing the OHW-RC Demo EAR File on Oracle WebLogic Server

Understanding OHW-RC Deployment 18-3

18.3 Installing OHW-RC Artifacts

There are some files needed to be installed on the server to make OHW-RC working. The details about this will be shown in different possible deployment of OHW-RC topics. The OHW-RC distributable components consist of JAR files like ohw-rcf.jar, ohw-share.jar, help-share.jar, and ohw-rcf-webapp.zip. The ohw-rcf-webapp.zip contains the helppages directory, which contains installable files like jspx XML style of a JSF page that are needed to run OHW-RC properly. All artifacts are available on OTN for download.

18.4 Understanding OHW-RC Configuration Files

Before you start deploying the OHW-RC helpset, there are some files that need to be created or modified to configure OHW-RC correctly. The following information will help you understand the XML configuration files: ■ application.xml : A manifest of all web modules that run under a given Java EE application. It points to each web module of each product that is deployed. The name and location of application.xml is fixed by the Java EE standard. The file is available in OHW-RC_HOME\META-INF\ directory. ■ web.xml : Sets the initialization parameters for the OHW-RC components, including the location of the OHW-RC configuration file. There is one instance of web.xml for each web module. The file is available in OHW-RC_ HOME\OHW-RC_deployment_name\WEB-INF\ directory. There is a minimum set of parameters need to be set in order to assure all prerequisites for OHW-RC are loaded and initialized correctly: – JSF servlet and servlet mapping – Trinidad resource servlet, servlet mapping, filter and filter mapping – OHW-RC filter and filter mapping – help instance servlet and servlet mapping The following example shows a sample web.xml file: context-param param-nameorg.apache.myfaces.trinidad.CHANGE_PERSISTENCEparam-name param-valueoracle.adf.view.rich.change.FilteredPersistenceChangeManagerpara m-value context-param filter filter-nametrinidadfilter-name filter-classorg.apache.myfaces.trinidad.webapp.TrinidadFilterfilter-class filter filter-mapping filter-nametrinidadfilter-name servlet-nameFaces Servletservlet-name filter-mapping servlet servlet-nameFaces Servletservlet-name servlet-classjavax.faces.webapp.FacesServletservlet-class load-on-startup1load-on-startup servlet 18-4 Oracle Fusion Middleware Developers Guide for Oracle Help servlet-mapping servlet-nameFaces Servletservlet-name url-patternfacesurl-pattern servlet-mapping servlet servlet-nameresourcesservlet-name servlet-classorg.apache.myfaces.trinidad.webapp.ResourceServletservlet-clas s servlet servlet-mapping servlet-nameresourcesservlet-name url-patternadfurl-pattern servlet-mapping servlet-mapping servlet-nameresourcesservlet-name url-patternafrurl-pattern servlet-mapping -- configuration for product1 help front servlet -- servlet servlet-nameproduct1servlet-name servlet-classoracle.help.web.rich.OHWServletservlet-class init-param param-nameohwConfigFileURLparam-name param-valuehelpsetsproduct1ohwconfig.xmlparam-value init-param load-on-startup2load-on-startup servlet -- configuration for product2 help front servlet -- servlet servlet-nameproduct2servlet-name servlet-classoracle.help.web.rich.OHWServletservlet-class init-param param-nameohwConfigFileURLparam-name param-valuehelpsetsproduct2ohwconfig.xmlparam-value init-param load-on-startup3load-on-startup servlet -- servlet mappings for the OHW-RC front servlets -- servlet-mapping servlet-nameproduct1servlet-name url-patternproduct1url-pattern servlet-mapping servlet-mapping servlet-nameproduct2servlet-name url-patternproduct2url-pattern servlet-mapping -- OHW-RC servlet filter definition and mappings -- filter filter-nameOHWRCFRequestFilterfilter-name filter-classoracle.help.web.rich.OHWFilterfilter-class filter filter-mapping filter-nameOHWRCFRequestFilterfilter-name