idsimigr

Description

The idsimigr command is a migration utility. This command migrates the schema and configuration files from an earlier supported versions to the current version of these files. After you migrate the schema and configuration files, the command creates a directory server instance with the migrated information. The created directory server instance is the upgraded version of your previous server. You can also use Instance Administration Tool to migrate from a previous version. For more information about Instance Administration Tool, see Creating and administering instances in the Installation and Configuration section of the IBM Security Directory Server documentation.

Synopsis

The syntax for the idsimigr command.

idsimigr [–I instancename] [-u backupdir] [-p port]
         [-s secure_port] [-a adm_port] [-c adm_secureport] [-t dbinstance]
         [-i ipaddress] [-l inst_location] [-r description] [-G group_name] 
         [–w password] [-d debuglevel] [-b outputfile] [–q] [-n] | [-v] 
         | [-?]

Options

-a adm_port

Specifies the port on which the administration server for the directory server instance listens on.

Note: If you have two or more instances that listen on an IP address, be sure that those instances do not use the same port.

-b outputfile

Specifies the full path of a file to redirect console output. If you use this parameter with the -q parameter, errors are sent to the outputfile file. If debug mode is set, then the debug output is sent to this file.

-c adm_secureport

Specifies the secure port on which the administration server for the directory server instance listens on. Specify a positive number that is greater than 0 and lesser than or equal to 65535. The port that is specified must a conflict with ports in use by other instances that are bound to a host name or IP address.

-d debuglevel

Sets the LDAP debug level to debuglevel. If you specify this parameter, the command sends the debug output to stdout. The debuglevel value is a bit mask that controls which output is generated with values from 1 to 65535. For more information about debug levels, see Debugging levels.

-G group_name

Specifies the operating system group name for the user. This parameter is required when you create an operating system user on a system. This parameter is valid only on AIX®, Linux®, and Solaris systems.

-i ipaddress

Specifies the IP address to which the directory server instance binds to. If more than one IP address is specified, the IP addresses must be separated by a comma with no spaces. Spaces can be used only if the entire argument is enclosed in quotation marks ("). If you want to use all available IP addresses, use the key word all. If you do not specify the -i parameter, all available IP addresses is the default setting.

-I instancename

Specifies the directory server instance name to be create or migrate. The instance name must be an existing user ID on the system and must not be greater than eight characters in length. If there is no corresponding user ID for the directory server instance name, the command fails. For more information about requirements for the instance name, see Setting up users and groups: directory server instance owner, database instance owner, and database owner in the Installing and Configuring section of the IBM Security Directory Server documentation.

-l inst_location

Specifies the location in which to store the configuration files and logs for the directory server instance. On Windows systems, you must specify this parameter and a drive letter must be provided. The location must have a minimum of 30 MB of free disk space. More disk space must be available to accommodate growth as directory server log files increase in size.

-n

Specifies to run in no prompt mode. All output from the command is generated, except for messages that require user interaction.

-p port

Specifies the port on which the directory server instance listens on. Specify a positive number that is greater than 0 and lesser than or equal to 65535. The port that is specified must not conflict with ports in use by other instances that are bound to a host name or IP address.

-q

Specifies to run in quiet mode. All output from the command is suppressed, except for error messages. If you also specify the -d parameter, then the trace output is not suppressed.

-r description

Specifies a description of the directory server instance.

-s secure_port

Specifies the secure port that the directory server instance listens on. Specify a positive number that is greater than 0 and lesser than or equal to 65535. The port that is specified must not conflict with ports in use by other instances that are bound to a host name or IP address.

-t dbinstance

Specifies the DB2® database instance name. By default, the database instance name is assumed to be the same as the directory server instance owner ID.

-u backupdir

Specifies the directory in which the schema and configuration files to migrate is saved.

If all the necessary files are not found in the directory, the command fails. These files include the server configuration files and the schema files: V3.ibm.at, V3.ibm.oc, V3.system.at, V3.system.oc, V3.user.at, V3.user.oc, and V3.modifiedschema.

-v

Specifies to show the version information of the command.

-w password

Specifies the password of the user. To create a user, you must also specify this parameter.

-?

Specifies to show the syntax format.