Installing HATS
With the information in this chapter you can:
- Review hardware and software prerequisites and plan for the installation
of HATS
- Install and uninstall HATS Toolkit on your workstation
- Install and uninstall HATS Toolkit silently
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):
- One of the following Rational SDP packages, or later fixpacks,
including the listed features:
- IBM Rational Application Developer for WebSphere® Software V7.5.5
- Tools for WebSphere Application
Server, version 6.0, version 6.1, or version 7.0
- IBM Rational Business Developer V7.5.1.5
- Tools for WebSphere Application
Server, version 6.0, version 6.1, or version 7.0
- IBM Rational Software Architect for WebSphere Software V7.5.5
- Tools for WebSphere Application
Server, version 6.0, version 6.1, or version 7.0
- IBM WebSphere Integration Developer V6.2 (latest fixpack)
- IBM WebSphere Integration Developer V7.0.0.2
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):
- One of the following Rational SDP packages, or later fixpacks,
including the Struts Tools feature:
- IBM Rational Application Developer for WebSphere Software V7.5.5
- IBM Rational Business Developer V7.5.1.5
- IBM Rational Software Architect for WebSphere Software V7.5.5
- IBM WebSphere Integration Developer V6.2 (latest fixpack)
- IBM WebSphere Integration Developer V7.0.0.2
- Plus one of the following Rational SDP packages, or later fixpacks,
including the listed features:
- IBM Rational Developer for Power Systems Software™ V7.6
- RPG and COBOL Development Tools for i
- IBM Rational Developer for i V7.5.0.5
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):
- One of the following Rational SDP packages, or
later fixpacks, including the Portlet and Portal Tools feature:
- IBM Rational Application Developer for WebSphere Software V7.5.5
- IBM Rational Software Architect for WebSphere Software V7.5.5
- IBM WebSphere Integration Developer V6.2 (latest fixpack)
- IBM WebSphere Integration Developer V7.0.0.2
- Plus the IBM WebFacing Tool
for IBM i feature.
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:
- Verify that your system meets all the prerequisites. For more
information see Prerequisites.
- HATS is structured as an Eclipse offering that is installed
to a Rational SDP system using IBM Installation
Manager.
- You must be logged on with Administrator privileges.
- 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.
- Select the language for the launchpad. Click OK.
- 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.
- 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.
- The IBM Installation Manager
window appears.
- 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.
- On the Licenses panel, read and accept the
terms in the license agreement, and click Next.
- 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.
- On the Features panel, in addition to HATS, you can select
for installation the following HATS features.
Click Next.
Notes:
- 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.
- For prerequisite information see Prerequisites.
- On the Summary panel, click Install.
- You will see a progress bar as the installation proceeds
and Start menu items are created.
- 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:
- All languages supported by HATS and the HATS features are installed
during the installation process.
- 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:
- Start IBM Installation Manager
from the Windows® Start menu.
- On the initial IBM Installation
Manager panel, click Update.
Note:
Do not click Install.
- 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.
- 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.
- 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.
- 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.
- 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:
- 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.
- On the initial IBM Installation
Manager panel, click Modify.
- On the Modify Packages panel, select the package group where you
have installed HATS and click Next.
- 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.
- On the Features panel that lists the features to add or remove,
select any of the following HATS features and click Next.
- IBM WebFacing Tool for IBM i
Note:
For prerequisite information see
Prerequisites.
- On the Summary panel, click Modify.
- You will see a progress bar as the installation proceeds.
- 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:
- From the IBM Installation
Manager menu bar, select File > Preferences.
- On the Preferences panel, click the Add
Repository button.
- On the Add a Repository panel, click the Browse button.
- 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.
- On the Add a Repository panel, click OK.
- On the Preferences panel, click OK.
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:
- Start the HATS Toolkit.
- 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.
- 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:
- The runtime enablement file is provided to you on a CD (or
image, if you downloaded HATS electronically) separate from the HATS Toolkit.
- If you downloaded HATS from the Passport Advantage® Web
site, the runtime enablement file is located in the runtime enablement
CD image.
- 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.
- 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.
- 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.
- After setting the location of the runtime enablement
file, click Next.
- 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.
- 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.
- 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.
- 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:
- You must be logged on with Administrator privileges.
- 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.
- Start the IBM Installation
Manager from the Start menu.
- On the IBM Installation
Manager panel, click Uninstall.
- On the Uninstall Packages panel, select
the IBM Rational HATS package
and click Next.
- On the Summary panel, click Uninstall.
- You will see a progress bar as the installation program uninstalls HATS and
the Start menu items.
- 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.