Installing the OHW-UIX Demo EAR File using Oracle JDeveloper

22-4 Oracle Fusion Middleware Developers Guide for Oracle Help only one helpSet element in the booksbooks section, the helpset switcher is not available. c. Update the brandingsbrandings section to display your own brand. For example: brandings branding text=My Module brandings 4. Download the cabo and OHW-UIX library files from OTN. Copy the cabo files in OHW-UIX_HOME\OHW-UIX_deployment_name\cabo and library files in OHW-UIX_HOME\OHW-UIX_deployment_name\WEB-INF\lib directory. You may also copy the library files from demo EAR file. The files are available in ohw-uix-demo\ohw-uix-demo\cabo and ohw-uix-demo\ohw-uix-demo\WEB-INF\lib directory. 5. Create the UIX configuration file uix-config.xml in OHW-UIX_ HOME\OHW-UIX_deployment_name\WEB-INF directory. You may also copy the uix-config.xml from demo EAR file and edit it to your requirements. The file is available in ohw-uix-demo\ohw-uix-demo\WEB-INF directory. 6. Create web.xml to set the initialization parameters in OHW-UIX_ HOME\OHW-UIX_deployment_name\WEB-INF directory. You may also copy the web.xml from demo EAR file and edit it to your requirements. The file is available in ohw-uix-demo\ohw-uix-demo\WEB-INF directory. If you are editing the demo EAR file’s web.xml, follow these instructions: a. Modify the display-namedisplay-name and descriptiondescription section to display your custom helpset name. For example: web-app display-nameMy Moduledisplay-name descriptionMy module helpdescription web-app b. Optionally, you may wish to edit the servlet-name element under servlet element to change your URL used to access OHW-UIX. For more information about changing the access URL, see Changing the OHW-UIX Access URL . 7. Compress the OHW-UIX_deployment_name directory into a WAR file. 8. Create application.xml in OHW-UIX_HOME\META-INF directory. In this file, you will provide the web module name of each product that you will deploy. You may also copy the application.xml from demo EAR file and edit it to your requirements. The file is available in ohw-uix-demo\META-INF directory. Specify the WAR file name, created in step 7, in web-uriweb-uri element. If you wish to change the access URL of the application, update the context-rootcontext-root element. For more information, see Section 22.4.2, Changing the access URL to another name . 9. Compress the OHW-UIX_HOME directory into a EAR file. Understanding OHW-UIX Deployment 22-5 10. Start the Oracle WebLogic Server and deploy the EAR file. If Oracle WebLogic Server is already running, you must shut it down and then restart it before the changes made since you last started the servlet will be available. 11. Direct the browser to http:hostname:portOHW-UIX_deployment_ namehelp, where hostname is the name of the machine on which OHW-UIX and Oracle WebLogic Server are installed. The first page of the demo help system displays in the browser. If there is more than one helpset, use the dropdown list in the toolbar to select a helpset, then click the helpset switcher to display the TOC and index from the selected helpset only. The text search will search only for items in the selected helpset.

22.4 Changing the OHW-UIX Access URL

The URL to access OHW-UIX is http:hostname:portmymodulehelp, where hostname is the name of the machine on which OHW-UIX and Oracle WebLogic Server are installed. You can change this URL in the following ways: ■ Changing the final URL element of the access URL ■ Changing the access URL to another name

22.4.1 Changing the final URL element of the access URL

To change the help at the end of the URL, edit web.xml in OHW-UIX_ HOME\OHW-UIX_deployment_name\WEB-INF. The servlet-mapping parameter url-pattern specifies the URL used to access OHW-UIX. For example, if you change url-pattern from the default help to onlinereference, the URL used to access OHW-UIX would become http:hostname:portmymoduleonlinereference. For example: servlet-mapping servlet-namemymoduleservlet-name url-patternonlinereferenceurl-pattern servlet-mapping

22.4.2 Changing the access URL to another name

To change the access URL for your application , edit the context-root element entry under web element in application.xml, located in OHW-UIX_ HOME\META-INF: web web-urimy_module.warweb-uri context-rootmy_modulecontext-root web For example, if you want the OHW-UIX access URL to be http:hostname:portjdeveloperhelp, modify the root element: web web-urimy_module.warweb-uri context-rootjdevelopercontext-root web