The driver upgrade process involves upgrading the installed driver packages and updating the driver files.
This section provides general instructions for updating a driver. For information about updating the driver to a specific version, search for that driver patch in the NetIQ Patch Finder Download Page and follow the instructions from the Readme file accompanying the driver patch release.
Download the latest available packages.
To configure Designer to automatically read the package updates when a new version of a package is available, click Windows > Preferences > NetIQ > Package Manager > Online Updates in Designer. However, if you need to add a custom package to the Package Catalog, you can import the package .jar file. For more information about creating custom packages, see Developing Packages in the NetIQ Designer for Identity Manager Administration Guide.
Upgrade the installed packages.
Open the project containing the driver.
Right-click the driver for which you want to upgrade an installed package, then click Driver > Properties.
Click Packages.
If there is a newer version of a package, there is check mark displayed in the Upgrades column.
Click Select Operation for the package that indicates there is an upgrade available.
From the drop-down list, click Upgrade.
Select the version that you want to upgrade to, then click OK.
NOTE:Designer lists all versions available for upgrade.
Click Apply.
(Conditional) Fill in the fields with appropriate information to upgrade the package, then click Next.
Depending on which package you selected to upgrade, you must fill in the required information to upgrade the package.
Read the summary of the packages that will be installed, then click Finish.
Review the upgraded package, then click OK to close the Package Management page.
For detailed information, see the Upgrading Installed Packages in the NetIQ Designer for Identity Manager Administration Guide.
The driver patch updates the driver files. You can install the patch as a root or non-root user.
Before installing the patch, complete the following steps:
Take a back-up of the current driver configuration.
(Conditional) If the driver is running with the Identity Manager engine, stop the Identity Vault and the driver instance.
(Conditional) If the driver is running with a Remote Loader instance, stop the Remote Loader instance and the driver instance.
In a browser, navigate to the NetIQ Patch Finder Download Page.
Under Patches, click Search Patches.
Specify Identity Manager nn Azure AD Driver nn in the search box.
Download and unzip the contents of the patch file to a temporary location on your server.
For example, IDM4.5_AzureAD_5010.zip.
In a root installation, the driver patch installs the driver files RPMs in the default locations on Linux. On Windows, you need to manually copy the files to the default locations.
Ensure that you have completed the prerequisites for installing the patch. For more information, see Prerequisites.
On the server where you want run the patch, log in as root.
Depending on your platform, perform one of the following actions:
Linux: Run the following command in a terminal window:
rpm -Uvh <Driver Patch File Temporary Location>/linux/netiq-DXMLRESTAzure.rpm
For example, rpm -Uvh <IDM4.5_AzureAD_5010.zip>/linux/netiq-DXMLRESTAzure.rpm
Windows: Navigate to the <Extracted Driver Patch File Temporary Location>\windows folder and copy the AZDriverShim.jar file to your driver installation folder.
For example, <IdentityManager installation>\NDS\lib or <IdentityManager installation>\RemoteLoader\<architecture>\lib.
(Conditional) Copy the Exchange Service files.
This step is only required if you enabled the driver to synchronize Exchange data or if you want to use Active Directory PowerShell.
Stop the Identity Manager Exchange Online service from Windows Services Console (services.msc).
Navigate to the <Extracted Driver Patch File Temporary Location>\windows folder and copy the following files to your Exchange service installation folder:
ExchServerHost.exe
IDMExchServer.dll
For example, <IdentityManager installation>\ExchaneServerHost.
Start the Identity Manager Exchange Online service from Windows Services Console (services.msc).
(Conditional) If the driver is running locally, start the Identity Vault and the driver instance.
(Conditional) If the driver is running with a Remote Loader instance, start the Remote Loader and the driver instance.
Verify that <non-root eDirectory location>/rpm directory exists and contains the file, _db.000.
The _db.000 file is created during a non-root installation of the Identity Manager engine. Absence of this file might indicate that Identity Manager is not properly installed. Reinstall Identity Manager to correctly place the file in the directory.
To set the root directory to non-root eDirectory location, enter the following command in the command prompt:
ROOTDIR=<non-root eDirectory location>
This will set the environmental variables to the directory where eDirectory is installed as a non-root user.
Download the patch and untar or unzip the downloaded file.
To install the driver files, run the following script in a command prompt:
*************************************************************** #!/bin/sh #set -x #© 2017 NetIQ Corporation and its affiliates. All Rights Reserved clear echo "======================================================================" echo " Installing packages... " echo "======================================================================" if [ "$1" == "" ] ; then exit fi pkgfile=$1 ROOTDIR="/local/home/bshidm/base/bshappl/edir" RPMDB=$ROOTDIR/rpm if [ ! -d "$RPMDB" ] ; then mkdir $RPMDB fi # create rpm database if it doesn't exist if [ ! -f $RPMDB/__db.000 ] then # mkdir -p $RPMDB rpm --dbpath "$RPMDB" --initdb fi RPM_FLAGS="--dbpath $RPMDB -Uvh --relocate=/etc=$ROOTDIR/etc --relocate=/ opt=$ROOTDIR/opt --relocate=/opt/novell/eDirectory/lib64=$ROOTDIR/opt/novell/ eDirectory/lib64 --relocate=/var=$ROOTDIR/var --badreloc --nodeps -- replacefiles --force" rpm $RPM_FLAGS $pkgfile