Forum Stats

  • 3,826,736 Users
  • 2,260,699 Discussions
  • 7,897,066 Comments

Discussions

Supporting multiple helpsets on same box

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

Comments

  • 3004
    3004 Member Posts: 204,171 Green Ribbon
    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
    bulanri Member Posts: 145
    Ben,
    Thank you for a thorough solution!
This discussion has been closed.