Importing the Driver Configuration

The Create Driver Wizard helps you import the basic driver configuration file. This file creates and configures the objects and policies needed to make the driver work properly.

  1. In Novell® iManager, click DirXML Utilities > Create Driver.

  2. Select a driver set.

    If you place this driver in a new driver set, you must specify a driver set name, context, and associated server.

  3. Select Import a Driver Configuration from the Server, then select PeopleSoft50.xml.

    The driver configuration files are installed on the Web server when you install Identity Manager. During the import, you are prompted for the driver's parameters and other information.

  4. Specify values for the following parameters:

    Parameter Name Parameter Description

    Driver name

    The actual name you want to use for the driver.

    Active Users Container

    The name of the Organizational Unit object where Active users are placed.

    Inactive Users Container

    The name of the Organizational Unit where Inactive users are placed.

    Active Employees Group

    The name of the Group Object to which Active Employee users are added.

    Active Managers Group

    The name of the Group Object to which Active Manager users are added.

    PeopleSoft Connection String

    The host name or IP address and port number for connecting to the appropriate PeopleSoft Application server. This is typically referred to as the PeopleSoft application server connection string. The default port is 9000.

    PeopleSoft User ID

    The PeopleSoft User ID the driver uses for authentication to PeopleSoft.

    PeopleSoft User Password

    The PeopleSoft User password the driver uses for authentication to PeopleSoft.

    Configure Data Flow

    Dataflow can be configured to one of the following options:

    • Bidirectional: PeopleSoft and eDirectory are both authoritative sources of the data synchronized between them.
    • PS-to-eDirectory: PeopleSoft is the authoritative source.
    • eDirectory-to-PS: eDirectory is the authoritative source.

    Install Driver as Remote/Local

    Configure the driver for use with the Remote Loader service by selecting the Remote option, or select Local to configure the driver for local use. (If you are using PeopleTools 8.4x, you must select a Remote installation. Local implementations are not supported.) If Local is selected, you can skip the remaining parameters.

    Remote Host Name and Port

    Specify the host name or IP address and port number for where the Remote Loader service has been installed and is running for this driver. The default port is 8090.

    Driver Password

    The driver object password is used by the Remote Loader to authenticate itself to the DirXML server. It must be the same password that is specified as the driver object password on the Identity Manager Remote Loader.

    Remote Password

    The Remote Loader password is used to control access to the Remote Loader instance. It must be the same password that is specified as the Remote Loader password on the Identity Manager Remote Loader.

    The additional driver parameters are set to default values during the import process, but they can be modified in iManager (by clicking the Driver Configuration tab on the driver object.)

    Parameter Description Default Value

    Schema CI Name

    The name of the PeopleSoft CI object that defines the set of data to be synchronized by the driver.

    DIRXML_SCHEMA01

    Data Record ID Field

    The name of the field in the Data Schema CI that uniquely identifies a PeopleSoft object. The value in this field is used as the DirXML object association identifier.

    DIRXML_ASSOC_ID

    Use Case-Sensitive Search

    Controls whether or not the driver evaluates search attribute matches using case-sensitive match criteria.

     

    Allow Add Events

    When data flow is configured to allow Subscriber Channel synchronization, this parameter allows the administrator to allow or deny Add events on the Subscriber Channel.

     

    Data Record ID Field Default Value

    Allows an administrator to specify the default value for the Schema CI key field. Only used for Subscriber Channel Add events.

    NEW

    Allow Delete Events

    When data flow is configured to allow Subscriber Channel synchronization, this parameter allows the administrator to allow or deny Delete events on the Subscriber Channel.

     

    Transaction CI Name

    Contains the name of the PeopleSoft CI object that defines the set of fields required for the DirXML Transaction interface. The set of fields in the specified transaction CI must contain the same fields and keys identified in the default transaction CI in order for the driver to work.

    DIRXML_TRANS01

    Driver Subset Identifier

    Identifies which transactions in the transaction CI are to be processed by the driver. When the driver reads a transaction CI record, it compares the values of the DIRXML_DRIVER field with this parameter value and only processes transactions that match.

    A match is determined by matching characters for the length of this parameter value. For instance, if this parameter is NPSDriver and the DIRXML_DRIVER field in a transaction is NPSDriver1, a match is made.

    This allows multiple drivers to utilize the same transaction CI, which in turn can be populated by multiple PeopleSoft applications or processes.

    NPSDriver

    Queue Poll Interval (seconds)

    This parameter specifies the number of seconds the driver waits between attempts to process transaction records. This poll interval is only applied when no transactions are available for processing.

    5 seconds

  5. Click Import.

  6. When the import is finished, you can define security equivalences and exclude administrative roles from replication.

    The driver object must be granted sufficient eDirectory rights to any object it reads or writes. You can do this by granting Security Equivalence to the driver object. The driver must have Read/Write access to users, post offices, resources, and distribution lists, and Create, Read, and Write rights to the post office container. Normally, the driver should be given security equal to Admin.

  7. Review the driver objects in the Summary screen, then click Finish.