org.glassfish.deployment.admin.redeploy.1 Maven / Gradle / Ivy
Administration Commands redeploy(1)
NAME
redeploy - redeploys the specified application
SYNOPSIS
redeploy
[--terse={true|false}][ --echo={true|false} ]
[ --interactive={true|false} ] [ --host host]
[--port port] [--secure| -s ] [ --user admin_user]
[--passwordfile filename] [--help]
--name component-name
[--contextroot context-root]
[--precompilejsp={true|false}]
[ --virtualservers virtual-servers]
[--properties(name=value)[:name=value]*][archive-path]
DESCRIPTION
The redeploy command redeploys an application that is
already deployed. The redeploy command preserves the set-
tings and other options with which the application was ori-
ginally deployed. The application must already be deployed.
Otherwise, an error occurs.
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.
Java EE 5 Last change: 30 Sep 2008 1
Administration Commands redeploy(1)
-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.
--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:
Java EE 5 Last change: 30 Sep 2008 2
Administration Commands redeploy(1)
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.
--help
Displays the help text for the command.
--name
The name of the application that is being redeployed.
This option must specify an application that has previ-
ously been deployed. If the application does not exist,
an error occurs.
--contextroot
The context root of the application that is being rede-
ployed. The context root identifies the application in
the server. The default is the name, without the exten-
sion, of the archive file that contains the application.
--precompilejsp
Specifies whether pages that are created with the
JavaServer PagesTM technology ("JSPTM pages") are
precomplied during deployment. Possible values are as
follows:
Java EE 5 Last change: 30 Sep 2008 3
Administration Commands redeploy(1)
false
JSP pages are not precompiled during deployment, but
are complied at runtime (default).
true
JSP pages are precompiled during deployment.
--virtualservers
One or more virtual server IDs. Multiple IDs are
separated by commas.
--properties
Optional keyword-value pairs that specify additional
properties for the redeployment. The following proper-
ties are available:
keepSessions={false|true}
Specifies whether active sessions of the application
that is being redeployed are preserved and then
restored when the redeployment is complete. Possible
values are as follows:
false
Active sessions of the application are not
preserved and restored (default).
true
Active sessions of the application are preserved
and restored.
If any active session of the application fails
to be preserved or restored, none of the ses-
sions will be available when the redeployment is
complete. However, the redeployment continues
and a warning is logged.
To preserve active sessions, the Enterprise
Server serializes the sessions and saves them in
memory. To restore the sessions, the class
loader of the newly redeployed application
deserializes any sessions that were previously
saved.
Java EE 5 Last change: 30 Sep 2008 4
Administration Commands redeploy(1)
OPERANDS
archive-path
The path to the archive that contains the application
that is being redeployed. This path can be a relative
path or an absolute path.
The archive can be in either of the following formats:
o An archive file, for example,
/export/JEE_apps/hello.war
o A directory that contains the exploded format
of the deployable archive
Whether this operand is required depends on how the
application was originally deployed:
o If the application was originally deployed from
a file, the archive-path operand is required.
The operand must specify an archive file.
o If the application was originally deployed from
a directory, the archive-path operand is
optional.
If this operand is omitted, the path is
retrieved from the domain.xml file. Otherwise,
the operand can specify a directory or an
archive file.
EXAMPLES
Example 1 Redeploying a Web Application From a File
This example redeploys the web application hello from the
hello.war file in the current working directory. The appli-
cation was originally deployed from a file. Active sessions
of the application are to be preserved and then restored
when the redeployment is complete.
asadmin> redeploy --user admin --passwordfile myfile --name hello
--properties keepSessions=true hello.war
Command redeploy executed successfully
Example 2 Redeploying a Web Application From a Directory
Java EE 5 Last change: 30 Sep 2008 5
Administration Commands redeploy(1)
This example redeploys the web application hellodir. The
application was originally deployed from a directory. The
path is retrieved from the domain.xml file.
asadmin> redeploy --user admin --passwordfile myfile --name hellodir
Command redeploy executed successfully
EXIT STATUS
0 command executed successfully
1 error in executing the command
SEE ALSO
deploy(1), undeploy(1), list-components(1)
Java EE 5 Last change: 30 Sep 2008 6
© 2015 - 2025 Weber Informatics LLC | Privacy Policy