Configuring Web Server Preferences

Perform the following steps to configure Web server preferences for displaying user-defined event information in a Web browser:

  1. In the Event Console Configuration view, click Consoles.
  2. Right-click Consoles to display the pop-up menu.
  3. From the pop-up menu, select Console Preferences.
  4. From the left pane of the Console Preferences dialog box, select Web Server.
    1. To use the Tivoli-supplied Web server (spider service), check Use Tivoli Web Server. If you specify to use the Tivoli Web server, it is automatically located at run time.

      To use the Tivoli Web server, the sample event information provided by Tivoli must be installed on the TMR server. The installation process for the Sample Event Information component of the IBM Tivoli Enterprise Console product configures the Tivoli Web server to handle requests for user-defined event information. As part of the installation process, a Perl script, a Perl library, and several HTML sample event information files are installed. The tec_help.pl script and the cgi-lib.pl library are installed in the $BINDIR/TAS/HTTPd/cgi-bin directory. The sample event information HTML files are installed in the $BINDIR/../generic/HTTPd/Tec directory. (Localized sample files are in locale-specific subdirectories within the $BINDIR/../generic/HTTPd/Tec directory.) The tec_help.pl script provides an example of one possible method to process event information. You can modify the script to implement your strategy.

    2. To use a different Web server, check Use Other Web Server. Type fully-qualified name of the Web server in the Server URL text box and then type the port number in the Server Port text box.

      Note: Do not specify the URL in http://server_name format. Simply use server_name format; for example, prod.tahiti.com.

      You must also perform the following tasks when using a non-Tivoli Web server:

      • Enable CGI script capability for the Web server you are using. See your Web server documentation to do this, as the procedure is different among Web servers. Place the tec_help.pl script and cgi-lib.pl library in the CGI scripts directory (typically named cgi-bin) on the Web server.
      • If you are using Internet Information Server (IIS), verify that the virtual directory showing the CGI script directory exists.
      • In the Event Information dialog enter the path and file name to the tec_help.pl script in the Program Path text box.

        For example:

        /cgi-bin/tec_help.pl
      • Copy the sample event help files from the $BINDIR/../generic/HTTPd/Tec directory on the TMR server to the Web server.
      • Edit the tec_help.pl script and make the following changes:
        • Update the required line to specify the absolute path to the cli_lib.pl script.
        • Update the $prefilename line to specify the absolute path to the directory where the user-defined event help files are stored.
  5. Click OK to apply your changes. Your changes are in effect immediately. You do not need to restart event consoles.

Note for UNIX Users: In a UNIX environment, the Web server will run Netscape as the browser. The location of the Netscape executable must be in the PATH environment variable.

Note for Windows Users: In a Windows environment, the Web server will use the registered default browser. If the browser is not currently running, it will launch.

See Also