mngunsetup (Deleting Management Server configuration environment)
- Organization of this page
Format
mngunsetup [-force]
Functionality
Executes the unset up of Management Server and Administration Agent on the host executing this command, and the unset up of the system environment (logical server) that is set up by using Management Server. You can execute this command regardless of whether Management Server and Administration Agent are operating.
Execute this command on Application Server in case of host unit model and on Management Server as well as Application Server in case of Management Server model (Host for operating Management Server).
Users having Administrator privileges or the users from Management Server management group must execute this command.
Furthermore, if the environment to be unset up matches the following conditions, command execution might fail. Execute the command after taking the necessary actions.
-
If there is a CTM or OTM (TPBroker Object Transaction Monitor) process that is started without using Management Server, or any command is running, stop the CTM or OTM (TPBroker Object Transaction Monitor) process as well as the running command.
-
In UNIX, if auto restart is set in Administration Agent and Management Server,
execute the mngautorun command, cancel the auto restart setting, and then restart.
Arguments
If an argument is not specified, a message to confirm whether to execute unsetup is displayed. If you select y, unsetup is executed, and if you select n, unsetup is stopped, and the process ends.
- -force
-
Execute unsetup forcibly without displaying a message to confirm whether to execute unsetup.
Input examples
-
Execute mngunsetup.
mngunsetup
-
Display a message to confirm whether to execute unsetup.
-
In Windows
Do you really want to unset up the following environment? -Management functionality (Management Server and Administration Agent). -System environment (Logical server) {y|n} >
-
In UNIX
Do you really want to unset up the following environment? -Management functionality (Management Server and Administration Agent) -System environment (Logical server) -Settings of start user of J2EE server (Component Container administrator) {y|n} >
-
-
Enter y to execute unsetup, and enter n to stop unsetup.
Return values
- 0:
-
Normal termination occurred
- 1:
-
Error has occurred at the time of execution.
- 2:
-
Syntax error has occurred.
Notes
-
Files other than the configuration information or the setup information files managed by the load balancer functionality, server communication agent, and Management Server are not unsetup. Delete these files manually.
-
If you execute unsetup in the environment set up before version 09-00, the logical server (logical J2EE server, or the logical Web server) might not get deleted. You can delete such logical servers; only if those have been started once after migrating to the version 09-00. The environment variables specified at the time of setup are not maintained and if the setup is executed without specifying the environment variables, deletion might fail. Delete the logical server manually using a command, if it has not been started even once.
-
Deleting the logical J2EE server
In Windows
Cosminexus-installation-directory/CC/server/bin/cjsetup -d real-server-name
In UNIX
/opt/Cosminexus/CC/server/bin/cjsetup -d real-server-name
-
Deleting the logical Web server
In Windows
Cosminexus-installation-directory/httpsd/admin/bin/hwsserveredit -delete HWS_real-server-name
In UNIX
/opt/hitachi/httpsd/admin/bin/hwsserveredit -delete HWS_real-server-name
-
-
When you have changed the real server name of Management Server in an environment configured in 09-50 or earlier, the environment of Management Server, set with the real server name before change, is not deleted even when you execute the un-setup. Manually delete the environment by using the command.
-
Deleting the environment of Management Server configured with the real server name before change
In Windows
Application-Server-installation-directory\CC\server\bin\cjsetup -d real-server-name
In UNIX
/opt/Cosminexus/CC/server/bin/cjsetup -d real-server-name
-
-
In UNIX, when auto restart is set in Management Server and Administration Agent, cancel the auto restart setting by the mngautorun command, restart the machine and execute this command. If you do not cancel the settings of auto restart and do not restart the machine, an error might occur during unsetup.
-
In the logical J2EE server, and logical Web server, the logical server setup using Management Server is considered for deletion. Accordingly, even if the logical server is deleted beforehand by using the management portal or Smart Composer functionality, the real server is deleted.
-
In the logical CTM domain manager, the CTM domain information of the logical CTM domain manager started by using Management Server is considered as deletion target. Accordingly, even if you delete the logical CTM domain manager beforehand, by using the management portal and Smart Composer functionality, CTM domain information is deleted.
For CTM domain manager, take precautions for the following points:
-
The CTM domain information of the CTM domain manager started without using Management Server is also deleted.
-
If OTM (TPBroker Object Transaction Monitor) environment exists on the host that executes the command, TSC domain related information is also deleted.
-
If CTM and OTM process is started without using Management Server, and if any command is running in this process, unexpected error might occur in the process or the command. Stop all CTM and OTM processes as well as the commands running in this process, and then execute this command.
-
-
In UNIX, settings of Management Server management group are not cancelled. If you want to cancel the settings of the Management Server management group, execute the mngenvsetup command. For the mngenvsetup command , see mngenvsetup (setup management group).