Starting a Realm Service

Each ActiveSpaces data grid depends on a TIBCO FTL realm service to supply configuration data to its components. The realm service is a process that is run by the TIBCO FTL server. The TIBCO FTL server can also be configured to run the state keeper, administration service, and proxy. When it is configured in this way, it is called an ActiveSpaces Core Server.

Dedicate a separate realm for each data grid. If your application programs also use TIBCO FTL communications, arrange a separate realm for them. Run either one TIBCO FTL server or an ActiveSpaces Core Server, or a group of three or five or seven TIBCO FTL servers or core servers.

If you choose to run some ActiveSpaces components as services, follow the instructions in the Starting a Core Server section. Else, follow the instructions in the Starting a TIBCO FTL Server section.

Starting a Core Server

Procedure
1. Create a YAML configuration file as described in the Running Processes as a Service section. Use the component names that you decided in the Designing a Data Grid section.
2. Copy the YAML configuration file to the TIBCO_HOME/activespacesdata directory on all the computers where the core server runs.
3. Start each core server from the TIBCO_HOME/activespacesdata directory by running the following command:

   tibftlserver -c <yaml_config_file> -n <server_name>

   where

   <server_name> is a unique name for the core server as defined in the YAML file, for example, SRV1.

Starting a TIBCO FTL Server

Procedure
1. Navigate to the realm configuration data directory.

   cd my_data_dir_1

   The realm service uses the current directory as the default location to store its working data files.
   The first time you start a realm service for a data grid, navigate to an empty directory. When the realm service detects an empty working directory, it begins with a default realm definition. As you configure the realm definition, in subsequent tasks, the realm service 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 service reads the realm definition from the working directory.
2. Run the realm service executable.

   tibftlserver -n <name>@<host>:<port>

   where

   <name> is a unique name for the TIBCO FTL server, for example, ftl1.

   The port must not be bound by any other process.

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

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