Creating a copy of an existing instance with Instance Administration Tool

Edit online

Use Instance Administration Tool to create a copy of an existing instance.

Before you begin

To create a copy of an existing instance, you must meet the following requirements:

Start the ibmslapd process and administration server of the instance in normal mode.
Ensure that the source directory server is accessible from Instance Administration Tool.

Procedure

Start Instance Administration Tool. See Starting Instance Administration Tool.
Choose one of the following options to create a copy of an existing instance:
- To create a copy of an existing instance that is on the local computer, click Copy local instance.
- To create a copy of an existing instance that is on a remote computer, click Copy remote instance.
On the Copy directory server instance panel, provide the following values:
1. In the Host field, enter the IP address or the host name if the source directory server is on a remote computer.
  If the source directory server is on a local computer, the field is populated with localhost and you cannot edit it.
2. In the Port field, enter the port number of the directory server if the port number in the field is not valid.
  If you want to use secure connection, you must specify the secured port number of the source directory server instance.
3. In the Administrator DN field, enter the administrator DN of the source directory server if the instance is on a remote computer.
  If the source directory server is on a local computer, the field is populated with the administrator DN value and you cannot edit it.
4. In the Password field, enter the password of the administrator DN.
5. In the Encryption seed field, enter the encryption seed for the source directory server instance.
6. If the source directory server is configured for secure communications and you want to configure the target directory server with it, click Use SSL connection.
  1. In the Key file field, enter the file name with path of the key database file. You can click Browse and specify the location.
  2. In the Key name field, enter the private key name to use from the key file of the source directory server.
  3. In the Key password field, enter the key database password of the key file.
7. Click Next.
In the Instance setup - step 1 panel, complete the following steps:
1. Verify the Source URL and Source instance type fields for information about source directory server.
  The Source instance type can be a full directory server or a proxy server instance.
2. To configure the target directory server as a peer or a replica in an existing replication topology, select Configure as Peer or Replica server and select one of the following options:
  - To configure the target directory server as a replica, click Replica.
  - To configure the target directory server as a peer, click Peer.
3. In the User name field, enter the system user ID that must own the target directory server instance. The name cannot be longer than 8 characters.
  The same name is also set for the directory server instance name, DB2® administrator ID, database instance name, and database name. The user ID must exist on the computer and must not be associated with any other directory server instance on the computer. See Users and groups that are associated with a directory server instance for detailed information about the user ID.
4. In the Password field, enter the password for the user ID.
5. In the Instance location field, enter the location of the directory server instance. You can click Browse and specify the instance home directory.
  The location must contain at least 30 MB of free disk space.
  On Windows™ systems, the location is a disk drive, such as C:. The directory instance files are stored in the \idsslapd-instance_name directory on the disk drive you specify. The instance_name variable is the name of the directory server instance.
  On AIX® and Linux™ systems, the home directory of the directory server instance owner is the default instance, but you can specify a different path.
6. Click Next.
In the Instance setup - step 2 panel, complete the following steps:
1. In the Administrator DN field, enter a valid DN for the target directory server instance.
  The administrator DN value is not case-sensitive. The administrator DN user has full access to all data in the directory server instance.
2. In the Password field, enter the password for the administrator DN.
  Passwords are case-sensitive. Double byte character set (DBCS) characters in the password are not valid.
3. In the Confirm password field, enter the password for the administrator DN.
  You must remember the password for future reference.
4. To copy data from the database of the source server to the target server, select Copy data from source instance to new instance and complete the following steps:
  Note: If selected to create the target directory server as a peer or a replica, this check box is selected and you cannot clear it.
  1. In the Path for backup images field, enter the path name of the backup image of the source server. You can click Browse to specify the location. If the source instance is on a remote computer, the backup path must be a shared and must be accessible from both the source and target computers. An example of shared path is a read/write NFS file system.
5. Click Next.
In the Verify settings panel, verify the summary that is generated.
To start the creation of copy of the source directory servers, click Finish.
In the Results window, verify the log messages that are generated for the instance creation operations.
To close the Results window, click Close.
To close Instance Administration Tool, click Close.

Results

Instance Administration Tool creates a copy of the source directory server instance on the computer.

What to do next

You must start the ibmslapd process and the administration server that is associated with the directory server instance. See Starting or stopping a directory server and an administration server.

Take backup of the instance. For information about backing up a directory server instance, see Directory server backup.