To Create a Suffix

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

If you use DSCC to create a new suffix, you can choose to copy some or all suffix configuration settings from an existing suffix.

1. Create the root suffix.

   Ensure that your server is running, then type this command:

   $ dsconf create-suffix -h host -p port suffix-DN

   where the suffix-DN is the full DN of the new suffix. For a root suffix, the convention is to use the domain-component (dc) naming attribute.

   For example, to create a suffix for the DN dc=example,dc=com , use this command:

   $ dsconf create-suffix -h host1 -p 1389 dc=example,dc=com

   This command creates the new suffix as follows:

   • The top level (or base) entry of the root suffix is created.

   • The configuration entries in cn=config for both the suffix and the database are created.

   • The default database name is based on the suffix DN.

   For information about the all of the suffixes, including the new suffix that has been created, use this command:

   $ dsconf list-suffixes -h host -p port -v

   The -v option displays verbose mode, which shows how many entries are on the suffix, and any replication information.

   ---

   Note –

   If you have more than one Directory Server instance, use the -h host name and -p port number options to specify which server instance the suffix should belong to.

   If you want to specify a non-default path for the database files, use the -L option. You can change the suffix database path at a later stage. To do this, use the command dsconf set-suffix-prop suffix-DN db-path:new-db-path, then stop the server, move the database files manually, and restart the server.

   To see all the options that you can use when creating suffixes, refer to the dsconf(1M) man page.

   ---

2. If required, create the sub-suffix:

   $ dsconf create-suffix -h host -p port subSuffix-DN

   then attach the sub-suffix to the root suffix.

   $ dsconf set-suffix-prop -h host -p port subSuffix-DN parent-suffix-dn:parentSuffix-DN

   where parentSuffix-DN must have the same value as suffix-DN in the previous step. The suffix-DN for the sub-suffix includes the relative distinguished name (RDN) of the sub-suffix and the DN of its parent suffix.

   For example, to create the sub-suffix ou=Contractors,dc=example,dc=com, and to attach the sub-suffix to the root suffix, type:

   $ dsconf create-suffix -h host1 -p 1389 ou=Contractors,dc=example,dc=com $ dsconf set-suffix-prop -h host1 -p 1389 ou=Contractors,dc=example,dc=com \ parent-suffix-dn:dc=example,dc=com

   When this entry is added to the directory, the database module of the server automatically creates the database files in the following directory:

   instance-path/db/database-name

   where database-name is the name automatically built from a part of the suffix. For example, in the previous example, the database-name would be Contractors

3. (Optional) Initialize the suffix with data. See Initializing a Suffix.