The following sections describe various upgrade scenarios of iManager:
To upgrade the iManager version from 2.5/2.6 to 2.7, you should first upgrade the corresponding version of Operating System.
For OES-Linux, upgrade:
OES 1 SP2 Linux (32-bit) to OES 2 SP1 Linux (32-bit)
OES 2 Linux (32-bit) to OES 2 SP1 Linux (32-bit)
For more information on upgrading the Linux version, refer to Novell Open Enterprise Server 2 Installation Guide.
When you upgrade OES to OES 2 SP1, iManager will be upgraded to iManager 2.7.2 (iManager 2.7 Support Pack 2). You can then upgrade iManager to version 2.7.6 using OES patch channel.
The following is a generic scenario to upgrade the iManager version from 2.7.x to iManager 2.7.5. Patches and support packs are cumulative, so you only need to install the latest available pack or patch to upgrade your iManager installation.
Perform the following steps to upgrade iManager:
Log in to iManager.
Click
. The Available Novell Plug-in Modules page is displayed.Navigate to the Novell Downloads Web site and download the latest support pack or patch.
In iManager, under
, click .Browse to select the NPM file downloaded with the support pack or patch, then click
.In the Novell Plug-in Modules list, select the support pack or patch to which you want to upgrade iManager 2.7 and click
.If iManager displays the License Agreement page, read the License Agreement, select
Click
. The progress indicator is displayed. If you want to stop the installation, click .After the installation is completed, click
. The following successful message is displayed.Success: The plug-in module has been successfully installed. You must now restart Tomcat in order for the changes to take effect. After Tomcat restarts, if Role Based Services is installed you will need to configure the newly installed modules.
Open a command-line interface and enter the following commands to restart Tomcat:
/etc/init.d/novell-tomcat7 stop
/etc/init.d/novell-tomcat7 start
If the iManager 2.7.6 installation detects a previously installed version of iManager 2.7.x, it prompts you to upgrade the installed version. If you choose to upgrade it, the installer replaces the existing JRE and Tomcat versions with the latest versions. This will also upgrade the iManager to the latest version.
IMPORTANT:Do not install the standalone iManager release on a server running any OES version. Instead, you must use the OES version's patch channel to upgrade to the latest iManager version.
To prepare for the installation, review the checklist of prerequisites provided in General Prerequisites and Linux Prerequisites.
iManager installs the following products during installation:
Tomcat 7.0.32
Java 1.7.0_04
Upgrade to latest iManager
At the Novell Downloads Web site, search for iManager products, select iManager 2.7.6, then download iMan_276_linux.tgz to a directory on your server.
Use the following command to extract to the iManager folder:
tar -zxvf iMan_276_linux.tgz
Open a shell and change to the /extracted_directory/iManager/installs/linux directory
This path is relative to the directory where you copied or extracted the iManager files.
Enter one of the following commands while logged in as root or root‐equivalent.
To do a command-line (text) install, enter the following command:
./iManagerInstallLinux.bin
To do a GUI install, enter the following command:
./iManagerInstallLinux.bin -i gui
After a successful install, the installer generates a configuration file (/var/log/installer.properties) with values based upon the questions asked during the install. This file can then be modified and used for a silent install. See Section 1.6, Silent Installation of iManager Server.
On the iManager splash screen, select a language, then click
.At the Upgrade prompt, select
.Read through the Introduction, then click
.Accept the license agreement, then click
.NOTE:By default, the HTTP port and SSL port values that were configured in the previous version of iManager will be used to configure the latest version of iManager.
Read the Pre-Upgrade Summary page and click
During upgrade, new iManager files are installed and they cause configuration changes. Upgrade can take several minutes. After the upgrade completes, the Upgrade Complete page displays the success or failure status of the installation.
Click
to quit the installer.A browser window appears which displays the Getting Started page.
Wait for iManager to initialize before attempting access.
To access iManager, click the first link on the Getting Started page, then log in. For more information, see Accessing iManager
in the Novell iManager 2.7.6 Administration Guide.
IMPORTANT: After the upgrade, the server.xml and context.xml configuration files are saved as server.xml.usave and context.xml.usave files. If you have modified the configuration files, the changes are lost during the upgrade. To save the configuration changes after upgrade, copy the modified configuration files into your new configuration files.
If the iManager 2.7.6 installation detects a previously installed version of iManager 2.7.x, it prompts you to upgrade the installed version. If you choose to upgrade it, the installer replaces the existing JRE and Tomcat versions with the latest versions. This will also upgrade the iManager to the latest version.
For information about running iManager Server on the same machine as Novell eDirectory, see Running eDirectory and iManager on the Same Machine (Windows only)
in the Novell iManager 2.7.6 Administration Guide.
Extract the iMan_276_win.zip file into the iManager folder.
Run the iManagerInstall.exe file from the extracted_directory\iManager\installs\win folder.
On the iManager splash screen, select a language, then click
.On the introduction page, then click
.Accept the license agreement, then click
.At the Upgrade prompt, select
.NOTE:By default, the HTTP port and SSL port values that were configured in the previous version will be used to configure the latest version of iManager.
Read the Detection Summary page, then click
.The Detection Summary displays the latest version of Servlet container and JVM software that iManager will use once it is installed.
Read the Pre-installation summary page, then click
.During upgrade, new iManager files are installed and they cause configuration changes. Upgrade can take several minutes.After the upgrade completes, the Upgrade Complete page displays the success or failure status of the installation.
NOTE:On Windows, the Install Complete page displays the following error message in spite of a successful installation.
The installation of iManager Install 2.7.6 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.
If the specified error message is displayed, do the following:
Make note of the log file path that is specified within the error message in the Install Complete page.
In the Install Complete page, click
.Open the log file.
If you find the following error in the log file, you can ignore the error message. The installation was successful, and iManager properly functions.
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)
Click
to quit the installer.A browser window appears which displays the Getting Started page.
Wait for iManager to initialize before attempting access.
To access iManager, click the first link on the Getting Started page, then log in. For more information, see Accessing iManager
in the Novell iManager 2.7.6 Administration Guide.
IMPORTANT:After the upgrade, the server.xml and context.xml configuration files are saved as server.xml.usave and context.xml.usave files. If you have modified the configuration files, the changes are lost during the upgrade. Therefore, to save the configuration changes after upgrade, copy the modified configuration files into your new configuration files.
To install the latest version of iManager, you must have iManager 2.7.6 installed on your system.
At the Novell Downloads Web site, search for iManager products, select iManager 2.7.6 Patch 1 then download iManager276_Patch1_Linux.tar.gz to a directory on your server.
Use the following command to extract to the iManager folder:
iManager276_Patch1_Linux.tar.gz
Open a shell and change to the /extracted_directory/imanager/Linux directory.
This path is relative to the directory where you copied or extracted the iManager files.
Log in as root or root‐equivalent to upgrade the iManager workstation.
To do a command-line (text) install, run the following command:
./patchInstall.bin
Follow the on-screen installation instructions to install the latest patch.
To do a GUI install, run the following command:
./patchInstall.bin -i gui
Follow the on-screen installation instructions to install the latest patch.
To do a silent install, ensure that the install.properties file contains the following values:
INSTALLER_UI = silent
USER_INSTALL_DIR= <Tomcat directory of the iManager 2.7.6 workstation>
Run the following command to do a silent install.
./patchInstall.bin -i silent -f install.properties
Follow the on-screen installation instructions to install the latest patch.
At the restart warning prompt, click
to restart Tomcat.By default, Tomcat is restarted after installation in silent mode installation.
To upgrade iManager workstation to the latest version:
At the Novell Downloads Web site, search for iManager products, select iManager 2.7.6 Patch 1 then download iManager276_Patch1_Linux.tar.gz to a directory on your server.
Run the following command to extract to the iManager folder:
iManager276_Patch1_Linux. tar -zxvf tar.gz
Open a shell and change to the /extracted_directory/imanager/Linux directory.
This path is relative to the directory where you copied or extracted the iManager files.
Log in as root or root‐equivalent to upgrade the iManager workstation.
To do a command-line (text) install, run the following command and specify the Tomcat path of the workstation:
./patchInstall.bin
Follow the on-screen installation instructions to install the latest patch.
To do a GUI install, run the following command and specify the Tomcat path of the workstation:
./patchInstall.bin -i gui
Follow the on-screen installation instructions to install the latest patch.
To do a silent install, ensure that the install.properties file contains the following values.
INSTALLER_UI = silent
USER_INSTALL_DIR= <Tomcat directory of the iManager 2.7.6 workstation>
Run the following command to do a silent install.
./patchInstall.bin -i silent -f install.properties
After successful installation, relaunch iManager to view the latest changes.
IMPORTANT: The Roll back feature is not supported in iManager patch releases.
To upgrade iManager to the latest patch, you must have iManager 2.7.6 installed on your system.
At the Novell Downloads Web site, select iManager 2.7.6 Patch 1, then download the iManager276_Patch1_Windows.zip to a directory on your server.
Extract the iManager276_Patch1_Windows.zip file into the iManager folder.
Run the patchInstallWin.exe file from the extracted_directory\iManager\installs\win folder to install the latest patch.
Follow the on-screen instructions to complete the installation.
At the restart warning prompt, click
to restart tomcat. In silent mode installation, by default, Tomcat is restarted after installation.To upgrade iManager workstation to the latest version:
At the Novell Downloads Web site, search for iManager products, select iManager 2.7.6 Patch 1 then download iManager276_Patch1_Windows.zip to a directory on your server.
Extract the iManager276_Patch1_Windows.zip file into the iManager folder.
Browse to the folder where you have extracted iManager 2.7.6 patch 1.
Run the patchInstallWin.exe file from the extracted_directory\imanager\Windows folder to install the latest patch.
Specify the Tomcat path of the workstation.
Follow the on-screen instructions to complete the installation.
To do a silent install, ensure that the install.properties file contains the following values.
INSTALLER_UI = silent
USER_INSTALL_DIR= <Tomcat directory of the iManager 2.7.6 workstation>
Run the following command at the command prompt.
patchInstallWin.exe -i silent -f install.properties
After successful installation, relaunch iManager to view the latest changes.
NOTE:For silent installation, ensure that you replace the backward slash (\) with forward slash (/) when you specify the file path in the USER_INSTALL_DIR (install.properties file). For example, if the default path in Windows is c:\276_workstation_extracted folder\imanager\tomcat, change it to c:/276_workstation_extracted folder/imanager/tomcat in the install.properties file. If you do not change the backward slash to the forward slash in the install.properties file, the installer fails to upgrade iManager to the latest patch.
If you want to reinstall iManager 2.7.6.1 on a system that has iManager 2.7.6.1 installed, you can use the forced installation feature that is supported in silent installation mode. Specify the following values in the install.properties file:
By default,
value is set to .To reinstall iManager, run the following commands:
For Linux :
./patchInstall.bin -i silent -f install.properties
For Windows:
patchInstallWin.exe -i silent -f install.properties
A silent (non-interactive) upgrade does not display a user interface or ask the user any questions. Instead, InstallAnywhere uses information from a properties file for this purpose.
To perform a standard silent install on Linux server and Windows Server, use the default install values.
Open a console window and browse to the directory that contains the iManager file you downloaded.
On the command line, run the following command:
For Linux:
./iManagerInstall<platform>.bin -i silent
For Windows:
iManagerInstall.exe -i silent