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.6 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:

  1. Log in to iManager.

  2. Click Configure > Plug-in Installation > Available Novell Plug-in Modules. The Available Novell Plug-in Modules page is displayed.

  3. Navigate to the Novell Downloads Web site and download the latest support pack or patch.

  4. In iManager, under Novell Plug-in Modules, click Add.

  5. Browse to select the NPM file downloaded with the support pack or patch, then click OK.

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

  7. If iManager displays the License Agreement page, read the License Agreement, select I Agree

  8. Click OK. The progress indicator is displayed. If you want to stop the installation, click Stop.

  9. 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.
    
  10. 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.6 on Linux

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

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

  2. Use the following command to extract to the iManager folder:

    tar -zxvf iMan_276_linux.tgz

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

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

  5. On the iManager splash screen, select a language, then click OK.

  6. At the Upgrade prompt, select Upgrade.

  7. Read through the Introduction, then click Next.

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

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

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

2.1.4 Upgrading to iManager 2.7.6 on Windows

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.

  1. Extract the iMan_276_win.zip file into the iManager folder.

  2. Run the iManagerInstall.exe file from the extracted_directory\iManager\installs\win folder.

  3. On the iManager splash screen, select a language, then click OK.

  4. On the introduction page, then click Next.

  5. Accept the license agreement, then click Next.

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

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

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

    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:

    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)
      
  9. 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 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.

2.1.5 Upgrading to iManager 2.7.6.1 on Linux

To install the latest version of iManager, you must have iManager 2.7.6 installed on your system.

Upgrading to iManager Server 2.7.6.1

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

  2. Use the following command to extract to the iManager folder:

    iManager276_Patch1_Linux.tar.gz

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

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

  5. Follow the on-screen installation instructions to install the latest patch.

  6. At the restart warning prompt, click OK to restart Tomcat.

    By default, Tomcat is restarted after installation in silent mode installation.

Upgrading to iManager Workstation 2.7.6.1

To upgrade iManager workstation to the latest version:

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

  2. Run the following command to extract to the iManager folder:

    iManager276_Patch1_Linux. tar -zxvf tar.gz

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

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

  5. After successful installation, relaunch iManager to view the latest changes.

IMPORTANT: The Roll back feature is not supported in iManager patch releases.

2.1.6 Upgrading to iManager 2.7.6.1 on Windows

To upgrade iManager to the latest patch, you must have iManager 2.7.6 installed on your system.

Upgrading to iManager Server 2.7.6.1

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

  2. Extract the iManager276_Patch1_Windows.zip file into the iManager folder.

  3. Run the patchInstallWin.exe file from the extracted_directory\iManager\installs\win folder to install the latest patch.

  4. Follow the on-screen instructions to complete the installation.

  5. At the restart warning prompt, click OK to restart tomcat. In silent mode installation, by default, Tomcat is restarted after installation.

Upgrading to iManager Workstation 2.7.6.1

To upgrade iManager workstation to the latest version:

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

  2. Extract the iManager276_Patch1_Windows.zip file into the iManager folder.

  3. Browse to the folder where you have extracted iManager 2.7.6 patch 1.

  4. Run the patchInstallWin.exe file from the extracted_directory\imanager\Windows folder to install the latest patch.

  5. Specify the Tomcat path of the workstation.

  6. Follow the on-screen instructions to complete the installation.

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

  8. Run the following command at the command prompt.

    patchInstallWin.exe -i silent -f install.properties

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

2.1.7 Reinstalling iManager 2.7.6.1 on Linux and Windows

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:

  • INSTALLER_UI = silent

  • FORCE_INSTALL_MODE=true

    By default, FORCE_INSTALL_MODE value is set to False.

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

2.1.8 Silent Upgrade of iManager Server on Linux and Windows

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.

  1. Open a console window and browse to the directory that contains the iManager file you downloaded.

  2. On the command line, run the following command:

    For Linux:

    ./iManagerInstall<platform>.bin -i silent

    For Windows:

    iManagerInstall.exe -i silent