Creating an instance with the command line

IBM Tivoli Directory Server, Version 6.3

Creating an instance with the command line

You can use the idsicrt command to create an instance or the idsideploy command to copy an instance.

For example, using the idsicrt command:

To create a new directory server instance called myinst that has a port of 389, a secure port of 636, an encryption seed of mysecretkey!, an encryption salt of mysecretsalt, and a DB2® instance with the name myinst, issue the command:
```
idsicrt -I myinst –p 389 –s 636 –e mysecretkey! -g mysecretsalt
```
If the directory server instance already existed, this command would fail. If you did not specify the encryption salt, the command would randomly generate an encryption salt. If you did not specify the encryption seed, you would be prompted for the seed. In the following example, you are prompted to enter an encryption seed. The encryption seed is not displayed on the command line when you enter it. After you type the encryption seed and press Enter, the command attempts to create the directory server instance.
```
idsicrt -I myinst –p 389 –s 636
```
The response is:
```
Enter encryption seed:
```
To create the same instance so that it binds to a particular IP address, issue the command:
```
idsicrt –I myinst –p 389 –s 636 –e mysecretkey! -g mysecretsalt –i 1.9.86.566
```
To create a new directory server instance called myinst that has a port of 389, a secure port of 636, an encryption seed of mysecretkey!, and a DB2 instance with the name mydbin, use the following command:
```
idsicrt -I myinst –p 389 –s 636 –e mysecretkey! –t mydbin
```
In this case, the command will randomly generate an encryption salt value.
To create an instance named myinst on a Windows system where the operating system user myinst does not exist, issue the following command. (The operating system user will also be created with password mypassword.)
```
idsicrt -I myinst -e mysecretkey! -l C: -w mypassword
```
To create an instance named myinst on an AIX®, Linux, or Solaris system where the operating system user myinst does not exist, issue the following command. (The operating system user will also be created with password mypassword and primary group primary.)
```
idsicrt -I myinst -e mysecretkey! -G primary -w mypassword
```
To create a new proxy directory server instance called proxinst, use the following command:
```
idsicrt -x -I proxinst –p 389 –s 636 –e mysecretkey!
```

Note:

After you create the directory server instance with the idsicrt command, use the idsdnpw command to set the administrator DN and password. See Managing the primary administrator DN with the command line. If the directory server instance is a full directory server, configure the database using the idscfgdb command line utility. See Configuring the database with the command line.

For example, to create a directory server instance that is a copy of an existing instance using the idsideploy command:

To create a new directory server instance (newinst) that is a copy of directory server myinst:

idsideploy -a ownerpw -I newinst -e mysecretkey! -D cn=root -sU ldap://localhost:389 
     -sD cn=root1 -sw srcpw -w newdnpw -l C: -b C:\output -q -L C:\backup

To create a new proxy directory server instance (prxinst) that is a copy of proxy server instance proxinst:
```
idsideploy -x -I prxinst -D cn=root -e abcdefghijkl -sD cn=root -sw root 
     -sU ldap://localhost:7389
```
To create an instance named newinst that is a copy of a directory server instance at URL ldap://localhost:7389 on a Windows system when the corresponding operating system user does not exist:
```
idsideploy -I newinst -a newusrpw -D newadminDN -w newdnpw -e encryptionseed
    -l C: -sU ldap://localhost:7389 -sD srcAdminDN -sw newadmpw
```
To create an instance named newinst that is a copy of a directory server instance at URL ldap://localhost:7389 on an AIX, Linux, or Solaris system when the corresponding operating system user does not exist:
```
idsideploy -I newinst -a newusrpw -D newadminDN -w newdnpw -e encryptionseed
       -G primary -sU ldap://localhost:7389 -sD srcAdminDN -sw srcadmpw
```

Note:

When created, a database instance normally requires 10 to 20 MB of space. This space is not used, however, if the directory server instance is configured as a proxy server.

See the IBM® Tivoli® Directory Server 6.3 Command Reference for more information about using the idsicrt and idsideploy commands.

[ Top of Page | Previous Page | Next Page ]