web server - Borland Technical Publications

Using the iastool command-line tools
ping
Use this tool to verify the current state of a hub or a managed object. The ping
command will return nothing for a hub that is not running.
Syntax
-ping [-mgmtport ]
[-realm ] [-user ] [-pwd ] [-file ]
or
-ping -cfg
-mo -moagent [-mgmtport ]
[-realm ] [-user ] [-pwd ] [-file ]
Default Output
The default output shows the name and status of the hub (and optionally the managed
object) if the process is pinged and running. For example:
Pinging Hub xyz_corp1: Running
The ping tool returns one of the following states:
■
■
■
■
■
■
■
■
■
Running
Starting
Stopping
Not Running
Restarting
Cannot Load
Cannot Start
Terminated
Unknown
Options
The following table describes the options available when using the ping tool.
Table 29.4
Option
-hub
Options available when using the ping tool
-host :
-cfg
-mo
-moagent
-mgmtport
-realm
-user
Description
Specifies the hub to ping or whose services to ping. There
is no default.
Specifies the host name and the listener port of the
machine on which the hub or managed object you are
interested in is running. The option is enables the iastool
utility to locate a managed object on a different subnet
than the machine on which iastool is running.
Specifies the name of the configuration on which to ping
for managed objects.
Specifies the name of the managed object.
Specifies the managed object agent name. Use this option
if the specified hub has more than one agent.
Specifies the management port number used by the
specified hub. The default is 42424.
Specifies the realm used to authenticate a user when the
user and password options are specified.
Specifies the user to authenticate against the specified
realm.
Chapter 29: iastool command-line utility 311