Updating Installed CLM Help
We've installed the full clmhelp application so that we've got help available for everyone, especially for those with no internet access.
The problem we have is updating it. It seems that in order to update the installed clmhelp, we need a browser and internet access on the physical server. Neither of which we have. In corporate environments, its common place for servers to be stripped down versions of the OS. Our 'gold' build of linux doesn't have any x-windows or browser and has no internet access. How can we upgrade the clmhelp system we've installed ?? |
4 answers
I currently maintain such an clmhelp environment with RTC 4.0:
1. You have to get access to the application via https://127.0.0.1:9443/clmhelp to update/modify the content of the help system, this is needed due some security policies and is a bit annoying (the server app checks that you are coming from 127.0.0.1). I solve this with port forwarding with my ssh client and using my local browser, but you MUST use 127.0.0.1 as local address, "localhost" doesn't work (at least in my environment). 2. As our server has no internet connection, I have to disable the default installed remote site or the help application always tries to get into internet, which extremely slows down access to the help. You can configure this with this url: https://127.0.0.1:9443/clmhelp/remote/remotehelp.jsp. There should be one site, disable or delete it. 3. You have to install the help system. First you can download a offline version at this URL at ibm: http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/updatesites/ For the CML 4.0 solution the file is CLM4.0_updateSite.zip Extract this site on your server, and add the site to your help system with the url https://127.0.0.1:9443/clmhelp/updater/updatewar.jsp For the 4.0, I removed the current installed help first, as it collides with the downloaded one. There is a "add" button where you can add the downloaded local "site.xml", e.g. /opt/clmhelp40/site.xml. Add the site to the installed ones and there you go. Comments
Alan Murphy
commented Jun 29 '12, 4:04 a.m.
Stefan, we're using RTC 3.0.1.3 at the moment but will be looking to move to RTC 4 laterin the year. I'll take a look at your suggestion and see if it applies to RTC 3.x as well - thanks Great post Stefan, exactly what I was looking for. The only additional step I needed was to add a signed.applets.codebase principal support boolean to my Firefox config, however the help updater provided steps to do this. Our CLM deployment was on Linux using the standard Firefox browser. |
John Suchy (161●2)
| answered Jun 28 '12, 3:48 p.m.
FORUM MODERATOR / JAZZ DEVELOPER edited Jun 28 '12, 3:50 p.m.
We anticipate that other clients will encounter similar situations, so we should provide a standardized solution. We have a few options under consideration, but we want to deliver a solution that meets all relevant security requirements. Comments
Alan Murphy
commented Jul 02 '12, 4:25 a.m.
Hi John, Yes, it's an immediate and ongoing concern since we can't see a way to update the help system with the constraints we have short of reinstalling a complete help system again from time to time when they become available. |
Just to add a note to this. I have been trying the URL https://hostname:9443/clmhelp/updater/updatewar.jsp (note hostname as server name) and in IE and this would not work. 404 error.
It was not until I tried https://127.0.0.1:9443/clmhelp/updater/updatewar.jsp in Fire Fox 10 ESR that the page loaded and I was able to get the dialog to update my help. Once I had pasted in the full file path (site.xml) into the dialog did my update work. Oh and I first had to remove the installed help using the checkbox, first.
Hope this helps folks!! Comments
Guido Schneider
commented Jan 13 '13, 5:00 a.m.
I had the same on WIndows 2088-R2.
127.0.0.1 localhost
to etc/hosts file. After this I was able to use localhost.
In Windows 2008-R2 this entry is commented out in the default hosts file, after OS installation. |
We have documented how to remotely administer the CLM help in this wiki topic: https://jazz.net/wiki/bin/view/Main/AdministeringHelpRemotely. Please let us know if you have any problems.
|
Your answer
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.
Comments
John, It's an immediate and ongoing concern since we can't see a way to update the help system with the constraints we have short of reinstalling a complete help system again from time to time when they become available.