About This Guide

This guide explains how to write your own plug-in, the set of scripts that are required to turn an application into a highly available service in conjunction with IRIS FailSafe 2.1.6 software.

This guide assumes that the FailSafe system has been configured as described in the FailSafe Administrator's Guide for SGI InfiniteStorage.

This guide supports IRIX 6.5.22 and later.


This guide is written for system programmers who are writing their own plug-ins for the FailSafe system. This software allows the failover of applications that are not handled by the base and optional plug-ins. Readers must be familiar with the operation and administration of nodes running FailSafe, with the applications that are to be failed over, and with the FailSafe Administrator's Guide for SGI InfiniteStorage.

Related Documentation

The following documentation is of interest:

  • FailSafe Administrator's Guide for SGI InfiniteStorage

  • CXFS Administration Guide for SGI Infinite Storage

  • Migrating from IRIS FailSafe 1.2 to IRIS FailSafe 2.1.X

The man pages are as follows:

  • cdbBackup

  • cdbRestore

  • cmgr

  • crsd

  • failsafe

  • fs2d

  • ha_cilog

  • ha_cmsd

  • ha_cxfs

  • ha_exec2

  • ha_fsd

  • ha_gcd

  • ha_ifd

  • ha_ifdadmin

  • ha_macconfig2

  • ha_srmd

  • ha_statd2

  • haStatus

Release notes are included with each FailSafe product. The names of the release notes are as follows:

Release Note



Cluster administration services


Cluster node control services


Cluster services


IRIS 2.x FailSafe


FailSafe Informix


FailSafe NFS


FailSafe Oracle


FailSafe Samba


FailSafe Netscape web

Conventions Used in This Guide

These type conventions and symbols are used in this guide:


Function names literal command-line arguments (options/flags)

Bold fixed-width type  

Commands and text that you are to type literally in response to shell and command prompts, or highlighting of differences between releases


New terms, manual/book titles, commands, variable command-line arguments, filenames, and variables to be supplied by the user in examples, code, and syntax statements

Fixed-width type  

Code examples, error messages, prompts, and screen text


IRIX shell prompt for the superuser (root)

Obtaining Publications

You can obtain SGI documentation as follows:

  • See the SGI Technical Publications Library at http://docs.sgi.com. Various formats are available. This library contains the most recent and most comprehensive set of online books, release notes, man pages, and other information.

  • If it is installed on your SGI system, you can use InfoSearch, an online tool that provides a more limited set of online books, release notes, and man pages. With an IRIX system, enter infosearch at a command line or select Help -> InfoSearch from the Toolchest.

  • On IRIX systems, you can view release notes by entering either grelnotes or relnotes at a command line.

  • On Linux systems, you can view release notes on your system by accessing the README.txt file for the product. This is usually located in the /usr/share/doc/productname directory, although file locations may vary.

  • You can view man pages by typing man title at a command line.

Reader Comments

If you have comments about the technical accuracy, content, or organization of this publication, contact SGI. Be sure to include the title and document number of the publication with your comments. (Online, the document number is located in the front matter of the publication. In printed publications, the document number is located at the bottom of each page.)

You can contact SGI in any of the following ways:

  • Send e-mail to the following address:

    [email protected]

  • Use the Feedback option on the Technical Publications Library Web page:


  • Contact your customer service representative and ask that an incident be filed in the SGI incident tracking system.

  • Send mail to the following address:

    Technical Publications
    1600 Amphitheatre Parkway, M/S 535
    Mountain View, California 94043-1351

SGI values your comments and will respond to them promptly.