mngenvupdate (Migration Command of Management Server)
- Organization of this page
Format
mngenvupdate
Functions
This command converts the information managed in Management Server to the information in the format compatible with the latest version.
Execute this command on the host for operating Management Server.
Users with the Administrator privileges (in Windows) or root permission (in UNIX) can execute this command.
For the migration procedure, see 10. Migrating from Application Server of Earlier Versions (In the J2EE Server Mode) in the uCosminexus Application Server Maintenance and Migration Guide.
If you execute the mngenvupdate command, the following process is executed:
-
Migrate the definition file (mserver.cfg) managed by Management Server to the format used in latest version.
- Reference note
-
At the time of migration, a backup file is created in the same directory as that of definition files. The name of the created backup file is Definition-file-name-of-migration-object .envupdate_bak. If a file with same name exists at the time of creating the backup file, the name changes to Definition-file-name-of-migration-object .envupdate_bak [n] (n is a serial number from 1 to 2147483647). If backup files are created for all the numbers from 1 to 2147483647, the numbers are overwritten starting from 1.
-
If you are using the following functions on an earlier version of Management Server, migrate the files used for each functionality in the format to be used in the latest version.
-
Integrated user management function
Cosminexus-installation-directory
/manager/containers/m/j2eeapps/mngsvr/mportal/useradmin/config/data/editusersConfig.xml
-
-
After you have changed the server name of Management Server, migrate the server name to an environment of the latest version (execute Application-Server -installation-directory/CC/server/bin/cjsetup real-server-name).
Input example
mngenvupdate
Return values
- 0:
-
Normal termination occurred
- Other than 0:
-
Abnormal termination occurred
Notes
-
Execute this command after upgrading the version from the previous version.
-
If an attempt to execute the mngenvupdate command fails, the temp files (mserver.cfgxxxxxxxxxxxxxxxxxxxx.tmp) remain under the Cosminexus-installation-directory/manager/config directory, and even if the temp files are retained or deleted, there is no impact on the subsequent operations.