QNX High Availability Toolkit 1.0

Installation Note

Date of this edition: October 19, 2001

QNX RTOS version: compatible with 6.1.0 or later

Contents

What is the HAT?

The QNX High Availability Toolkit (HAT) lets you detect failures in your system before they escalate to an unrecoverable state. The fully customizable toolkit, with its High Availability Manager (HAM), offers a more sophisticated approach to failure detection and recovery.

The HAT lets you monitor system components and construct custom failure-recovery scenarios according to the needs of a particular application. Applications can, themselves, select failure conditions (events) and specify actions to be performed when these conditions occur (e.g. notify processes that have subscribed to particular events).

The toolkit also features heartbeat services and checkpointing, which help reduce downtime by allowing application-specific state recovery after failures.

For more information, see the online docs (/usr/help/product/ham_en/bookset.html).

Installation

On a QNX 6 host

To install the HAT package on a QNX 6 host:

  1. Start the QNX Package Installer.
  2. If you've installed a previous version of this beta software, you must uninstall it.
  3. Add the following repository:

    http://commercial.qnx.com

  4. Expand the System entry under QNX Realtime Platform.
  5. Expand the QNX Neutrino entry and select the High Availability Toolkit package for each target you wish to install.
  6. Click Install.

On a Windows host

To install the HAT on a Windows host:


Caution: You MUST delete all previously installed packages as instructed in the QNX 6.1.0A (SDK 1.1.0A) For Windows Hosts Installation Note before you copy the new QPKs/QPMs. If you don't, you'll have serious problems with your installation.

  1. Make sure you have the Windows SDK 1.1.0A properly installed and configured.
  2. Download the following file:

    http://commercial.qnx.com/hat-1.0.tar

  3. Extract the hat-1.0.tar file so all qpk/qpm files reside in:

    %QNX_HOST%\..\..\pkgs\qpk\

  4. If you've met all the above conditions, you can now run the following script at an MS-DOS command prompt:

    qpkadd.bat

    Follow the instructions on your screen.

On a Solaris host

To install the HAT on a Solaris host:

  1. Install the Solaris SDK 1.1.0A.
  2. Make sure you have the Solaris SDK 1.1.0A properly installed and configured.
  3. Download the hat-1.0.tar file from:

    http://commercial.qnx.com

  4. Create a temp directory (e.g. /tmp/hat).
  5. Extract the hat-1.0.tar file into the temp directory.
  6. Issue the following command:
    qpkadd /tmp/hat/*.qpm                 

    The QNX qpkadd utility will extract and install the QPKs and their associated QPM files.

Full source included

The HAT includes full source code for the HAM, its API, several examples, etc. The source is installed under:

/usr/src/hat-1.0.0/


Caution: Before you build the source, you should delete the following file:

/usr/src/hat-1.0.0/hat/src/lib/c/kercalls/kercalls.mk

This file was inadvertently shipped; it may prevent the source from building on some machines.


To build all modules, simply type make at the top-level directory (i.e. hat/src/ under /usr/src/hat-1.0.0/).

Regression test suite

The source code includes several regression test programs, which you might find useful for testing any source modules that you modify.

For details, see the README file (under hat/src/regress).

Technical support

If you have any questions, comments, or problems with a QNX product, we recommend that you use our support forums available from our news server, news://nntp.qnx.com.

For this product, try under the following newsgroup:

qdn.public.qnxrtp.*

Since QNX developers and support staff frequent our newsgroups, you should find them to be your best avenue of support for solving problems.