
Administration Commands                              deploydir(1)

NAME
     deploydir  -  deploys  an  exploded  format  of  application
     archive

SYNOPSIS
     deploydir
     [--terse={true|false}][ --echo={true|false} ]
     [ --interactive={true|false} ] [ --host  host]
     [--port port] [--secure| -s ] [ --user  admin_user]
     [--passwordfile filename] [--help]
     [ --virtualservers  virtual_servers]
     [--contextroot context_root] [--force=true]
     [ --verify =false] [ --precompilejsp =false]
     [ --name  component_name] [--uniquetablenames=true|false]
     [--dbvendorname dbvendorname] [--createtables=false |  --dropandcreatetables =false]
     [ --generatermistubs =false] [ --availabilityenabled =false]
     [ --libraries  jar_file[(path_separator)jar_file*]]
     [--target target] dirpath

DESCRIPTION
     Note -

       This command is  deprecated.  Use  the  deploy(1)  command
       instead.

     Use this command to deploy an application  directly  from  a
     development  directory.  The appropriate directory hierarchy
     and deployment descriptors conforming to the Java EE specif-
     ication must exist in the deployment directory.

     Directory deployment is for advanced developers only. Do not
     use  it  in  production environments. In production environ-
     ments, use the deploy command.  Directory deployment is only
     supported  on localhost, that is, the client and server must
     reside on the same machine. For this reason, the only values
     for the --host option are:

         o    localhost

         o    The value of the $HOSTNAME environment variable

         o    The IP address of the machine

     The --force option makes sure the  component  is  forcefully
     (re)deployed  even  if  the  specified component has already
     been deployed or already exists. Set --force to false for  a
     first  deployment. If the application with that name is run-
     ning and force is set to false, the command fails.

Java EE 5           Last change: 16 Sep 2008                    1

Administration Commands                              deploydir(1)

     This command is supported in remote mode only.

OPTIONS
     -t --terse

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

     -e --echo
         If set to true, the command-line statement is echoed  on
         the standard output. Default is false.

     -I --interactive

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

     -H --host
         The machine name where the domain administration  server
         is running. The default value is localhost.

     -p --port

         The HTTP port or HTTPS  port  for  administration.  This
         port is the port in the URL that you specify in your web
         browser   to   manage   the   domain,    for    example,
         http://localhost:4848.

         The default port number for administration is 4848.

     -s --secure
         If set to true, uses SSL/TLS  to  communicate  with  the
         domain administration server.

         The default is false.

     -u --user

         The user name of the authorized administrative  user  of
         the domain administration server.

         If you have authenticated to a domain by using the asad-
         min  login  command,  you  need  not  specify the --user
         option for subsequent operations on the domain.

Java EE 5           Last change: 16 Sep 2008                    2

Administration Commands                              deploydir(1)

     --passwordfile

         Specifies the name, including the full path, of  a  file
         that contains the password entries in a specific format.

         The entry for a password must have the AS_ADMIN_  prefix
         followed  by the password name in uppercase letters. For
         example, to specify the password for the domain adminis-
         tration server, use an entry with the following format:

           AS_ADMIN_PASSWORD=password

         In this example, password is  the  actual  administrator
         password.

         The following other passwords can also be specified:

             o    AS_ADMIN_MAPPEDPASSWORD

             o    AS_ADMIN_USERPASSWORD

             o    AS_ADMIN_ALIASPASSWORD
         All remote  commands  must  specify  the  administration
         password  to  authenticate  to the domain administration
         server. The password can be specified by one of the fol-
         lowing means:

             o    Through the --passwordfile option

             o    Through the asadmin login command

             o    Interactively at the command prompt
         The asadmin login command can be used  only  to  specify
         the  administration  password.  For other passwords that
         remote commands require, use the  --passwordfile  option
         or specify them at the command prompt.

         After authenticating to a domain by  using  the  asadmin
         login  command,  you need not specify the administration
         password through the --passwordfile  option  for  subse-
         quent  operations  on  the  domain.  However,  only  the
         AS_ADMIN_PASSWORD option is not required. You still must
         provide    the    other    passwords,    for    example,
         AS_ADMIN_USERPASSWORD, when required by individual  com-
         mands, such as update-file-user.

         For security reasons, a password that is specified as an
         environment variable is not read by the asadmin command.

         The  default  value   for   AS_ADMIN_MASTERPASSWORD   is
         changeit.

Java EE 5           Last change: 16 Sep 2008                    3

Administration Commands                              deploydir(1)

     --help

         Displays the help text for the command.

     --virtualservers
         Comma-separated list of virtual server IDs.

     --contextroot

         Valid only if the archive is a web module. It is ignored
         for  other  archive  types; defaults to filename without
         extension.

     --force
         Makes sure the component is forcefully (re)deployed even
         if  the specified component has already been deployed or
         already exists.

     --verify

         If set to true, the syntax and semantics of the  deploy-
         ment descriptor is verified.

     --precompilejsp
         By default, this option is set to false, which does  not
         allow the JSP to pre-compile during deployment. Instead,
         JSPs are compiled during runtime.

     --name

         Name of the deployable component.

     --uniquetablenames
         Do not specify this option. This option is retained  for
         compatibility  with  other releases. If you specify this
         option, a syntax error does not occur. Instead, the com-
         mand  runs  successfully  and  the  option  is  silently
         ignored.

     --dbvendorname

         Do not specify this option. This option is retained  for
         compatibility  with  other releases. If you specify this
         option, a syntax error does not occur. Instead, the com-
         mand  runs  successfully  and  the  option  is  silently

Java EE 5           Last change: 16 Sep 2008                    4

Administration Commands                              deploydir(1)

         ignored.

     --createtables

         Do not specify this option. This option is retained  for
         compatibility  with  other releases. If you specify this
         option, a syntax error does not occur. Instead, the com-
         mand  runs  successfully  and  the  option  is  silently
         ignored.

     --dropandcreatetables
         Do not specify this option. This option is retained  for
         compatibility  with  other releases. If you specify this
         option, a syntax error does not occur. Instead, the com-
         mand  runs  successfully  and  the  option  is  silently
         ignored.

     --generatermistubs

         if set to true, static RMI-IIOP stubs are generated  and
         put  into  the client.jar. If set to false (default) the
         stubs are not generated.

     --availabilityenabled
         This option is valid only in domains that are configured
         to  support  clusters,  such as domains that are created
         with the cluster profile or the enterprise profile. This
         option controls whether high-availability is enabled for
         SFSB checkpointing and potentially passivation.  If  set
         to  false  (default)  all SFSB checkpointing is disabled
         for the specified application or EJB module. If  set  to
         true, the specified application or module is enabled for
         high-availability. Set this option to true only if  high
         availability is configured and enabled at higher levels,
         such as the server and container levels.

     --libraries

         Specify the library JAR files by their relative or abso-
         lute   paths.   Specify   relative   paths  relative  to
         instance-root/lib/applibs. The JAR files  are  separated
         by  a colon on Unix and Linux systems and by a semicolon
         on Windows systems. The libraries are made available  to
         the application in the order specified. Place the depen-
         dent JAR files in the domain-dir/lib directory.

Java EE 5           Last change: 16 Sep 2008                    5

Administration Commands                              deploydir(1)

     --target

         Do not specify this option. This option is retained  for
         compatibility  with  other releases. If you specify this
         option, a syntax error does not occur. Instead, the com-
         mand  runs  successfully  and  the  option  is  silently
         ignored.

OPERANDS
     dirpath
         Path to the directory containing the exploded format  of
         the deployable archive.

EXAMPLES
     Example 1 Using the deploydir command

     The  exploded  application  to  be  deployed   is   in   the
     /home/temp/sampleApp  directory.  Since  the force option is
     set to true, if an application of that name already  exists,
     the application is redeployed.

       asadmin> deploydir --user admin --passwordfile passwords.txt
       --host localhost --port 4848 --force=true --precompilejsp=true /home/temp/sampleApp
       Command deploydir executed successfully

EXIT STATUS
     0                           command executed successfully

     1                           error in executing the command

SEE ALSO
     deploy(1), disable(1), enable(1), list-components(1),  rede-
     ploy(1), undeploy(1)

Java EE 5           Last change: 16 Sep 2008                    6

