Creating an instance with the command-line utility

Use the command-line utility, idsicrt, to create an instance.

Before you begin

To create an instance with the command-line utility, you must meet the following conditions:

Install IBM® Verify Directory with the Server, Proxy Server, or Virtual Directory features.
A system user ID must exist that must own the instance. For more information about creating a system user ID, see Users and groups that are associated with a directory server instance.

When the idsicrt command is run, the command creates an instance and a DB2® database instance for the full directory server instance.

Log in as root user on AIX®, or Linux™, and as an administrator member on Windows™.
Change the current working directory to the sbin subdirectory in the IBM Verify Directory installation location.

To create an instance, run the following command:

Substitute the instance_name variable with the name of a valid system user ID.

Task to complete	Command to run:
Create a directory server instance	`idsicrt -I instance_name -e mysecretkey! -l instance_home`
Create a proxy server instance	`idsicrt -I instance_name -e mysecretkey! -l instance_home -x`
Create a virtual directory instance	`idsicrt -I instance_name -e mysecretkey! -l instance_home -F`

For more information about the idsicrt command, see Command Reference.

Example 1:

To create a directory server instance with the following values on AIX, or Linux, run the following command:

idsicrt -I myinst -p 389 -s 636 -e mysecretkey!\
-g mysecretsalt -l /home/myinst

To create a directory server instance with the following values on Windows, run the following command:

idsicrt -I myinst -p 389 -s 636 -e mysecretkey! 
-g mysecretsalt -l C:

Example 2:

To create a proxy server instance with the following values on AIX, or Linux, run the following command:

idsicrt -I myproxy -p 389 -s 636 -e mysecretkey!\
-g mysecretsalt -l /home/myproxy -x

To create a proxy server instance with the following values on Windows, run the following command:

idsicrt -I myproxy -p 389 -s 636 -e mysecretkey! 
-g mysecretsalt -l C: -x

Example 3:

To create a virtual directory instance with the following values on AIX, or Linux, run the following command:

idsicrt -I myvirtualdir -p 389 -s 636 -e mysecretkey!\
-g mysecretsalt -l /home/myvirtualdir -F

To create a proxy server instance with the following values on Windows, run the following command:

idsicrt -I myvirtualdir -p 389 -s 636 -e mysecretkey! 
-g mysecretsalt -l C: -F

Complete the following configuration to create a functional instance: