[AIX Solaris HP-UX Linux Windows]

Installing IBM HTTP Server using the GUI

You can use the Installation Manager GUI to install 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.
Complete the following steps to install Installation Manager:
  1. Perform one of the following procedures:
    • If you want to use the Installation Manager that is included with this product, perform the following actions:
      1. Obtain the necessary files.
        There are three basic options for obtaining and installing Installation Manager and the product.
        • Access the physical media, and use local installation.

          You can access Installation Manager and the product repositories on the product media. You can install Installation Manager on your system and use it to install the product from the product repositories on the media.

        • Download the files from the Passport Advantage® site, and use local installation.

          Licensed customers can download Installation Manager as well as the necessary product repositories from the Passport Advantage site. You can then install Installation Manager on your system and use it to install the product from the repositories.

        • Download a file from the Installation Manager website, and use web-based installation.
          You can download and unpack a compressed file containing Installation Manager from the IBM Installation Manager website. You can then install Installation Manager on your local system and use it to install the product from the web-based repository located at
          http://www.ibm.com/software/repositorymanager/com.ibm.websphere.IHS.v85 
          Note: This location does not contain a web page that you can access using a web browser. This is a remote web-based repository location that you must add to your Installation Manager preferences before the Installation Manager GUI can access the files in this repository to install the product.
      2. Change to the location containing the Installation Manager installation files, and run one of the following commands:
        Administrative installation:
        • [Windows]install.exe
        • [Linux][AIX][HP-UX][Solaris]./install
        Non-administrative installation:
        • [Windows]userinst.exe
        • [Linux][AIX][HP-UX][Solaris]./userinst
        Group-mode installation:
        [Linux][AIX][HP-UX][Solaris]./groupinst
        Notes on group mode:
        • Group mode allows multiple users to use a single instance of IBM Installation Manager to manage software packages.

          This does not mean that two people can use the single instance of IBM Installation Manager at the same time.

        • [Windows]Group mode is not available on Windows operating systems.
        • If you do not install Installation Manager using group mode, you will not be able to use group mode to manage any of the products that you install later using this Installation Manager.
        • Make sure that you change the installation location from the default location in the current user's home directory to a location that is accessible by all users in the group.
        • Set up your groups, permissions, and environment variables as described in the Group mode road maps in the IBM Installation Manager documentation before installing in group mode.

        The installer opens an Install Packages window.

      3. Make sure that the Installation Manager package is selected, and click Next.
      4. Accept the terms in the license agreements, and click Next.

        The program creates the directory for your installation.

      5. Click Next.
      6. Review the summary information, and click Install.
        • If the installation is successful, the program displays a message indicating that installation is successful.
        • If the installation is not successful, click View Log File to troubleshoot the problem.
    • If you already have Installation Manager Version 1.5.2 or later installed on your system and you want to use it to install and maintain the product, obtain the necessary product files from the physical media or the web.
      There are three basic options for installing the product.
      • Access the physical media, and use local installation.

        You can access the product repositories on the product media. Use your existing Installation Manager to install the product from the product repositories on the media.

      • Download the files from the Passport Advantage site, and use local installation.

        Licensed customers can download the necessary product repositories from the Passport Advantage site. You can then use your existing Installation Manager to install the product from the repositories.

      • Access the live repositories, and use web-based installation.
        You can install Installation Manager on your local system and use it to install the product from the web-based repository located at
        https://www.ibm.com/software/repositorymanager/com.ibm.websphere.IHS.v85 
        Note: This location does not contain a web page that you can access using a web browser. This is a remote web-based repository location that you must add to your Installation Manager preferences before the Installation Manager GUI can access the files in this repository to install the product.

        Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.

  2. Add the product repository to your Installation Manager preferences.
    1. Start Installation Manager.
    2. Go toFile > Preferences.
    3. Select Repositories.
    4. Perform the following actions:
      1. Click Add Repository.
      2. Enter the path to the repository.config file in the location containing the repository files.
        For example:
        • [Windows]C:\repositories\product_name\local-repositories
        • [Linux][AIX][HP-UX][Solaris]/var/repositories/product_name/local-repositories
        or
        https://www.ibm.com/software/repositorymanager/com.ibm.websphere.IHS.v85 
      3. Click OK.
    5. Deselect any locations listed in the Repositories window that you will not be using.
    6. Click Apply.
    7. Click OK.
    8. Click File > Exit to close Installation Manager.

About this task

Complete this procedure to use the Installation Manager GUI to install IBM HTTP Server.

Procedure

  1. Start Installation Manager.
  2. Click Install.
    Note: If you are prompted to authenticate, use the IBM ID and password that you registered with on the program website.

    Installation Manager searches its defined repositories for available packages.

  3. In the Install Packages window, complete the appropriate actions.
    1. Select IBM HTTP Server and the appropriate version.
      Note: If you are installing the trial version of this product, select IBM HTTP Server Trial.

      If you already have IBM HTTP Server installed on your system, a message displays indicating that IBM HTTP Server is already installed. To create another installation of IBM HTTP Server in another location, click Continue.

    2. Click Next.
    Note: If you try to install a newer level of IBM HTTP Server with a previous version of Installation Manager, Installation Manager might prompt you to update to the latest level of Installation Manager when it connects to the repository. Update to the newer version before you continue if you are prompted to do so. Read Installing updates in the Installation Manager documentation for information about automatic updates.
  4. Accept the terms in the license agreements, and click Next.
  5. On the Location panel, specify the installation root directory for the product binaries, which are also referred to as the core product files or system files.

    The panel also displays the shared resources directory and disk-space information.

    The core product files do not change unless you install maintenance.
    Restrictions:
    • Deleting the default target location and leaving an installation-directory field empty prevents you from continuing.
    • Do not use symbolic links as the destination directory.

      Symbolic links are not supported.

    • Be careful on using spaces in the name of the installation directory. Some operating systems allow spaces in the specification of the installation directory. Other operating systems do not allow spaces. See the following examples:
      C:\Program Files (x86)    Windows supported
      /opt/IBM/HTTP Server      Unix NOT supported
      /opt/IBM/HTTPServer       Unix supported
    • Do not use a semicolon in the directory name.

      IBM HTTP Server cannot install properly if the target directory includes a semicolon.

      [Windows]A semicolon is the character used to construct the class path on Windows systems.

    • [Windows]The maximum path length on the Windows XP, Windows Vista, and Windows 7 operating systems is 60 characters.
  6. Click Next.
  7. [Linux][AIX][Solaris] If you are installing on a 64-bit system, choose between a 32-bit or 64-bit HTTP Server environment and click Next.
    Notes:
    • This option displays only if you are installing on a 64-bit system.
    • This does not apply to Solaris x86 64-bit systems.
    • You must select one of the two options.
    • You cannot modify this installation later and change this selection.
  8. Click Next to display the Configuration for IBM HTTP Server panel,
  9. [Windows] On the Configuration for IBM HTTP Server panel, specify your Web server configuration.
    • Specify a port number on which IBM HTTP Server will communicate. The default port is 80.
    • Choose whether to use a Windows service to run IBM HTTP Server.
      Note: You have the option to create a Windows service for IBM HTTP Server on this panel. You can configure the services to run as local system account or a user ID that you specify. The user ID requires the following advanced user rights:
      • Act as part of the operating system
      • Log on as a service
      Important: If you do not select Run IBM HTTP Server as a Windows Service, this instance of IBM HTTP Server cannot be stopped or started by the WebSphere Application Server administrative console. At any time after installation, you can create a new service by running the following command:
      ihs_root/bin/httpd.exe -n new_service_name -k install 
      and then updating the web server definition in the administrative console to reflect the new service name.
    • Determine if your startup type will be automatic or manual.
  10. [AIX HP-UX Solaris] On the Configuration for IBM HTTP Server panel, specify your Web server configuration.

    Specify a port number on which IBM HTTP Server will communicate. The default port is 80.

  11. Click Next.
  12. Review the summary information, and click Install.
    • If the installation is successful, the program displays a message indicating that installation is successful.
      Note: The program might also display important post-installation instructions as well.
    • If the installation is not successful, click View Log File to troubleshoot the problem.
  13. Click Finish.
  14. Click File > Exit to close Installation Manager.

Results

If the installation is successful, the IBM HTTP Server product is installed and the log file is located in the /logs/install/ directory. However, if the product installation fails, see the log.txt file in either the /logs/install/ directory or the $USER/ihslogs/ directory.

What to do next

Set up IBM HTTP Server administration authentication, using the htpasswd utility.

You can get started using Secure Sockets Layer (SSL) connections by making only a few configuration changes, as described in Securing with SSL communications.

[AIX][Windows]You can configure the Fast Response Cache Accelerator to boost performance.

You can also make other configuration changes with Apache directives.