To upgrade an existing driver to the supported GroupWise driver, you need to upgrade the following driver components:
Driver shim
Driver packages
To upgrade the driver shim, perform the following actions:
Stop the driver instance by using iManager, Designer, or dxcmd by performing one of the following actions:
If the driver is running locally, stop the driver instance and the Identity Vault.
If the driver is running with a Remote Loader instance, stop the driver and the Remote Loader instance.
For example, go to a command prompt on Linux and run ndsmanage stopall
Download the driver patch file to a temporary folder on your server.
Extract the contents of the driver patch file.
Update the driver files:
Linux: Open a command prompt and run the following command to upgrade the existing RPM:
rpm -U (image-path)/novell-DXMLGWRest.rpm
Windows: Navigate to the <Extracted Driver Patch File Temporary Location>\windows folder and copy the GWRestShim.jar file to <IdentityManager installation>\RemoteLoader\lib folder.
(Conditional) If the driver is running locally, start the Identity Vault and the driver instance.
For example, open a command prompt on Linux and run ndsmanage startall
(Conditional) If the driver is running with a Remote Loader, start the Remote Loader and the driver instance.
You must upgrade the existing GroupWise driver packages to GroupWise 2.5 packages.
Download all GroupWise 2.5 or 2.6 packages from the Package Update site.
Ensure that the package version is 2.5 or 2.6. For more information about the packages needed for the driver upgrade, see Driver Packages.
Right-click the driver, then click Properties.
Click Packages, and select the 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.
Follow the driver configuration steps from Installing the Driver Packages.
Click Next.
In the driver configuration page, update the GroupWise 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.
Deploy the driver.
Start the driver.
IMPORTANT:GroupWise 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 GCVs Applicable for the Upgraded Driver.