Installing HATS

With the information in this chapter you can:

Note:
HATS V7.5.1 can be installed as a full software package using the IBM® Installation Manager Install function. It can also be installed as a fix pack to HATS V7.5 using the IBM Installation Manager Update function.

Prerequisites

IBM Installation Manager Version 1.3.3, or later, is required to install HATS Toolkit.

Note:
For more about IBM Installation Manager, see the information center at http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp.

When you install HATS V7.5.1 using the IBM Installation Manager, the installation process checks that prerequisite packages and features are already installed. If not, a message is displayed, and the install does not proceed. The following sections list the prerequisite packages and features that must already be installed.

IBM Rational HATS

For IBM Rational® HATS (HATS):

If none of the required Rational SDP packages are installed, HATS will not install. If this occurs, use the Install function of the IBM Installation Manager to install one of the required packages along with the required features. Then start the HATS install again.

If one of the required Rational SDP packages is installed without the required features, HATS will not install. If this occurs, use the Modify function of IBM Installation Manager to add the required features. Then start the HATS install again.

IBM WebFacing Tool for IBM i feature

For the IBM WebFacing Tool for IBM i feature (WebFacing):

Note:
The Rational SDP packages must be installed in the same package group.

If the prerequisites are not satisfied, the WebFacing feature cannot be selected for installation. If this occurs, use the Install or Modify function, as appropriate, of the IBM Installation Manager to install the prerequisites. Then use the Modify function to install WebFacing.

Portal support for IBM WebFacing Tool for IBM i feature

For the Portal support for IBM WebFacing Tool for IBM i feature (Portal for WebFacing):

If the prerequisites are not satisfied, the Portal for WebFacing feature cannot be selected for installation. If this occurs, use the Modify function of IBM Installation Manager to install the prerequisites. Then use the Modify function to install Portal for WebFacing.

There are other hardware and software prerequisites for the system where you install HATS Toolkit, the systems where you deploy HATS applications, WebSphere Application Server, WebSphere Portal, or rich client platform systems, and the browsers with which your users will interact with HATS Web applications. See the HATS Information Center at http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp for the current list of supported hardware and software prerequisites. In the Contents under HATS prerequisites, select Detailed System Requirements.

Installing HATS Toolkit

To install HATS Toolkit:

  1. Verify that your system meets all the prerequisites. For more information see Prerequisites.
  2. HATS is structured as an Eclipse offering that is installed to a Rational SDP system using IBM Installation Manager.
  3. You must be logged on with Administrator privileges.
  4. If you are installing from a CD and autorun is enabled, then the launchpad starts automatically when you insert the installation disk into your CD drive. If autorun is not enabled, or if you are installing from an electronic image, run the launchpad.exe program located in the root directory of the CD or located in the root directory of the extracted electronic image of the installation disk.
  5. Select the language for the launchpad. Click OK.
  6. The IBM Rational HATS V7.5.1 window appears. From this window you can install the product and view release information. Be sure to click Release Notes to review last-minute information.
  7. When you are ready to install HATS Toolkit, click Install IBM Rational HATS V7.5.1 which launches the IBM Installation Manager.
    Note:
    If IBM Installation Manager is not installed an error message is displayed.
  8. The IBM Installation Manager window appears.
  9. On the Install Packages panel, the box for IBM Rational HATS is selected for you. Click Next.
    Note:
    An error message is displayed if the required level of IBM Installation Manager is not installed.
  10. On the Licenses panel, read and accept the terms in the license agreement, and click Next.
  11. On the Location panel, under Package Group Name, select the package group where you want to install HATS, for example IBM Software Delivery Platform, and click Next.
    Note:
    You must select an existing package group where you have installed the prerequisite software delivery products.
  12. On the Features panel, in addition to HATS, you can select for installation the following HATS features. Click Next.
    Notes:
    1. You can install these features at a later time by using the Modify function of IBM Installation Manager. For more information see Modifying the HATS Toolkit installation.
    2. For prerequisite information see Prerequisites.
  13. On the Summary panel, click Install.
  14. You will see a progress bar as the installation proceeds and Start menu items are created.
  15. On the Install Packages panel, you are informed if the installation was completed successfully. If necessary, you can click View Log File to view the installation log. Click Finish to close the installation panel.
Notes:
  1. All languages supported by HATS and the HATS features are installed during the installation process.
  2. HATS cannot be installed at the same time you install the prerequisite level of Rational SDP and features. You must complete the installation of the prerequisite level of Rational SDP and features before installing HATS.

Updating the HATS Toolkit installation

You can install HATS V7.5.1 fix packs using the update functionality of the IBM Installation Manager. By default, Internet access is required unless your repository preferences point to a local update site. For Installation Manager to search the IBM update repository locations for the HATS updates, the preference, Search service repositories during installation and updates, on the Repositories preference page must be selected. This preference is selected by default. See the Installation Manager help for more information.

Note:
HATS V7.0 and HATS V7.1, both of which require Rational SDP V7.0-based products, cannot be updated to HATS V7.5.1. To coexist, either HATS V7.0 or V7.1, and HATS V7.5.1 can be installed in separate package groups. HATS V7.5 can be updated to HATS V7.5.1.

To update the HATS Toolkit:

  1. Start IBM Installation Manager from the Windows® Start menu.
  2. On the initial IBM Installation Manager panel, click Update.
    Note:
    Do not click Install.
  3. Select the package group in which you installed IBM Rational HATS V7.5.1. The default is IBM Software Delivery Platform. The Installed Packages and Fixes list at the bottom of the panel should show IBM Rational HATS 7.5.1.x as one of the entries. Click Next.
  4. Select IBM Rational HATS 7.5.1.x and any other required or optional updates from the list of available updates. Any updates you already have installed will be displayed in grey and will not be selectable. Click Next.
  5. Read and accept the license agreements for the selected updates, and then follow the remaining installation dialogs to install the selected updates.
    Note:
    Depending on the speed of your computer processor, the amount of RAM, and the speed of your Internet connection, the update(s) could take an extended period of time to download and install.
  6. Review your selections on the Summary panel. If you want to make any changes to your selections, click Back and make your changes. When you are ready to install the update, click Update.
  7. When the updates are complete, a message will be displayed by IBM Installation Manager informing you that updates were successfully installed. You can click View Log File to view the log file for the current Installation Manager session. When you are finished, click Finish.
Note:
For more about fix pack contents and install instructions, see the appropriate release notes on the HATS Information Center at http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.

Modifying the HATS Toolkit installation

You can use the IBM Installation Manager to modify an already installed HATS Toolkit. For example, you can add, or remove, any of the HATS features. To add any of the HATS features, follow these steps:

  1. With the HATS CD in the CD-ROM drive or the extracted electronic image of the HATS installation disk accessible, start IBM Installation Manager.
    Note:
    If the HATS CD or electronic image is not already defined as an installation repository, see Adding the HATS installation repository to IBM Installation Manager.
  2. On the initial IBM Installation Manager panel, click Modify.
  3. On the Modify Packages panel, select the package group where you have installed HATS and click Next.
  4. On the Features panel that list languages, click Next.
    Note:
    All languages supported by HATS and the HATS features are installed during the installation process.
  5. On the Features panel that lists the features to add or remove, select any of the following HATS features and click Next.
    Note:
    For prerequisite information see Prerequisites.
  6. On the Summary panel, click Modify.
  7. You will see a progress bar as the installation proceeds.
  8. On the Modify Packages panel, you are informed if the installation was completed successfully. If necessary, you can click View Log File to view the installation log. Click Finish to close the Modify Packages panel.

Use similar steps to remove any of the HATS features.

Adding the HATS installation repository to IBM Installation Manager

The HATS installation program automatically adds the HATS installation directory as a repository in IBM Installation Manager. If for any reason you need to manually add the HATS installation directory as a repository, follow these steps:

  1. From the IBM Installation Manager menu bar, select File > Preferences.
  2. On the Preferences panel, click the Add Repository button.
  3. On the Add a Repository panel, click the Browse button.
  4. On the Select a Repository panel, browse to the HATS CD or the extracted electronic image of the HATS installation disk, in the root directory select the diskTag.inf file, and click OPEN.
    Note:
    If adding a repository for a local installation of a HATS fix pack, browse to the directory where you extracted the fix pack installation files. Inside the directory you will see a hats\updates directory. Change to that directory, select repository.config, and click Open.
  5. On the Add a Repository panel, click OK.
  6. On the Preferences panel, click OK.

Evaluating HATS

Regardless of where you obtain the HATS package (HATS CD, Web, or packaged with another product), you install the same version of the HATS Toolkit. This is a limited-use version that you can use to evaluate HATS. After installation, you must use the License Settings wizard in the HATS Toolkit to fully enable the HATS runtime for production in accordance with your licensed proof of entitlement.

Before purchasing runtime licenses, you can evaluate HATS with minimal restrictions. You can use the HATS Toolkit to develop applications and test them using the local test environments.

HATS Web applications that you develop before you fully enable the HATS runtime are restricted to just two runtime host connections. HATS rich client applications that you develop before fully enabling the HATS runtime allow unlimited host connections in the local test environment but no host connections in a deployed production environment.

After evaluating the HATS Toolkit, if you decide you want to purchase HATS licenses for runtime deployment, you can fully enable the runtime using the License Settings wizard without reinstalling the HATS Toolkit.

Enabling HATS runtime and license settings

You can fully enable the runtimes for HATS Web projects, HATS rich client projects, and WebFacing projects. To fully enable the runtimes for production in accordance with your licensed proof of entitlement, you must specify your license settings using the License Settings wizard included in the HATS Toolkit.

Note:
You must run the License Settings wizard even for projects whose runtimes were fully enabled in previous versions of HATS.

To run the License Settings wizard, follow these steps:

  1. Start the HATS Toolkit.
  2. In the HATS perspective, from the menu bar select HATS > License Settings. In the WebFacing perspective, right-click anywhere in the WebFacing Projects view and select License Settings.
  3. On the Runtime Enablement File panel, if the location of the runtime enablement file is not already set from a previous use of the wizard, use the Browse button to browse for the location of the file.
    Notes:
    1. The runtime enablement file is provided to you on a CD (or image, if you downloaded HATS electronically) separate from the HATS Toolkit.
    2. If you downloaded HATS from the Passport Advantage® Web site, the runtime enablement file is located in the runtime enablement CD image.
    3. If you cannot locate your runtime enablement file, contact your IBM business partner or IBM sales representative, as appropriate. IBM technical service representatives cannot provide you the file. For more information see http://www-01.ibm.com/support/docview.wss?uid=swg21316632.
    4. The name of the runtime enablement file used to fully enable HATS Web, HATS rich client, and WebFacing projects is runtimeenablement75-webrcp.jar. The wizard enables both the HATS and WebFacing runtimes in one step.
    5. You must use the file intended for use with your version of HATS. An error message will display if during this process you try to use a file for an older version of HATS.
  4. After setting the location of the runtime enablement file, click Next.
  5. On the License Options panel the types of projects are displayed with an indication whether they will be enabled or not enabled based on the selected runtime enablement file. Select the license option specified by your Proof of Entitlement. Options are Authorized User or Value Unit. If you specify Authorized User, you must also enter the number of licenses purchased.
  6. Select Apply to all new projects created in any workspace to fully enable the runtime for all new projects, depending on your type of license, created in any workspace.
  7. Select Apply to all existing projects in the current workspace to fully enable the runtime for all projects, depending on your type of license, that exist in the current workspace. If you have existing projects in other workspaces, you must run the License Settings wizard in each of those workspaces.
    Note:
    HATS checks the license settings of projects in a workspace on startup and prompts you to update the license settings if any of the projects don't match the master license settings. For information about how to disable checking the license settings at startup, see the HATS User's and Administrator's Guide.
  8. Click Finish.

Uninstalling HATS Toolkit

When you uninstall the HATS package, the HATS Toolkit and all installed features are uninstalled.

When you uninstall HATS Toolkit, the files for your HATS projects and their resources are not deleted. If you re-install HATS Toolkit you are able to work with projects you have previously created. To delete your HATS project files, delete each project before you uninstall HATS. If you want to delete HATS project files after uninstalling HATS, go to the workspace directory on the file system and delete the HATS project files.

To uninstall HATS Toolkit:

  1. You must be logged on with Administrator privileges.
  2. Close the HATS and WebFacing perspectives and exit from Rational SDP.
    Note:
    When you start Rational SDP, it always tries to reopen the last perspective that was open. To avoid error messages, before you uninstall HATS, close the HATS and WebFacing perspectives before you exit Rational SDP. If HATS or WebFacing were the last perspective open when you uninstall HATS, Rational SDP will issue error messages because it cannot find the files necessary to reopen the perspective. If this occurs, change the perspective, the errors do not harm anything.
  3. Start the IBM Installation Manager from the Start menu.
  4. On the IBM Installation Manager panel, click Uninstall.
  5. On the Uninstall Packages panel, select the IBM Rational HATS package and click Next.
  6. On the Summary panel, click Uninstall.
  7. You will see a progress bar as the installation program uninstalls HATS and the Start menu items.
  8. On the Uninstall Packages panel, you are informed if the uninstallation was completed successfully. If necessary, you can click View Log File to view the uninstall log. Click Finish to close the Uninstall Packages panel.

Using silent install and uninstall

You can install or uninstall a product package silently using Installation Manager in silent installation mode. When you run Installation Manager in silent mode, the user interface is not available; instead, a response file inputs the commands that are required to install or uninstall the product package. For more information about how to generate the response files and use them see the section, Installing Silently, in the Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r2/topic/com.ibm.silentinstall12.doc/topics/c_silent_roadmap.html.

Log files

The install, update, modify, and uninstall processes create log files that you can examine if an error occurs.

By default, the log files are stored in the c:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\logs\ directory.