rsa.xml reference

The rsa.xml configuration file defines the EGO repository server agent service, which is available only with the IBM® Spectrum Symphony Advanced Edition. An entitlement key is required to enable advanced features.

Location

This configuration file is installed with IBM Spectrum Symphony at $EGO_TOP/eservice/esc/conf/services on Linux® and Installation_top\eservice\esc\conf\services on Windows.

GS_ENABLE_GRIDSYNC

Specifies whether or not grid synchronization is enabled on the repository server agent.

Default: N

To enable grid synchronization for IBM Spectrum Symphony, set this value to Y and also enable the grid synchronization service profile to be automatic (instead of manual). See Data distribution using grid synchronization for grid synchronization configuration steps.

GS_SERVER_THREADS

The number of threads to handle command line and API push or pull requests to the repository server agent.

Default: 2

GS_AGENT_PORT

The listening port for outgoing communication on a repository server agent, so that the repository server agent can receive peer connections. This port must be free on every host in the cluster; the GS_AGENT_PORT is set by the IBM Spectrum Symphony installer to a free port.

Default: No default. The GS_AGENT_PORT is set by the IBM Spectrum Symphony installer to a free port.

GS_AGENT_PORT_RANGE

The listening port range for communication between the repository server agents, so that each repository server agent can receive peer connections. At least one port in this port range must be free on every host in the cluster. The range must include two valid port numbers, separated with an n-dash (for example, 7890-8100).

If the GS_AGENT_PORT_RANGE is specified, GS_AGENT_PORT will be ignored.

Default: No default. The value of GS_AGENT_PORT will be used, if GS_AGENT_PORT_RANGE is not set.

GS_TRANSFER_CHUNK_SIZE_KB

The size of each data chunk that the repository server agent will transfer per session, in KB.

Default: 10240

GS_STORAGE_DIR

The path to the repository server agent storage.
Default:
  • For Linux: ${EGO_TOP}/eservice/rs/.cache
  • For Windows: %Installation_top%\eservice\rs\.cache

GS_CLUSTER_ADMIN

The cluster administrator user for the repository server agent to set file permissions for directories shared with other daemons. The GS_CLUSTER_ADMIN is set by the IBM Spectrum Symphony installer.

Default: No default. The GS_CLUSTER_ADMIN is set by the IBM Spectrum Symphony installer.

GS_CONSISTENCY_INTERVAL_MINUTES

The time, in seconds, between repository server agent consistency checks. The interval is calculated based on the time that the last consistency check completes.

Default: 720 (12 hours)

GS_BANDWIDTH_MAX_MBPS

The maximum bandwidth in megabits per second (Mbps) to use for uploading or downloading data sets to or from another repository server agent.

Default: Unlimited

GS_DATASET_CHUNK_TIMEOUT_SECONDS

The timeout period, in seconds, for a repository server agent to wait between receiving chunks of an active data set transfer.

Default: 30

GS_PEER_RESPONSE_TIMEOUT_SECONDS

The timeout period, in seconds, for a repository server agent to wait for responses from a peer repository server agent.

Default: 30

GS_AGENT_HEARTBEAT_INTERVAL_SECONDS

The interval, in seconds, when the repository server agent will send a heartbeat to the repository server. Set the value for GS_AGENT_HEARTBEAT_INTERVAL_SECONDS the same for both the rs.xml and rsa.xml files.

Default: 300

Example of rsa.xml file

<sc:ActivityDescription>
    ...
    <ego:ActivitySpecification>
      ...
		<ego:EnvironmentVariable name="GS_ENABLE_GRIDSYNC">N</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_SERVER_THREADS">2</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_AGENT_PORT">7881</ego:EnvironmentVariable>
<ego:EnvironmentVariable name="GS_AGENT_PORT_RANGE">7890-8100</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_TRANSFER_CHUNK_SIZE_KB">10240
			</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_STORAGE_DIR">${EGO_TOP}/eservice/rs/.cache
			</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_CLUSTER_ADMIN">./admin</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_CONSISTENCY_INTERVAL_MINUTES">720
			</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_BANDWIDTH_MAX_MBPS">0</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_DATASET_CHUNK_TIMEOUT_SECONDS">30
			</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_PEER_RESPONSE_TIMEOUT_SECONDS">30
			</ego:EnvironmentVariable>
		<ego:EnvironmentVariable name="GS_AGENT_HEARTBEAT_INTERVAL_SECONDS">300
			</ego:EnvironmentVariable>			 
		...
    </ego:ActivitySpecification>
  </sc:ActivityDescription>