Migrate Instances

Edit online

Ensure that the target Universal Messaging server has the migration utility installed. For information about the migration utility, see Upgrading IBM webMethods Products.

Important: You must run the commands in the context and order documented in Upgrading IBM webMethods 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 IBM 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 IBM 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 IBM 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.