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

LCDI-networks(1M)

NAME

LCDI-networks(1M) — access to LCM network data

SYNOPSIS

net_create [-d dest] -s sys -n {TTY|TCP} [-D devicepath] [-b baud] [-r ipaddress] [-l ipaddress] [-p {1-99}]

net_remove [-d dest] -s sys [-D devicepath] [-r ipaddress] [-l ipaddress]

net_change [-d dest] -s sys [-N newsys] -D {device|address pair} [-Pnewdev] [-n {TTY|TCP}] [-b baud]

net_list [-d dest] [-fC] [-s sys]

DESCRIPTION

The LifeKeeper communications manager (LCM) needs to know what devices are used to send messages to other servers. These commands manage the information that describes these communications paths to LifeKeeper.

LifeKeeper currently allows two types of communication connections:

TTY:  This LCM connection uses a TTY port.

TCP:  This LCM connection uses a TCP connection.

These commands give the programmer the ability to create new communication paths. The net_list command provides the application programmer with a method of retrieving all communication paths from the configuration database.

SYNTAX

The interface provides the following commands. All commands exit 0 if successful, and a nonzero code (see EXIT CODES section) and prints to stderr, for failure.

net_create [-d dest] -s sys -D devicepath -n {TTY|TCP} [-b baud] [-r ipaddress] [-l ipaddress] [-p IP priorty]

Defines a new network instance in the configuration database for the server named dest (local, if not specified). The network instance is described by the arguments given.

net_remove [-d dest] -s sys [-D devicepath] [-r ipaddress] [-l ipaddress]

Removes a network instance from the configuration database on the server named dest (local, if not specified) for the server named sys.

net_change [-d dest] -s sys [-N newsys] -D device [-P newdev] [-n{TTY|TCP}] [-b baud]

Changes the data in a network instance from the configuration database of server dest (local, if not specified). The dest argument is meaningful only if an earlier Commpath has been established. The first Commpath requires two steps: a net_create on the local server, and a net_create on the remote server. Subsequent Commpaths require the same steps, but both steps can be performed on the same server.

If -N is specified, sys is changed to newsys. If -P is specified, device is changed to newdev. If -n is specified, the network type is changed to the new value.

net_list [-d dest] [-fC] [-s sys]

This command prints to Unix stdout a list of the infomation stored on communication paths. If sys is not specified, all communication paths are returned. Each line represents one communication path and the fields of each line printed are separated by a delimiter character. The default delimiter character is ^A (\001). If the -f option is specified, the delimiter is changed to C. The following examples show a colon (:) as a delimiter.

dipper:153.78.52.15/153.78.52.41:TCP:0:0:0:ALIVE:4:0:0:0:0:0:0:0:0:0:153.78.52.41:153.78.52.15:1

dipper:/dev/ttyS0:TTY:9600:25646:25647:ALIVE:7:0:0:0:0:0:0:0:2162:2050:0:0:99

dipper:128.1.1.2/128.1.1.1:TCP:0:0:0:ALIVE:0:0:0:0:0:0:0:0:0:0:128.1.1.1:128.1.1.2:2

 

The fields are as follows:

1

The other server the communications path is connected to.

2

For TTY communication paths, the name of the local serial device used to communicate to the other server. For TCP communication paths, the local and remote IP addresses for the path.

3

The type of path (TCP or TTY).

4

For TTY, baud rate of line.

5

For TTY, Unix process ID of process used to write to other server.

6

For TTY, process ID of process used to read from other server.

7

State communication path is in:

ALIVE Communication path is working both ways.

DEAD Communication path is not working.

 

8

Number of times this port caused a sendevent lifekeeper, comm_down event (FAILOVER event).

9

TTY only, number of times Maximum number of TTYLCM Retrys exceeded.

10

TTY only, number of NAK packets received.

11

TTY only, number of times received packet with checksum error.

12

TTY only, number of times an incomplete message was received.

13

TTY only, number of times packets were resent.

14

TTY only, number of times packets were received out of sequence.

15

TTY only, number of times alarm timed out waiting for packet response.

16

TTY only, activity count.

17

TTY only, previous activity count for comparison.

18

Remote server's IP Address.

19

Local server's IP Address.

20

Priority assigned to communication path.

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