vrport

NAME

vrport - VERITAS Volume Replicator port management utility

SYNOPSIS

DESCRIPTION

The vrport utility manages the various UDP and TCP ports used by VERITAS Volume Replicator (VVR).

VVR uses the UDP and TCP transport protocols to communicate between the Primary and Secondary.

VVR exchanges three types of message between the Primary and Secondary: heartbeat, data and administrative control.

The heartbeat messages are transmitted using the UDP protocol on the IANA approved 4145 UDP Port number. VVR can use either the UDP transport protocol or the TCP transport protocol to exchange data messages. VVR uses UDP Anonymous ports for data replication between Primary and the Secondary if the network protocol is UDP. VVR uses IANA approved 4145 TCP port number for TCP listener port on the Secondary and TCP Anonymous ports on the Primary for data replication if the network protocol is TCP.

VVR uses IANA approved 8199 TCP port for communication between the vradmind daemons on the Primary and the Secondary. vradmind server provides administration of VVR objects in a distributed environment. VVR uses 8989 TCP port number for communication between the vxrsyncd daemons on the Primary and the Secondary.

Use vrport to display, change or set the port numbers used by VVR. You may have to change the port numbers to resolve a port number conflict with other applications, to configure VVR to work in a firewall environment when using UDP network protocol by restricting the number of ports to replicate data between the Primary and the Secondary.

The action performed by vrport depends on the specified keyword operand(s).

When invoked with no arguments, vrport displays the port number(s) used for heartbeat, data, vradmind and vxrsyncd communication between the Primary and Secondary on the standard output.

KEYWORDS

data [port |\ portlow-porthigh [,port...]]

Without any arguments, the vrport data command displays the port number(s) used by VVR for data replication between the Primary and the Secondary. This is applicable only if you have chosen UDP for network protocol.

With the port number(s) or range specified, restricts VVR to use the ports or list of ports specified for data replication.

If the -a flag is specified, the vrport data command appends the given port numbers(s) or range to the existing port number(s) or range to be used for data replication.

If the -r flag is specified, the vrport data command removes the given port number(s) or range from the existing port number(s) for data replication.

You need to execute /usr/sbin/vxnetd, and pause and resume all RLINKs for VVR to use the new port information.

heartbeat [port]

Without the port argument, displays the UDP port number used to exchange heartbeat messages.

With the port argument specified, sets the UDP port number to exchange heartbeat messages. Use the vradmin changeip command to update the RLINKs with the new port information. To have VVR use the new port number, enter the command /usr/sbin/vxnetd stop followed by /usr/sbin/vxnetd.

vradmind [port]

Without the port argument, displays the TCP port number used by the vradmind daemons for communication between the Primary and the Secondary.

With the port argument specified, sets the TCP port number to be used by the vradmind daemons. The new port is used when the vradmind process is restarted.

vxrsyncd [port]

Without the port argument, displays the port the TCP port number used by vxrsyncd daemons for communication between the Primary and the Secondary hosts.

With the port argument specified, command sets the TCP port number to be used by the vxrsyncd daemons. The new port is used when the vxrsyncd process is restarted.

EXAMPLES

See the VERITAS Volume Replicator Configuration Notes for examples.

EXIT CODES

The vrport utility exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered but denotes the first condition that prevented further execution of the utility.

SEE ALSO

vradmin (1M),vxrlink (1M)

VERITAS Volume Replicator Administrator's Guide

VERITAS Volume Replicator Configuration Notes