mngsvrupdate (Management Server migration command)
- Organization of this page
Format
mngsvrupdate [-t target-name] [-k target-type] [subcommand [arguments]]
Function
This command migrates information managed by Management Server to the latest version that matches the Cosminexus Component Container version.
You execute this command from the host where Management Server is running.
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.
Arguments
- -t target-name
-
Specifies the name of the target (logical server or host) to which the subcommand is to be applied.
If this option is omitted, the subcommand will be applied to all logical servers of all hosts.
- -k target-type
-
Specifies the type of target to which the subcommand is to be applied, as one of the following:
-
logicalServer: Logical server
-
host: Host
If this option is omitted or a value other than those listed above is specified, logicalServer is set.
-
- subcommand arguments
-
Specifies a subcommand and arguments.
When these items are omitted, the command's usage is displayed.
The subcommand and arguments that can be specified are described below.
- d2r [data-source-display-name [resource-adapter-display-name]]
-
Migrates the data source information managed by Management Server to the resource adapter. The migration target is specified by target-name and target-type.
-
When data-source-display-name is specified:
Only the specified data source is migrated. When this argument is specified, you must specify a logical server name for target-name. If this argument is omitted, all data sources imported into the applicable logical server become migration targets.
-
When resource-adapter-display-name is specified:
The value specified by this argument is used as the data source display name following migration. However, if an existing resource adapter is specified, migration does not occur. If this argument is omitted, the data source display name is assumed as the resource adapter display name.
-
The following file is edited during the migration process:
-
In Windows:
Cosminexus-installation-directory\manager\config\mmodel.xml
-
In UNIX:
/opt/Cosminexus/manager/config/mmodel.xml
Note that mmodel.xml is backed up in mmodel.xml.bak. If mmodel.xml.bak already exists, it is overwritten.
Input examples
-
Input example 1
Migrate all the hosts within the management domain, in a batch:
mngsvrupdate d2r
-
Input example 2
Migrate by specifying a host:
mngsvrupdate -t hostA -k host d2r
-
Input example 3
Migrate by specifying a logical server:
mngsvrupdate -t MyServer d2r ds ds1
Notes
-
Before executing this command, make sure that Management Server is stopped. If this command is executed while Management Server is active, the changes might not become effective.
-
If multiple instances of the migration command are executed at the same time, the environment might not be migrated correctly. You should never execute more than one instance of the migration command at the same time.
-
You should save the following file in some other location before you execute the migration command:
-
In Windows:
Cosminexus-installation-directory\manager\config\mmodel.xml
-
In UNIX:
/opt/Cosminexus/manager/config/mmodel.xml
-