Filter
Top Products
TRIM FACILITY
TRIM FACILITY
Removes nodes or roles or both from an existing facility definition.
Format
TRIM FACILITY [facility_name]
Command Qualifiers Defaults
/BACKEND=backend-list /NOBACKEND
/CLUSTER /NOCLUSTER
/FRONTEND=frontend-list /NOFRONTEND
/NODE[=node-list] /NODE=default-node-list
/OUTPUT[=file-spec] /OUTPUT=stdout
/ROUTER=router-list /NOROUTER
Description
The
TRIM FACILITY
command removes nodes or roles or both from an RTR facility
definition. A node can be removed from a facility or a role can be removed from a
node. For example, a node having both router and frontend roles can be trimmed
to have only a router role.
A TRIM FACILITY command resulting in the removal of all roles is equivalent to
a DELETE FACILITY command.
A frontend role can be removed from a node with the router role as long as there
is at least one other frontend defined.
A backend role can be removed from a node with the router role as long as at
least one other backend is defined. A command to remove a backend role should
be executed on all router nodes to avoid problems with inconsistent facility
definitions.
If a router role is removed, then the node from which it is removed will discard
its knowledge of other backends and frontends in the facility. If the router role is
re-added to the node (using EXTEND FACILITY), this information will have to
be specified again.
In order to have a consistent facility definition across the nodes of the facility
(avoiding problems with attaining quorum), the command to remove a router role
must be executed on all relevant nodes. This means executing the command on
the node losing the router role, plus all backend and frontend nodes which know
about this router.
As with CREATE or MODIFY 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.
When using this command, the facility being extended may 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.
RTR Command Line Interface 6–179