Configuring Web Server Preferences
Perform the following steps to configure Web server preferences for displaying
user-defined event information in a Web browser:
- In the Event Console Configuration view, click Consoles.
- Right-click Consoles to display the pop-up menu.
- From the pop-up menu, select Console Preferences.
- From the left pane of the Console Preferences dialog box,
select Web Server.
- 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.
- 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.
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