Server Instance Migration Commands
Ensure that the target Universal Messaging server has the migration utility installed. For information about the migration utility, see Upgrading Software AG Products.
Important:
You must run the commands in the context and order documented in Upgrading Software AG Products. Otherwise, you may experience unpredictable results, possibly including corruption of your installation and data.
View the command line help for the migration utility using the
sagcc list administration product node_alias NUMRealmServer migration help command.
Migrate all
Universal Messaging server instances present in a source installation using the
sagcc exec administration product node_alias NUMRealmServer migration migrate srcDir=SAG_Installation_directory command.
Note:
Use this command when migrating from Universal Messaging server version 9.8 and later.
Start migration by providing the source
Universal Messaging instance name using the
sagcc exec administration product node_alias NUMRealmServer migration migrate srcDir=SAG_Installation_directory instanceName=instance_name[,instance_name,instance_name...] command .
Note:
Use this command when migrating from Universal Messaging server version 9.8 and later.
Start migration by passing arguments and using the migrate.dat file using the
sagcc exec administration product node_alias NUMRealmServer migration migrate srcDir=SAG_Installation_directory importFile=migrate.dat command.
Note:
Use this command when migrating from Universal Messaging server 9.0 through 9.7. The argument silent is set to true and continueOnError is set to false by default.
Start migration using the zip file from the old product installation using the
sagcc exec administration product node_alias NUMRealmServer migration migrate srcFile=old_installation.zip importFile=migrate.dat command.
Start migration using the zip file from the old product installation and specifying the source
Universal Messaging instance name using the
sagcc exec administration product node_alias NUMRealmServer migration migrate srcFile=old_installation.zip instanceName=instance_name[,instance_name,instance_name...] command.
View APIs under the migration namespace using the
sagcc list administration product node_alias NUMRealmServer migration command.
View if
Universal Messaging supports migration as a custom API using the
sagcc list administration product node_alias NUMRealmServer command.
Examples
To view the command line help:
sagcc list administration product sag01 NUMRealmServer migration help
where sag01 is the alias name of the installation where NUMRealmServer server instance is running. migration is the namespace for the custom Command Central API. Help is the command to view the migration tool's command line help.
To migrate all
Universal Messaging server instances present in a source installation:
sagcc exec administration product sag01 NUMRealmServer
migration migrate srcDir=C:\SoftwareAG
where sag01 is the alias name of the installation where NUMRealmServer server instance is running. migration is the namespace for the custom Command Central API. migrate is the command to access the migration tool. scrDir is the source Software AG installation directory.
To start migrating an older server instance to a new
NUMRealmServer server instance by providing the source instance name:
sagcc exec administration product sag01 NUMRealmServer
migration migrate srcDir=C:\SoftwareAG
instanceName=umserver1,umserver2
where sag01 is the alias name of the installation where NUMRealmServer server instance is running. migration is the namespace for the custom Command Central API. migrate is the command to access the migration tool. scrDir is the source Software AG installation directory. instanceName contains the comma-separated names of the Universal Messaging instances that will be migrated.
To start migrating an older server instance to a new
NUMRealmServer server instance using the migrate.dat file:
sagcc exec administration product sag01 NUMRealmServer
migration migrate srcDir=C:\SoftwareAG
silent=true importFile=migrate.dat
where sag01 is the alias name of the installation where NUMRealmServer server instance is running. migration is the namespace for the custom Command Central API. migrate is the command to access the migration tool. scrDir is the source Software AG installation directory. importFile specifies the data file containing the migration settings.
To start migration using the zip file from the old product installation:
sagcc exec administration product sag01 NUMRealmServer
migration migrate srcFile=99Src.zip importFile=migrate.dat
where sag01 is the alias name of the installation where NUMRealmServer server instance is running. migration is the namespace for the custom Command Central API. migrate is the command to access the migration tool. scrFile argument is used to provide the name of the zip file from the source Universal Messaging instance. importFile specifies the archive file path containing migration settings.
To view APIs under the migration namespace for the
NUMRealmServer server instance:
sagcc list administration product sag01 NUMRealmServer migration
where sag01 is the alias name of the installation where NUMRealmServer server instance is running.
To view if
Universal Messaging supports migration as a custom API:
sagcc list administration product sag01 NUMRealmServer
where sag01 is the alias name of the installation where NUMRealmServer server instance is running.