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.0 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 Business Process Configuration NETIQWDBP 1.0.0 20210512 153820
Workday Entitlement Configuration NETIQWDENT 1.0.0 20210505 165701

The Workday driver packages available for upgrade in this release:

Name Package Name Version Build Date Build Number
Workday Base Configuration package NETQWDBASE 1.1.0 20210506 144947
Workday Default Configuration NETQWDDCFG 1.1.0 20210430 093535
Workday Job Family Synchronization Configuration NETQWDJBFSYN 1.1.0 20210310 165334
Workday Job Profile Synchronization Configuration NETQWDJOBSYN 1.1.0 20210310 165405
Workday Location Synchronization Configuration NETQWDLOCSYN 1.1.0 20210310 165431
Workday Organization Synchronization Configuration NETQWDORGSYN 1.1.0 20210310 165507
Workday Photo Synchronization Configuration NETQWDPHTSYN 1.1.0 20210513 134600
Workday Position Relation Configuration NETQWDPRLN 1.1.0 20210310 165628
Workday Retry Events Configuration NETQWDRETRY 1.1.0 20210310 165727

Installing the Workday Driver

The Workday driver install process involves the following tasks:

Installing the Workday Driver Packages

  1. Download the required Workday driver packages from Workday Driver plugins.

  2. Open a new project in Designer to deploy the Workday driver.

  3. In the Menu bar, navigate to Help and select Check for Package Updates. Install the above Workday packages.

  4. Drag the Workday driver object from Designer Pallet > Enterprise.

  5. To verify the Workday driver's configuration and packages, navigate to Driver Properties > Driver Configuration > Packages.

Installing the Workday Driver Files

  1. Download and unzip the contents of the IDM_WorkDayDriver_1300.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_1300.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_1300/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_1300/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_1300/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_1300/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.

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

    5. 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. Open the project containing the driver.

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

  10. Click Packages.
  11. 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.

  16. Click Apply.

  17. (Conditional) Fill in the fields with appropriate information to upgrade the package, then click Next.
  18. Read the summary of the packages that will be installed, then click Finish.

  19. 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_1300.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_1300.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.

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

    7. 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_1300/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

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

Enhancements Introduced in Workday 1.3.0.0 Release

Issues Fixed in Workday 1.3.0.0 Release

Enhancements in Previous Release 1.2.2.1

Issues Fixed in Previous Release 1.2.2.1