7.1 Planning to Install iManager

This section provides the prerequisites, considerations, and system setup needed to install iManager. First, consult the checklist to understand the installation process.

7.1.1 Checklist for Installing iManager

Before beginning the installation, NetIQ recommends that you review the following steps:

Checklist Items

  1. Review the planning information. For more information, see Section I, Planning to Install Identity Manager.

  1. Review the hardware and software requirements for the computers that will host iManager. For more information, see Meeting System Requirements.

  1. Understand the difference between iManager and iManager Workstation. For more information, see Understanding the Server and Client Versions of iManager.

  1. Access the installation files for iManager, located by default in the \products\iManager\installs\server_platform\ directory within the .iso image file for the Identity Manager installation package.

    Alternatively, download the installation files from the NetIQ Downloads website. Search for iManager products, select the iManager version that you want, then download the win.zip file to a directory on your server. For example, iMan_31_win.zip.

  1. (Optional) To learn more about the process for installing plug-ins, see Understanding Installation for iManager Plug-ins.

  1. (Optional) To review actions that you can perform after installing iManager, see Post-Installation Tasks for iManager.

  1. To install iManager and iManager Workstation, see the following sections:

7.1.2 Understanding the Server and Client Versions of iManager

You must install iManager on a server that can access an eDirectory tree. To install iManager on a workstation instead of a server, you need the client-based version of iManager, the iManager Workstation. Use the following guidelines to decide which version fits best in your environment, or whether your eDirectory management policies would benefit from installing both versions:

  • If you have a single administrator who always manages eDirectory from the same client workstation, you can take advantage of iManager Workstation. iManager Workstation is fully self-contained and requires little setup. It automatically starts and stops the resources it needs when it loads or unloads. iManager Workstation installs and runs on various Windows client workstations, has no dependencies on server-based iManager, and it can co-exist with any other versions of iManager installed on your network.

    iManager plug-ins do not automatically synchronize between iManager instances. If you have multiple administrators and use customized plug-ins, iManager Workstation and these plug-ins must be installed on each administrator’s client workstation.

  • If you manage eDirectory from multiple client workstations, or have multiple administrators, install iManager Server so that it is available from any connected workstation. Additionally, customized plug-ins only need to be installed once per iManager Server.

7.1.3 Understanding Installation for iManager Plug-ins

By default, the plug-in modules are not replicated between iManager servers. You must install the plug-in modules that you want on each iManager server.

In a clean install, the setup program preselects the “typical” plug-ins. For an upgrade, only plug-ins that need to be updated are preselected. You can override the default selections and add new plug-ins to download. However, for an upgrade, NetIQ recommends that you do not unselect any plug-in that was pre-selected. As a general rule, you should always upgrade plug-ins that you installed with a previous version of iManager. Also, more recent plug-ins might not be compatible with previous versions of iManager.

The base plug-ins for iManager are available only as part of the complete iManager software download (for example, eDirectory administrative plug-ins). Unless there are specific updates to these plug-ins, you can only download and install them with the entire iManager product.

The installation program uses an XML descriptor file, iman_mod_desc.xml, to identify the plug-ins that are available for downloading. The default URL for the file is . However, you can point the installation program to an alternative network URL. For example, you might be installing iManager behind a proxy or firewall that prevents the installation program from accessing the default URL.

For instructions about downloading and installing plug-ins, see the steps in one of the following sections:

For more information about customizing the process for downloading and installing plug-ins, see “Downloading and Installing Plug-in Modules” in the NetIQ iManager Installation Guide.

7.1.4 Prerequisites and Considerations for Installing iManager

This section provide information for installing server and workstation versions of iManager.

General Considerations for Installing iManager

Before installing iManager, review the following considerations:

  • Identity Manager 4.7 supports eDirectory 9.1. Use iManager 3.1. For more information, see iManager 3.1 Installation Guide.

  • If you plan to have more than 10 administrators regularly working in iManager at the same time, do not install iManager on the same server as other Identity Manager components.

  • If you plan to have only one administrator, you can install iManager on the same server as the Identity Manager engine.

  • If the iManager Server setup program detects a previously installed version of iManager, you can stop the installation process or remove the existing iManager, JRE, and Tomcat installations.

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

  • You cannot run iManager Workstation from a path that includes spaces. For example, C:\NetIQ\iManager Workstation\working.

  • You must have Administrator access for Windows servers.

  • To create a Role-Based Services (RBS) collection in the eDirectory tree, you must have admin-equivalent rights.

  • To run the iManager RBS Configuration Wizard, you must have admin-equivalent rights.

  • To manage the same eDirectory tree with multiple versions of iManager, you must update your RBS Collection(s) to the latest iManager version.

Considerations for Installing iManager Server

If you are using Microsoft Internet Information Services (IIS) or Apache HTTP Server, you must manually integrate iManager with these web server infrastructures. By default, iManager uses Tomcat.

Considerations for Installing iManager Workstation

Before installing iManager Workstation on your Windows clients, NetIQ recommends that you review the following considerations:

  • To enable Internet Explorer to use a proxy server for your LAN, you must specify Bypass Proxy Server for Local Addresses under Tools > Internet Options > Connections > LAN Settings.

  • To run a Novell Client earlier than version 4.91, the NetIQ Modular Authentication Service (NMAS) client must be installed on the workstation before you launch iManager Workstation.

  • If you run iManager Workstation from a path where any directory contains temp or tmp in the name, such as c:\programs\temp\imanager, iManager plug-ins do not install. Instead, run iManager Workstation from C:\imanager or a non-temporary directory.

  • The first time that you run iManager Workstation on a Windows workstation, use an account that is a member of the workstation's Administrators group.