Workday Driver 1.3.0.0100 Readme

Overview

The Workday driver for Identity Manager can seamlessly provision users from the Workday cloud application, keeping the user identity information consistent across the Identity Vault (IDV), and can also update certain attributes of the Workday application.

The driver version will change to 1.3.0.0100 after applying this patch.

This readme document consists the following sections:

System Requirements

Workday Driver Packages

The Workday driver packages available for installation in this release:

Name Package Name Version Build Date Build Number
Workday Base Configuration Package NETQWDBASE 1.1.1 20220106 170805

Installing the Workday Driver

The Workday driver install process involves the following tasks:

Installing the Workday Driver Files

  1. Download and unzip the contents of the IDM_WorkDayDriver_1.3_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 apply the driver jar file.

    2. Navigate to the extracted IDM_WorkDayDriver_1.3_P1.zip directory and perform one of the following actions for your platform:

      • For Linux: Install the new novell-DXMLWday.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 -Ivh (binaries-path)/novell-DXMLWday.rpm

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

    3. Find the dependent jar files and perform the following actions as required:

      • Linux:
        • Copy the jar file WorkdayUtils.jar, from IDM_WorkDayDriver_1.3_P1/common folder and place it in /opt/novell/eDirectory/lib/dirxml/classes/ directory in the Identity Manager engine.
        • Copy the WorkdayUtils.jar, imgscalr-lib-4.2.jar, jcce-1.3.0.jar, and jcce-oauth-1.3.0.jar from IDM_WorkDayDriver_1.3_P1/common folder and place it in the driver installation folder. For example, /opt/novell/eDirectory/lib/dirxml/classes/ (for local or remote installation).

      • Windows:
        • Copy the jar files WorkdayUtils.jar from IDM_WorkDayDriver_1.3_P1/common folder and place it in Identity Manager engine path \NetIQ\IdentityManager\NDS\lib.
        • Copy the imgscalr-lib-4.2.jar, jcce-1.3.0.jar and jcce-oauth-1.3.0.jar from IDM_WorkDayDriver_1.3_P1/common folder and place it in the 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.

    2. 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.

    3. To install the Workday driver files, enter the following command:

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

      rpm --dbpath $ROOTDIR/rpm -Ivh --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-DXMLWday.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.

    4. Find the dependent jar files and perform the following actions as required:

      • Linux:
        • Copy the file WorkdayUtils.jar and place it in the Identity Manager engine.
        • Copy the jar files imgscalr-lib-4.2.jar, jcce-1.3.0.jar and jcce-oauth-1.3.0.jar and place it in the driver installation folder.

      • Windows:
        • Copy the file WorkdayUtils.jar and place it in the Identity Manager engine.
        • Copy the jar files imgscalr-lib-4.2.jar, jcce-1.3.0.jar and jcce-oauth-1.3.0.jar and place it in the driver installation folder.

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

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

Upgrading the Workday Driver

The driver upgrade process involves the following tasks:

Upgrading the Workday Driver Packages

  1. Download the required Workday Driver Packages from Workday Driver plugins to a temporary location on your computer.

  2. Open Designer.

  3. In the Outline view, right-click the Package Catalog.

  4. Click Import Package

  5. Browse to the location where you downloaded the Workday packages.

  6. Click Select All to import all of the packages displayed

  7. Click OK.

  8. (Conditional)To update packages in designer with internet connectivity:-In the Menu bar, navigate to Help and select Check for Package Updates. Install the required Workday packages

  9. Open the project containing the driver.

  10. Right-click the driver for which you want to upgrade an installed package, then click Driver > Properties.

  11. Click Packages.

    12. A check mark indicates a newer version of a package in the Upgrades column.

  12. Click Select Operation for the package that indicates there is an upgrade available.

  13. From the drop-down list, click Upgrade.

  14. Select the version that you want to upgrade to, then click OK.

    15. NOTE: Designer lists all versions available for upgrade.

  15. Click Apply.

  16. (Conditional) Fill in the fields with appropriate information to upgrade the package, then click Next.

  17. Read the summary of the packages that will be installed, then click Finish.

  18. Review the upgraded package, then click OK to close the Package Management page.

Upgrading the Workday Driver Files

  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 IDM_WorkDayDriver_1.3_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/administrator.

    2. Navigate to the extracted IDM_WorkDayDriver_1.3_P1.zip directory and perform one of the following actions for your platform:


    3. Find the dependent jar files and perform the actions as shown in Step 3, in the "Install the driver files as a root user" section.

  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.

    2. To set the root directory to the location of non-root Identity Vault, enter the following command in the command prompt:

      3. ROOTDIR=<non-root eDirectory location>

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

    3. To upgrade the driver files, enter the following command.

      4. For example, to upgrade the Workday 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-DXMLWday.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.

    4. Find the dependent jar files and perform the following actions as shown in Step 4, in the "Install the driver files as a non-root user" section.

Extending the Schema

  1. Copy the schema file from IDM_WorkDayDriver_1.3_P1/schema/ folder to the system where Identity Manager is installed.

    For example, /root/schema/wd-schema.sch

  2. Run the following ndssch command.

    3. ndssch [-h hostname[:port]] [-t tree_name] [-d] admin_FDN schemafile [schema_description]

    For example, ndssch -h 10.XX.XXX.123:524 -t SLES12SP3_Quality_131123_TREE -d admin.sa.system /root/schema/wd-schema.sch

  3. The log file is created in default location i.e., /root/schema.log for troubleshooting.

    NOTE: You must restart the eDirectory (Identity Vault) to see the schema changes.

Technical Support Information

Issues Fixed in this Release

Enhancements Introduced in Workday 1.3.0.0 Release

Issues Fixed in Previous Workday 1.3.0.0 Release