4.3 Upgrading a GroupWise Driver to GroupWise 2014 Driver

To upgrade an existing GroupWise driver to GroupWise 2014 driver, you need to upgrade the following driver components:

  • Driver shim

  • Driver packages

4.3.1 Upgrading the Driver Shim

The GroupWise driver does not provide an in-place upgrade. You need to install a new driver. To upgrade the driver shim:

  1. Stop the existing GroupWise driver.

    or

    Stop the driver instance if you are using Remote Loader.

  2. Install the new GroupWise 2014 driver using the driver installation wizard.

    For more information, see Section 2.2, Installing the Driver Shim.

4.3.2 Upgrading the Existing Driver Packages

You must upgrade the existing GroupWise driver packages to GroupWise 2.5 packages.

  1. Download all GroupWise 2.5 packages from the Package Update site.

    Ensure that the package version is 2.5. For more information about the packages needed for the driver upgrade, see Driver Packages.

  2. Right-click the driver, then click Properties.

  3. Click Upgrade, and select all packages to upgrade.

    IMPORTANT:Performing a partial upgrade of the packages might break the existing driver functionality.

    If you want to install the legacy GroupWise driver after installing the upgraded packages, you need to manually select 2.0.x packages during package installation because 2.5 packages will become the default packages for the GroupWise driver. You must ignore 2.5 packages for creating a legacy GroupWise driver.

  4. Follow the driver configuration steps from Section 3.1.2, Installing the Driver Packages.

  5. Click Next.

  6. In the driver configuration page, update the GroupWise 2014 Driver Class name to com.novell.gw.dirxml.driver.rest.shim.GWdriverShim.

    NOTE:Change the name of the driver module if you are running the driver locally. If you are running the driver remotely, modify the Remote Loader instance configuration with the new class name before starting the driver instance.

  7. Deploy the driver.

  8. Start the driver.

IMPORTANT:GroupWise 2014 does not support Distribution List and External Entities objects. However, the upgraded driver supports the Modify operation for them. For a list of GCVs applicable for the upgraded driver, see Section A.3, GCVs Applicable for the Upgraded Driver.