Hosts File Format

The TSM for Nortel DMS uses a hosts file to connect to multiple hosts.

This file is specified by the HostsFile property. When the TSM starts, it reads through the hosts file attempting to connect and log into each host.

The hosts file defines the TSM connections in the following format:
<host> <port> [ci co], [un p1 p2], lc, ac, dc,[hs hr hi ht];
Note: If you encounter problems when uninstalling the TSM after the hosts file has been modified, remove the hosts file or replace it with the original file before you try to uninstall again.

Table 1 describes the hosts file format and the properties in the properties file that correspond to each item.

Table 1. Hosts file format
Item Corresponding property Description
host Host The host to which the TSM connects.
port Port The port to which the TSM connects.
ci ChatinString The chat in string for the host/port.
co ChatoutString The chat out string for the host/port.
un UserName Username with which the TSM logs on.
p1 Password Password associated with the username.
p2 AltPassword Alternate password associated with the username.
lc LogClasses Log classes the TSM monitors. to
ac AddrepClasses Log reports the TSM includes.
dc DelrepClasses Log reports the TSM excludes.
hs HeartbeatString Heartbeat string the TSM sends to the switch.
hr HeartbeatResponse Response the TSM expects to the heartbeat request.
hi HeartbeatInterval Interval between heartbeats.
ht HeartbeatTimeout Time within which the TSM expects to receive a response.

Be aware of the following when creating a hosts file:

  • Semicolons (;) indicate the end of each entry in the host file.
  • Colons (:) are used to separate the device details from the corresponding connection information.
  • Commas (,) separate individual sections within logins.
  • Whitespace separates individual elements within the sections.
  • Whitespace characters are <sp>, <tab>, <cr>, and <nl>.
  • Comment lines are preceded by #.
  • Blank lines are ignored.
  • If the hosts file is defined, all properties in the properties file that define the connection to an individual host are ignored. These are the properties listed in the Corresponding property column of Table 1.
  • If the hosts file is not defined, the TSM uses the Host and Port properties to connect to the device. If the Host, Port, and HostsFile properties are not defined, the TSM exits.