web server - Borland Technical Publications

web server - Borland Technical Publications web server - Borland Technical Publications

techpubs.borland.com
from techpubs.borland.com More from this publisher
12.11.2014 Views

Using the iastool command-line tools listhubs Use this tool to list hubs running on a particular management port located on the same local area network. Syntax -listhubs [-mgmtport ] [-bare] [-realm ] [-user ] [-pwd ] [-file ] Note Default Output By default, the listhubs tool displays the hubs running in the default management port or on a specified management port. If a particular hub that is queried is down, it is not listed. Options The following table describes the options available when using the listhubs tool. Option -mgmtport -bare -realm -user -pwd -file Description Specifies a management port number of the running hub you want to list. The default is 42424. Suppresses output information, other than the names of the running hubs. 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. Specifies the user's password to authenticate against the specified realm. Specifies a login script file containing the realm, user name, and password used to authenticate a user. The full or relative path to this file must be specified. See “Executing iastool command-line tools from a script file” on page 321 for more information. Examples The following example lists the hubs running in the default management port: iastool -listhubs The following example lists the hubs running in the management port 24410: iastool -listhubs -mgmtport 24100 listservices Use this tool to list one or more services running on a hub. Syntax -listservices [-cfg ] [-mgmtport ] [-bare] [-realm ] [-user ] [-pwd ] [-file ] Default Output By default, listservices displays a list of all partition services registered for the specified hub on a particular management port. Chapter 29: iastool command-line utility 305

Using the iastool command-line tools Options The following table describes the options available when using the listservices tool. Option -hub -host : -cfg -mgmtport -bare -realm -user -pwd -file Description Specifies the name of the hub for which you want to list the running services. Specifies the host name and the listener port of the machine on which the services you are interested in are running. The option is enables the iastool utility to locate a hub on a different subnet than the machine on which iastool is running. Specifies the name of the configuration on which to list services. Specifies the management port number used by the specified hub. The default is 42424. Suppresses output of information other than the names of the running services. 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. Specifies the user's password to authenticate against the specified realm. Specifies a login script file containing the realm, user name, and password used to authenticate a user. The full or relative path to this file must be specified. See “Executing iastool command-line tools from a script file” on page 321 for more information. Example The following example lists all services running on the salsa hub: iastool -listservices -hub salsa manage Use this tool to actively manage a managed object in a configuration. Syntax -manage (-hub | -host :) [-cfg ] -mo [-moagent ] [-mgmtport ] [-realm ] [-user ] [-pwd ] [-file ] Default Output The default output returns nothing to standard output (stdout). 306 BES Developer’s Guide

Using the iastool command-line tools<br />

listhubs<br />

Use this tool to list hubs running on a particular management port located on the same<br />

local area network.<br />

Syntax<br />

-listhubs [-mgmtport ] [-bare] [-realm ] [-user ]<br />

[-pwd ] [-file ]<br />

Note<br />

Default Output<br />

By default, the listhubs tool displays the hubs running in the default management port<br />

or on a specified management port.<br />

If a particular hub that is queried is down, it is not listed.<br />

Options<br />

The following table describes the options available when using the listhubs tool.<br />

Option<br />

-mgmtport <br />

-bare<br />

-realm <br />

-user <br />

-pwd <br />

-file <br />

Description<br />

Specifies a management port number of the running hub you want<br />

to list. The default is 42424.<br />

Suppresses output information, other than the names of the running<br />

hubs.<br />

Specifies the realm used to authenticate a user when the user and<br />

password options are specified.<br />

Specifies the user to authenticate against the specified realm.<br />

Specifies the user's password to authenticate against the specified<br />

realm.<br />

Specifies a login script file containing the realm, user name, and<br />

password used to authenticate a user. The full or relative path to this<br />

file must be specified. See “Executing iastool command-line tools<br />

from a script file” on page 321 for more information.<br />

Examples<br />

The following example lists the hubs running in the default management port:<br />

iastool -listhubs<br />

The following example lists the hubs running in the management port 24410:<br />

iastool -listhubs -mgmtport 24100<br />

listservices<br />

Use this tool to list one or more services running on a hub.<br />

Syntax<br />

-listservices [-cfg ]<br />

[-mgmtport ] [-bare] [-realm ] [-user ]<br />

[-pwd ] [-file ]<br />

Default Output<br />

By default, listservices displays a list of all partition services registered for the<br />

specified hub on a particular management port.<br />

Chapter 29: iastool command-line utility 305

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!