Add sections from the help system's table of contents

If we installed a subset of the Connections applications, remove the help files associated with the applications that you did not install from the help table of contents. If add an application, or install Connections Mail, we can add that product's help to the table of contents.

This procedure is not required.

The help system enables users to navigate from the help for one application to another application by providing a table of contents that lists each application as a separate section and includes help topics within the section. However, if you choose to install only a subset of the available applications, we must manually remove the other help sections from the help system table of contents after installing the product or users see help for applications to which they do not have access. We can also add help if add an application.

1. Start the wsadmin client
   cd app_server_root/profiles/Dmgr01/bin
   ./wsadmin.sh -lang jython

2. Access the Connections configuration files:
   execfile("connectionsConfig.py")

3. Enter the following command to specify which applications to include in the help system's table of contents:

   Important: To add an extra application to the existing help, you still need to list all the applications for which we are already providing help. Only the help files for applications that you list as parameters in the LCConfifigHelp.setHelp command will appear in the table of contents.

   LCConfigHelp.setHelp("temp_directory","application_name","application_name")

   where:

   • temp_directory is the name of a temporary directory on the system. The directory we specify can be any directory, but it must exist before you enter the command. When you enter the command, an XML file called helpData.xml is added to this directory, and is used by the command.

     AIX and Linux: The directory must grant write permissions or the command does not complete successfully.

   • application_name is the name of the application whose help section to include in the table of contents. List each application name separated by commas. The options are:
     • activities
     • blogs

     • bookmarks
     • communities
     • files
     • forums
     • homepage
     • profiles
     • wikis

     • icmail

     • ibmdocs

   For example, if you installed all the applications except Wikis and Connections Mail, we can run the following command to include all sections but Wikis and Connections Mail in the help system:

   LCConfigHelp.setHelp("c:/temp","activities","blogs","bookmarks","communities","files","forums","homepage","profiles")

4. To force the table of contents in the help system to reflect the change, stop the help application, and delete the temporary help directory on each node where help runs.

   For example, delete the following directory:
   C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\node-name\cluster-name\Help.

   This directory is recreated when the application restarts.

Results

When a user opens the product help system, the table of contents lists only those sections you wanted it to include.

Attention: If a help topic links to a topic in a section you have removed from the help system, the link text continues to be displayed, but returns an error when clicked.

Parent topic:
Customize the deployment

Related:

Start the wsadmin client