Code (-9031) Global Configuration Value 'ggl.userdefinedfieldlist' not found

  • 7016417
  • 13-Apr-2015
  • 13-Apr-2015

Environment

NetIQ Identity Manager 4.0.2
NetIQ Identity Manager Driver - GoogleApps 4.0.5.0

IDM Google Apps driver has just been updated to version 4.0.5.0.

Situation

Attempting to start a GoogleApps driver just updated to version 4.0.5.0 from a previous version results in the error message: "Unable to start on {server-name} for an unknown reason."

In the driver trace log, running with trace level 3, the following error is seen:

:GApps ST:Reading XML attribute vnd.nds.stream://TREE/services/DriverSet/Google+Apps#DirXML-ShimConfigInfo.
:GApps ST:
DirXML Log Event -------------------
     Driver:   \TREE\services\DriverSet\Google Apps
     Status:   Error
     Message:  Code(-9010) An exception occurred: com.novell.nds.dirxml.engine.VRDException: Code(-9031) Global Configuration Value 'ggl.userdefinedfieldlist' not found: vnd.nds.stream://TREE/services/DriverSet/Google+Apps#DirXML-ShimConfigInfo at line 0.

Resolution

Add the GCV definition for 'ggl.userdefinedfieldlist' to the driver's Google Config tab.
  1. Right click the driver and select properties
  2. Select the GCV option on the left side
  3. Select the Google Config GCV tab
  4. Click the Edit XML button
  5. Add the following XML snippet at the end of the definitions - just ahead of the </definitions> token
  6. Click OK
  7. Click OK
XML Snippet:
=============================
        <definition critical-change="true" display-name="User Defined Fields" item-separator="." name="ggl.userdefinedfieldlist" type="list">
            <description>This list contains the names of Google User Defined Fields which the driver will synchronize from the IDV to Google. Each value should be a single alphabetic string with no whitespace. For example: Cube

Upon driver restart, the attribute names listed here will be available in the application schema for mapping and filtering. See the documentation for more information.</description>
            <value/>
        </definition>
=============================

Cause

When updating an existing Google Apps driver the GCV definition for ggl.userdefinedfieldlist may not be added if the original Google Apps package(s) were customized.