Chapter 17 The Directory Server 4.x Instance Creation Tool

The 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:

Overview

The 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 Usage

The 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:

Change to the DirectoryServer_base/admin-serv/config directory.

$ cd DirectoryServer_base/admin-serv/config

Run create_instance.pl from the command-line.

$ ./create_instance.pl



Note	The tool has no options, but it must be run from the config directory of a previously installed administration server.

Configuration Information

The 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

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

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

Previous Contents Index Next
Sun ONE Directory Server Resource Kit 5.2 Tools Reference