DB2 Version 9.7 for Linux, UNIX, and Windows

db2imigr - Migrate instance command

The db2imigr command migrates an instance from a previous version of DB2® database system to a new release. This command is deprecated and will be discontinued in a future release. You should use the db2iupgrade command instead.

Authorization

Root access on Linux and UNIX operating systems or Local Administrator on Windows operating systems.

Command syntax

For Linux and UNIX operating systems

Read syntax diagramSkip visual syntax diagram
>>-db2imigr--+-----+--+---------------+--+---------------+--InstName-><
             '- -d-'  '- -a--AuthType-'  '- -u--FencedID-'             

For Windows operating systems

Read syntax diagramSkip visual syntax diagram
>>-db2imigr--InstName--/u:--username,password------------------->

>--+----------------------------+--+----+--+---------------+---->
   '-/p:--instance-profile-path-'  '-/q-'  '-/a:--authType-'   

>--+-----------------------------------------------------+------>
   '-/j--"TEXT_SEARCH-+--------------+-+-------------+-"-'   
                      '-,servicename-' '-,portnumber-'       

>--+----+------------------------------------------------------><
   '-/?-'   

Command parameters

For Linux and UNIX operating systems

-d
Turns debug mode on. Use this option only when instructed by DB2 Support.
-a AuthType
Specifies the authentication type (SERVER, CLIENT or SERVER_ENCRYPT) for the instance. The default is SERVER.
-u FencedID
Specifies the name of the user ID under which fenced user-defined functions and fenced stored procedures will run. This option is required when migrating a DB2 client instance to a DB2 server instance.
InstName
Specifies the name of the instance.

For Windows operating systems

InstName
Specifies the name of the instance.
/u:username,password
Specifies the account name and password for the DB2 service. This option is required when migrating a partitioned instance.
/p:instance-profile-path
Specifies the new instance profile path for the migrated instance.
/q
Issues the db2imigr command in quiet mode.
/a:authType
Specifies the authentication type (SERVER, CLIENT, or SERVER_ENCRYPT) for the instance.
/j "TEXT_SEARCH"
Configures the DB2 Text Search server using generated default values for service name and TCP/IP port number. This parameter cannot be used if the instance type is client.
/j "TEXT_SEARCH, servicename"

Configures the DB2 Text Search server using the provided service name and an automatically generated port number. If the service name has a port number assigned in the services file, it uses the assigned port number.

/j "TEXT_SEARCH, servicename, portnumber"

Configures the DB2 Text Search server using the provided service name and port number.

/j "TEXT_SEARCH, portnumber"

Configures the DB2 Text Search server using a default service name and the provided port number. Valid port numbers must be within the 1024 - 65535 range.

/?
Displays usage information for the db2imigr command.

Usage notes

Refer to the db2iupgrade command documentation.