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.

Audience

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

Product

cluster_admin

Cluster administration services

cluster_control

Cluster node control services

cluster_services

Cluster services

failsafe2

IRIS 2.x FailSafe

failsafe2_informix

FailSafe Informix

failsafe2_nfs

FailSafe NFS

failsafe2_oracle

FailSafe Oracle

failsafe2_samba

FailSafe Samba

failsafe2_web

FailSafe Netscape web


Conventions Used in This Guide

These type conventions and symbols are used in this guide:

Bold 

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

Italics  

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:

    http://docs.sgi.com

  • 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
    SGI
    1600 Amphitheatre Parkway, M/S 535
    Mountain View, California 94043-1351

SGI values your comments and will respond to them promptly.