How to deploy help content to an intranet server?
Hello All,
I am trying to set up an intranet server (Windows) as a Rational products help server. Our help server host and Jazz server host are different. I checked the following and deployed help.war on Tomcat.
The help server doesn't have internet access so I downloaded CLM3.0.1.3_updateSite.zip and DoorsDWA9.4.0_updateSite.zip from http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/updatesites/.
My questions are about the following information.
Q1. The procedure 1.b. mentions "Move the updateSite.zip file to the location where the help WAR file is running". Does this updateSite.zip mean CLM3.0.1.3_updateSite.zip. If not, where can I get updateSite.zip ? In the above updatesites, there is updateSite_zip.zip but it cannot be unzipped.
Q2. I need help for CLM and DOORS and would like them to have separate URLs. (i.e. When accessing to CLM help URL, the page shows only CLM help and doesn't show DOORS help) The procedure 2. mentions "On the help server, navigate to https://localhost:port/help-name/updater/updatewar.jsp. Tip: To find the help context root (server, port, and help-name), open the help from the product by clicking . Your URL is https://server:port/help-name/index.jsp.Instead of server, use localhost or 127.0.0.1. "
When I access to https://myJazzServer:9443/ccm/admin and click
Any information would be very much apprecaited.
John.
5 answers
Hi Hadar,
I set up CLM help by the following steps. Could you please confirm if it is correct? The steps are different from what IC (http://pic.dhe.ibm.com/infocenter/clmhelp/v3r0m1/topic/com.ibm.help.common.rational.remote.web.doc/topics/t_setup_intranet_web.html) mentions and I did this way because adding local content didn't work with help.war. (I specified the site.xml file but the content was not listed as available contents)
1. Copy clmhelp.war from <RTC server>\server\tomcat\webapps to <Tomcat for help server>\webapps
2. Upzip CLM3.0.1.3_updateSite.zip to c:\temp
3. Go to http://localhost:8080/clmhelp/updater/updatewar.jsp and add c:\temp\CLM3.0.1.3_updateSite\site.xml as the available contents
4. Select the added content and click "Install"
Now I can access to the CLM help from http://MyHelpServer:8080/clmhelp/index.jsp
I would like to separate helps for each Rational product (i.e. http://MyHelpServer:8080/clmhelp/index.jsp shows only CLM help and doesn't contain DOORS help) so my understanding is that I have to have help application for DOORS and install the DOORS help contents. Right?
There is dwa-help.war under c:\IBM\Rational\DOORS Web Access\1.4.0.5\server\webapps but this seems to already have DOORS and DWA help contents which is different from clmhelp.war. In this case, should I simply deploy dwa-help.war to our help serer? (I'm using DOORS 9.3)
John,
Hi there John.
I had the very same problems. If you hav ea look through my post here how to install help you should see the answers. The help is a little fuzzy on this. I would use Fire Fox as my browser when trying this and you may need to refresh a couple of times for it to work. Once you have downloaded and dropped the files into the correct directory, you need to copy and paste the update directory into the updater.jsp directory dialog box. It should work. Following the instructions given to me in the above post.
Comments
Hi Der,
Thank you very much for the information.
I downloaded help.war from the following site according to IC but the help.war seems to have some problem.
http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war/help.war
So I copied clmhelp.war from my RTC server install directory and pasted it to <Tomcat>\webapps directory on my help server and access to http://localhost:8080/clmhelp/updater/updatewar.jsp. In this case I could add unzipped CLM3.0.1.3_updateSite.zip as the internal site and install it.
Now I can access to CLM help from http://myHelpServer:8080/clmhelp/index.jsp.
John,
1 vote
The short answer is no, but they are good enough.
The required steps are:
1. Copy clmhelp.war from [RTC server install]\server\tomcat\webapps to [tomcat for help server]\webapps
2. Copy dwa-help.war from [Doors server install]\server\webapps to [tomcat for help server]\webapps
These two servlets should already contain the documention for the products that you installed.
The info center servlet is distributed as a part of various products with different names and content. As mentioned in the IC you linked it is also available as a downloadable stand alone servlet help.war. However this seems to be a more recent version and I confirmed that I was unable to add content using the update site zips. (It does work with content from our servers when an internet connection is available.)
I found I was able to add the DOORS documentation to the CLM help servlet using the update site zip.
Comments
Der M
Oct 08 '12, 6:58 a.m.Oh yeah, don't forget to use the localhost in the updater.jsp URL, not the hostname. This was a blocker for me. On using fire fox and the locahost url, I was able to access the correct url to apply the fixes. See the link in my previous post.