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.
Creating an instance with the command line http://www-01.ibm.com/support/knowledgecenter/api/content/SSVJJU_6...
1 of 2 6/5/2014 5:16 PM
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 ]
Creating an instance with the command line http://www-01.ibm.com/support/knowledgecenter/api/content/SSVJJU_6...
2 of 2 6/5/2014 5:16 PM