Sun ONE Directory Server Resource Kit 5.2 Tools Reference |
Chapter 17
The Directory Server 4.x Instance Creation ToolThe create_instance.pl tool is a Perl script that helps automate the process of creating new Sun ONE Directory Server 4.x instances on a machine where that product has already been installed. This chapter provides instructions on how to use the script. It contains the following sections:
OverviewThe create_instance.pl tool automates the process of creating new Directory Server 4.x instances on a machine where that product has already been installed. The script is not compatible with the Sun ONE Directory Server 5.x product. The tool will create the new instance using existing configuration files and information given interactively by the user. The Sun ONE Directory Server Resource Kit (DSRK) includes the script in the DSRK_base/perl directory. It requires Perl version 5.005_03 or later.
Note
See Third-Party Sources of Information for links to Perl resources.
Command UsageThe create_instance.pl script reads existing configuration files and queries the user for any additional information about the new instance. It creates a file named newdsinst.inf that details the configuration for the new instance. (See Configuration Information for a listing of the collected information.) When finished, the tool will prompt you to create a new instance using the configurations detailed in this file. Following is the procedure to run create_instance.pl:
Configuration InformationThe following sections detail the configuration information written to the newdsinst.inf file (as generated by the create_instance.pl tool). The placeholders in italics show the origin of the specific information, either from an existing file or through user input.
General Information
This information is listed under the [general] section of the newdsinst.inf file.
- FullMachineName= value of ldapHost from adm.conf file
- SuiteSpotUserID= user input of OS user ID
- SuitespotGroup= user input of OS group ID
- ServerRoot= value of ServerRoot from local.conf file
- AdminDomain= value of isie from adm.conf file
- ConfigDirectoryAdminID= administrator ID extracted from admpw file
- ConfigDirectoryAdminPwd= user input of existing config DS admin password
- ConfigDirectoryLdapURL= ldap://ldapHost:ldapPort/ (from adm.conf file)
- Components= svrcore,base,slapd,admin
New Directory Instance Information
This information is listed under the [slapd] section of the newdsinst.inf file.
- SlapdConfigForMC= No
- SecurityOn= No
- UseExistingMC= Yes
- UseExistingUG= No
- ServerPort= user input of new server port
- ServerIdentifier= user input of new server identifier
- Suffix= user input of new data suffix
- RootDN= user input of new root DN
- UseReplication= No
- SetupSupplier= No
- SetupConsumer= No
- AddSampleEntries= No
- InstallLdifFile= none
- AddOrgEntries= No
- DisableSchemaChecking= No
- RootDNPwd= user input of new root DN password
- Components= slapd,slapd-client
Administration Information
This information is listed under the [admin] section of the newdsinst.inf file.
- SysUser= value of configuration.nssuitespotuser in local.conf file
- Port= value of configuration.nsserverport in local.conf file
- ServerIpAddress= value of configuration.nsadminaccessaddresses in local.conf file
- ServerAdminID= administrator ID extracted from admpw file
- ServerAdminPwd= user input of existing config DS admin password
- Components= admin,admin-client
Base Information
This information is listed under the [base] section of the newdsinst.inf file.