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

LCDI-relationship(1M)

NAME

LCDI-relationship(1M) - Relating LifeKeeper resources

SYNOPSIS

dep_create [-d dest] -p partag -c chdtag

dep_remove [-d dest] [-p partag] [-c chdtag]

dep_list [-d dest] [-fC] [-C allchild | -P allparent | -c ofparenttag | -p ofchildtag] [-r typ] [-a app]

eqv_create [-d dest] -t tag [-p sysPriority] -S othersys [-r othersysPriority] -o othertag -e SHARED

eqv_remove [-d dest] -t tag -S othersys [-o othertag] -e SHARED

eqv_list [-d dest] [-t tag] [-e SHARED] [-fC]

hry_setpri [-d dest] -t tag(s) [-p priority] [-l] [-q]

DESCRIPTION

LifeKeeper resources exist in relationship to one another. Two resources may be unrelated, they may be in a dependency relationship, or they may be in an indirect dependency relationship. Resources also relate by equivalency, since they may be shared by one or more paired systems.

SHARED examples include writable SCSI disks and IP addresses.

The terms dependency and equivalency describe a single relationship between a pair of resources. However a given resource may have multiple dependency and equivalency relationships. A resource may have several resources depending on it, and it may depend on several resources. Several devices on different systems may be equivalent as well.

SYNTAX

The dependencies and equivalencies interface provides the following commands. All commands exit 0 if successful. On failure, they return a nonzero code (see EXIT CODES section) and print to stderr.

dep_create [-d dest] -p partag -c chdtag

This function creates a dependency relationship between the resource instances with tags partag and chdtag. Both resources must be on the same system dest. If dest is not specified, the current system is assumed. This implies the parent resource now requires the child for proper operation. Both resource instances must already exist.

dep_remove [-d dest] [-p partag] [-c chdtag]

Removes the dependency relationship(s) from the database on system dest. If dest is not specified, the current system is assumed. If chdtag is not specified, all dependencies with parent partag are removed. If partag is not specified, all dependents with child chdtag are removed. If both are not specified, all dependencies are removed.

dep_list [-d dest] [-fC] [-C allchild | -P allparent | -c ofparenttag | -p ofchildtag] [-r typ] [-a app]

This function prints strings to stdout describing dependency relationships between resource instances. If dest is not specified, the current system is assumed. Each string is in the following form:

varfs:part10

part10:ha5

usrfs:part20

part20:ha5

There are two fields in each string that are separated by a delimiter character. The default delimiter character is ^A ( 01). If the -f option is specified, the delimiter is changed to C. The previous example shows a colon(:) as a delimiter. The first field indicates the parent tag name of the relationship and the field on the right is the child tag name. If the -p option is specified, this command will print out only the direct parent dependents of the resource specified in of child tag. If the -c option is specified, this command will print out only the direct child dependencies ofthe resource specified in of parent tag. If the -C option is specified, this command will print out all direct and indirect child dependencies of the resource specified in all child. If the -P option is specified, this command will print out all direct and indirect parent dependencies of the resource specified in all parent. If no -p, -c, -P, or -C option is specified, all dependencies are printed. Specifying the -r option lists all the dependencies of child typ, and specifying the -a option lists all the dependencies of application app.

eqv_create [-d dest] -t tag [-p sysPriority] -S othersys -o othertag [-r othersysPriority] -e SHARED

Creates an equivalency in the configuration database between the resource specified by tag on system dest (defaults to the local system, if not specified) and the resource specified by othertag on the system othersys. The sysPriority and othersysPriority parameters specify the priority values of the resources on the systems dest (or the local system) and othersys respectively.

LifeKeeper will automatically add a equivalency on a remote system. The sysPriority and othersysPriority options will default to 1 and 2 respectively if not provided, for backward compatibility.

eqv_remove [-d dest] -t tag -S othersys [-o othertag] -e SHARED

Removes equivalency from the configuration database on systems dest (defaults to the local system, if not specified) and othersys of equivalency type, specified by the -e option, between the resources tag and othertag existing on systems dest (or the local system) and othersys, respectively.

eqv_list [-d dest] [-s sys] [-t tag] [-e {COMMON|SHARED|COMPOSITE}][-fC]

This function prints strings to stdout describing equivalency relationships between resource instances. If dest is not specified, the current system is assumed. Each string is in the form:

iwstp:varfs:remote:varfs_backup:SHARED:1:2

iwstp:usrfs:remote:usrfs_backup:SHARED:1:2

Each line contains fields separated by a delimiter character. The default delimiter character is ^A ( 01). If the -f option is specified, the delimiter is changed to C. The above example shows a colon (:) as a delimiter. The fields are as follows (fields 1, 2, and 6 are information for the local system; fields 3, 4, and 7 pertain to the remote system, and field 5 is the equivalency type):

1

Local system name where resource tag 1 of equivalency resides: iwstp.

2

Tag name of resource tag 1: varfs.

3

Remote system name where resource tag 2 of equivalency resides: remote.

4

Tag name of resource tag 2: varfs backup.

5

Equivalency type: SHARED.

6

Priority value for local system/resource: 1.

7

Priority value for the remote system/resource: 2.

The remaining arguments to this function limit the information output as specified below:

-e SHARED

This option prints all SHARED equivalency information.

-t tag

This option limits the output to include only the equivalencies relating to the tag specified by the tag argument.

hry_setpri [-d dest] -t tag(s) [-p priority] [-q] [- l]

This function sets the priority of the dest system (defaults to the local system, if not specified) in an existing hierarchy. All associated equivalences are updated. The hierarchy is identified by the root resource tag(s) specified by the -t option. A hierarchy with multiple roots may be specified when the tags are comma separated with no imbedded spaces.  The new priority is specified using the -p option. If the -q option is specified, all normal output to stdout is suppressed, except for -l option output. If the -l option is specified, a list of systems this hierarchy is resident on, and their associated priorities is displayed. For example:

teak 10

ash 20

plum 30

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 anothernon-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.