Configuring the Directory Server

In this section we'll configure our Directory Server for use with Meta-Directory. We'll enable the changelog and import a demonstration schema file.

There are 11 steps in this procedure.

This procedure assumes you've already installed the Directory Server. If you haven't, go back to the previous page.

The Directory Manager account has the most control over the Directory Server and must be used to make significant configuration changes. The Administration account is used for routine activites like changing directory data.

Step 1: Login to Netscape Console as Directory Manager

Using the main Windows Start menu in the lower left-hand corner of your screen, select Programs, then Netscape Server Products, then Netscape Console 4.1. This will produce the Netscape Console login window shown here.

The Administration URL should already be set to your machine name plus your domain name plus the administrative port number (4000). Login as cn=Directory Manager with the password dirmanager. This should bring up the main Netscape Console window.


Step 2: Expand the Server Group

By clicking on the + symbols in the left-hand side of the Console window, you can expand the server group until you see an icon representing your directory server. Double-click on this icon, or click the Open button in the main Netscape Console window.


Step 3: Open the Directory Configuration Window

You should see a window like the one shown here. Click on the Configuration tab.

As you configure the Directory Server, a small red dot will show up next on the tab for the function you're changing. When you click the Save button, the red dot will disappear.

Step 4: Enable the Changelog

Select the Replication Agreements icon in the left-hand window, then click on the Supplier Settings tab. When the window refreshes, click on the Use default button. Make sure that both Max changelog records and Max changelog age have the unlimited checkbox selected. When you've done this click on Save.

You should see the notice shown here:

Click OK. We'll restart the Directory Server in Step 9.


Step 5: Locate mc.ldf

In the next 2 steps we're going to load the mc.ldf schema file. In this step we'll locate the file, and in the next step we'll import it into the Directory Server.

mc.ldf should be located in the SCHEMA folder, which is in the temp folder where you unzipped the Meta-Directory installation software.

Click on the Configuration tab to go back to the previous control panel. Select the Database icon and right-click to bring up the small popup menu. Select Import.

Click on the Browse button to bring up the navigation window.

Use the navigation window to locate your temp folder, then the SCHEMA folder, then mc.ldf

Select mc.ldf then click Open.


Step 6: Import mc.ldf

If you successfully located mc.ldf in the previous step, your Import Database window should look like this:

Be sure the Append data to database and Continue on error buttons are checked, then click OK.

When you see the "cn=schema" message don't do anything - just wait until this process finishes. This should take just a few seconds.

You should see a confirmation message similar to the one shown here. It's normal to see a large number of rejected entries, so don't be concerned about this message.


Step 7: Copy the oblix schema file

In the next two steps we're going to add a new schema definition for some Oblix data to the Directory Server's schema configuration file. First we'll put a copy of the Oblix schema into the Server's config folder. In the next step we'll edit the main configuration file so that it recognizes the new file we're adding.

Locate oblix-csa-schema.conf. This file should be in the temp folder where you uncompressed the Meta-Directory installation software. When you find it, make a copy of it.
Paste a copy of oblix-csa-schema.conf into the Directory Server's config folder. The config folder should be located in drive: \netscape\server4\slapd-hostname, where drive is the NTFS drive you specified during the DS4 installation script, and hostname is the name of your system. In the examples shown here, that is drive D:.

If you're not sure how to use WordPad, click here for a demonstration.

When you add a new line to ns-schema.conf, be sure the hostname and drive designation match those used in the other statements.

Step 8: Edit ns-schema.conf

Use a text editor like WordPad or Notepad to edit ns-schema.conf. ns-schema.conf is located in the Directory Server's config folder where you copied the Oblix schema in the previous step.

Add a new include statement which references the file you added to this folder in the previous step. The easiest way to do this is to copy and paste the last line in ns-schema.conf, then change the filename in the newly-pasted line to oblix-csa-schema.conf.

The hostname and drive designation you use must be appropriate for your system.

# Used by Netscape Directory Server
include	"D:/Netscape/Server4/slapd-mrbrown/config/ns-common-schema.conf"
include	"D:/Netscape/Server4/slapd-mrbrown/config/ns-mlm-schema.conf"
...
include "D:/Netscape/Server4/slapd-mrbrown/config/ns-wcal-schema.conf"
include "D:/Netscape/Server4/slapd-mrbrown/config/java-object-schema.conf"

include "D:/Netscape/Server4/slapd-mrbrown/config/oblix-csa-schema.conf"

Be sure to save your changes when you're finished. If you're using WordPad, be sure to Save As.. text.

 

Step 9: Restart the Directory Server

You'll need to restart the Directory Server, so click on the Tasks tab. This will bring you back to the main function window we saw earlier. Click on the Restart the Directory Server icon.

You'll need to verify your request...

Click Yes. After a delay of several seconds you should see this confirmation notice. Click OK.


Step 10: Create 4 new indexes

In this step we're going to instruct the Directory Server to create 4 new indexes based on these 4 attributes:

  • mdslinktocv
  • mdslinktomv
  • mdsexcludedcvs
  • mdsexcludedmvs

In the Directory Server control window, select the Configuration tab and click on the Database icon. That should produce the window shown here:

Click on the Add attribute... button. This will bring up a scrolling list of possible attributes like the one shown here:

Scroll down until you see the attribute you want to add, select it, then click OK. You'll have to repeat this step for each of the 4 attributes: mdslinktocv, mdslinktomv, mdsexcludedcvs, and mdsexcludedmvs.

As you do this you should see the red dot next to the Indexes tab, indicating we haven't saved these configuration changes yet.


Step 11: Specify index matching rules

After you've added the 4 new attributes in the previous step, turn on the check boxes for equality, presence, and substring matches. Equality and presence should already be checked, but you'll have to click twice on the check boxes to activate substring matches. (The first click will turn the check box grey; the second click will put a check in the box.)

Click on the Save button when you're finished. After the Directory Server commits these changes, you should see the following message:


Summary

In this section we enabled the changelog setting on the Directory Server and imported the MC.ldf schema file. We edited one of the Directory Server's configuration file, ns-schema.conf, so that it reads schema information in oblix-csa-schema.conf and restarted the Directory Server. We also created 4 new indexes required by Meta-Directory.

In the next section we'll load up some sample data needed for our MetaViews demonstration in the following module.

Top of Page
Copyright © 2000
Sun-Netscape Alliance.