Technical Blog Post
Changing the default help location in Maximo 18.104.22.168
In Maximo 22.214.171.124 a new help system was introduced, which instead of building a help ear and deploying locally links out to the IBM Knowledge Center. Recently I was asked about the configuration of Maximo Help, specifically how to point it to the base 7.6.0 documentation rather then Maximo 126.96.36.199.
First off why would you want to do this? One main reason is the default link to the Maximo 188.8.131.52 Knowledge Center is not translated, so if you link out to the Knowledge center from a french language Maximo, the Knowledge Center links will be translated, however the Maximo documentation will remain in English. The initial Maximo 7.6.0 documentation is fully translated, so it may be better in certain configurations to have the help default to its locations and then select 184.108.40.206 if you wish to view the new features or 220.127.116.11 specific documentation in English.
The default location the Maximo Help now links to in the following.
To get this to point to the core documentation we want to link to
Before I tell you how to do this, I will list the system properties that are required to configure help and explain them a bit further.
mxe.help.host - This is the host name of the server were the Knowledge Center is hosted.
mxe.help.maximohelplink - This is the top level link (what is appended to the end of the mxe.help.path) property. This value is stored in a help_products.xml file that is deployed with the maximo.ear. The top level help link can not be modified directly from the system properties.
mxe.help.path - This is the context path to the Knowledge Center
mxe.help.port - The http port for the Knowledge Center
mxe.help.protocol - Either http or https
With the default configured properties as seen above we are linked out to the 18.104.22.168 update on the Knowledge Center.
You will notice the path has an added value different then our properties and is also not defined directly in our properties, that is the SSLKT6_22.214.171.124. This value is formed from the com.ibm.mam.doc value in your mxe.help.maximohelplink system property.
To change this we need to do the following.
Open your help_product.xml file from the ibm\smp\maximo\applications\maximo\properties\products\features folder. In there you will see 7 entries that look similar to the following. The package name will differ a bit on each, also notice how the package name matches the value in mxe.help.maximohelplink above.
<name>IBM Maximo Asset Management</name>
For each of these entries you would change the taxonomy from SSLKT6 to SSLKT6_7.6.0 and the appendversion from y to n. This will stop the product from appending the current Maximo version and map the SSLKT6_7.6.0 to packagename.
Once updated, you can rebuild and redeploy your Maximo ear file and your Maximo help should now link out to the 7.6.0 core documentation, as well as translated documentation if logged in with another language.
*One other thing to note is that this file is updated with new feature packs, so if installing a new feature pack in the future you will need to make the same changes again, assuming the updated Knowledge Center is not translated.
I hope this blog was helpful, if there are any questions, comments or concerns please feel free to post below.