beautypg.com

Extend facility – Compaq AA-Q88CE-TE User Manual

Page 167

background image

EXTEND FACILITY

EXTEND FACILITY

Adds new nodes or roles or both to an existing facility definition.

Format

EXTEND FACILITY

[facility_name]

Command Qualifiers

Defaults

/BACKEND=backend-list

/NOBACKEND

/BALANCE

/NOBALANCE

/CALL_OUT=role-list

/NOCALL_OUT

/CLUSTER

/NOCLUSTER

/FRONTEND=frontend-list

/NOFRONTEND

/NODE[=node-list]

/NODE=default-node-list

/OUTPUT[=file-spec]

/OUTPUT=stdout

/ROUTER=router-list

/NOROUTER

Description

The

EXTEND FACILITY

command extends the configuration of an RTR facility.

New nodes and roles can be added to a facility definition using the EXTEND
FACILITY command. Thus a new node can be introduced into a facility, or a new
role can be added to an existing node (for example, a router node can be extended
to have a backend role).

Notes:

New router nodes must have

all

backend nodes defined and new backend

nodes must have

all

router nodes defined.

Routers need only be defined with the frontends that they can connect to.

Frontends need only be defined with the routers they can connect to.

When using this command, the facility being extended may temporarily lose
quorum until the affected nodes agree upon the new facility definition. During
this time server applications will not be presented with any new transactions.

The RTR MONITOR QUORUM displays a monitor picture which allows the
quorum negotiations to be followed after a TRIM or EXTEND of a facility. Once
quorum has been attained, the participating nodes return to state ‘‘qrt’’.

As with CREATE FACILITY, nodes or roles may be specified which are
superfluous. That is, you may specify backend nodes on a node which only
has a frontend role, and frontend nodes may be specified on a node which only
has a backend role. This permits a single RTR management command to be
issued on many nodes, and each node only accepts those parts of the command
which are relevant to it.

For example, in a two node facility called

facnam

, the node

FE

has the frontend

role only, and node

FETRBE

that has frontend, router and backend roles can be

created as follows:

RTR Command Line Interface 6–91