cmx_register_application (Register a J2EE application) (For compatibility)
Format
- To register a J2EE application in the archive format
cmx_register_application [Common-arguments] -f EAR-file -appver application-version-ID [-replace]
- To register a J2EE application in the exploded archive format
cmx_register_application [Common-arguments] -appname application-display-name -d application-directory [-replace]
Function
This command registers a J2EE application into the domain managed by Management Server.
The J2EE application formats that you can register include the archive format and the exploded archive format.
- To register a J2EE application in the archive format
The J2EE applications in the archive format are uniquely identified by the application display name and the application version ID. If an application with the same application display name and the same application version ID is already registered, you can re-register the application by specifying the -replace option.
- To register a J2EE application in the exploded archive format
The J2EE applications in the exploded archive format are uniquely identified by the application display name. If an application with the same application display name is already registered, you can re-register the application by specifying the -replace option.
Arguments
- -f EAR-file
- Specifies the EAR file path of J2EE applications.
- -appver application-version-ID
- Specifies the version ID of J2EE applications.
- -appname application-display-name
- Specifies the application display name coded in the display-name tag of DD (application.xml) below the application directory.
- -d application-directory-path
- Specifies the application directory path that can be referenced from the Application Server machine (J2EE server).
- -replace
- Specify this option to re-register J2EE applications.
Input examples
cmx_register_application -f App1.ear -appver 1.1 -replace
Return values
- 0:
- The command is terminated normally.
- 1:
- The command is terminated with a warning.
- 64:
- The command is terminated abnormally.
Notes
- Applications with the same application display names cannot be registered even if the registration formats of the J2EE applications are different.
Additionally, if applications with the same application display name are already registered, even if you specify the -replace option, you cannot re-register the applications in the case the formats of the applications to be registered are different. To re-register applications with different formats, first delete the registered application and then you register the application.
- 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 08-00 and later versions.