Realm Definition Storage

Each FTL server stores the definition of exactly one realm stored as the current realm definition or a working copy of the realm definition.

Figure 41: Realm Definition Storage and Transitions

The FTL server configuration interfaces access either the working copy or the current realm definition based on the edit mode:

• Edit Mode Off (red arrow): When edit mode is off, the interface accesses the current realm definition which is used by clients and services to guide their behavior.
• Edit Mode On (orange arrows): Entering edit mode (orange dotted arrow) obtains the modification lock and opens a workspace as a copy of the current realm definition. The interface displays the workspace and uses it as intermediate storage while the administrator modifies the realm definition. The interface automatically saves your modifications to the workspace.

Modification Lock (Edit Mode On)

An administrator must be in the ftl-admin authorization group to set Edit Mode On to obtain a lock to edit the realm definition. When locked, only one administrator at a time can enter modifications. If you do not hold the lock, the interface is read-only. The lock is not required for management operations, such as purging durables from a persistence store, or saving the state of a persistence service.