When you install or change a server component on any host
in your Tivoli Netcool/OMNIbus system,
you must configure the component to communicate with other components
by using the Server Editor. Use this window to create and modify communication
details for the server components, test server activity, and add backup
(or failover) servers and listeners.
Server components include ObjectServers, gateways, process
control agents, and proxy servers. This functionality is available
to system administrators and super users only.
You must maintain
the server communication information on the host workstation and on
every workstation that needs to connect to the server component. When
you have configured the communications setting, the Server Editor
saves the results in the connections data file. The name and location
of this file is as follows:
| UNIX systems |
$NCHOME/etc/omni.dat |
| Windows systems |
%NCHOME%\ini\sql.ini |
The
elements of the Server Editor window are as follows:
- Server list
- The server list shows existing server components and their settings:
- Server
- This column displays the name of each server that is defined for
this workstation. The default server names are:
- NCOMS: The default name for ObjectServers
- NCO_PROXY: The default name for proxy servers
- NCO_GATE: The default name for gateways
- NCO_PA: The default name for process agents
- On Windows, the host workstation for the server
must have a listener entry, and the host workstation
and any other workstation that connects to that server must have a client entry.
- Backup ObjectServers appear below the primary ObjectServer in
the Server Editor. To hide the list of backup ObjectServers, double-click
the primary ObjectServer name or server icon. The backup ObjectServers
are hidden and the letter C appears in the server icon. Double-click
again to display the backup ObjectServers. The server icon returns
to normal.
- Hostname
- This column displays the host name or IP address of the workstation
on which the server component is installed.
Note: After
installation, the default host name on UNIX and Linux operating systems
for all server components is omnihost. You must
change this to the host name of the host computer. On Windows, the
host name is automatically set to the host name of the host computer
during installation.
- Port
- This column displays the port on which the server component listens
for unencrypted connections.
- SSL
- On UNIX, this column displays the port on which
the server component listens for encrypted connections. On UNIX systems,
a server component can have a standard port, an SSL port, or both,
defined.
- On Windows, this column displays the word yes for
encrypted connections. On Windows systems,
the same port number is used for both encrypted and unencrypted connections.
- Server panel
- Use the server panel fields to enter or edit the details of each
server component. If you are editing the details of an existing server
component, you must first select the relevant row in the server list,
so that the details are shown within the server panel fields.
- Name
- Type the name of a new server component or edit the name of an
existing component. On Windows,
you can also use the drop-down list to select a name. Use the following
suffixes when naming components: _PROXY for proxy servers, _GATE for
gateways, and _PA for process agents.
Note: The name of
a server entry must consist of 29 or fewer uppercase letters and cannot
begin with an integer.
- Host
- Type or edit the host name or IP address of the workstation on
which the server component is installed. (For new server components
on UNIX, the name is set to omnihost by default, and must
be changed to the actual host name or IP address.)
- If you type an IP address, you can specify an IPv4 or IPv6 address.
For example:
- 192.168.0.1
- 2094:82a:2a6e:123:503:badd:fe43:f552
- Port
- On UNIX, if you want clients using unencrypted
connections to be able to connect to the server, type a valid, unused
port number in this field. To disallow unencrypted connections, do
not set the port.
- On Windows, type a valid, unused port number
in this field.
- SSL
- On UNIX, type a valid, unused port number in this
field if you want clients using encrypted connections to be able to
connect to the server. To disallow encrypted connections, do not set
the port.
- On Windows, select this check box to indicate
that the port accepts encrypted connections from clients that use
SSL.
Note: On UNIX systems, a server component can have a
standard port, an SSL port, or both ports defined. On Windows systems, the same port number is
used for either type of connection.
- Listener (Windows only)
- Select this check box if this is a listener entry on the host
workstation for the server. Clear the Listener check
box if this is a client entry.
- Add
- Click this button to add new, unique server details to the server
list.
- Remove/Update
- This button changes based on whether you have made any changes
to the server component that is currently selected. Click Remove if
you want to remove the server component that is currently selected
from the server list. Click Update to refresh
the server list with updated details of an existing server component.
- Test
- Click this button to test that you can connect to the server that
is selected in the server list. The Server Editor attempts to contact
the server on the specified host and port. A window shows the result
of the test command.
- Priority panel
- The server priority fields enable you to raise or lower the priority
of server components that are configured as failover systems. For
example, suppose an ObjectServer called NCOMS_PRI is configured with
a backup called NCOMS_BAK. Using the Raise or Lower buttons,
you can raise the priority of NCOMS_BAK to be the primary ObjectServer
and NCOMS_PRI to be the backup.
- Raise
- Click this button to raise the priority of the selected server
component by one level.
- Lower
- Click this button to lower the priority of the selected server
component by one level.
- Generate All (UNIX only)
- Click this button to generate interfaces files for all UNIX operating
systems. When you apply your changes (using the Apply button),
this generates interfaces files named $NCHOME/etc/interfaces.arch,
where arch represents individual UNIX platform
names; for example, interfaces.hpux11 and interfaces.solaris2.
- Show Groups (Windows only)
- On Windows, select this check box to group each
server by name within the server list, with backup servers and listeners
identified following the client entry.
- Apply (UNIX only)
- Click this button to apply the changes to the interfaces file.
Any server components that were added to the server list, removed
from the server list, or edited, will be saved to this file.
- OK (Windows only)
- Click this button to save your changes and close this window.
- Close (UNIX)/Cancel (Windows)
- Click this button to either close this window after saving your
changes with the Apply button, or to close
this window without saving your changes.
- Import (UNIX only)
- Click this button to import communication details.