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 | start-instance(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- OPERANDS
- EXAMPLES
- EXIT STATUS
- SEE ALSO

## NAME

> start-instance - starts a server instance and all the services associated with it

## SYNOPSIS

> `start-instance` [--user admin_user] [--password admin_password] [ --host local_host] [--port 4848] [--local=false] [--domain domain_name] [--debug=false] [--passwordfile filename] [ --secure|-s] `instance_name`

## DESCRIPTION

> Use the `start-instance` command to start an instance with the instance name you specify. The `start-instance` command can be run both locally and remotely. To start locally, with a domain name identified, the named instance must already exist within that domain. To start remotely, the 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 instance.

> --password

>   administrative password corresponding to the administrative user.

> --host

>   host name of the machine hosting the administrative instance.

> --port

>   administrative port number associated with the administrative host.

> --local

>   determines if the command should delegate the request to administrative instance or run locally.

> --domain

>   name of the domain.

> --debug

>   starts the instance in debug mode.

> --passwordfile

>   file containing passwords appropriate for the command (e.g., administrative instance).

> --secure

>   if true, uses SSL/TLS to communicate with the administrative instance.

## OPERANDS

> instance_name

>   name of the instance to be started.

## EXAMPLES

> Example 1. Using `start-instance` in local mode

> > >     asadmin> start-instance --domain domain1 --local=true admin-server
> > >     Instance admin-server started

> > Where: the `admin-server` instance is started on the local `domain1` domain.

> Example 2. Using `start-instance` in remote mode

> > >     asadmin> start-instance --user admin --password bluestar --host localhost --port 4848 server1
> > >     Instance server1 started

> > Where: the `server1` instance is started on the remote domain associated with the specified user, password, host, and port number.

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## SEE ALSO

> `delete-instance`(1), `create-instance`(1), `stop-instance`(1), `restart-instance`(1), `start-appserv`(1), `stop-appserv`(1), `start-domain`(1),.`stop-domain`(1)

| Go To Top | Last Changed April 2004

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