DEPLOY 
This command group contains commands necessary for deploying, updating or monitoring J2EE applications. You can add the commands of the deploy shell group by executing ADD DEPLOY in a Telnet client.
The commands and their parameters are listed bellow.
APPLICATION_INFO
Syntax |
APPLICATION_INFO [-s serverName] <-a applicationName> |
Parameters |
|
[-s serverName] |
The name of the server from which the info is to be taken. The default one is the current server. |
<-a applicationName> |
The name of the application. |
Description |
Displays the deployment information of an application deployed on the J2EE Engine. |
CHANGE_INTERFACE
Syntax |
CHANGE_INTERFACE <parameters> |
Parameters |
|
-d <JarName> |
|
-r <InterfaceName> |
Removes an interface. |
Description |
Deploys or removes an interface from the J2EE Engine. |
CHANGE_LIB
Syntax |
CHANGE_LIB <parameters> |
Parameters |
|
-d <JarName> |
Deploys a JAR file as a library. |
-r <LibraryName> |
Removes a library. |
Description |
Deploys or removes a library from the J2EE Engine. |
CHANGE_REF
Syntax |
CHANGE_REF <mode> <ApplicationName> [ReferenceType][-pr ProviderName] <[ResourceType]:<ResourceName>>* |
Mode |
|
-m |
Creates references from an application to the resource(s). |
-r |
Removes references between an application and the resource(s). |
Arguments |
|
<ApplicationName> |
A name of an application. |
[ReferenceType] |
Reference type for the resource – strong or weak. The default value is weak. The reference type is ignored if reference(s) are removed. |
[-pr ProviderName] |
Provider name for application resources. The default values are sap.com (for applications) and engine.sap.com (for libraries, interfaces and services). |
[ResourceType] |
Resource types are application, library, interface and service. The default value is library. |
<ResourceName> |
The name of the resource. |
Description |
Creates or removes references between resource(s) and an application. |
CHANGE_SERVICE
Syntax |
CHANGE_SERVICE <parameters> |
Parameters |
|
-d <JarName> |
Deploys a JAR file as a service. |
-r <ServiceName> |
Removes a service. |
Description |
Deploys or removes a service from the J2EE Engine. |
CLIENT_JARS
Syntax |
CLIENT_JARS <-d OutputDir> <-a ApplicationName> |
Arguments |
|
<-d OutputDir> |
The directory where the client JAR files are to be stored. |
<-a ApplicationName> |
The name of the application from which client JAR files are created. |
Description |
Creates an array of JAR files that contains the classes necessary for a client module to work with an application. |
CONTAINER_INFO
Syntax |
CONTAINER_INFO <options> [-s ServerName*] |
Arguments |
|
[-s ServerName*] |
A space-separated list of server names that are to be requested for container information. By default, containers on all servers in the J2EE Engine are displayed. |
Options |
|
-a |
Lists the names of all containers on servers in the J2EE Engine. |
-c <ContainerName> |
The name of the container. |
Description |
Displays container data information. |
DEPLOY
Syntax |
DEPLOY [-r RemoteProtocol*] [-c ContainerName] [-Properties “<key=value>”*] [-NoStart] [-NoWarnings] [-Verify] <ArchiveName> |
Arguments |
|
[-r RemoteProtocol*] |
A space-separated list of remote communication protocols for which the deployed components generate support. The default value is P4. |
[-c ContainerName] |
The name of the container to which a J2EE application module (for example JAR, WAR, and so on) is to be deployed. If the deployable archive is not a J2EE application module, it is ignored. |
[-properties “<key=value>”*] |
User properties for the deploy process. “<key=value>” is semicolon-separated list of properties, which is enclosed in quotation marks. |
[-NoStart] |
Application will not be started after deploy.
By default, the application is started after the execution of the command deploy. |
[-NoWarnings] |
Performs deployment without displaying warning messages. |
[-Verify] |
Checks for an application with the same name on the J2EE Engine. If such an application exists, you can replace it. |
<ArchiveName> |
Name of an archive file that is to be deployed. |
Description |
Deploys an archive file on the J2EE Engine and starts the deployed application. |
DEPLOY_LANG_LIB
Syntax |
DEPLOY_LANG_LIB <-a ApplicationName> <-l <LanguageLibrary>>* |
Arguments |
|
<-a ApplicationName> |
Name of an application. |
<-l <LanguageLibrary>> |
Path to the library archive(s). |
Description |
Deploys the language library for an application on the J2EE Engine. |
GET_STATUS
Syntax |
GET_STATUS <-a ApplicationName> [-s ServerName] |
Arguments |
|
<-a ApplicationName> |
Name of an application. |
[-s ServerName] |
The name of the J2EE Engine Server on which the application is deployed. If this is not specified, the command displays the status of the server that processes the request. |
Description |
Displays the current status of an application. |
LIST_APP
Syntax |
LIST_APP [-s ServerName*] [-c containerName] |
Arguments |
|
[-s ServerName*] |
A list of names of the J2EE Engine Servers. The names must be separated by a space. If they are not specified, all applications deployed on the J2EE Engine are listed. |
[-c ContainerName] |
Name of a container. If it is not specified, all applications deployed on all registered containers are listed. |
Description |
Lists all applications deployed on containers on the J2EE Engine. |
LIST_EL
Syntax |
LIST_EL [-s ServerName*] [-c ContainerName] <-a ApplicationName> |
Arguments |
|
[-s ServerName*] |
A list of names of J2EE Engine Servers. The names must be separated by a space. If they are not specified, all application components deployed on the J2EE Engine are listed. |
[-c ContainerName] |
Name of a container. If it is not specified, all applications deployed on all registered containers are listed. |
<-a ApplicationName> |
The name of the deployed application. |
Description |
Lists all components of a deployed application. |
LIST_REFS
Syntax |
LIST_REFS <ApplicationName> |
Arguments |
|
<ApplicationName> |
Name of an application. |
Description |
Lists all the references of an application. |
REMOVE_APP
Syntax |
REMOVE_APP [-all] [-a ApplicationName] |
Arguments |
|
[-all] |
Removes all applications from the J2EE engine. |
[-a ApplicationName] |
Name of an application. |
Description |
Removes an application from the J2EE Engine. |
START_APP
Syntax |
START_APP [-all] <ApplicationName> [-s serverName*] |
Arguments |
|
[-all] |
Starts all applications on the J2EE Engine. |
<ApplicationName> |
Name of an application. |
[-s ServerName*] |
A space-separated list of J2EE Engine Servers. |
Description |
Starts an application on the servers in a cluster. |
STOP_APP
Syntax |
STOP_APP [-all] <ApplicationName> [-s serverName*] |
Arguments |
|
[-all] |
Stops all applications on the J2EE engine. |
<ApplicationName> |
Name of an application. |
[-s ServerName*] |
A space-separated list of server names on which the application is to be stopped. |
Description |
Stops an application on servers in the cluster. |
UNLOCK_APP
Syntax |
UNLOCK_APP <ApplicationName> |
Arguments |
|
<ApplicationName> |
Name of the application to be unlocked.
Use this command only in case of emergency. Ensure that another command from DEPLOY group is not operating on that application at the same time. |
Description |
Unlocks an application on all servers in the cluster. The application is locked while another shell command from DEPLOY group operates on the same application. |
UPDATE
Syntax |
UPDATE [-Properties "<key=value>"*] [-NoWarnings] <ArchiveName> |
Arguments |
|
[-Properties "<key=value>"*] |
A semicolon-separated list of user-specific properties, which is enclosed in quotation marks. |
[-NoWarnings] |
Performs update without displaying warnings. |
<ArchiveName> |
Name of an archive. |
Description |
Updates components of an archive file deployed on servers in the cluster. |
UPDATE_FILES
Syntax |
UPDATE_FILES <-a ApplicationName> <-Unit <-f FilePath> <-e FileEntryName> <-m ModuleArchiveEntryName> <-c ContainerName>>* |
Arguments |
|
<-a ApplicationName> |
Name of an application. |
<-Unit>* |
Marks the beginning of the definition of the information for the file that is going to be uploaded. |
<-f FilePath> |
Path to the file that is to replace an existing file in the application archive. |
<-e FileEntryName> |
Entry name of a file that is to be uploaded in the structure of the J2EE archive, which is a part of the EAR application. |
<-m ModuleArchiveEntryName> |
Entry name of a module archive in the structure of application EAR. |
<-c ContainerName> |
The name of the container on which a module archive is deployed. |
Description |
Updates single file(s) in the structure of a deployed application. Information about each updated file is described in a separate unit. |