I helped a customer today to access part of the Maximo help system. He had installed a new product and could not see the help screens for them "The topic that you have requested is not available." This meant that Maximo application help properly pointed to the topic, but the topic files were unavailable in the deployed help ear. The rest of the Maximo help system worked fine.
This told me that he had installed and deployed the Maximo application (maximo.ear), but had not built and deployed the updated Maximo help (maximoiehs.ear), which contained the help files for the add-on. Problem diagnosed, now onto solving it. (Before I diagnosed the problem, did a quick install of the product add-on myself--I've been meaning to do this for a while now--so as to be able to see what steps might have been missed.)
How to resolve the problem? I needed to provide the customer with the links he would need to redeploy the Maximo Help application. I started with the new Maximo 7.5 Knowledge Center.
The first three steps were to uninstall, rebuild and reinstall the Maximo Help application. At the Knowledge Center I searched for deploy ear and found the items I wanted immediately. The topic covered building, uninstalling and manually installing applications.
The fourth step was to clear the WebSphere 7.0 temporary file caches. This is necessary because even deploying the new ear file I couldn't guarantee that the files would be up to date. I wanted to delete the cached application files. I couldn't find that at the Knowledge Center, so I popped over to the IBM Support Portal, searching only Maximo Asset Management, and searched for clear websphere cache. Aha! It's one of my favorite tech notes, and not just because I wrote it.
[Note: Since I was deploying only the maximoiehs.ear could have just deleted the MXIEHS sub-directories.]
The fifth and last step was to make sure that Maximo help was configured properly. We have updated the way we configure Maximo help since product documentation was first released, so I searched for configure maximo help in the Support Portal. Here we go. Job done.