cmx_delete_system (Delete a Web system)
- Organization of this page
Format
-
To delete a Web system
cmx_delete_system [Common-arguments] [-s web-system-name] [-lb {keepvs|deletevs}]
-
To delete a service unit
cmx_delete_system [Common-arguments] [-s web-system-name] -unit service-unit-name
-
To delete all the logical servers that are not associated with Web systems and hosts
cmx_delete_system [Common-arguments] -ns
Function
This command deletes Web systems or service units of Web systems. If you do not specify the -unit option, Web systems will be deleted and if you specify the -unit option, service units of Web systems will be deleted. For a Web system that is built using the host-based management model, if multiple application servers (hosts) share the virtual server of load balancers, you specify whether to delete the virtual server with the -lb option, and then delete the Web system.
Additionally, when you specify the -ns option, all the logical servers that are not associated with the Web system and the hosts will be deleted.
Note that this command also deletes the Web system information model registered with Management Server, the information set in the load balancer, and all the hosts associated with Web systems or service units to be deleted. However, the hosts referenced from other Web systems and service units that are not to be deleted and the hosts in which a logical server is added without using the Smart Composer functionality will not be deleted. To delete hosts registered in the management domain and not associated with Web systems, you must temporarily associate the hosts to be deleted with Web systems and service units, and then delete the host for each associated Web system or service unit.
Arguments
- -s web-system-name
-
Specifies names of Web systems.
If you omit this option, the value set in the cmx.websystem.name key of the .cmxrc file or the cmxclient.properties file is 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_delete_system command by omitting the -s option, an error occurs.
- -unit service-unit-name
-
Specifies names of service units.
- -lb
-
Specifies whether the virtual server of the load balancer will be deleted. Specify this option to scale out the Web systems that are built with the host-based management model.
-
keepvs
Does not delete the virtual server of load balancers. Deleted the load balancer settings. You specify this option when multiple hosts share the virtual server of the load balancer.
-
deletevs
Deletes the virtual server of load balancers and load balancer settings.
If you omit this option, the value set in the cmx.lb key of the .cmxrc file or the cmxclient.properties file is used. Note that if the cmx.lb key is not specified in the .cmxrc file and the cmxclient.properties file and if you omit the -lb option, deletevs is used. For the .cmxrc file, see 4.2.2 .cmxrc (client setting properties file) in the uCosminexus Application Server Definition Reference Guide. For the cmxclient.properties file, see 4.2.3 cmxclient.properties (common client setting properties file) in the uCosminexus Application Server Definition Reference Guide.
-
- -ns
-
Deletes all the logical servers that are not associated with Web systems and hosts.
Input examples
cmx_delete_system -s sample-system -unit unit1
Return values
- 0:
-
The command is terminated normally.
- 1:
-
The command is terminated with a warning.
- 64:
-
The command is terminated abnormally.
Notes
-
If you use this command to delete Web systems and service units, the Web server and J2EE server environments are retained in the hosts that configure service units.
To re-use this host using the Smart Composer functionality, unset up the server environment as follows:
-
Unset up the Web server environment
You use the Cosminexus HTTP Server utility to unset up the environment.
Specify the Web server name specified in the utility in the format "HWS_logical-server-name-of-Web-server". You can use the cmx_list_model command to reference the logical server name of the Web server. Confirm the logical server name before you execute the cmx_delete_system command.
However, if the real server name of the Web server is specified in the realservername parameter of the physical tier, specify "HWS_ real-server-of-the-Web-server " as the server name to be specified in the utility.
-
Unset up the J2EE server environment
You use the server management command cjsetup (set up or unsetup J2EE server) to unset up the environment.
Using the command, you specify the logical server name of J2EE servers. You can use the cmx_list_model command to reference the logical server name of J2EE servers. Confirm the logical server name before you execute the cmx_delete_system command.
However, if the real server name of the J2EE server is specified in the realservername parameter of the physical tier, you specify the real server name as the server name to be specified in the command.
The following are the examples for deleting the environments of the respective servers:
- Example for deleting the Web server environment
-
In Windows
Cosminexus-installation-directory\httpsd\admin\bin\hwsserveredit -delete HWS_cmx_sample-system_unit1_HTTP_01
In UNIX
/opt/hitachi/httpsd/admin/bin/hwsserveredit -delete HWS_cmx_sample-system_unit1_HTTP_01
- Example for deleting the J2EE server environment
-
In Windows
Cosminexus-installation-directory\CC\server\bin\cjsetup -d cmx_sample-system_unit1_J2EE_01
In UNIX
/opt/Cosminexus/CC/server/bin/cjsetup -d cmx_sample-system_unit1_J2EE_01
For details on the Cosminexus HTTP Server utility, see the uCosminexus Application Server HTTP Server User Guide.
-
-
If you execute the cmx_delete_system command, the logical user server is also deleted simultaneously.