Supporting multiple helpsets on same box

bulanri

I have a working Oracle Help for the Web instance. It works pretty well once you get the hang of all of the configuration files. If I want to run a separate Oracle Help Instance without merging the helpsets, etc how can I do this. I currently access the helpset via a URL like:
http://mywebsite:8888/ohw/help/
Would I need to run a separate help server on a different port like :9999?
Thanks

3004

I have a working Oracle Help for the Web instance. It works pretty well once you get the hang of all of the configuration files. If I want to run a separate Oracle Help Instance without merging the helpsets, etc how can I do this. I currently access the helpset via a URL like:
http://mywebsite:8888/ohw/help/
Would I need to run a separate help server on a different port like :9999?
Thanks

Create two different OC4J web modules that will create URLs like this:

mywebsite.com/project_one/help
mywebsite.com/project_two/help


1. The first thing to do is to create two web modules under the same OHW OC4J application, found under j2ee/home/applications/OHW, as shown below.

j2ee/home/applications/OHW directory structure
================================================
+---META-INF

+---project_one
& +---cabo
& +---helpsets
& & +---project_one
& +---jsLibs
& +---WEB-INF
& +---lib

+---project_two
& +---cabo
& +---helpsets
& & +---project_two
& +---jsLibs
& +---WEB-INF
& +---lib


2. Next, edit application.xml found in META-INF directory to define two web-modules, both within the same <application> element:

j2ee/home/applications/OHW/META-INF/application.xml
======================================================
<module>
<web>
<web-uri>project_one</web-uri>
<context-root>/</context-root>
</web>
</module>

<module>
<web>
<web-uri>project_two</web-uri>
<context-root>/</context-root>
</web>
</module>


3. Then create a separate entry for each web site/url in j2ee/home/config/default-web-site.xml. These entries will be under the same <web-site> element

j2ee/home/config/default-web-site.xml
======================================================================
<web-app application="OHW" name="project_one" root="/project_one" />
<web-app application="OHW" name="project_two" root="/project_two" />

Note: if you need to change the URL at some point to something else, like "my_new_project", simply use root="/my_new_project".
name="project_one" and <web-uri>project_one</web-uri> from step 2 should both use the same name.
These names refer to the "project_one" directory in j2ee/home/applications/OHW/project_one


4. Finally, if you want to change the "help" at the end of the URL, then edit the <url-pattern> within the <servlet mapping> for each instance of web.xml.

j2ee/home/applications/OHW/project_one/WEB-INF/web.xml and
j2ee/home/applications/OHW/project_two/WEB-INF/web.xml
=======================================================
<servlet-mapping>
<servlet-name>OHW</servlet-name>
<url-pattern>/help2/*</url-pattern>
</servlet-mapping>



Ben Gelernter
Oracle Help Technologies

bulanri

Ben,
Thank you for a thorough solution!