Oracle® Fusion Middleware Developer's Guide for Oracle Help 11g Release 1 (11.1.1.5.0) E14149-03 |
|
![]() Previous |
![]() Next |
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.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"
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".
Note: Do not deploy bothohw-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. |
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.
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.
Table 17-1 OHW-RC Demo Files and Directories
File | Description |
---|---|
|
Java EE application file. The file is available in |
|
Web module containing two helpsets: The helpsets directory exists in the respective WAR files ( |
|
Contains configuration and deployment information that affects OHW-RC thin and thick clients. The files are available in |
The following library files are available for thick clients only:
|
OHW-RC library files required for deployment. The files are available in |
|
OHW-RC configuration file. The file is available in |
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:
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.
Start the Oracle WebLogic Administration Console and navigate to Deployments page.
In the Deployments page, click Install to start the deployment wizard.
In the Path field, enter the location where you saved the ohw-rcf-demo-thick.ear
file, or in the Current Location, browse and select the EAR file.
Click Next to continue.
In the Choose targeting style page, select Install this deployment as an application, and click Next.
In the Optional Settings page, verify the settings. It is recommended that you leave the settings as default. Click Next to continue, or click Finish to complete the deployment.
In the Additional Configuration page, select Yes, take me to the deployment's configuration screen and click Finish to complete the deployment.
The deployment wizard, after successful deployment, returns you to the Settings page of ohw-rcf-demo-thick.ear
. If there are errors while deploying the file, you are navigated to Deployment home page where the errors are listed in red text.
To install the demo file on Oracle JDeveloper, follow these steps:
Download the OHW-RC demo EAR file from OTN. The name of the demo file is ohw-rcf-demo-thin.ear
. This file includes OHW-RCF and sample helpsets.
Start JDeveloper.
Create a new application from the ohw-rcf-demo-thin.ear
file. From the File menu, select New. In the New Gallery dialog, select Applications under General category, and then select Application from EAR File from the Items list.
In the Location page of Create Application from EAR File wizard, browse and select the ohw-rcf-demo-thin.ear
file. You may also change the application name and the location of application. Click Next to continue.
The EAR Modules page of the wizard shows the project name and the module name. Click Next to continue, or click Finish to create the application from EAR file.
The Finish page of the wizard shows a summary of your settings for the application. Click Finish to create the application from EAR file. JDeveloper extracts all files from the EAR file and creates an application which is ready to edit and deploy.
In the Application Navigator, open the project and edit the desired files.
To deploy the application, start the integrated Oracle WebLogic Server instance. From Run menu, choose Start Server Instance to start the integrated Oracle WebLogic Server.
In the Application Navigator, select the ohw-rcf-demo-thin project. From the Application menu, select Deploy. Then from the submenu, select ohw-rcf-demo-thin, to, and then select IntegratedWLSConnection. JDeveloper starts the deployment process and the status of the deployment is reflected in the Log window.
When the application is successfully deployed, JDeveloper prompts with Deployment finished
message in the Log window.
After successful deployment of demo file, open your browser and navigate to the following URL:
http://<yourHost>:<yourPort>/<jdevProjectName>/ohguide/
If you have installed the OHW-RC demo EAR file using Oracle WebLogic Administration Console, use the following URL:
http://localhost:7101/ohw-rcf-demo/ohguide
If you have installed the OHW-RC demo EAR file using Oracle JDeveloper, use the following URL:
http://localhost:7101/ohw-rcf-demo-thin/ohguide
For more information on user interface of OHW-RC, see Chapter 3, "OHW-RC User Interface".