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.
The upgrade process includes the following activities:
If the setup program for iManager Server detects a previously installed version of iManager, it might give you the option to stop the installation process or remove the existing iManager, JRE, and Tomcat installations.
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 Section 19.4.2, Considerations for Installing iManager on a Linux Platform.
For iManager Workstation, see Section 19.4.4, Considerations for Installing iManager Workstation on Linux Clients.
NOTE:The upgrade process uses the HTTP port and SSL port values that were configured in the previous version of iManager.
To upgrade iManager Server on Linux:
Log in as root or root-equivalent to the computer where you want to run the installation program.
(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, search for iManager products, select the iManager version that you want, then download the .tgz file to a directory on your server. For example, iMan_277_linux.tgz.
To extract the iManager folder, enter the following command:
tar -zxvf iMan_version_linux.tgz
In a shell, change to the /extracted_directory/iManager/installs/linux directory.
This path is relative to the directory where you copied or extracted the iManager files.
(Conditional) To run a command-line (text) installation, enter the following command:
./iManagerInstallLinux.bin
(Conditional) To run the wizard for the installation program, enter the following command:
./iManagerInstallLinux.bin -i gui
At the splash screen, specify a language, and then click OK.
At the Upgrade prompt, select Upgrade.
Read the Introduction, and then click Next.
Accept the License Agreement, and then click Next.
(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 Section 21.2, Configuring iManager for IPv6 Addresses after Installation.
Click Next.
Read the Pre-Upgrade Summary page, and then click Next.
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.
When the upgrade process completes, click Done.
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 2.7.7 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.
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 Section 19.4.2, Considerations for Installing iManager on a Linux Platform.
For iManager Workstation, see Section 19.4.4, Considerations for Installing iManager Workstation on Linux Clients.
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 OK.
In the Introduction window, and then click Next.
Accept the License Agreement, and then click Next.
(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 Section 21.2, Configuring iManager for IPv6 Addresses after Installation.
Click Next.
At the Upgrade prompt, select Upgrade.
(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.
Click Next.
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.
(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.
Note the path to the log file that the error message displays.
In the Install Complete window, click Done.
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 20.d, NetIQ recommends that you retry the installation.
Click Done.
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 2.7.7 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.
To perform a standard silent install on a Linux or Windows server, use the default installation values.
At the NetIQ Downloads website, select the iManager version that you want. For example:
Linux: iMan_version_linux.tgz
Windows: iMan_version_win.zip
Download the upgrade file to a directory on your server.
(Conditional) On Windows computers, extract the win.zip file to the iManager folder.
In a console window, go to the directory containing the upgrade file that you downloaded.
On the command line, enter one of the following commands:
Linux: ./iManagerInstallplatform.bin -i silent
Windows: iManagerInstall.exe -i silent
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.
NOTE:
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 Section 19.3, 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:
Log in to iManager.
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.
(Optional) To update a module, complete the following steps:
For the Collection that you want to update, select the number in the Out-Of-Date column.
iManager displays the list of outdated modules.
Select the module you that want to update.
Click Update at 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 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.
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.
Click Install.
Repeat these steps for every plug-in that you need to re-install or migrate.
When you upgrade to iManager 2.7.7 or re-install it, the installation process does not update the existing plug-ins. Ensure that the plug-ins match iManager version 2.7.7. For more information, see Section 19.3, Understanding Installation for iManager Plug-ins.
Open iManager.
Navigate to Configure > Plug-in Installation > Available Novell Plug-in Modules.
Update the plug-ins.