You are here: Administration > Man Pages > LCDI-systems(1M)

LCDI-systems(1M)

NAME

LCDI-systems(1M) - Describe systems LifeKeeper can access

SYNOPSIS

sys_create [-d dest] -s sys

sys_remove [-d dest] -s sys

sys_getdescr [-d dest] -s sys

sys_getstate [-d dest] -s sys

sys_setstate [-d dest] -s sys -S {DEAD|ALIVE|UNKNOWN} [- R reason]

sys_list [-d dest]

DESCRIPTION

The LifeKeeper configuration database knows about related systems. Because resources and resource types are specific to the systems on which they exist, it is necessary for the configuration database interface to contain the concept of a system.

The LCDI-systems(1M) commands return (or create) information about a system into the database. Their primary use is to manipulate the operational state of a system.

The system states are:

DEAD

The system is believed to be unavailable. (Either the system is down or LifeKeeper is not running on the system.)

ALIVE

The system is believed to be available.

UNKNOWN

System state is unavailable.

SYNTAX

All commands exit 0 if successful. On failure, they return a nonzero code (see EXIT CODES section) and print to stderr.

sys_create [-d dest] -s sys

Creates knowledge for the given system with the name as given in the database on system dest (local, if not specified). Failures may be because the name already exists for the given system.

sys_remove [-d dest] -s sys

Removes knowledge of the system from the database on system dest (local, if not specified). Any network objects relating to this system are also removed. Failures may be because the name does not exist for the given system.

sys_getdescr [-d dest] -s sys

Prints to stdout the optional text description of why the system has gone to the current state from the database on system dest (local, if not specified).

sys_getstate -s sys

Prints the system's state to stdout as one of the strings DEAD, ALIVE, or UNKNOWN from the database on system dest (local, if not specified).

sys_setstate [-d dest] -s sys -S {DEAD|ALIVE|UNKNOWN} [-R reason]

Sets the system's state to that given in the option -S from the database on system dest (local, if not specified). Also sets the optional description of the reason for the last state change, if the reason is given.

sys_list [-d dest]

This command prints to stdout a list of systems that LifeKeeper knows about from the database on system dest (local, if not specified).

EXIT CODES

The following exit codes could be returned by these commands:

0

The operation has succeeded.

1

A Unix system call or library call has internally returned failure.

2

A user-specified syntax error occurred.

3

LifeKeeper internal error.

4

A request to perform an operation on an object that already exists.

5

An argument specified is illegal.

6

Index out-of-range.

7

A request has been made on an object that does not exist.

8

A request was made to delete a resource instance on which another non-deleted resource instance depends.

9

An attempt to communicate with another system failed.

NOTES

The location of this utility, LKROOT, is defined in the default file /etc/default/LifeKeeper.

FILES

/etc/default/LifeKeeper

© 2012 SIOS Technology Corp., the industry's leading provider of business continuity solutions, data replication for continuous data protection.