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 Commandsasadmin-deploy(1AS)


NAME

 asadmin-deploy, deploy - deploys the specifiedcomponent

SYNOPSIS

 deploy --user admin_user[ --password admin_password ][ --host localhost ] [ --port 4848 ][ --passwordfile filename ][ --secure|-s ][ --virtualservers virtual_servers ] [ --type application|ejb|web|connector ][ --contextroot context_root ][ --force=true ] [ --precompilejsp=false ][ --verify=false ][ --name component_name ] [ --upload=true ][ --retrieve local_dirpath ] [ --instance instance_name ] filepath

DESCRIPTION

 

Use the deploy command to deploy an EJB, web, connector or application. If the component is already deployed or already exists, it is forcefully re-deployed if the --force option is set to true.


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.
--passwordfile
file containing passwords appropriate for the command (e.g., administrative instance).
--secure
if true, uses SSL/TLS tocommunicate with the administrative instance.
--virtualservers
comma separated list of virtual server IDs.
--type
identifies the type of component to be deployed; defaults to the type of the extension of file.
--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.
--precompilejsp
by default is set to false which does not allow the JSP to pre-compile during deployment. Instead JSPs are compiled during runtime.
--verify
the syntax and semantics of the deployment descriptor is verified if set to true.
--name
name of the deployable component.
--upload
when set to true uploads the deployable file to the administration server. If the filepath of the deployable file is mounted to the server machine, or if the administration server is running locally, set the upload option to false.
--retrieve
retrieves the client stub JAR file from the server machine to the local directory. Retrieve works only if the deployable component is of type application; otherwise it is ignored.
--instance
name of the instance.

OPERANDS

 
filepath
path to the deployable file on local machine if the --upload option is set to true; otherwise the absolute path to the file on the server machine.

EXAMPLES

 Example 1. Using deploy for WAR module
 
 
asadmin> deploy --user admin --passwordfile passwords.txt --host localhost --port 4848 --virtualservers server1 --type web --contextroot simiple --no-force --precompilejsp --verify --name simple --upload --instance server1 /export/samples/simple.war
Deployed the WAR module:simple

Where: the simple WAR module is deployed to the server1 instance.

Example 2. Using deploy for an application
 
 
asadmin> deploy --user admin --password adminadmin --host localhost --port 4848 --virtualservers server1 --type application --no-force --precompilejsp --verify --name fortune --upload --instance server1 /export/samples/fortune.ear
Deployed the application:fortune

Where: the fortune application is deployed to the absolute filepath specified.


EXIT STATUS

 
0
command executed successfully
1
error in executing the command

INTERFACE EQUIVALENT

 

Applications folder, Module interface


SEE ALSO

 

asadmin-deploydir(1AS), asadmin-undeploy(1AS), asadmin-enable(1AS), asadmin-disable(1AS), asadmin-list-components(1AS)



Sun ONE Application ServerGo To TopLast Changed 9 Sep 2002


Updated: 2003-06-13, 20:30