sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

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 Commands | list-instances(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXAMPLES
- EXIT STATUS
- INTERFACE EQUIVALENT
- SEE ALSO

## 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)

Sun Java System Application Server | Go To Top | Last Changed 29 Dec 2003

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.