1.5 Installing a New Version of iManager

NetIQ iManager 2.7.7 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.7 Server setup program detects a previously installed version of iManager 2.7.x, it gives you the option to stop the installation process or remove the existing iManager, jre, and Tomcat installations.

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

  • Java 1.7.0_25

  • Novell International Cryptographic Infrastructure (NICI) 2.7.7

Procedure

  1. At the Novell Downloads Web site, search for iManager products, select iManager 2.7.7, then download iMan_277_linux.tgz to a directory on your server.

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

    tar -zxvf iMan_277_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:

    ./iManagerInstallLinux.bin

    To do a GUI install:

    ./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. You can modify this file for use in a silent installation. See Section 1.6, Silent Installation of iManager Server.

  5. On the 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. NetIQ iManager 2.7.7, Tomcat, JVM.

      NOTE:Ensure that you select only this option. iManager will not work as expected if the any of the other two options is selected.

    2. NetIQ iManager 2.7.7

    3. Tomcat, JVM

  9. 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 the /var/opt/novell/tomcat7/conf/catalina.properties file.

    2. Set the following configuration entries in the catalina.properties file:

      java.net.preferIPv4Stack=false             
      
      java.net.preferIPv4Addresses=true
      

      Note that java.net.preferIPv4Stack applies for iManager to work with eDirectory and java.net.preferIPv4Addresses applies for browsers to work with iManager.

    3. Restart Tomcat.

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

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

    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 Descriptor File was not successful.

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

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

  13. (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, you must verify the URL contents, and verify that the plug-in is appropriate for your use.

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

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

    If you leave these fields blank, iManager allows any user to install plug-ins and make changes to iManager server settings. NetIQ does not recommend leaving these settings blank. 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 NetIQ iManager 2.7.7 Administration Guide.

  16. Read the Pre-Installation Summary page, and then click Next.

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

IMPORTANT:When you install iManager on Linux, the following files from InstallAnywhere are given write 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.7 Server setup program detects a previously installed version of iManager 2.7.x, it gives you the option to stop the installation process or remove the existing iManager, jre, and Tomcat installations.

When the setup program removes the previously installed version of iManager, it backs up the directory structure 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.42

  • Java 1.7.0_25

  • Novell International Cryptographic Infrastructure (NICI) 2.7.7

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

  1. Log in as a user with administrator privileges.

  2. At the Novell Downloads Web site, search for iManager products, select iManager 2.7.7, then download iMan_277_win.zip 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 NetIQ iManager 2.7.7 Administration Guide.

  5. On the 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.

    The Detection Summary page lists the 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.

  9. (Optional) Use the Browse button to modify the list of installed components, if the correct version is not listed.

  10. Click Next.

  11. On the Get PORT Input window, specify 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.

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

  13. Specify the install folder, then click Next.

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

  14. 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 Descriptor File was not successful.

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

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

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

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

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

    NOTE: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.
    
  18. (Conditional) 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 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)
      
  19. Click Done to quit the setup program.

    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.

1.5.3 iManager Workstation on Linux Clients

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

  • Java 1.7.0_25

  • Novell International Cryptographic Infrastructure (NICI) 2.7.7

Procedure

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

  2. Use the following command to extract the file:

    tar -xjvf iMan_277_workstation_linux.tar.bz2

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

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

  4. Execute the following command from the imanager/NICI/linux directory:

    rpm -Uvh nici.i586.rpm
    

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

  5. (Conditional) 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
    
  6. When the iManager login screen appears, specify a user name, password, and eDirectory tree.

    To access iManager, see Accessing iManager in the NetIQ iManager 2.7.7 Administration Guide.

  7. To enable IPv6, complete 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.

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

  • Java 1.7.0_25

  • Novell International Cryptographic Infrastructure (NICI) 2.7.7

Procedure

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

  2. Extract the iMan_277_workstation_win.zip file to a folder.

  3. Navigate to the imanager\bin folder.

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

  6. To enable IPv6:

    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.

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