IBM Tivoli Netcool/OMNIbus Version 8.1

Configuring server communication information

You must maintain server communication information for the Tivoli Netcool/OMNIbus server components. You can use the Server Editor to create and modify communication details for the server components, test server activity, and add backup (or failover) servers and listeners.

About this task

To configure server communication information:

Procedure

  1. Perform the appropriate action for your operating system:
    Operating system Action
    UNIX Perform either of the following actions:
    • Click the Interfaces button on the UNIX Conductor.
    • Enter $NCHOME/omnibus/bin/nco_xigen on the command line.
    Windows Perform either of the following actions:
    • Click Start > Programs > Netcool Suite > System Utilities > Servers Editor.
    • Open the Conductor menu by right-clicking the bus icon in the desktop tray, and then click Servers.
    The Server Editor opens.
  2. Complete this window 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.
Parent topic: Configuring properties, server communication, and settings
Related concepts:
IPv6 configuration

Library | Support |