
User Commands                                    start-appserv(1)

NAME
     start-appserv - starts the domains in the specified  domains
     directory

SYNOPSIS
     start-appserv     [--terse=false]     [--echo=false]     [--
     interactive=true]    [--user   admin_user]   [--passwordfile
     passwordfile] [--domaindir install_dir/domains]

DESCRIPTION
     This command is deprecated.  Use  the  start-domain  command
     instead.  Use the start-appserv command to start the domains
     in specified domain directory. If the  domain  directory  is
     not specified the domains in the default install_dir/domains
     directory are started. The  start-appserv  command  requires
     that the user has set  up an AS_ADMIN_USER environment vari-
     able and that all domains have the same administration user.
     You  are  prompted  for  the master password for each domain
     (unless the --savemasterpassword option was specified at the
     domain creation time).

     The  start-appserv  command  functions  correctly  if  every
     domain   is   created   with   --savemasterpassword.  If  --
     savemasterpassword is not specified, then you  are  prompted
     for the master password for every domain.

     This command is supported in local mode only.

OPTIONS
     --domaindir                 The directory where the  domains
                                 are to be started. If specified,
                                 the path must be  accessible  in
                                 the  filesystem.  If  not speci-
                                 fied, the domain in the  default
                                 install_dir/domains directory is
                                 started.

     -t --terse                  Indicates that any  output  data
                                 must  be very concise, typically
                                 avoiding   human-friendly   sen-
                                 tences    and   favoring   well-
                                 formatted data  for  consumption
                                 by a script. Default is false.

     -e --echo                   Setting to true  will  echo  the
                                 command line statement on to the
                                 standard  output.   Default   is
                                 false.

Java EE 5         Last change: 20 January 2007                  1

User Commands                                    start-appserv(1)

     -I --interactive            If set to true  (default),  only
                                 the  required  password  options
                                 are prompted.

     -u --user                   The authorized  domain  adminis-
                                 tration   server  administrative
                                 username.

                                 If you have authenticated  to  a
                                 domain  using  the asadmin login
                                 command,  then  you   need   not
                                 specify  the  --user  option  on
                                 subsequent  operations  to  this
                                 particular domain.

     --passwordfile              The --passwordfile option speci-
                                 fies the name of a file contain-
                                 ing the password  entries  in  a
                                 specific  format.  The entry for
                                 the  password  must   have   the
                                 AS_ADMIN_ prefix followed by the
                                 password   name   in   uppercase
                                 letters.

                                 For  example,  to  specify   the
                                 domain   administration   server
                                 password, use an entry with  the
                                 following                format:
                                 AS_ADMIN_PASSWORD=password,
                                 where  password  is  the  actual
                                 administrator  password.   Other
                                 passwords  that can be specified
                                 include AS_ADMIN_MAPPEDPASSWORD,
                                 AS_ADMIN_USERPASSWORD,       and
                                 AS_ADMIN_ALIASPASSWORD.

                                 All remote commands must specify
                                 the  admin password to authenti-
                                 cate to the  domain  administra-
                                 tion  server,  either through --
                                 passwordfile or  asadmin  login,
                                 or  interactively on the command
                                 prompt. The asadmin  login  com-
                                 mand can be used only to specify
                                 the admin  password.  For  other
                                 passwords,  that  must be speci-
                                 fied for  remote  commands,  use
                                 the --passwordfile or enter them
                                 at the command prompt.

Java EE 5         Last change: 20 January 2007                  2

User Commands                                    start-appserv(1)

                                 If you have authenticated  to  a
                                 domain  using  the asadmin login
                                 command,  then  you   need   not
                                 specify   the   admin   password
                                 through    the    --passwordfile
                                 option  on subsequent operations
                                 to this particular domain.  How-
                                 ever, this is applicable only to
                                 AS_ADMIN_PASSWORD  option.   You
                                 will  still  need to provide the
                                 other  passwords,  for  example,
                                 AS_ADMIN_USERPASSWORD,   as  and
                                 when required by individual com-
                                 mands, such as update-file-user.

                                 For security reasons,  passwords
                                 specified   as   an  environment
                                 variable will  not  be  read  by
                                 asadmin.

EXAMPLES
     Example 1 Using the start-appserv command

       asadmin> start-appserv --user admin
       Command start-appserv is deprecated.
       Starting all the domains in /opt/SUNWappserver90/domains, please wait.
       Starting Domain domain1, please wait.
       Log redirected to /opt/SUNWappserver90/domains/domain1/logs/server.log.
       Please enter the admin password>
       Domain domain1 started.

EXIT STATUS
     0                           command executed successfully

     1                           error in executing the command

SEE ALSO
     create-domain(1), delete-domain(1),  start-domain(1),  stop-
     domain(1), list-domains(1), stop-appserv(1)

Java EE 5         Last change: 20 January 2007                  3

