17
Deploying OHW-RC Demo File 17-1
17
Deploying OHW-RC Demo File
This chapter describes how to deploy OHW-RC demo file on Oracle WebLogic Server. The OHW-RC demo EAR file contains all class libraries that you need to view the
demo and try out the release. It includes sample helpsets, OHW-RC servlet file, and XML configuration files. You can deploy the demo file to experience the OHW-RC
interface, or replace the existing helpsets and add your own.
The following sections help you understand the demo file, deploy and test the sample helpset in your environment:
■
Section 17.1, Understanding the OHW-RC Demo Files
■
Section 17.2, Installing the OHW-RC Demo EAR File on Oracle WebLogic Server
■
Section 17.3, Installing the OHW-RC Demo EAR File on Oracle JDeveloper
■
Section 17.4, Running the OHW-RC Demo EAR File
17.1 Understanding the OHW-RC Demo Files
The OHW-RC demo file is available in two variants: ohw-rcf-demo-thin.ear and ohw-rcf-demo-thick.ear.
The ohw-rcf-demo-thick.ear contains ADF, JSF and JSTL libraries preconfigured for deployment. The file is recommended if you are not using a supported application
server or JDeveloper, or if you are using a supported application server but do not have the libraries installed. For more information about supported application servers,
see the Certification Information page on OTN.
The ohw-rcf-demo-thin.ear does not contain ADF, JSF and JSTL libraries, hence it is required that the libraries must be installed on the application server before
deployment. JDeveloper is required for this demo file. For more information on how to deploy libraries, see
Section 17.2, Installing the OHW-RC Demo EAR File on Oracle WebLogic Server
.
Both OHW-RC demo EAR files, ohw-rcf-demo-thin.ear and ohw-rcf-demo-thick.ear, contain two OHW-RC sample helpsets along with their
help topics, helpset file, and control files. They also contain ohwconfig.xml which is needed to configure OHW-RC.
Note: Do not deploy both ohw-rcf-demo-thin.ear and
ohw-rcf-demo-thick.ear on Oracle WebLogic Server as they would conflict when you run the demo EAR files.
17-2 Oracle Fusion Middleware Developers Guide for Oracle Help
When extracted into a directory, the OHW-RC demo file extracts files into their respective name directories, ohw-rcf-demo-thin and ohw-rcf-demo-thick. The
EAR file contains a WAR file and a META-INF directory, which contains the application.xml file. The WAR file contains all helpset directories along with their
help topics, helpset file, and control files.
Table 17–1 describes the files and directories in OHW-RC demo EAR files.
17.2 Installing the OHW-RC Demo EAR File on Oracle WebLogic Server
Before you start the demo file installation, verify that ADF, JSF, and JSTL libraries are installed in Oracle WebLogic Server. For more information, see
Section 18.2, Verifying OHW-RC Library Files
. After the library verification, installing the demo EAR file is a very simple process:
1. Download the OHW-RC demo EAR file from OTN. The name of the demo file is
ohw-rcf-demo-thick.ear. This file includes OHW-RC library files and sample helpsets.
2. Start the Oracle WebLogic Administration Console and navigate to Deployments
page.
3. In the Deployments page, click Install to start the deployment wizard.
Table 17–1 OHW-RC Demo Files and Directories
File Description
application.xml Java EE application file.
The file is available in META-INF directory. helpsets directory
Web module containing two helpsets: ohguide and the sample shakespeare, in
their respective directories. The helpsets directory exists in the respective
WAR files ohw-rcf-demo-thick.war or ohw-rcf-demo-thin.war.
trinidad-config.xml faces-config.xml
web.xml weblogic.xml
Contains configuration and deployment information that affects OHW-RC thin and
thick clients. The files are available in WEB-INF directory
of WAR files. help-share.jar
ohw-rcf.jar ohw-share.jar
The following library files are available for thick clients only:
■
adf-richclient-api-11.jar
■
adf-richclient-impl-11.jar
■
trinidad-api.jar
■
trinidad-impl.jar OHW-RC library files required for
deployment. The files are available in WEB-INF\lib
directory of WAR files.
ohwconfig.xml OHW-RC configuration file.
The file is available in helpsets directory.
