22.2 Upgrading iManager

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:

22.2.1 Upgrading iManager on Windows

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:

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:

  1. Log in as a user with administrator privileges on the computer where you want to upgrade iManager.

  2. (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.

  3. 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.

  4. Extract the win.zip file to the iManager folder.

  5. Run iManagerInstall.exe, located by default in the extracted_directory\iManager\installs\win folder.

  6. In the iManager welcome window, select a language, and then click OK.

  7. In the Introduction window, and then click Next.

  8. Accept the License Agreement, and then click Next.

  9. (Optional) To use IPv6 addresses with iManager, click Yes in the Enable IPv6 window.

    You can enable IPv6 addresses after you upgrade iManager. For more information, see Configuring iManager for IPv6 Addresses after Installation.

  10. Click Next.

  11. At the Upgrade prompt, select Upgrade.

  12. (Conditional) Review the Detection Summary window.

    The Detection Summary window lists the latest version of Servlet container and JVM software that iManager will use once it is upgraded.

  13. Click Next.

  14. Read the Pre-installation summary page, and then click Install.

    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.

  15. (Conditional) If the Install Complete window 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.
    1. Note the path to the log file that the error message displays.

    2. In the Install Complete window, click Done.

    3. Open the log file.

    4. (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)
    5. (Conditional) If the log file does not contain the error listed in Step 21.d, NetIQ recommends that you retry the installation.

  16. Click Done.

  17. 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.

  18. (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.

22.2.2 Updating Role-Based Services

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 Configure > Plug-in Installation > Available Novell Plug-in Modules. For more information, see Understanding Installation for iManager Plug-ins.

  • 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 Role Based Services > RBS Configuration 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:

  1. Log in to iManager.

  2. In the Configure view, select Role Based Services > RBS Configuration.

    Review the table in the 2.x Collections tabbed page for any out-of-date modules.

  3. (Optional) To update a module, complete the following steps:

    1. For the Collection that you want to update, select the number in the Out-Of-Date column.

      iManager displays the list of outdated modules.

    2. Select the module you that want to update.

    3. Click Update at the top of the table.

22.2.3 Re-installing or Migrating Plug-ins for Plug-in Studio

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.

  1. Log in to iManager.

  2. In the iManager Configure view, select Role Based Services > Plug-in Studio.

    The Content frame displays the Installed Custom Plug-ins list, including the location of the RBS collection to which the plug-ins belong.

  3. Select the plug-in that you want to re-install or migrate, then click Edit.

    NOTE:You can edit only one plug-in at a time.

  4. Click Install.

  5. Repeat these steps for every plug-in that you need to re-install or migrate.

22.2.4 Updating iManager Plug-ins after an Upgrade or Re-installation

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.

  1. Open iManager.

  2. Navigate to Configure > Plug-in Installation > Available Novell Plug-in Modules.

  3. Update the plug-ins.