3.3 Importing the Driver Configuration in iManager

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 Identity Manager Utilities > New 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 (.XML file), then select PeopleSoft50-IDM3_5_0-V1.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 driver’s parameters. See Table 3-1 for a list of parameters you can set.

  5. Click Import.

    When the import is finished, you should 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, resources, and distribution lists. Normally, the driver should be given security equal to Admin.

  6. Review the driver objects in the Summary page, then click Finish.

    Table 3-1 Specify Values for These Parameters

    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 from PeopleSoft are placed. You can modify this parameter through a global configuration variable (GCV) after installation.

    Inactive Users Container

    The name of the Organizational Unit where Inactive users from PeopleSoft are placed.You can modify this parameter through a GCV after installation.

    Active Employees Group

    The name of the Group Object to which Active Employee users from PeopleSoft are added. You can modify this parameter through a GCV after installation.

    Active Managers Group

    The name of the Group Object to which Active Manager users from PeopleSoft are added. You can modify this parameter through a GCV after installation.

    PeopleSoft Connection String

    The hostname 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.

    The connection string uses the following format: <hostname or IP address>:<Jolt Port Number> Example: //PSServer:9000

    To enable failover and loadbalancing, you can supply multiple server connection strings separated by a comma. Example: //PSServer:9000,//111.222.3.4: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.

    Password Failure Notification User

    Password synchronization policies are configured to send e-mail notifications to the associated user when password updates fail. You have the option of sending a copy of the notification e-mail to another user, such as a security administrator. If you want to send a copy, specify the DN of that user now. Otherwise, leave this field blank.

    Driver is Local/Remote

    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.4 x, 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 hostname 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.

    Allow ‘add’ events

    Subscriber Add events are implemented by invoking the Component Interface Create method (if present). If you want the driver to allow Subscriber channel add events, select Allow Subscriber add.

    Allow ‘delete’ events

    Subscriber Delete events are implemented by invoking the Component Interface Delete method (if present). If you want the driver to allow Subscriber channel Delete events, select Allow Subscriber delete.

    Driver Password

    The driver object password is used by the Remote Loader to authenticate itself to the Metadirectory server. It must be the same password that is specified as the driver object password on the 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 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).

    Table 3-2 Additional Driver Parameters

    Parameter

    Description

    Default Value

    Schema CI Name

    List of the names of the PeopleSoft CI objects that define 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.

    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 if Subscriber channel Add events are allowed.

    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.

    NPSDriver1

    Publisher Polling Option

    The PeopleSoft driver supports two options for Publisher Transaction record polling. To choose an interval of seconds between polls, select Utilize Interval Polling. To use a crontab format, select Utilize crontab Format Polling.

    Utilize Interval Polling

    Queue Poll Interval (seconds) or Enter Queue Poll crontab Format String

    If you select Utilize Interval Polling, this entry displays Queue Poll Interval. Specify the number of seconds between checks for available transactions to process. The default is 5.

    If you select Utilize crontab Format Polling, this entry displays Enter Queue Poll crontab Format String. Specify five required crontab field parameters that are separated by blank characters. The default value of * * * * * generates a poll every minute.

    5 seconds

    or

    * * * * *