1.5 Installing a New Version of iManager

Novell iManager 2.7.6 can be installed on the platforms listed below. In general, you should apply the latest Service Packs for your platform and meet the prerequisites listed in Section 1.2, Prerequisites, before installing iManager.

IMPORTANT:Do not install this patch on an OES server. The patch channel must be used instead.

1.5.1 iManager Server on Linux

If the iManager 2.7.6 installation detects previously installed version of iManager 2.7.x, it prompts you to upgrade. If you continue, the existing JRE and Tomcat will be removed and the latest JRE and Tomcat versions will be installed. This will also upgrade the iManager to the latest version. If you do not want this to happen, stop the installation.

To prepare for the installation, review the checklist of prerequisites provided in Section 1.2.1, General Prerequisites and Section 1.2.2, Linux Prerequisites.

iManager installs the following products during installation:

  • Tomcat 7.0.32

  • Java 1.7.0_04

  • Novell International Cryptographic Infrastructure (NICI) 2.7.6

Procedure

  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 opening iManager splash screen, select a language, then click OK.

  6. Read through the Introduction, then click Next.

  7. Accept the license agreement, then click Next.

  8. Specify the components to install as part of the iManager installation, then click Next.

    You can select one of the following options:

    1. Novell iManager 2.7.6, Tomcat, JVM.

      Ensure that you select this option to install JVM and Tomcat that comes along with iManager.

    2. Novell iManager 2.7.6

    3. Tomcat, JVM

  9. Specify if you want to download and install plug-ins as part of the installation, then click Next.

  10. (Conditional) To download plug-ins as part of the installation, specify the plug-ins you want to download, then click Next.

    • For a console install, enter a comma-separated list of the plug-in numbers to download.

    • For a GUI install, select the check boxes. Default selections are already made.

    If the message No new or updated plug-ins found. All plug-ins are downloaded or updated or the iManager download server is unavailable appears in the plug-in download area, one or more of the following conditions exist:

    • There are no updated plug-ins available on the Novell download site.

    • There is a problem with your Internet connection. Verify your connection and try again.

    • Connection to the Novell Descriptor File was not successful.

    • The iManager install is behind a proxy that does not allow a connection to the above URL

  11. Specify if you want to install plug-ins from a local drive, then click Next.

  12. (Conditional) To install plug-ins from a local directory, specify the directory path that contains the appropriate plug-in (.npm) files.

    The default path is /extracted location/iManager/installs/plugins, but you can specify any valid mount point here.

    If desired, you can specify an alternative URL for downloading plug-ins. For more information, see Section 1.4, Downloading and Installing Plug-Ins During Installation. When using an alternative URL for downloading plug-ins, it is solely your responsibility to verify the URL contents, and verify that the plug-in is appropriate for your use.

  13. Specify the ports on which you want Tomcat to run.

    The defaults are 8080 for HTTP, 8443 for HTTPS, and 9009 as the MOD_JK connector port.

  14. (Optional) Specify an authorized user and the appropriate eDirectory tree name that this user will manage, then click Next.

    This information is not used to authenticate to eDirectory during installation and the information is not validated in any way. Make sure you use the syntax required by the iManager login page.

    If you leave these fields blank, iManager allows any user to install plug-ins and make changes to iManager server settings (not recommended long-term.) Specify an authorized user post-install from the Configure > iManager Server > Configure iManager > Security page in iManager. For more information, see iManager Authorized Users and Groups in the Novell iManager 2.7.6 Administration Guide.

  15. Read the Pre-Installation Summary page and click Next.

    During installation, iManager files are installed, plug-ins are downloaded, and configuration changes occur. Installation can take several minutes.

    After the installation completes, the Install Complete page, which displays the successful/unsuccessful installation message, is displayed.

  16. 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:When you install iManager on Linux, the following files from InstallAnywhere are given with writeable permissions:

  • /var/opt/novell/tomcat7/webapps/nps/UninstallerData/.com.zerog.registry.xml

  • /var/opt/novell/tomcat7/webapps/nps/UninstallerData/Uninstall_<PluginName>/.com.zerog.registry.xml

    <PluginName> - The name of the plug-in installed on iManager.

You must change the permissions from 600 to 644 using the chmod command. However, you should not modify the content in the files. If you modify the files, any change might impact the other installations that use InstallAnywhere.

1.5.2 iManager Server on Windows

If the iManager 2.7.6 installation routine detects a previously installed version of iManager 2.7.x, it prompts you that it will remove the existing iManager ,jre and Tomcat. If you do not want this to happen, stop the installation.

However, when removing the previously installed version of iManager, its directory structure is backed up to the old TOMCAT_HOME directory to preserve any previously created custom content.

To prepare for the installation, review the checklist of prerequisites provided in Section 1.2.1, General Prerequisites and Section 1.2.3, Windows Prerequisites.

iManager can install the following products during installation:

  • Tomcat 7.0.32

  • Java 1.7.0_04

  • Novell International Cryptographic Infrastructure (NICI) 2.7.6

Procedure

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. Log in as a user with administrator privileges to install iManager.

  2. At the Novell Downloads Web site, search for iManager products, select iManager 2.7.6, then download it to a directory on your server.

  3. Extract the file into the iManager folder.

  4. Run iManagerInstall.exe (extracted_directory\iManager\installs\win).

    You can view the debug output of the installation program by holding down the Ctrl key immediately after launching the installer. Continue to hold down the key until a console window appears. For more information on debugging, see Troubleshooting in the Novell iManager 2.7.6 Administration Guide.

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

  6. On the introduction page, click Next.

  7. Accept the license agreement, then click Next.

  8. Read the Detection Summary page, then click Next.

    The Detection Summary displays currently installed Servlet container and JVM software that iManager will use once it is installed, and supporting components that are installed as part of the iManager install. Use the Browse button to modify the list of installed components if the correct version is not listed.

    The Get PORT Input window is displayed.

  9. Mention the HTTP and SSL port numbers on which Tomcat server must run on, and click Next.

    By default, the HTTP port and SSL port values are 8080 and 8443, respectively. However, if you have any other service or Tomcat server configured on the default ports, you can configure ports of your choice.

    The Choose Install Folder window is displayed.

  10. Specify the install folder, then click Next.

    The default installation location is C:\Program Files\Novell.

  11. Select the plug-ins to download and install, then click Next.

    If desired, you can specify an alternative URL. For more information, see Section 1.4, Downloading and Installing Plug-Ins During Installation. When using an alternative URL for downloading plug-ins, it is solely your responsibility to verify the URL contents, and verify that the plug-in is appropriate for your use.

    If the message No new or updated plug-ins found.All the plug-ins are downloaded or updated or the iManager download server is unavailable appears in the plug-in download area, one or more of the following conditions exist:

    • There are no updated plug-ins available on the Novell download site.

    • There is a problem with your Internet connection. Verify your connection and try again.

    • Connection to the Novell Descriptor File was not successful.

    • The iManager install is behind a proxy that does not allow a connection to the above URL

  12. (Optional) Select plug-ins to install from the local disk drive, then click Next.

    This lets you to install previously downloaded or custom plug-ins during the installation.

  13. (Optional) Specify an authorized user and the appropriate eDirectory tree name that this user will manage, then click Next.

    This information is not used to authenticate to eDirectory during installation and the information is not validated in any way. Make sure you use the syntax required by the iManager login page.

    If you leave these fields blank, iManager allows any user to install plug-ins and make changes to iManager server settings (not recommended long-term.) Specify an authorized user post-install from the Configure > iManager Server > Configure iManager > Security page in iManager. For more information, see iManager Authorized Users and Groups in the Novell iManager 2.7.6 Administration Guide.

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

    During installation, iManager files are installed, plug-ins are downloaded, and configuration changes occur. Installation can take several minutes.

    After the installation completes, the Install Complete page, which displays the successful/unsuccessful installation message, is displayed.

    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 installer displays the error message, 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)
      
  15. 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.

1.5.3 iManager Workstation on Linux Clients

iManager Workstation is a self-contained environment. Therefore, you can install multiple versions on the same workstation (including older versions of Mobile iManager). However, you should not attempt to run them simultaneously. If you need to use different versions, run one version, close it, and then run the other version.

To prepare for the installation, review the checklist of prerequisites provided in Section 1.2.1, General Prerequisites and Section 1.2.4, iManager Workstation on Linux Prerequisites.

iManager installs the following products during installation:

  • Tomcat 7.0.32

  • Java 1.7.0_04

  • Novell International Cryptographic Infrastructure (NICI) 2.7.6

Procedure

  1. At the Novell Downloads Web site, search for iManager products, select iManager 2.7.6, then download iMan_276_workstation_linux.tar.bz2 to a directory on your server.

  2. Extract the file using the following command:

    tar -xjvf iMan_276_workstation_linux.tar.bz2

    The extraction creates an imanager folder in the same folder where iManager Workstation’s tar.bz2 file is located.

  3. Log in as root, or a root-equivalent, and install the Novell International Cryptography Infrastructure (NICI) software.

    To do this, execute the following command from the imanager/NICI/linux directory:

    rpm -Uvh nici.i386.rpm
    

    On desktops where NICI is not installed, this command installs NICI. On desktops where NICI is already installed, this command upgrades NICI.

  4. If you plan to run iManager Workstation as a non-root user in the future, do not run iManager as root the first time. Navigate to the imanager/bin directory and execute the iManager Workstation startup script.

    ./iManager.sh
    
  5. When the iManager login screen appears, specify a user name, password, and eDirectory tree.

    To access iManager, see Accessing iManager in the Novell iManager 2.7.6 Administration Guide.

If you upgraded from a previous version of iManager, see Section 2.0, Upgrading iManager.

1.5.4 iManager Workstation on Windows Clients

Because iManager Workstation is a self-contained environment, you can install multiple versions on the same workstation (including older versions of Mobile iManager.) However, you should not attempt to run them simultaneously. If you need to use different versions, run one version, close it, and then run the other version.

To prepare for the installation, review the following checklist of prerequisites.

Prerequisites

  • Additional Configuration: If you configure Internet Explorer to use a proxy server for your LAN, then you must also select the Tools > Internet Options > Connections > LAN Settings > Bypass Proxy Server for Local Addresses option.

  • Processor: Pentium III 600 MHz or higher processor

  • Disk Space: 200 MB minimum

  • Memory: 256 MB of RAM (512 MB recommended)

  • Do not run iManager Workstation from a path with spaces in it.

  • If you are running a Novell Client earlier than version 4.91, make sure that the Novell Modular Authentication Service (NMAS) client is already installed on the workstation before launching iManager Workstation.

  • Running iManager Workstation from a path where any directory contains temp or tmp in the name is not supported. If you do this, iManager plug-ins won't install. Run iManager Workstation from C:\imanager or some other permanent directory, rather than c:\temp\imanager or d:\tmp\imanager or c:\programs\temp\imanager

  • The first time you run iManager Workstation on a Windows workstation, you must do so as a user that is a member of the workstation's Administrators group.

iManager installs the following products during installation:

  • Tomcat 7.0.32

  • Java 1.7.0_04

  • Novell International Cryptographic Infrastructure (NICI) 2.7.6

Procedure

  1. At the Novell Downloads Web site, search for iManager products, select iManager 2.7, then download iMan_276_workstation_win.zip.

  2. Using any ZIP program, extract the iMan_276_workstation_win.zip file to a folder.

  3. With a file browser, navigate to the imanager\bin folder.

  4. To execute the script, double-click the iManager.bat file.

  5. When the iManager login page appears, enter your user name, password, and tree.

    To access iManager, see Accessing iManager in the Novell iManager 2.7.6 Administration Guide.

If you upgraded from a previous version of iManager, see Section 2.0, Upgrading iManager.