pw device add

pw device add <device> [-a -agenttimeout <seconds>
-A <name=value> -Alist -y -copy-baseline-from <device>
-D <name=value> -d <device_type_name> -desc <description>
-tag <tag_value> -g <group> -m <monitor> -mall<monitor>
-malllist -mlist -n <name> -na -r <read_community_string> -s <agent>
-t <template_name> -debug -u <url> -x <tranfile> -force
-prc <conn_protocol> -pno <port_no> -lus <local_user_name>
-rus <remote_user_name> -rpa <remote_user_passwd>
-rsp <remote_system_prompt> -withdns]

Use the following command to add a device with an optional agent and monitors:

pw device add <device> [options]

<device> must be an IP address or DNS Name.

If you want to add a new name to the device , use the -n option as shown below:

pw device add <device> -n <name>

The device type can be specified with the -d option as follows:

pw device add <device> -n <name> -d <devicetype>

To add a description for the device, run the following command:

pw device add <device> -desc <description>

To add an alias to a device while adding a device, run the following command:

pw device add <device> -A Device.ALIAS=<value>

The variable <value> is an alias name or comma-separated multiple alias name(s).

To associate a given tag value with a device, run the following command:

pw device add <device> -tag <tag_value>

To get a list of the available device types, run the following command:

pw device help -dlist

Use the following command to add the device to one or more groups simultaneously:

pw device add <device> -g <group1> -g <group2> ...

For example, use this command to add a <device_type> Server and IP address 192.168.3.162.

Use the following command to associate a given tag value with a device:

pw device add <device> -tag <tag_value>

List of case-sensitive devices

• Router
• Hub
• Switch
• Printer
• Rmon Probe
• Workstation
• NT Server
• Server
• Print Server
• Other
• WebServer
• DBServer
• MailServer
• FireWall
• Appserver
• Netware
• FDDI
• AdapterCard

To copy baseline values from an existing device and create a new device, run the following command:

pw device add <new device name> -copy-baseline-from <existing device name> [other params]

When you specify a device to copy baseline values from, then for all monitors being added to the new device, a corresponding monitor is searched on the specified device. If matching monitors are present, then all baseline values (hourly, weekly) are copied from the existing monitor to the new monitor instances being created.

Use the following command to add the device along with the remote connection details:

pw device add <device> -prc <conn_protocol> [-pno <port_no>] -lus <local_user_name> -rus <remote_user_name> -rpa <remote_user_password> [-rsp <remote_system_prompt>]

where,

<conn_protocol> can be any one of the following: rexec, rlogin, rsh, ssh, and telnet

<port_no> is the port number where the remote service is running. If port number is not specified, the default port number for the protocol is considered.

<local_user_name> is the user name on the local system from where the Detailed Diagnostics is fired and is mandatory when using the rsh and rlogin protocol.

<remote_user_name> is the remote user name on the device and mandatory for all protocols.

<remote_user_password> is the remote user password on the device and mandatory for rexec, rlogin, telnet, and ssh protocols.

<remote_system_prompt> is mandatory for rlogin and telent protocols.

To add a device with a DNS name, run the following command:

pw device add <device name> -withdns

For example, if you have given google as the device name, the device is created with the DNS name (google), that is, the DNS Name/IP address field will display the DNS name in the Add Device window of Administration Console.

If you have not specified the -withdns option, the device gets created with the IP address of the device name, that is, the IP address is displayed in the DNS Name/IP address field in the Add Device window of Administration Console.

The same applies to agents, that is, if you use the -a option along with the -withdns option, the agent is created with the DNS name; otherwise, it is created with an IP address.

All monitors that are created under this device which supports the DNS name are created with the DNS name so, the Target Device field of the monitor displays the DNS name. For example, when you run the following command, the ping monitor is created with the device name google:

pw device add google -withdns -m Ping

Monitors that do not support the DNS name take the IP address of the device. For example, when you run the following command, the FTP monitor is created with the resolved IP address of the device name google:

pw device add google -withdns -m FTP

The -y option confirms an operation. If the device name you create cannot be resolved to a valid IP address, confirm the same with this option. The device is created with the name specified, and the device name specified is displayed in the DNS Name/IP Address field.