Deviceinfo.txt syntax

Purpose

Syntax

a:username
p:password
e:password
d:location of results folder
r:realm
device IP address
.
.
.

[r:realm]
[device IP address]
.
.
.

a:username

Specifies the name of the user.

p:password

Specifies the password of the user.

e:enable password

Specifies that the password of the user be enabled.

r:realm

Specifies the realm. The realm is followed by one or more IP addresses. Use the realm syntax to specify as many realms as necessary to create multiple realms. At least one realm must be created.

Syntax for adding a password group

The following example shows the syntax used to add a password group. This password group is used to log onto a device.

a:acc1
p:pwd1

The account name is preceded by a: and the password for that account by p:. The DeviceInfo.txt file must contain at least one password group. Multiple password groups may be added if required.

Order for using multiple password groups

When using multiple password groups in the DeviceInfo.txt file, the order in which they are entered may affect the performance of Auto-Discovery. To facilitate the most efficient discovery, arrange password groups that are most commonly used first. The reason being that for every password group, a connection is opened to each device. This ensures that the minimum number of connections to the password groups are established.

Syntax for adding an enable password

The following example shows the syntax used to add an enable password:

e:epwd1

The enable password is preceded by e:. The DeviceInfo.txt file must contain at least one enable password. Multiple enable passwords can be added, simply by repeating the line in the text file with a different password.

The enable password used has no dependency on the password group used. Once Auto-Discovery has logged onto a device, it can attempt a number of passwords to gain access to enable mode.

Syntax for adding a results directory

The following example shows the syntax used to add a results directory on a Windows operating system platform:

d:.\results

The results directory is preceded by d:. This is the directory where the Auto-Discovery tool creates the output files. For example, the location might be in the current working directory in a folder called \results.

The results directory will be written to any location provided. The naming of this file is arbitrary, as long as the directory is specified. If the directory name specified does not exist, the Auto-Discovery tool will create it.

Syntax for adding a realm

The following example shows the syntax used to add a realm on a Windows operating system platform:

r:example\devices

The realm is preceded by an r: (the letterr: followed by a colon). This is the name of the realm that will be written to the BulkLoad.csv file. When using the Bulk import utility to import the CSV file into Netcool Configuration Manager, this is the realm the devices will be held under.

The specified realm should be a valid host realm. If the specified realm does not exist in Netcool Configuration Manager, the Bulk Loader will fail. The -cr command can be used to create a realm, if the realm you are importing to does not already exist.

For further information about Adding Realms, see the IBM Tivoli Netcool Configuration Manager Administration Guide.

Syntax for adding device IP addresses

The following example shows the syntax used to add a device IP address:

182.178.29.1

Specifying device IP addresses does not require any preceding characters. They are inserted into the files as shown. All individual device IP addresses should be listed. IP ranges are also accepted. For example: 182.178.29.*. Host names may also be used.