WorkOrder Driver 4.0.0.0100 Readme

Overview

The WorkOrder driver enables to schedule the work order tasks to be performed. This driver applies any policies to the work order (performing any actions associated with the policies) and creates a WorkToDo object in the Identity Vault’s work order container.

The driver version will be changed to 4.0.0.0100 after applying this patch.

This readme document consists of the following sections:

System Requirements

  • Identity Manager 4.8.x or later
  • Installing the WorkOrder Driver

    1. Download and unzip the contents of the WorkOrder_Driver_4.0.0_P1.zip file to a temporary location on your computer.

    2. To install the driver files as a root user:

      1. Login as root on the server where you want to apply the driver jar file.

      2. Navigate to the extracted WorkOrder_Driver_4.0.0_P1.zip directory and perform one of the following actions on your platform:

        • For Linux: Install the new novell-DXMLwkodr.rpm in your driver installation directory by running the following command in a terminal window:

          • If you are installing the binary, run the command: rpm -Uvh (binaries-path)/novell-DXMLwkodr.rpm

        • For Windows: Copy the WorkOrder.jar file to your driver installation folder. For example, \NetIQ\IdentityManager\NDS (local installation) or \Novell\RemoteLoader\64bit (remote installation).

      3. (Conditional) To install the driver files as a non-root user:

        1. Verify that /rpm directory exists and contains _db.* file.

        2. The _db.* file is created during a non-root installation of the Identity Manager engine. The absence of this file might indicate that the Identity Manager is not installed properly. You must reinstall the Identity Manager to correctly place the file in the directory.

        3. To set the root directory to the location of non-root Identity Vault, enter the command ROOTDIR=non-root eDirectory location in the command prompt.

          This will set the environmental variables to the directory where Identity Vault is installed as a non-root user.

        4. To install the WorkOrder driver files, enter the following command:

          For example, to install the WorkOrder driver RPM, use this command:

          rpm --dbpath $ROOTDIR/rpm -Uvh --relocate=/usr=$ROOTDIR/opt/novell/eDirectory --relocate=/etc=$ROOTDIR/etc --relocate=/opt/novell/eDirectory=$ROOTDIR/opt/novell/eDirectory --relocate=/opt/novell/dirxml=$ROOTDIR/opt/novell/dirxml --relocate=/var=$ROOTDIR/var --badreloc --nodeps --replacefiles /home/user/novell-DXMLwkodr.rpm

          Note: In the above command /opt/novell/eDirectory is the location where non-root Identity Vault is installed, and /home/user/ is the home directory of the non-root user.

        5. (Conditional) If the driver is running locally, start the Identity Vault and the driver instance.

        6. (Conditional) If the driver is running with a Remote Loader instance, start the Remote Loader instance and the driver instance.

      Upgrading the WorkOrder Driver Files

      The driver upgrade process involves the following tasks:

      1. Take a back-up of the current driver configuration.

      2. (Conditional) If the driver is running locally, stop the driver instance and the Identity Vault.

      3. (Conditional) If the driver is running with a Remote Loader instance, stop the driver and the Remote Loader instance.

      4. Download and unzip the contents of the WorkOrder_Driver_4.0.0_P1.zip file to a temporary location on your computer.

      5. (Conditional) To upgrade the driver files as a root user:

        1. On the server where you want to apply the driver patch, log in as root or administrator.

        2. Navigate to the extracted WorkOrder_Driver_4.0.0_P1.zip directory and perform one of the following actions on your platform:

          • Linux: Install the new novell-DXMLwkodr.rpm in your driver installation directory by running the following command in a terminal window:
          • rpm -Uvh (patch-path)/linux/novell-DXMLwkodr.rpm

          • Windows: Copy the WorkOrder.jar file to your driver installation folder. For example, \NetIQ\IdentityManager\NDS\lib, if the driver is locally installed with the Identity Manager engine. If the driver is running with the remote loader, then copy the WorkOrder.jar to \Novell\RemoteLoader\lib.


      6. (Conditional) To upgrade the driver files as a non-root user:

        1. Verify that non-root edirectory="" location=""/rpm directory exists and contains _db.* file.
        2. The _db.* file is created during a non-root installation of the Identity Manager engine. The absence of this file might indicate that Identity Manager is not installed properly. You must reinstall the Identity Manager to correctly place the file in the directory.

        3. To set the root directory to the location of non-root Identity Vault, enter the following command in the command prompt:
        4. ROOTDIR=<non-root eDirectory location>

          This will set the environmental variables to the directory where Identity Vault is installed as a non-root user.

        5. To upgrade the driver files, enter the following command.
        6. For example, to upgrade the WorkOrder driver RPM, use this command:

          rpm --dbpath $ROOTDIR/rpm -Uvh --relocate=/usr=$ROOTDIR/opt/novell/eDirectory --relocate=/etc=$ROOTDIR/etc --relocate=/opt/novell/eDirectory=$ROOTDIR/opt/novell/eDirectory --relocate=/opt/novell/dirxml=$ROOTDIR/opt/novell/dirxml --relocate=/var=$ROOTDIR/var --badreloc --nodeps --replacefiles /home/user/novell-DXMLwkodr.rpm

          where /opt/novell/eDirectory is the location where non-root eDirectory is installed and /home/user/ is the home directory of the non-root user.


      Technical Support Information

      Issues Fixed in Current (4.0.0.0100) Release