Configuring the DirXML Drivers

After the systems hosting DirXML drivers have been set up, you will configure the drivers by importing driver preconfiguration files and then testing data synchronization. These tasks can be completed using Novell iManager 2.0 plug-ins, which were installed when you completed the section, Setting Up iManager .

NOTE:  ConsoleOne can also be used to configure DirXML drivers. For ConsoleOne information, see DirXML Administration.

To configure the drivers, complete the steps in the following sections:


Importing the Preconfigured Drivers

Using application information that you provide, the Import Drivers Wizard completes configuration for the DirXML drivers.

You'll need the data you collected and recorded in the Configuration Information tables at the beginning of each system's setup.

  1. Launch iManager by going to http://serveripaddress/nps/iManager.html.

    IMPORTANT:  This URL is case sensitive.

  2. Authenticate to the NetWare 6.5 tree.

  3. Click DirXML Management > Import Drivers.

  4. Mark In a New Driver Set, then click Next.

  5. Specify a driver set name, browse to the context where you want the driver set object to be created, then browse to the server object representing the server where you installed DirXML.

  6. Leave Create a New Partition checked, then click Next.

  7. Select the appropriate driver configuration files for your installation.

    Driver configuration files are available for drivers licensed with this release (eDirectory, Active Directory, and NT Domain) and for evaluation drivers.

  8. Click Next, then fill in the prompts for application information using the data you recorded in Configuration Information tables.

    You will be presented with a page of information prompts for each driver you selected.

    IMPORTANT:  Scroll to the bottom of the page to see all the prompts. If you quit before configuring all of the drivers, the drivers will not have enough information to function properly.

  9. Click Define Security Equivalence, add Admin, then click OK.

    Drivers need rights to read and update data in eDirectory. Assigning a security equivalent is a quick way to provide necessary rights assignments. This option does not provide access to data in the target application. Access to the target application is provided through other driver parameters.

  10. Click Exclude Administrative Roles, add Admin, click OK, then click Next.

    These objects will not be replicated to the application. We recommend that you add all objects that represent an administrative role (for example, the Admin object) to this list. These objects typically have no function outside of the directory that they were created in. Maintaining these objects in only one directory prevents potentially disruptive changes, such as access control or password changes, from causing problems.

  11. After providing all the required information, click Finish with Overview.

    Setup of the DirXML Starter Pack is complete.

  12. If you are synchronizing data between two eDirectory trees, continue with the next section, Configuring Secure Data Transfers for the DirXML Driver for eDirectory .

    or

    If you are not synchronizing data between two eDirectory trees, continue with Testing Data Synchronization .


Configuring Secure Data Transfers for the DirXML Driver for eDirectory

The DirXML driver for eDirectory requires Novell Certificate ServerTM and a Certificate Authority (CA) to ensure data security. All transactions between trees must be secured through an SSL connection. We recommend that you use the Certificate Authority from the tree containing the driver to issue the certificates used for SSL.

For more information about Novell Certificate Server, see Understanding the Novell Certificate Server.


Run the Certificate Wizard

  1. Launch iManager by going to http://serveripaddress/nps/iManager.html.

    IMPORTANT:  This URL is case sensitive.

  2. Authenticate to the eDirectory tree hosted on the NetWare 6.5 server.

  3. Click DirXML Management > NDS2NDS Driver Certificates.

  4. On the Welcome page, enter the requested information for the first tree.

    Default values are provided using objects in the tree that you authenticated to when you launched iManager. You must enter or confirm the following information:

  5. Click Next.

    The wizard uses the information you entered to authenticate to the first tree, verify the driver DN, and verify that the driver is associated with a server.

  6. Enter or confirm the following information for the second tree:

  7. Click Next.

    The wizard uses the information you entered to authenticate to the second tree, verify the driver DN, and verify that the driver is associated with a server.

  8. Review the information on the Summary Page, then click Finish.

    If Key Material Objects (KMOs) already exist for these trees, the wizard deletes them and then does the following:

  9. Configuration for secure data synchronization is complete. Continue with the next section, Testing Data Synchronization .


Testing Data Synchronization

After participating systems are set up and their drivers have been configured, use the following procedures to verify that data is synchronized correctly.


Start Each Driver

Start one driver at a time to validate proper DirXML configuration. By default, drivers are set for Manual startup.

NOTE:  After you have a driver configuration that works in your environment, use iManager to change the startup option to Auto Start. Auto Start will re-start the driver whenever eDirectory is re-started.

  1. Ensure that the Remote Loader service is running on the systems where you set it up and that you can view the trace screen for the Remote Loader.

    NOTE:  To open the Trace Screen: at a command prompt enter dirxml_remote -window on.

  2. Open a DSTrace screen on the computer where the DirXML engine is installed by typing dstrace on screen on file off at the console prompt.

    To configure dstrace.nlm to display only DirXML trace messages, enter
    dstrace -all +dxml +dvrs
    .

    To include message tags and time stamps, enter
    dstrace -all +dxml +dvrs +tags +time
    .

  3. In iManager, select DirXML Management > Overview.

  4. Browse to the DirXML driver set.

  5. (Conditional) If you configured the Remote Loader Service to use SSL, before you start the drivers, you must edit the Authentication section of the Driver Parameters and re-enter passwords.

    Add a reference to the certificate as shown in the following example.
    hostname=192.168.0.1 port=8090 kmo=servernamecert

    Figure 21
    Referencing the KMO

  6. Click the status icon in the upper right corner of the driver's icon, then click Start Driver.

  7. Review the messages in the DSTrace screen and the remote trace screen to verify successful driver start.

    NOTE:  See Novell AppNotes, Effectively Reading a DirXML Trace File for in-depth information about using DSTrace with DirXML.

  8. After all drivers are running, add a new user as described in the following Data Synchronization Tests .


Data Synchronization Tests



  Previous Page: Setting Up NT Domain  Next Page: Migrating Existing Data