When you install HATS V9.6 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 HATS
For IBM HATS (HATS):
One of the following Rational® SDP packages, or later
fixpacks, including the WebSphere® Application
Server version 7.0, version 8.0, or version 8.5 development tools
features:
IBM Application Developer
for WebSphere Software
V9.6
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):
IBM Developer
for i V9.6, or later fixpacks, including IBM i
and enterprise web developer tools.
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.
Other prerequisites
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 "System
Requirements for Rational Host Access Transformation Services"
at http://www.ibm.com/support/docview.wss?uid=swg27011794 for
the current list of supported hardware and software prerequisites.
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.
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 HATS V9.6 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 HATS V9.6 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 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.
IBM WebFacing
Tool for IBM i
Provides
the ability to convert IBM i DDS
display file source members into a Web-based user interface for your
existing 5250 programs.
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.
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 V9.6 fix
packs using the update function of the IBM Installation
Manager. By default, Internet access is required unless your repository
preferences point to a local update site.
Note:
Earlier versions of HATS cannot be updated
to HATS V9.6. To coexist, earlier versions and HATS V9.6 can
be installed in separate package groups.
To update the HATS Toolkit:
Start IBM Installation
Manager from the Windows Start
menu. By default this is under Start > All
Programs > IBM Installation Manager > IBM Installation Manager.
From the menu bar, select File
> Preferences.
Ensure that the Search
service repositories during installation and updates option is
selected to allow updates from the IBM Update Server. Click OK to return to the IBM Installation Manager
screen.
On the initial IBM Installation
Manager panel, click Update.
Note:
Do not click Install.
Select the package group in which you installed IBM HATS V9.6.
The default is IBM Software
Delivery Platform. The Installed Packages and Fixes list at the
bottom of the panel should show IBM HATS 9.6.0.x as one of the entries. Click Next.
Select IBM HATS 9.6.0.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.
Exit IBM Installation Manager and start Host Access
Transformation Services from the Windows Start menu to begin using
the product. By default this is under Start
> All Programs > IBM Software Delivery Platform > Host Access Transformation
Services.
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.
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.
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 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,
on IBM Knowledge Center at http://www.ibm.com/support/knowledgecenter/SSDV2W_1.8.3/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.