cmx_deploy_application (Deploy a J2EE application) (For compatibility)
Format
- When a J2EE application is specified in the archive format
cmx_deploy_application [Common-arguments] [-s web-system-name] [-unit service-unit-name] -appname application-display-name -appver application-version-ID
- When a J2EE application is specified in the exploded archive format
cmx_deploy_application [Common-arguments] [-s web-system-name] [-unit service-unit-name] -appname application-display-name
- When the J2EE application is not specified
cmx_deploy_application [Common-arguments] [-s web-system-name] [-unit service-unit-name]
Function
This command deploys J2EE applications. The deployment method differs when the J2EE application is specified or not specified in the command.
- When a J2EE application is specified in the archive format
This command deploys the specified J2EE application in the archive format for all the service units included in the Web system.
If the service unit is specified, the J2EE application specified in the archive format will be deployed on the specified service unit.
- When a J2EE application is specified in the exploded archive format
This command deploys the J2EE application specified in the exploded archive format on all the service units that are included in the Web system.
If a service unit is specified, the J2EE application specified in the exploded archive format will be deployed on the specified service unit.
- When the J2EE application is not specified
Deploys all the J2EE applications (archive format and exploded archive format), associated with a Web system, on all the service units that are included in that Web system.
If a service unit is specified, all the J2EE applications associated with the Web system will be deployed on the specified service unit.
Arguments
- -s web-system-name
- Specifies the Web system name.
- If you omit this option, the value set in the cmx.websystem.name key of the .cmxrc file or the cmxclient.properties file will be used. Note that if the cmx.websystem.name key is not specified in the .cmxrc file and the cmxclient.properties file and if you execute the cmx_deploy_application command by omitting the -s option, an error occurs.
- -unit service-unit-name
- Specifies the service unit name.
- -appname application-display-name
- Specifies the display name of the J2EE application. You use the display name output to the message issued after the cmx_register_application command is executed.
- -appver application-version-ID
- Specifies the version ID of the J2EE application.
Input examples
cmx_deploy_application -s sample-system -unit unit1 -appname App1 -appver 1.0
Return values
- 0:
- The command is terminated normally.
- 1:
- The command is terminated with a warning.
- 64:
- The command is terminated abnormally.
Notes
- For the J2EE applications in the archive format, the J2EE applications with different version ID but having the same display name cannot be deployed simultaneously.
- If a service unit for memory session failover is specified for processing, an error occurs.
- This command is used for compatibility with the earlier versions. For the commands related to application operations, we recommend that you use the server management commands in the version 08-00 and later versions.