Chapter 2. Installation, Configuration and Maintenance

2.1.  Perform installation of WebSphere components (e.g., IBM HTTP Server (IHS), IBM Assembly and Deploy Tools (IADT), WebSphere Application Server, Fix packs) using the IBM Installation Manager (IIM).


IBM Installation Manager (IIM) is an installation management tool that installs and maintains Installation Manager-based software packages. It is the Eclipse-based tool that enables you to install and modify packages, search for updates, uninstall, and roll back. IBM Installation Manager makes it easier for you to download and install code for a number of IBM software packages.

Starting with WebSphere Application Server V8, Installation Manager V1.4.3.1 or later is used for installation and replaces InstallShield MultiPlatform (ISMP) and Update Installer, which were used to install, update, and uninstall previous versions of WebSphere Application Server. It also replaces the functionality previously provided by the installation factory. Installation Manager V1.4.3.1 comes with WebSphere Application Server V8, but you can also use newer version of Installation Manager to install WebSphere Application Server V8.

Installation Manager was originally introduced to support installation of IBM Rational products and is currently available for all platforms and supports installation of WebSphere, Rational, and other products. A single instance of Installation Manager can manage the product life cycle for any Installation Manager based product from WebSphere, Rational, IBM Lotus and any other brand within IBM.

You can install Installation Manager using one of the following methods:

  • Launchpad installation: A single point of reference for interactively installing the entire application server environment. The launchpad application is included only in the product physical media. When you insert a disk, the launchpad application has the intelligence to start the appropriate launchpad application based on the operating system.

  • GUI installation: You can install using an interactive installation using a graphical user interface.

  • Command-line installation: You can install silently using the Installation Manager command line (imcl) installation command.

  • Console installation: You can install interactively using a command. This method does not include a GUI.

  • Silent installation: You can install using a command where you do not have a GUI or interactive installation option.

Before installing IBM Installation Manager, you must decide in which mode the Installation Manager will run as well as where the binaries and runtime data will reside. You can install Installation Manager in administrator, non-administrator, or group mode. On UNIX systems, you can install in group mode using a predefined user group. All users in the group can then install and run the same instance of the Installation Manager to manage packages.

Only one administrator instance of Installation Manager can be installed. For non-administrators, install only one instance of Installation Manager for each user.

After you have installed Installation Manager, you can use it to install other packages, update or modify them, and so on. The Installation Manager tracks the packages it installs, including selectable features and maintenance updates for products.

There are a number of ways you can interact with the Installation Manager.

  • Wizard mode (GUI mode)

    The Installation Manager includes a number of wizards to help maintain product packages (Update, Modify, Rollback, Uninstall).

    To use the Installation Manager wizard mode, navigate to the Installation Manager install directory and run the following command:

    test317:~ # cd /opt/IBM/InstallationManager/eclipse/
    test317:/opt/IBM/InstallationManager/eclipse # ./IBMIM

    Figure 2.1. Installation Manager GUI

    Installation Manager GUI

  • Command-line mode

    If you cannot use the GUI mode, or have a preference for a non-GUI environment, you can use the command-line mode to manage installations. Using the command-line mode, you can install, update, and uninstall packages, list installed features and packages, list available packages, display version information, import a response file to be used for a silent installation, and obtain help for the command line.

    The imcl command can be found in the IM_install/eclipse/tools/ directory. Example below illustrates how to obtain help for the command-line mode and provides a listing of all commands and options:

    test317:/opt/IBM/InstallationManager/eclipse/tools # ./imcl help
    help, -help, -h, -?  (all, <command>)
        Print short info about available commands and exit.
    input, -input  <script file>
        Execute Installation Manager script file.
    install  <packageId(_Version)(,featureN,featureM,...)>...
        Install packages or specific features.
    listAvailableFixes  <id>_<version>
        List information about available fixes.
        List information about available packages.
        List information about installation directories, shared resources directory, package group names, and installed translations.
    listInstalledFeatures  <id>_<version>
        Specify a package to list installed features.
        List information about packages currently installed on the system.
    modify  <packageID(_Version)>
        Change the installed software packages.  Features can be added or removed from the packages.
    rollback  <packageID(_Version)>...
        Roll Back.
    uninstall  <packageId(_Version)(,featureN,featureM,...)>...
        Uninstall packages or specific features.
        Silently uninstall all installed packages.
    updateAll, -updateAll
        Update all installed packages.
    version, -version
        Print the version of this application and exit.
    viewLog  (logFile)
        Show a list of log files.
        Indicate acceptance of the license agreement.
    -accessRights, -aR  <access rights>
        Define the user as an admin, a nonAdmin or a group.  The default value is admin.  This setting ignores the system status.
    -consoleMode, -c
        Run Installation Manager in console mode.
    -dataLocation, -dL  <data-location>
        Specify a directory to hold internal Installation Manager data.
    -log, -l  <log file>
        Create a log file from the program script execution.
    -nl  <nl>
        Specify desired language to be used.
    -passwordKey, -pK  (<passwordKey>)
        Provides password encryption key in UI or silent mode.
    -preferences  <key>=<value>(,<key2>=<value2>...)
        Specify a preference value or a comma-delimited list of preference values to be used.
    -record  <recordedFile>
        Response file that is recorded.
    -showProgress, -sP
        Show progress.
    -showVerboseProgress, -sVP
        Show verbose progress.
    -silent, -s
        Run Installation Manager in silent mode.
        Stop blocking processes.

  • Console mode

    Another option for interacting with the Installation Manager to manage installations is through the console mode. Console mode is a non-graphical, command-line, and text-based interactive mode for the Installation Manager. In console mode, you can set and examine preferences, install, update, modify, rollback, and uninstall packages.

    To start console mode:

    test317:/opt/IBM/InstallationManager/eclipse/tools # ./imcl -c
    =====> IBM Installation Manager
           1. Install - Install software packages
           2. Update - Find and install updates and fixes to installed software packages
           3. Modify - Change installed software packages
           4. Roll Back - Revert to an earlier version of installed software packages
           5. Uninstall - Remove installed software packages
    Other Options:
           L. View Logs
           S. View Installation History
           V. View Installed Packages
           P. Preferences
           E. Export Data for Problem Analysis
           A. About IBM Installation Manager
           X. Exit Installation Manager

  • Silent mode

    Silent mode allows you to install packages in a non-interactive and non-GUI mode. In a silent mode installation, a response file is used to provide the input for the installation. The three steps to a silent installation are as follows:

    1. Install Installation Manger.

    2. Record a response file.

    3. Run the installation in silent mode.

    Response files can be used to install, update, modify, roll back, and uninstall software packages.

    Creating response files:

    test317:/opt/IBM/InstallationManager/eclipse # ./IBMIM -skipInstall /tmp/imRegistry -record ~/silent_install_reponse_file.xml

    Figure 2.2. Response file recording

    Response file recording

    Using response files:

    test317:/opt/IBM/InstallationManager/eclipse/tools # ./imcl -acceptLicence input ~/silent_install_reponse_file.xml -log /tmp/install_log_file.xml

Professional hosting         Free 'Oracle Certified Expert Web Services Developer 6' Guide     Free SCDJWS 5.0 Guide