Administering Backend Services

This topic explains how to view a list of all configured Generic Service Containers along with their with status, and relocate active backend services to Generic Service Containers in TrueSight Capacity Optimization. For information about the various backend services available, see Viewing backend services.


To have a successful integration between TrueSight Operations Management and TrueSight Capacity Optimization, the following backend services of the Application Server must run on the same generic service container or Data Hub:

  • API Providers - Agent Data service
  • API Providers - Data Provider service

  • API Providers - Search service

If you decide to relocate a backend service, you must relocate all three of them to the new container, re-register the TrueSight Capacity Optimizationcomponent, and enter the port value according to the current container (Data Hub - 8280, Service Container - 8380). For more information about service containers, see Managing Service Containers.

For more information, refer to the following sections:

Relocating a backend service

To learn how to relocate a backend service from one Generic Service Container to another, perform the following task:

  1. Navigate to Administration > COMPONENTS > Backend Services. The page contains an Active Services table that displays the following information:

    IconHyper-linked icon depicting the type of service.
    NameHyper-linked name of the active backend service.
    Service ContainerThe type of Service Container – Data Hub or Generic Service Container – that the active backend service in the corresponding row is configured on.
    StatusDisplays whether the status of the service is OK or NOT OK.
    MessageDisplays whether the service is OK (running) or SLEEPING.
    Last updateTime stamp of when the service was last updated on.
    Show logClick Show Log to view a log for the corresponding backend service. The Log table contains the following information:
    • Timestamp: Time stamp of when the service was last updated on.
    • Type: Type of logged information.
    • Message: The actual message that was logged in the service log.

    You can also click the following buttons in the Log table of the service to:

    • Refresh: Click to refresh the Log table with current data for the service.
    • Download log: Click to download the log file to your machine as a .log text file.
  2. Click the hyper-linked icon or name of the active backened service that you want to relocate.
  3. Under the active backend service details page, click Relocate to display the Relocate Service dialog box. The following figure shows an example of the Relocate Service dialog box.

    The Relocate button is displayed only for backend services that can be relocated to another Generic Service Container. 

  4. From the dialog box, select a Destination Service Container from the list, to relocate the selected service.


    After you click Move in the next step, both Service Containers involved – the one that was containing the service before the move (source), and the destination service container – are shut down and restarted, and their services are unavailable for some time. After the relocation is complete, Services will be available again.

  5. Click Move to relocate the selected service.

The following figure shows an example of the Backend Services page displaying the Active services table.

Backend Services page

Adding a Generic Service Container

A Generic Service Container is automatically installed (added) to BMC TrueSight Capacity Optimization when you choose to install either the Web, Data Hub or Primary Scheduler Application Server features.

The product Installer automatically configures all Application Server machines with a Generic Service Container, including those running the Data Hub. Any machine that you are installing either the Web, Data Hub or Primary Scheduler features on, will automatically have the Generic Service Container feature configured on it.

After relocating a backend service

After you relocate an active backend service from one Generic Service Container to another, the concerned clients should be reconfigured to use the right port. The following table elicits basic guidelines for CAPA and Remote ETL services:

ServiceClient reconfiguration steps
CAPARegister the BCM Provider with the new URL, and set the port to number 8380.
Remote ETLs

There are two scenarios:

  • Relocating the Data API to a Generic Service Container on the same machine: Port change is transparent for the remote ETL.
  • Relocating Data API to a Generic Service Container on another machine: Perform the following steps:
    • If there is a firewall/NAT between the Remote ETL and BMC TrueSight Capacity Optimization Application Server: Reconfigure the NAT to point to the new machine.
    • Edit the Data API External Backend Service URL property from the Data Hub tab under Administration > System > Global configuration and Save your settings. All components including the Remote ETLs are notified of the change.

Note: BMC recommends you not to relocate the Data API service while ETL processes are running, this might result in loss of data.

Administration tasks for Generic Service Containers

The following table lists important information about Service Containers.

Generic Service Container propertyValue/Command/Description

Installation folder


Log files

Reside in the /log subfolder.
To manually start/stop

Use the following commands:

  • Start: cpit start servicecontainer
  • Stop: cpit stop servicecontainer

The start command will start the Service Container only if it has a service assigned to it. If there is no service to run, the Service Container will remain tuned off and a 'No active services to run' message will be returned. This also ensures that the Service Container is started only if needed.

Type of processA Generic Service Container is a Java/Tomcat process.
To detect the process from the shell prompt

Type the ps command at the prompt. Name of the process is:

java -Dcpit.component=servicecontainer

To force a restart

You can use the kill command to force a restart.

Was this page helpful? Yes No Submitting... Thank you