asadmin-start-instance(1AS)					   User Commands				       asadmin-start-instance(1AS)

NAME

       asadmin-start-instance, 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

       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.

       Example 1: Using start-instance in local mode

       asadmin> start-instance --domain domain1 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

INTERFACE EQUIVALENT

       Server Instance page

       asadmin-delete-instance(1AS),   asadmin-create-instance(1AS),   asadmin-stop-instance(1AS),  asadmin-restart-instance(1AS),  asadmin-start-
       appserv(1AS), asadmin-stop-appserv(1AS), asadmin-start-domain(1AS),.asadmin-stop-domain(1AS)

J2EE 1.4 SDK							    March 2004					       asadmin-start-instance(1AS)