[AIX Solaris HP-UX Linux Windows]

Installing, updating, rolling back, and uninstalling IBM HTTP Server

IBM® Installation Manager is a common installer for many IBM software products that you use to install, update, roll back, and uninstall IBM HTTP Server.

Before you begin

Note: For new installations of version 8.5.5.11 and higher, the default Java SDK is Java SE 8. Java 8 is the recommended Java SDK because it provides the latest features and security updates. You can continue to use Java SE 6, but no service can be provided after the end of support in April 2018, which could expose your environment to security risks.
Restrictions:
  • Before you can successfully install IBM HTTP Server, ensure that your environment meets the prerequisites for the application server. For more information, see the Preparing the operating system for product installation topic.
  • [Linux]For any Linux® system that is enabled for Security Enhanced Linux (SELinux), such as Red Hat Enterprise Linux Version 5 or SUSE Linux Enterprise Server Version 11, you must identify the Java™ shared libraries in the Installation Manager 1.4.2 or later installation image to the system. Also, you must identify the Java shared libraries in the Installation Manager 1.4.2 or later installation after it has been installed. For example:
    chcon -R -t texrel_shlib_t ${IM_Image}/jre_5.0.3.sr8a_20080811b/jre/bin
    chcon -R -t texrel_shlib_t ${IM_Install_root}/eclipse/jre_5.0.3.sr8a_20080811b/jre/bin 

About this task

Complete one of these procedures to install, update, roll back, or uninstall IBM HTTP Server using Installation Manager.

Procedure

Results

Notes on logging and tracing:
  • An easy way to view the logs is to open Installation Manager and go to File > View Log. An individual log file can be opened by selecting it in the table and then clicking the Open log file icon.
  • Logs are located in the logs directory of Installation Manager's application data location. For example:
    • [Windows]Administrative installation:
      C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager
      
      
    • [Windows]Non-administrative installation:
      C:\Documents and Settings\user_name\Application Data\IBM\Installation Manager
      
      
    • [Linux][AIX][HP-UX][Solaris]Administrative installation:
      /var/ibm/InstallationManager
      
      
    • [Linux][AIX][HP-UX][Solaris]Non-administrative installation:
      user_home/var/ibm/InstallationManager
      
      
  • The main log files are time-stamped XML files in the logs directory, and they can be viewed using any standard Web browser.
  • The log.properties file in the logs directory specifies the level of logging or tracing that Installation Manager uses.
Notes on troubleshooting:
  • [HP-UX]By default, some HP-UX systems are configured to not use DNS to resolve host names. This could result in Installation Manager not being able to connect to an external repository.

    You can ping the repository, but nslookup does not return anything.

    Work with your system administrator to configure your machine to use DNS, or use the IP address of the repository.

  • In some cases, you might need to bypass existing checking mechanisms in Installation Manager.
    • On some network file systems, disk space might not be reported correctly at times; and you might need to bypass disk-space checking and proceed with your installation.
      To disable disk-space checking, specify the following system property in the config.ini file in IM_install_root/eclipse/configuration and restart Installation Manager:
      cic.override.disk.space=sizeunit  
      where size is a positive integer and unit is blank for bytes, k for kilo, m for megabytes, or g for gigabytes. For example:
      cic.override.disk.space=120 (120 bytes)
      cic.override.disk.space=130k (130 kilobytes)
      cic.override.disk.space=140m (140 megabytes)
      cic.override.disk.space=150g (150 gigabytes)
      cic.override.disk.space=true
      Installation Manager will report a disk-space size of Long.MAX_VALUE. Instead of displaying a very large amount of available disk space, N/A is displayed.
    • To bypass operating-system prerequisite checking, add disableOSPrereqChecking=true to the config.ini file in IM_install_root/eclipse/configuration and restart Installation Manager.
    If you need to use any of these bypass methods, contact IBM Support for assistance in developing a solution that does not involve bypassing the Installation Manager checking mechanisms.
  • Installation Manager might display a warning message during the uninstallation process.

    Uninstalling IBM HTTP Server using Installation Manager requires that the data repositories remain valid and available.

    A warning message is displayed by Installation Manager to alert you when repositories are not available or connected. A similar warning message might display after you add or modify data repository connection preferences in Installation Manager.

    If Installation Manager detects missing data repositories or fails to connect to repositories during the uninstallation process, complete the following actions:
    1. Click Cancel to end the uninstallation task.
    2. Select File > Preferences > Repositories, and add the appropriate data repositories that you can connect to successfully.
    3. Exit Installation Manager.
    4. Restart Installation Manager.
    5. Uninstall IBM HTTP Server.
  • For more information on using Installation Manager, read the IBM Installation Manager Information Center.
    Read the release notes to learn more about the latest version of Installation Manager. To access the release notes, complete the following task:
    • [Windows]Click Start > Programs > IBM Installation Manager > Release Notes®.
    • [Linux][AIX][HP-UX][Solaris]Go to the documentation subdirectory in the directory where Installation Manager is installed, and open the readme.html file.