Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
User Commandslist-instances(1)


NAME

 list-instances - lists all the instances in the server

SYNOPSIS

 list-instances [--user admin_user] [--password admin_password] [--host localhost] [--port 4848] [--domain domain_name] [--local=false] [--passwordfile filename] [--secure|-s]

DESCRIPTION

 

Use the list-instances to list all the instance in the server. The list-instances command can be run both locally and remotely. To list remote instances, the named administration server must be running on the hostname and port number specified. The user authenticates using the password identified for the administration server.


OPTIONS

 
--user
administrative user associated for the instanace.
--password
administrative password corresponding to the administrative user.
--host
host name of the machine hosting the administrative instance.
--port
port number associated with the administrative host.
--domain
name of the domain.
--local
determines if the command should delegate the request to administrative instance or run locally.
--passwordfile
file containing passwords appropriate for the command (e.g., administrative instance).
--secure
if true, uses SSL/TLS to communicate with the administrative instance.

EXAMPLES

 Example 1. Using list-instances in local mode
 
 
asadmin> list-instances --domain1 --local
admin-server running
server1 running

Where: the server1 and admin-server instances for the domain1 domain is listed.

Example 2. Using list-instances in remote mode
 
 
asadmin> list-instances --user admin --passwordfile passwords.txt --host localhost --port 4848
server1 [mayank:80] running

Where: the server1 instance associated with the specified user, passwords, host, and port number specified is listed for the remote machine.


EXIT STATUS

 
0
command executed successfully
1
error in executing the command

INTERFACE EQUIVALENT

 

Server Instance page


SEE ALSO

 

show-instance-status(1)



J2EE 1.4 SDKGo To TopLast Changed March 2004