In general, the upgrade process for iManager uses the existing configuration values in the configiman.properties file, such as port values and authorized users. Before upgrading, NetIQ recommends that you back up the server.xml and context.xml configuration files if you have previously modified them.
If you are on eDirectory 9.1, upgrade your iManager version to 3.1. iManager 3.1 installation files are located in the <iso_extracted_directory>\products\iManager277\installs\win directory.
The upgrade process includes the following activities:
If the setup program for iManager Server detects a previously installed version of iManager, it might prompt you to upgrade the installed version. If you choose to upgrade, the program replaces the existing JRE and Tomcat versions with the latest versions. This will also upgrade the iManager to the latest version.
Before upgrading iManager, ensure that the computer meets the prerequisites and system requirements. For more information, see the following sources:
The Release Notes accompanying the update.
For iManager, see Considerations for Installing iManager Server.
For iManager Workstation, see Considerations for Installing iManager Workstation.
NOTE:The upgrade process uses the HTTP port and SSL port values that were configured in the previous version of iManager.
To install iManager Server on Windows:
Log in as a user with administrator privileges on the computer where you want to upgrade iManager.
(Conditional) If you modified the server.xml and context.xml configuration files, save a backup copy of the files in a different location before performing the upgrade.
The upgrade process replaces the configuration files.
At the NetIQ Downloads website, select the iManager version that you want, then download the win.zip file to a directory on your server. For example, iMan_277_win.zip.
Extract the win.zip file to the iManager folder.
Run iManagerInstall.exe, located by default in the extracted_directory\iManager\installs\win folder.
In the iManager welcome window, select a language, and then click.
In thewindow, and then click .
Accept the License Agreement, and then click.
(Optional) To use IPv6 addresses with iManager, clickin the window.
You can enable IPv6 addresses after you upgrade iManager. For more information, see Configuring iManager for IPv6 Addresses after Installation.
At the Upgrade prompt, select.
(Conditional) Review thewindow.
Thewindow lists the latest version of Servlet container and JVM software that iManager will use once it is upgraded.
Read thepage, and then click .
The upgrade process can take several minutes. The process might add new files for iManager components or change the iManager configuration. For more information, see the Release Notes for the upgrade.
(Conditional) If thewindow displays the following error message, complete the following steps:
The installation of iManager version is complete, but some errors occurred during the install. Please see the installation log Log file path for details. Press "Done" to quit the installer.
Note the path to the log file that the error message displays.
In thewindow, click .
Open the log file.
(Conditional) If you find the following error in the log file, you can ignore the error message. The installation was successful, and iManager functions properly.
Custom Action: com.novell.application.iManager.install.InstallDLLs Status: ERROR Additional Notes: ERROR - class com.novell.application.iManager.install.InstallDLLs NonfatalInstallException C:\WINDOWS\system32\msvcr71.dll (The process cannot access the file because it is being used by another process)
(Conditional) If the log file does not contain the error listed in Step 21.d, NetIQ recommends that you retry the installation.
When the initialization of iManager finishes, click the first link in the Getting Started page, and then log in. For more information, see “Accessing iManager” in the NetIQ iManager Administration Guide.
(Conditional) If you made backup copies of the server.xml and context.xml configuration files before starting the upgrade process, replace the new configuration files with the backup copies.
The first time that you use iManager to log in to an eDirectory tree that already contains a Role-Based Services (RBS) collection, you might not see all of the roles information. This behavior is normal because you must update some of the plug-ins to function with the latest version of iManager. NetIQ recommends that you update your RBS modules to the latest version so that you can see and use all of the available functionality in iManager. The RBS Configuration table lists which RBS modules need to be updated.
Be aware that you might have multiple roles with the same name. Starting with iManager 2.5, some plug-in developers changed task IDs or module names but retained the same display names. This issue causes the roles to appear to be duplicated when, in fact, one instance is from one version and the other is from a newer version.
When updating or re-installing iManager, the installation program does not update existing plug-ins. To update plug-ins manually, launch iManager and navigate to Understanding Installation for iManager Plug-ins.> > . For more information, see
Different installations of iManager might have a different number of plug-ins locally installed. As a result, you might see discrepancies in the module report for any given collection from the> page. For the numbers to match between iManager installations, ensure that you install the same subset of plug-ins on each iManager instance in the tree.
To check for and update outdated RBS objects:
Log in to iManager.
In the Configure view, select.
Review the table in the 2.x Collections tabbed page for any out-of-date modules.
(Optional) To update a module, complete the following steps:
For the Collection that you want to update, select the number in thecolumn.
iManager displays the list of outdated modules.
Select the module you that want to update.
Clickat the top of the table.
You can migrate or replicate Plug-in Studio plug-ins to another iManager instance, as well as to a new or updated version of iManager.
Log in to iManager.
In the iManager Configure view, select
The Content frame displays the Installed Custom Plug-ins list, including the location of the RBS collection to which the plug-ins belong.
Select the plug-in that you want to re-install or migrate, then click.
NOTE:You can edit only one plug-in at a time.
Repeat these steps for every plug-in that you need to re-install or migrate.
When you upgrade or re-install your iManager, the installation process does not update the existing plug-ins. Ensure that the plug-ins match the correct iManager version. For more information, see Understanding Installation for iManager Plug-ins.
Update the plug-ins.