2.1 Upgrade Scenarios

The following sections describe various upgrade scenarios of iManager:

2.1.1 Upgrading OES Installations Running iManager 2.5/2.6

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.7 using OES patch channel.

2.1.2 Upgrading to iManager 2.7.5

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 Configure > Plug-in Installation > Available Novell Plug-in Modules. 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 Novell Plug-in Modules, click Add.
Browse to select the NPM file downloaded with the support pack or patch, then click OK.
In the Novell Plug-in Modules list, select the support pack or patch to which you want to upgrade iManager 2.7 and click Install.
If iManager displays the License Agreement page, read the License Agreement, select I Agree
Click OK. The progress indicator is displayed. If you want to stop the installation, click Stop.

After the installation is completed, click Close. 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
```

2.1.3 Upgrading to iManager 2.7.7 on Linux

If the iManager 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 standalone iManager package 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.81
Java 1.8.0_144 (32-bit)

(Conditional) If you have modified the server.xml and context.xml configuration files, make a backup copy of the files in a different location before performing the upgrade. The upgrade process replaces the configuration files.
At the Novell Downloads Web site, search for iManager products, select iManager 2.7.7, then download iMan_277x_linux.tgz to a directory on your server.
To extract to the iManager folder, use the following command:

tar -zxvf iMan_277x_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) installation, enter:

./iManagerInstallLinux.bin

To do a GUI install, enter:

./iManagerInstallLinux.bin -i gui

After a successful installation, the installer generates a configuration file (/var/log/installer.properties) with values based upon the questions asked during the installation process. This file can then be modified and used for a silent installation. See Silent Installation of iManager Server.
On the iManager splash screen, select a language, then click OK.
At the Upgrade prompt, select Upgrade.
Read through the Introduction, then click Next.
Accept the license agreement, then click Next.

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.
On the Enable IPV6 window, click Yes to enable IPv6, then click Next.

Alternatively, you can enable IPv6 after installing iManager using the following steps:
1. Open <USER_INSTALL_DIR>\Tomcat\conf\catalina.properties file.
2. Set the following configuration entries in the catalina.properties file:
```
java.net.preferIPv4Stack=false              
```
```
java.net.preferIPv4Addresses=true
```
3. Restart Tomcat.
Read the Pre-Upgrade Summary page and click Next.

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 Done to quit the installer.

When the Getting Started page appears, 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 NetIQ iManager 2.7.7 Administration Guide.
(Conditional) If you made backup copies of the server.xml and context.xml configuration files prior to starting the upgrade process, replace the new configuration files with the backup copies.

2.1.4 Upgrading to iManager 2.7.7 on Windows

If the iManager 2.7.7 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 iManager to the latest version.

For information about running iManager Server on the same machine as eDirectory, see Running eDirectory and iManager on the Same Machine (Windows only) in the NetIQ iManager 2.7.7 Administration Guide.

(Conditional) If you have modified the server.xml and context.xml configuration files, make a backup copy of the files in a different location before performing the upgrade. The upgrade process replaces the configuration. files.
Extract the iMan_277x_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 OK.
On the introduction page, then click Next.
Accept the license agreement, then click Next.
On the Enable IPV6 window, click Yes to enable IPv6, then click Next.

Alternatively, you can enable IPv6 after installing iManager using the following steps:
1. Open <USER_INSTALL_DIR>\Tomcat\conf\catalina.properties file.
2. Set the following configuration entries in the catalina.properties file:
```
java.net.preferIPv4Stack=false              
```
```
java.net.preferIPv4Addresses=true
```
3. Restart Tomcat.
At the Upgrade prompt, select Upgrade.

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

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

The upgrade process 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.7 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:
1. Make note of the log file path that is specified within the error message in the Install Complete page.
2. In the Install Complete page, click Done.
3. Open the log file.
4. 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 Done 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 NetIQ® iManager Administration Guide.
(Conditional) If you made backup copies of the server.xml and context.xml configuration files prior to starting the upgrade process, replace the new configuration files with the backup copies.

2.1.5 Silent Upgrade of iManager

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

2.1.6 Upgrading to iManager 2.7.7 Patch 11 on Linux

If the iManager installation detects a previously installed version of iManager 2.7.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 standalone iManager package on a server running any OES version. Instead, you must use the OES 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.81
Java 1.8.0_144 (32-bit)

(Conditional) If you have modified the server.xml and context.xml configuration files, make a backup copy of the files in a different location before performing the upgrade. The upgrade process replaces the configuration. files.
At the NetIQ Download Web site, search for iManager products, select iManager version, then download the file to a directory on your server. For example, iMan_27711_linux.tgz
To extract to the iManager folder, use the following command:

tar -zxvf iMan_27711_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) installation, enter:

./iManagerInstallLinux.bin

To do a GUI install, enter:

./iManagerInstallLinux.bin -i gui

After a successful installation, the installer generates a configuration file (/var/log/installer.properties) with values based upon the questions asked during the installation process. This file can then be modified and used for a silent installation. See Silent Installation of iManager Server.
On the iManager splash screen, select a language, then click OK.
At the Upgrade prompt, select Upgrade.
Read through the Introduction, then click Next.
Accept the license agreement, then click Next.

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.
On the Enable IPV6 window, click Yes to enable IPv6, then click Next.

Alternatively, you can enable IPv6 after installing iManager using the following steps:
1. Open <USER_INSTALL_DIR>\Tomcat\conf\catalina.properties file.
2. Set the following configuration entries in the catalina.properties file:
```
java.net.preferIPv4Stack=false              
```
```
java.net.preferIPv4Addresses=true
```
3. Restart Tomcat.
Read the Pre-Upgrade Summary page and click Next.

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 Done to quit the installer.

When the Getting Started page appears, 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 NetIQ iManager 2.7.7 Administration Guide.
(Conditional) If you made backup copies of the server.xml and context.xml configuration files prior to starting the upgrade process, replace the new configuration files with the backup copies.

2.1.7 Upgrading to iManager 2.7.7 Patch 11 on Windows

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 NetIQ iManager 2.7.7 Administration Guide.

(Conditional) If you have modified the server.xml and context.xml configuration files, make a backup copy of the files in a different location before performing the upgrade. The upgrade process replaces the configuration. files.
Extract the iMan_27711_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 OK.
On the introduction page, then click Next.
Accept the license agreement, then click Next.
On the Enable IPV6 window, click Yes to enable IPv6, then click Next.

Alternatively, you can enable IPv6 after installing iManager using the following steps:
1. Open <USER_INSTALL_DIR>\Tomcat\conf\catalina.properties file.
2. Set the following configuration entries in the catalina.properties file:
```
java.net.preferIPv4Stack=false              
```
```
java.net.preferIPv4Addresses=true
```
3. Restart Tomcat.
At the Upgrade prompt, select Upgrade.

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

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

The upgrade process 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.7 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:
1. Make note of the log file path that is specified within the error message in the Install Complete page.
2. In the Install Complete page, click Done.
3. Open the log file.
4. 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 Done 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 NetIQ® iManager Administration Guide.
(Conditional) If you made backup copies of the server.xml and context.xml configuration files prior to starting the upgrade process, replace the new configuration files with the backup copies.