Important This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Installing local HTML help

This topic explains how to install local HTML help when the TrueSight Network Automation server is in a secured environment and you cannot access the online documentation via a web browser. This topic contains the following sections:

Note

From TrueSight Network Automation version 8.9.03, the local HTML (offline) help is deprecated. You are encouraged to use the online help or the ready-made PDF for offline viewing. You can also create your own PDF.  For more information, see PDFs-and-videos.

To install the local HTML help in your environment:

  1. Download the bcan-localhelp-<versionNumber>.zip from EPD.
  2. Copy the zip file to the <BCAN_INSTALL>\public\bmc\bca-networks\extras directory.

The unzipped bcan-localhelp folder contains the following files: 

  • README.txt: Text file that contains instructions about how to use the local help
  • help.properties: Properties file that must be installed on the TrueSight Network Automation server
  • bcan-html-localhelp.zip: Zip archive containing the local help files that must be installed on a web server
Warning

Do not install the local HTML Help on the web server on which TrueSight Network Automation is installed. Instead, install the local HTML Help on another local web server.

To install local HTML Help on another web server

  1. Copy the bcan-localhelp-<versionNumber>.zip file located in the <BCAN_INSTALL>\public\bmc\bca-networks\extras\ folder on the computer on which TrueSight Network Automation is installed to a custom directory on the other web server.
  2. Unzip the bcan-localhelp-<versionNumber>.zip file in the folder you specified in step 1.
  3. In the extracted bcan-localhelp-<versionNumber> directory, navigate to the bcan-localhelp directory.
  4. Create a directory where you want to extract the local help files.
  5. Unzip the bcan-html-localhelp.zip file to the directory you have created in step 4.
  6. Copy the directory created in step 4 to the Home directory on the web server.

    For example, on a Windows computer with default Tomcat 7.0 installation, CATALINA_HOME= C:\Program Files\Apache Software Foundation\Tomcat 7.0.
  7. Verify that the local help is accessible by browsing to http://<server>:<port>/<path>/index.html.
    • <server>: Specifies the name of your web server
    • <port>: Specifies the is the port used by your web server
    • <path>: Specifies optional path information if the directory created in step 4 is not present in the root of the web server

      For example: http://<myserver>:80/<path>/index.html 

Note

Local help is implemented by using JSP. Therefore, if you have an IIS server, you must update the web.config file to configure the allowDoubleEscaping parameter because by default IIS does not allow URLs with ‘+’ signs. For details, see http://support.microsoft.com/kb/942076.

<system.webServer>
 <security>
   <requestFiltering allowDoubleEscaping="true" />
 </security>
</system.webServer>

To configure the TrueSight Network Automation web server to use local HTML Help

  1. Copy the help.properties file to your TrueSight Network Automation server's <BNA-DATA> directory.

    For example,
    1. On Windows: C:\bca-networks-data\help.properties
    2. On Linux: /var/bca-networks-data/help.properties

  2. Modify the help.properties file as follows:
    1. Set the helpUseLocal property to true as follows: helpUseLocal=true
    2. Set the helpResolverURL property to your web server. For example:
      helpResolverURL=http://myserver:80/<path>/urlresolver.html?product={0}&version={1}&topic={2}&lang={3}
  3. Restart the TrueSight Network Automation web server.

Note

The following functionality might not be available in the local HTML Help:

  • Navigating to tabs and sorting tables
  • Hyperlinks pointing to sections or headings within a page or another page
  • Expanding and collapsing content

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*