This chapter covers how configure the Cisco Info Center Java Event List. You need only read this section
if you have installed Java support for the Java Event List.
This chapter includes the following sections:
• “Introduction”
• “Configuration Procedure”
• “License File”
• “Creating HTML Pages”
• “Running the JELD Process in Background”
The Java Event List is used to distribute and manage Cisco Info Center events through the World Wide
Web (WWW). The Java Event List uses a background server process, which obtains information from
the Cisco Info Server.
The background process, called jeld, and a Web server should be installed on the same machine to
overcome Java browser security issues.
When a Web browser makes a connection to the Web server, the server can send back an HTML page
containing the Java applet to the browser. The applet then connects to the jeld and requests a
configuration. The jeld
the Event List information in the Web browser.
The configuration information is stored in an Cisco Info Server database table and is configured using
the JEL Advanced Configuration Editor (JACE).
retrieves the configuration from the Cisco Info Server, and this is used to display
78-5664-05
Cisco Info Center Administrator Reference
6-1
Configuration Procedure
Chapter 6 Java Event List Configuration
Figure 6-1Java Component
Web browsers display the HTML
page containing the Java applet
Configuration
with JACE
Web server
jeld
Cisco Info Server
Configuration Procedure
The Java support components are, by default, installed in the $OMNIHOME/java directory. The
configuration procedure for Java support covers the following steps:
1. Install a Web server and set up the communications to Cisco Info Center.
2. Copy the class files to the publication home directory of the Web server.
3. Set the jeld properties files.
4. Create configurations with JACE.
5. Create the HTML pages.
6. Run the background process, jeld.
These steps are described in detail in the following sections.
Web Servers
In order to use the Java Event List, you must have a Web server installed and configured to support Java
applets. The Web server must be installed on the same machine as the Java support components. You can
obtain free Web servers from the WWW.
14913
6-2
For information about how to configure the Web server to support Java applets, for example,
initialization of class files, see your Web server documentation.
You should configure the system that runs the Web server to connect to Cisco Info Center. To do this,
you install a Cisco Info Admin Desktop on the machine that runs the Web server to check the
connectivity requirements. See the Cisco Info Center Installation and Configuration guide for more
information.
You also need to generate an interfaces file. This file contains information about which machines run
the Cisco Info Servers and also the communications between those machines. See the Cisco Info Center Installation and Configuration guide for more information.
Cisco Info Center Administrator Reference
78-5664-05
Chapter 6 Java Event List Configuration
Publishing Class and Zip Files
Before you can create HTML pages for the WWW, you must publish the class and zip files on the Web
server. The class files are in the $OMNIHOME/java/jel directory. This directory contains the following
subdirectories:
• classes containing the Java class files
• html containing an example configuration of the applet.
Copy these directories to the publication home directory of your Web server. To test the applets, load the
pages from the Web server.
For example, specify your server name with the following URL:
http://<your-server-name>/html/index.html
Setting the Properties File
The jeld.props properties file is located in the $OMNIHOME/java/props directory. You must modify
this file to match your system configuration. An example properties file is shown below.
The following sections explain the items in the properties file and how to set the values.
Cisco Info Center Administrator Reference
6-3
Configuration Procedure
Info Server Connection Properties
The properties file provides three methods of connecting to an Info Server. These are:
1. Connection to a list of Info Servers. JELD tries each Info Server in the list until a connection is
made. This is the preferred method.
2. Single connection to an Info Server. This method is provided for backward compatibility with
previous versions.
3. Connection to a list of URLs. Each URL specifies fully an Info Server connection. JELD tries each
URL in the list until it connects to an Info Server. This option is only for use by experienced
integrators. It should not be used in normal implementations.
Connection to List of Info Servers
The preferred method for the JELD to connect to an Info Server is for it to try to connect to each Info
Server in a list until it makes a connection. This means that you can specify a fallback Info Server, or
have the JELD retry the same one several times.
Chapter 6 Java Event List Configuration
Host Name
Port
Each Info Server is specified in the properties file by a set of properties. Each property includes a number
which identifies the position of the Info Server in the list. The property names for the first Info Server
are:
The second Info Server has 2 instead of 1, and so on for subsequent Info Servers.
You can override the entries in the properties file from the command line. For more information, see the
“JELD Command Line Utility” section on page B-2
This entry contains the host name where the Cisco Info Server is located. For example, specify:
jeld.objectserver.host: <omnihost>
Where <omnihost> is the name of the host.
You can override this entry with the jeld command line option -host.
This entry contains the port setting for the Cisco Info Server. For example, specify:
jeld.objectserver.port: 4100
You can override this entry with the jeld command line option -port.
User Name
6-4
This entry contains a user name (the suggested user name is jeld) for the Cisco Info Server. For example,
specify:
jeld.objectserver.user: jeld
Cisco Info Center Administrator Reference
78-5664-05
Chapter 6 Java Event List Configuration
Password
This entry contains the jeld password for the Cisco Info Server. The password should be encrypted using
the nco_crypt command. For example, specify:
jeld.Cisco Info Server.password: <string>
Where <string> is the encrypted password. To create an encrypted password, specify:
nco_crypt <password>
Where <password> is the unencrypted form of the password. The nco_crypt command displays an
encrypted version of the password.
Single Connection to an Info Server
This option is provided for backward compatibility only. These lines are commented out in the example
configuration file.
Use the following fields to specify a connection to a single Info Server.
Enter the Info Server details against these properties. The JELD tries to connect to the specified Info
Server. If it cannot connect the first time, it tries a second time. If it cannot connect then, it returns a
failure.
Info Server URL List
NoteOnly experienced integrators should use this connection method.
When you specify an Info Server URL list, the data from each URL is used to establish a connection to
the Info Server. You can use this option you need to specify fully the connection to an Info Server. The
property name is:
jeld.objectserver.1.url
In this property name, url is the address of the machine running the Info Server. It is not a web reference
and does not include the
This property is commented out in the example configuration file. Replace the number 1 with the number
2 for the second Info Server, 3 for the third Info Server and so on.
JDBC Driver Properties
http: prefix.
78-5664-05
This option defines the way in which the connection to the Info Server is established:
jeld.jdbc: com.sybase.jdbc.SybDriver
It should not be changed or removed except under instruction from technical support.
Cisco Info Center Administrator Reference
6-5
Configuration Procedure
JELD Server Properties
There are two JELD server properties: listenport and maxconns.
Listen Port
This entry contains the listen port number. For example, specify:
jeld.listenport: 7575
You can override this entry with the jeld command line option -listenport.
Maximum Connections
This entry contains the maximum number of connections supported by the nco_jeld process. For
example, specify:
jeld.maxconns: 3
You can control the number of connections a single jeld process can handle, however, this does not
override the number of available licences.
Chapter 6 Java Event List Configuration
JELD Global Security Properties
There are two JELD global security properties: ips and hosts.
IPS
This entry is a list of the domains allowed to connect to the applet. For example, to allow only 10.0.0.1,
10.0.0.5, and 10.0.0.10 to connect to the applet, specify:
ips:+10.0.0.1 +10.0.0.5 +10.0.0.10 -*
To allow only machines in the domain 10.n.n.n to connect, specify:
ips:+10.* -*
To allow any domain to connect, specify:
ips: +*
Hosts
This entry is a list of hosts allowed to connect to the applet. For example, to allow only machine1,
machine2, and machine3 to connect to the applet, specify:
hosts:+machine1 +machine2 +machine3 -*
To allow only machine1 to connect, specify:
hosts:+*machine1 -*
To allow any machine to connect, specify:
hosts:+*
6-6
Cisco Info Center Administrator Reference
78-5664-05
Chapter 6 Java Event List Configuration
Log File Properties
There are two log file properties: logdir and logfile.
Log Directory
This entry contains the name of the directory in which the log file is located. For example, to ensure the
log file is located in the /opt/Omnibus directory, specify:
jeld.logdir: /opt/Omnibus
Log File
This entry contain the name of a log file. The log file contains diagnostic information about the
background process, jeld. For example, to use a log file called jeld.log
jeld.logfile: jeld.log
License File
Configuration Procedure
,specify:
The JELD license file is $OMNIHOME/java/props/jeld.lic.
The license file contains information about the IP address of the host on which the JELD is licensed to
run, the license key, the number of licenses, and the expiry date of the JELD license. For example, a
license file could look like the following:
To obtain a license file, email Micromuse Technical Support (support@micromuse.com). After they
send you the information for a license, use the text editor of your choice to create a jeld.lic file and paste
the information that they send you into the file. Then save the file in the
directory.
Info Server Connection and Reconnection
This section describes how JELD makes a connection when it is configured to connect to a list of Info
Servers, and how it reconnects if necessary. For more information about the Info Server connection see
the “Info Server Connection Properties” section on page 6-4.
Initial Info Server Connection
When JELD is started, it tries to establish a connection to the first Info Server in the properties file. If it
cannot, it tries to establish a connection to the second Info Server.
If you wish to try to connect to the same Info Server twice, enter the same details in the first and second
Info Server properties.
opt/Omnibus/java/props
78-5664-05
Cisco Info Center Administrator Reference
6-7
Configuration with the JACE Editor
There is no limit to the number of Info Servers that you can specify in the properties file or the number
of times you can enter the details of the same Info Server.
Once a connection has been established, the JELD can respond to requests from the Java applet in the
JEL.
Info Server Connection Failure
If the connection to the Info Server is broken, the JELD shuts down automatically. The JEL detects the
shutdown of the JELD, report an error on the desktop and offers the user the option of reconnecting.
If the JELD is running under process control it can be restarted automatically. As a new process the JELD
tries to establish a connection with an Info Server as described in the “Initial Info Server Connection”
section on page 6-7.
A dialog box appears on the JEL to reconnect to the JELD. If the JELD has established a new Info Server
connection, the JEL resynchronizes the data from the Info Server.
Fail Over Support
Chapter 6 Java Event List Configuration
When you enter a list of Info Servers in the jeld.props file, the JELD attempts to connect to each Info
Server in turn until a successful connection is made.
For the JELD to continue to operate after a failure, every Info Server listed in the
contain the same JELD configuration table, and the JELD must be restarted automatically under process
control.
Configuration with the JACE Editor
For Java configuration, use the JEL Advanced Configuration Editor (JACE). JACE is a table-orientated
editor that allows you to manage configurations. These configurations are stored in the jel.jel_props
Cisco Info Server table, to which the jeld is connected. You must have super user privilege to use JACE.
For maximum flexibility, the configuration files include options to take particular settings from the
HTML parameters. These parameters include, view name, fields, order, and filter.
Starting JACE
Before starting JACE, set OMNIHOME:
host# setenv OMNIHOME=/opt/Omnibus
To start JACE, specify the following command:
host# $OMNIHOME/java/bin/jace
Figure 6-2 shows the JACE display.
jeld.props file must
6-8
Cisco Info Center Administrator Reference
78-5664-05
Loading...
+ 18 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.