In general, the Fanout driver upgrade process involves upgrading the installed driver packages and updating the existing Fanout agent and 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. For more information about managing packages, see 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.
Take a back-up of the current driver configuration.
Stop the driver instance.
Stop the Identity Vault.
In a browser, navigate to the NetIQ Patch Finder Download Page.
Under Patches, click Search Patches.
Specify Identity Manager nn Fanout 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_FanoutAgent_1110.zip.
Stop the Fanout agent. For more information, see Stopping the Fanout Agent.
Remove all the versions of the activemq-all-<Version>.jar file from your current <Fanout agent installation>\lib directory.
Update the Fanout agent files:
Linux: Depending on your Identity Manager installation type as root or non-root, log in to your server with appropriate rights and run the following command in a command prompt:
rpm -Uvh <Fanout Agent Patch File Temporary Location>/linux/netiq-DXMfanout.rpm
Windows: Navigate to the <Extracted Fanout Agent Patch File Temporary Location>\windows\FanoutAgent\bin folder and copy the following files to <IdentityManager installation>\NDS\lib folder.
stopAgent.bat
FanoutAgent.jar
activemq-all-5.15.2.jar
Start the Fanout agent. For more information, see Starting the Fanout Agent.
(Conditional) Stop the driver instance, then stop the Identity Vault if not already stopped:
Update the driver files:
Linux: To upgrade the existing RPM, log in as root and run the following command in a command prompt:
rpm -Uvh <Driver Patch File Temporary Location>/linux/novell-DXMLfanoutdriver.rpm
For example, rpm -Uvh <IDM4.5_FanoutAgent_1110.zip>/linux/novell-DXMLfanoutdriver.rpm
Windows: Perform the following actions:
Navigate to the <Extracted Driver Patch File Temporary Location>\windows folder and copy the FanoutDriverShim.jar file to <IdentityManager installation>\NDS\lib folder.
Copy the activemq-all-5.14.3.jar from <Extracted Driver Patch File Temporary Location>\windows\FanoutAgent\lib folder to <C:\NetIQ\IdentityManager\NDS\lib folder.
Start the Identity Vault and the Fanout driver instance.