Configuring Relationship Service

In the Relationship Service tab, you configure settings for the SBM Relationship Service, which enables you to view and analyze relationships between items in separate applications.

Note: This topic only applies to Serena Release Control or Serena Service Manager installations. To enable Relationship Service functionality, you must install Serena Release Control or Serena Service Manager 5.0 or later.

The Relationship Service graph database is a set of files that are stored on the file system in a special format that is not human readable. The location of these files is specified in the Database location (described below). When the Relationship Service database is initially created, no tables are added to the Application Engine database—they are two separate databases. Data from the Application Engine database is copied to the graph database; however, the databases remain distinct and do not share any files.

The Relationship Service and database are installed on the server that hosts SBM Common Services. Therefore, there is only one active Relationship Service instance per SBM instance.

For multi-environment installations (composed of development, staging, and production servers), each environment should have its own dedicated Relationship Service instance because each environment can only run one instance of SBM Common Services. Use the Manage Services tab in SBM Configurator to stop and start the SBM Relationship Service.

Important: Serena recommends that you wait to start the SBM Relationship Service on the Manage Services tab until after you have finished promoting all of the Serena Release Control process apps. This service does not start automatically when you click Apply to finish the configuration process.

The Status section displays the current status and activity of the Relationship Service. For example, if you have never started the SBM Relationship Service on the Manage Services tab, the Relationship Service database is empty and not in use. That information is reported in the status section. After you start the service and the initial loading of data begins, the status is updated.

In the Database Server Settings section, enter the HTTP port that will be used to connect to the Relationship Service database. The default port value is 7474.

In the Database Settings section, configure the following settings:

Configuring Relationship Service in a Tomcat Cluster

You can improve Relationship Service performance by clustering the SBM Common Services component on multiple servers. When you create a cluster for SBM Common Services, the Cluster Settings group box appears in the Relationship Service sub-tab.

Each node in the cluster is capable of running Relationship Service; however, only one node in the cluster can run the service. You will enter the database settings on this node. All other nodes in the cluster must know the location of the node that will run the Relationship Service. No other Relationship Service configuration is required on these nodes.

To configure Relationship Service in a Tomcat cluster:

  1. Define the nodes in your SBM Common Services cluster according to the steps described in Clustering Tomcat Server Components.
  2. On the node that will run the Relationship Service, select the local host name in the drop-down list that appears.
  3. On each node that will not run the service, select the host name of the node that will run the service.
  4. Click Apply to save your changes.

Related Topics

Release Control

Manage Services