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


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 TopLast Changed April 2004