title: 389-ds command line fun link: https://onemoretech.wordpress.com/2010/12/24/389-ds-command-line-fun/ author: lembobro description: post_id: 93 created: 2010/12/24 09:48:38 created_gmt: 2010/12/24 09:48:38 comment_status: open post_name: 389-ds-command-line-fun status: publish post_type: post

389-ds command line fun

Had a world of trouble with a recent 389 Directory (389-DS) instance. While the immediate problem was due to issues with an attempted migration of some custom schema objects from an existing Sun DS instance, I was able to benefit from experience with some of the command line utilities that come with 389-DS.

Initial Setup

The first thing I learned is that my old practice of setting up a separate directory back-end for the admin server is still a good idea. Doing so provides a measure of independence from the other working directory instances and allows you to perform operations through the gui console even if an instance (other than your dedicated admin instance) is down.

Initial setup of the admin server and its directory instance is done as root with setup-ds-admin.pl.

I usually assign a nonstandard port to the admin instance, and give it a descriptive label, like “example-admin”. Once created, this instance’s config will show up under /etc/dirsrv/slapd-example-admin. I always install as a non-privileged user like “dirsrv” (you have to create the user account beforehand).

Additional Instances

You’re supposed to be able to set up additional instances of the directory server using the gui, but in my case it failed. In any event the gui won’t work if you set up using want to create an instance to run on port 389 or any other port under 1000.

For these reasons I use setup-ds.pl as root to set up my additional instances.

Once the new instance is up and running, you’ll want to register it with the admin server so you can control it with the gui console. For this run register-ds-admin.pl as root. It will prompt you for the admin server manager (cn=directory manager) password, as well as the password for the instance to be registered.

Copyright 2004-2019 Phil Lembo