Upgrading a remote instance of a previous version with the idsimigr command

Edit online

Use the idsimigr command with the -u parameter to upgrade a remote directory server instance or proxy server instance of a previous supported version to version 10.0.4.

Before you begin

You must complete the following tasks before you upgrade an instance with the idsimigr command with the -u parameter:

Set up the environment before you upgrade an instance. See, Setting the environment before you upgrade an instance.
Log in as a root user on an AIX®, or Linux™ operating system, and as a member of the Administrator group on the Windows™ operating system.

You can also upgrade a remote instance with backup files by using Instance Administration Tool. For more information, see Upgrading a remote instance of a previous version with Instance Administration Tool.

About this task

After you complete the upgrade process, the idsimigr command creates an instance of 10.0.4 on the computer with the information from the remote instance.

Procedure

Back up the database of a directory server instance (with Versions 6.2, 6.3, 6.3.1, 6.4, 8.0, 8.0.1, 10.0, 10.0.1, 10.0.2 and 10.0.3) that is on a remote computer with the idsdb2ldif command.
Important: If you are upgrading a proxy server instance, do not back up database. Proxy server does not contain a database that is associated with it.
```
idsdb2ldif -I instance_name -o inst_out.ldif
```
For more information about the idsdb2ldif command, see the Command Reference.
Complete IBM® Security Verify Directory Version 10.0.4 installation on a computer to which you want to upgrade the remote instance.

To back up the schema and configuration files of the remote instance, run the migbkup command of the version to which you want to upgrade:

Operating system	Command to run:
Microsoft™ Windows	migbkup.bat drive_name\idsslapd-instance_name `backup_directory`
AIX and Linux	migbkup user_home_dir/idsslapd-instance_name `backup_directory`
Directory Suite Virtual Appliance 8.0.1	sds migration_tools migbkup This command creates `migbkup.tar` in `CustomOut` folder.

The migbkup command is in the tools subdirectory of the IBM Security Verify Directory installation media.

Copy the backup directory, backup_directory, which you created with migbkup, from the remote computer to the computer with IBM Security Verify Directory. Extract migbkup.tar file.
Copy the database backup file, inst_out.ldif, from the remote computer to the computer with IBM Security Verify Directory.

Run the idsadduser command to create the local operating system user to own the instance.

For example, on AIX or Linux:

idsadduser -u instance_name -w password -l /home/instance_name -g idsldap -n

On Windows:

idsadduser -u instance_name -w password -n

Run the idsimigr command with the -I and -u parameters to create an instance with the backup data of the remote instance.
```
idsimigr -I instance_name -u backup_directory
```

Configure a database, suffix, and administrator DN and password for the directory server instance.

Important: If you are upgrading a proxy server instance, do not run the idscfgdb command to configure a database.

idscfgdb -I instance_name –a db_admin_id –w db_admin_pwd –t db_name –l db_location
idscfgsuf -I instance_name –s suffix   
idsdnpw -I instance_name –u admin_DN –p admin_PWD

Run the idsldif2db command to import the database backup file, inst_out.ldif, to the upgraded directory server instance. For large ldif files use the idsbulkload command to import the data.
After completing the data import from an ldif file, run the idsrunstats command to optimize the database.
```
idsrunstats -I instance_name
```
Start the ibmslapd process and the administration server of the instance.
On AIX/Linux:
```
ibmslapd -I instance_name -n
ibmdiradm -I instance_name 
```
On Windows - Use Windows Services Panel to start services, "IBM Security Verify Directory Instance V10.0.4 - <instance_name>" and "IBM Security Verify Directory Admin Server V10.0.4 - <instance_name>".
Take backup of the instance.
For more information, see Directory server backup.