Install > Install the Service Manager Help Center > Set up access to the online help from the web client

Set up access to the online help from the web client

To set up web clients to display online help from a web server, configure the web client web.xml file to define the help server's host name and communications port, as well as the virtual directory in which the online help is deployed.

  1. Log in to the server where you installed the web tier.
  2. In a text editor, open the web.xml file from the <web tier>/WEB-INF folder of your application server installation.
  3. Set the showHelp parameter to true (default: false).

    <context-param>
        <param-name>showHelp</param-name>
        <param-value>true</param-value>
    </context-param>
  4. In the helpServerHost entry, type the fully qualified domain name or IP address of the help server host of the web server hosting your help. For example, type helpserver.domain.com.

    <init-param>
        <param-name>helpServerHost</param-name>
        <param-value>helpserver.domain.com</param-value>
    </init-param>
  5. In the helpServerPort entry, type the communication port of the help server. For example, type 8080 or leave the communications port empty to use the default communications port of 80.

    <init-param>
          <param-name>helpServerPort</param-name>
          <param-value>8080</param-value>
    </init-param>
  6. Insert a helpServerContext entry below the helpServerPort entry, and set the parameter to the name of the virtual directory where you publish the online help.

    <init-param>
          <param-name>helpServerContext</param-name>
          <param-value>sm_help</param-value>
    </init-param>

    Note It excludes the web server’s document directory path. For example, if the help is deployed in C:/Apache/2.2/htdocs/sm_help, the document directory path is C:/Apache/2.2/htdocs/ and the virtual directory name is sm_help. Therefore, the helpServerContext parameter should be set to sm_help. The virtual directory path can contain subdirectories, such as sm_help/codeless.

  7. Save and close the web.xml file.

The web client launches the online help using the following URL:

http://<helpServerHost>:<helpServerPort>/<helpServerContext>