NAME¶

rspregistrar—RSerPool Pool Registrar (PR) Service

SYNOPSIS¶

rspregistrar [-announcettl=TTL][-asap=auto|address:port,address,...][-asapannounce=auto|address:port][-autoclosetimeout=seconds][-endpointkeepalivetransmissioninterval=milliseconds][-endpointkeepalivetimeoutinterval=milliseconds][-maxbadpereports=reports][-maxhresitems=items][-maxincrement=increment][-minaddressscope=loopback|sitelocal|global][-serverannouncecycle=milliseconds][-enrp=auto|address:port,address,...][-enrpannounce=auto|address:port][-maxelementsperhtrequest=items][-mentordiscoverytimeout=milliseconds][-peer=address:port][-peerheartbeatcycle=milliseconds][-peermaxtimelastheard=millisecond][-peermaxtimenoresponse=milliseconds][-takeoverexpiryinterval=milliseconds][-cspinterval=milliseconds][-cspserver=address:port][-logcolor=on|off][-logappend=filename][-logfile=filename][-loglevel=0-9]

DESCRIPTION¶

rspregistrarprovides a registrar service for Reliable Server Pooling (RSerPool) poolelements (PEs) and pool users (PUs). PRs of an operation scope synchronizetheir view of the handlespace using the Endpoint haNdlespace RedundancyProtocol (ENRP), transported via SCTP. An operation scope has a limited range,e.g. an organization or only a building. In particular, it is restricted to asingle administrative domain - in contrast to GRID computing - in order tokeep the management complexity at a minimum. Nevertheless, PEs may bedistributed globally for their service to survive localized disasters.

PEs choose an arbitrary PR of the operation scope to register into a pool byusing the Aggregate Server Access Protocol (ASAP), again transported via SCTP.Upon registration at a PR, the chosen PR becomes the Home-PR (PR-H) of thenewly registered PE. A PR-H is responsible for monitoring its PEs' availabilityby keep-alive messages (to be acknowledged by the PE within a given timeout)and propagates the information about its PEs to the other PRs of the operationscope via ENRP updates.

In order to access the service of a pool given by its PH, a PU requests a PEselection from an arbitrary PR of the operation scope, using the AggregateServer Access Protocol (ASAP), transported via SCTP. The PR selects therequested list of PE identities by applying a pool-specific selection rule,called pool policy.

In order to allow for automatic configuration, a PR can send out regularannounces via an ASAP and ENRP multicast address. PEs and PUs can listen tothis address to learn the list of currently available PRs.

ARGUMENTS¶

The following options are available:

-quiet

Do not print startup and shutdown messages.

-announcettl=TTL

Sets the TTL for outgoing ASAP Announce/ENRP Presence messages via multicast.

Logging Parameters:

It is recommended to use at least a value of 2 to see possiblyimportant error messages and warnings.

-logcolor=on|off: Turns ANSI colorization of the logging output on or off.
-logappend=filename: Write logging output to a file (default is stdout); output will be appended to given file.
-logfile=filename: Write logging output to a file (default is stdout); given file will be overwritten.
-loglevel=0-9: Sets the logging verbosity from 0 (none) to 9 (very verbose).

Component Status Protocol (CSP) Parameters:

-cspinterval=milliseconds: Sets the interval for the CSP status updates in milliseconds.
-cspserver=address:port: Sets the CSP monitor server's address and port.

Aggregate Server Access Protocol (ASAP) Parameters:

-autoclosetimeout=seconds: Sets the SCTP autoclose timeout for idle ASAP associations.
-asap=auto|address:port,address,...: Sets the ASAP endpoint address(es). Use "auto" to automatically set it (default).
-asapannounce=auto|address:port: Sets the multicast address and UDP port to send the ASAP Announces to. Use "auto" to automatically set it (default). Examples:
-asapannounce=auto
-asapannounce=239.0.0.1:3863
-endpointkeepalivetransmissioninterval=milliseconds: Sets the ASAP Endpoint Keep Alive interval.
-endpointkeepalivetimeoutinterval=milliseconds: Sets the ASAP Endpoint Keep Alive timeout.
-maxbadpereports=reports: Sets the maximum number of ASAP Endpoint Unreachable reports beforeremoving a PE.
-maxincrement=increment: Sets the MaxIncrement constant. Handle with care!
-maxhresitems=items: Sets the MaxHResItems constant.
-minaddressscope=loopback|sitelocal|global: Sets the minimum address scope acceptable for registered PEs:
loopback: Loopback address (only valid on the same node!)
site-local: Site-local addresses (e.g. 192.168.1.1, etc.)
global: Global addresses
-serverannouncecycle=milliseconds: Sets the ASAP Announce interval.

Endpoint Handlespace Redundancy Protocol (ENRP) Parameters:

-enrp=auto|address:port,address,...: Sets the ENRP endpoint address(es). Use "auto" to automatically set it (default). Examples:
-enrp=auto
-enrp=1.2.3.4:9901
-enrp=1.2.3.4:9901,[2000::1:2:3],9.8.7.6
-enrpannounce=auto|address:port: Sets the multicast address and UDP port to send the ENRP Announces to. Use "auto" to automatically set it (default). Examples:
-enrpannounce=auto
-enrpannounce=239.0.0.1:9901
-maxelementsperhtrequest=items: Sets the maximum number of items per ENRP Handle Table Response.
-mentordiscoverytimeout=milliseconds: Sets the mentor PR discovery timeout in milliseconds.
-peer=address:port: Adds a static PR entry into the Peer List. It is possible to add multiple entries.
-peerheartbeatcycle=milliseconds: Sets the ENRP peer heartbeat interval.
-peermaxtimelastheard=milliseconds: Sets the ENRP peer max time last heard.
-peermaxtimenoresponse=milliseconds: Sets the ENRP maximum time without response.
-takeoverexpiryinterval=milliseconds: Sets the ENRP takeover timeout.

ENVIRONMENT¶

rspregistraruses the environment variables CSP_SERVER and CSP_INTERVAL to define a CSPserver to send reports to in the specified interval.

DIAGNOSTICS¶

If loglevel>0, log messages will be printed to stdout or into a specifiedlog file.

Source file:	rspregistrar.1.en.gz (from rsplib-registrar 3.4.4-1.1+b1)
Source last updated:	2024-03-29T16:57:19Z
Converted to HTML:	2024-10-21T18:57:06Z