4.3 Upgrade an Existing Driver

4.3.1 Instructions for Patching from Google Apps Driver v 4.0.x

Linux

  1. The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path is dependent on your install location. On Linux hosts, it is typically opt/novell/eDirectory/lib/dirxml/classes.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

    • google-api-client-java6-1.19.1.jar

    • google-http-client-1.19.0.jar

    • google-http-client-gson-1.19.0.jar

    • google-http-client-jackson2-1.19.0.jar

    • google-oauth-client-1.19.0.jar

    • google-oauth-client-java6-1.19.0.jar

    • google-oauth-client-jetty-1.19.0.jar

    • google-api-services-admin-directory_v1-rev50-1.19.1.jar

    • google-api-services-oauth2-v2-rev87-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

    • google-api-client-java6-1.20.1.jar

    • google-http-client-1.20.0.jar

    • google-http-client-gson-1.20.0.jar

    • google-http-client-jackson2-1.20.0.jar

    • google-oauth-client-1.20.0.jar

    • google-oauth-client-java6-1.20.0.jar

    • google-oauth-client-jetty-1.20.0.jar

    • google-api-services-admin-directory_v1-rev55-1.20.0.jar

    • google-api-services-oauth2-v1-rev95-1.20.0.jar

    • google-api-services-groupssettings-v1-rev54-1.20.0.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

  9. Enable the Groups Settings API in the Google Developers Console. Section 3.1.2, Enabling Google API Access

  10. Re-authorize the Client ID for your Service Account Credential using the scopes provided in DirectoryScopes.txt provided with the patch.Section 3.2.2, Delegate Domain-wide Administrative rights to the Google Service Account

Windows

  1. The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path is dependent on your install location. On Windows hosts, it is typically [Install_Location]\NDS\lib\.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

    • google-api-client-java6-1.19.1.jar

    • google-http-client-1.19.0.jar

    • google-http-client-gson-1.19.0.jar

    • google-http-client-jackson2-1.19.0.jar

    • google-oauth-client-1.19.0.jar

    • google-oauth-client-java6-1.19.0.jar

    • google-oauth-client-jetty-1.19.0.jar

    • google-api-services-admin-directory_v1-rev50-1.19.1.jar

    • google-api-services-oauth2-v2-rev87-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

    • google-api-client-java6-1.20.1.jar

    • google-http-client-1.20.0.jar

    • google-http-client-gson-1.20.0.jar

    • google-http-client-jackson2-1.20.0.jar

    • google-oauth-client-1.20.0.jar

    • google-oauth-client-java6-1.20.0.jar

    • google-oauth-client-jetty-1.20.0.jar

    • google-api-services-admin-directory_v1-rev55-1.20.0.jar

    • google-api-services-oauth2-v1-rev95-1.20.0.jar

    • google-api-services-groupssettings-v1-rev54-1.20.0.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

  9. Enable the Groups Settings API in the Google Developers Console. Section 3.1.2, Enabling Google API Access

  10. Re-authorize the Client ID for your Service Account Credential using the scopes provided in DirectoryScopes.txt provided with the patch.Section 3.2.2, Delegate Domain-wide Administrative rights to the Google Service Account

Remote Loader

  1. Remote loader driver paths are dependent on how the remote loader is installed. Locate the existing gmailshim.jar on the remote loader host to identify the correct path.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

    • google-api-client-java6-1.19.1.jar

    • google-http-client-1.19.0.jar

    • google-http-client-gson-1.19.0.jar

    • google-http-client-jackson2-1.19.0.jar

    • google-oauth-client-1.19.0.jar

    • google-oauth-client-java6-1.19.0.jar

    • google-oauth-client-jetty-1.19.0.jar

    • google-api-services-admin-directory_v1-rev50-1.19.1.jar

    • google-api-services-oauth2-v2-rev87-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

    • google-api-client-java6-1.20.1.jar

    • google-http-client-1.20.0.jar

    • google-http-client-gson-1.20.0.jar

    • google-http-client-jackson2-1.20.0.jar

    • google-oauth-client-1.20.0.jar

    • google-oauth-client-java6-1.20.0.jar

    • google-oauth-client-jetty-1.20.0.jar

    • google-api-services-admin-directory_v1-rev55-1.20.0.jar

    • google-api-services-oauth2-v1-rev95-1.20.0.jar

    • google-api-services-groupssettings-v1-rev54-1.20.0.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

  9. Enable the Groups Settings API in the Google Developers Console. Section 3.1.2, Enabling Google API Access

  10. Re-authorize the Client ID for your Service Account Credential using the scopes provided in DirectoryScopes.txt provided with the patch.Section 3.2.2, Delegate Domain-wide Administrative rights to the Google Service Account

4.3.2 Instructions for Patching from Google Apps Driver v 4.1.0

Linux

  1. The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path is dependent on your install location. On Linux hosts, it is typically opt/novell/eDirectory/lib/dirxml/classes.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

    • google-api-services-admin-directory_v1-rev53-1.20.0.jar

    • google-api-services-oauth2-v2-rev87-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

    • google-api-services-admin-directory_v1-rev55-1.20.0.jar

    • google-api-services-oauth2-v1-rev95-1.20.0.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

Windows

  1. The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path is dependent on your install location. On Windows hosts, it is typically [Install_Location]\NDS\lib\.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

    • google-api-services-admin-directory_v1-rev53-1.20.0.jar

    • google-api-services-oauth2-v2-rev87-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

    • google-api-services-admin-directory_v1-rev55-1.20.0.jar

    • google-api-services-oauth2-v1-rev95-1.20.0.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

Remote Loader

  1. Remote loader driver paths are dependent on how the remote loader is installed. Locate the existing gmailshim.jar on the remote loader host to identify the correct path.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

    • google-api-services-admin-directory_v1-rev53-1.20.0.jar

    • google-api-services-oauth2-v2-rev87-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

    • google-api-services-admin-directory_v1-rev55-1.20.0.jar

    • google-api-services-oauth2-v1-rev95-1.20.0.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

4.3.3 Instructions for Patching from Google Apps Driver v 4.1.0.1 or 4.1.0.2

Linux

  1. The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path is dependent on your install location. On Linux hosts, it is typically opt/novell/eDirectory/lib/dirxml/classes.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

Windows

  1. The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path is dependent on your install location. On Windows hosts, it is typically [Install_Location]\NDS\lib\.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)

Remote Loader

  1. Remote loader driver paths are dependent on how the remote loader is installed. Locate the existing gmailshim.jar on the remote loader host to identify the correct path.

  2. Update the GoogleApps Driver Packages

    • Google Apps Account Tracking

    • Google Apps Base

    • Google Apps Configuration

    • Google Apps Contact Package

    • Google Apps Entitlements

    • Google Apps Groups Package

    • Google Apps Managed System Settings

    • Google Apps Organizational Unites Package

    • Google Apps Password Settings

    • Google Apps User Package

  3. The Google Apps driver packages can be used to import a new driver or perform an in-place update of an existing driver.

  4. Stop all drivers

  5. Stop eDirectory

  6. Delete the existing Google Apps driver binary. The files to delete are:

    • gmailshim.jar

    • google-api-client-1.19.1.jar

  7. Copy the driver binary files provided with the patch to the eDirectory DirXML Library Path.

    • gmailshim.jar

    • google-api-client-1.20.1.jar

  8. Restart eDirectory - rcndsd restart (all drivers marked as automatic start will restart)