Starting a Realm Server

Each ActiveSpaces data grid depends on a TIBCO FTL realm server to supply configuration data to its components. To start a realm server process, complete this task.

Dedicate a separate family of realm servers for each data grid. If your application programs also use FTL communications, arrange a separate family of realm servers for them.

At minimum, a family of affiliated realm servers must include a primary realm server process. It can also include a backup realm server, as appropriate for your enterprise. (For more information, see "Affiliated Realm Servers" in TIBCO FTL Administration.)

Prerequisites

TIBCO FTL software must already be installed on realm server hosts.

Procedure

  1. Navigate to the realm configuration data directory. 
    cd my_data_dir_1
    The realm server uses the current directory as the default location to store its working data files.
    • The first time you start a realm server for a data grid, navigate to an empty directory. When the realm server detects an empty working directory, it begins with a default realm definition. As you configure the realm definition, in subsequent tasks, the realm server stores that definition in its data directory.
    • If you have already begun to configure the realm definition, then navigate to the same data directory. The realm server reads the realm definition from the working directory.
  2. Run the realm server executable. 
    tibrealmserver -ht my_host:my_port
    Specify the HTTP port using the -ht parameter. The port must not be bound by any other process.

    ActiveSpaces® component processes initiate contact with the realm server at this address.

    Note: Application programs must supply this realm server URL (host:port) to data grid connect call.