Skip to content
CA Application Performance Management - 10.5
Documentation powered by DocOps

Configure Enterprise Team Center

Last update May 4, 2018

Enterprise Team Center (ETC) is a deployment of an Enterprise Manager that behaves as an Enterprise Team Center Server (ETC Server). Enterprise Team Center federates queries from all components of an enterprise environment to a single APM Team Center view. ETC crosses cluster boundaries to provide the analyst with a single entrance to the user interface. The Enterprise Team Center server can link to any MOMs and standalone Enterprise Managers that together constitute the enterprise environment.

Enterprise Team Center Architecture

In most enterprise environments, the number of components is too large to work with efficiently. Team Center Universes enable the administrator to refine the number and types of components into meaningful groups. This refined group is a Universe. For security reasons, there is no default assignment to all users. A user must be allocated to a Universe to view Team Center. If no Universe is associated with the user ID, the user is warned. As an administrator, create universes for users. Use the default universe that is created for every connected provider, or, create a custom universe.

In the example below, the Enterprise Team Center Server is an Enterprise Manager. The Enterprise Manager is federating requests through two MOMs and a standalone Enterprise Manager. The basic functionality is to allow all users to connect to the ETC server when viewing information in Team Center. MOMs and standalone Enterprise Managers that provide the data are Providers. The Enterprise Manager running in an ETC Server role is a Master. REST calls provide the connections between the Master and the Provider. The Master or the Provider can initiate the termination of the connection. A Provider can only connect to one Master.

Enterprise TC architecture

Note: You need to assign a WebView server to each cluster.

Configure an Enterprise Manager as the Enterprise Team Center Server

Any Enterprise Manager can be configured as the Enterprise Team Center server (Master). We recommend that you use a dedicated Enterprise Manager as the Master. You can configure an Enterprise Manager as Master during the Enterprise Manager installation in the installation wizard. In an existing Enterprise Manager, you can configure the introscope.apmserver.teamcenter.master property.

Follow these steps:

  1. Open the IntroscopeEnterpriseManager.properties file for the Enterprise Manager.
  2. Set introscope.apmserver.teamcenter.master=true.
  3. Restart the Enterprise Manager.
    The Enterprise Manager is now running as Master. In the Settings tab, the Providers tab is available.
    You are ready to configure other Enterprise Managers as Providers reporting to the Master.

Connect a Provider

To connect a Provider to the Master, generate a security token at the Master. Use the token during the Provider registration process.

Note: The APM 10.5.2 Master is backward compatible with APM 10.5.1 Providers. If you use APM 10.5.1 Providers, the Public REST API performance optimization that is available in APM 10.5.2 does not work.

In Settings, Providers, a Version column shows the version of the Provider.

Generate a System Security Token

Before you register a Provider, generate a security token in the Master instance of Team Center.

Note: You need a new token for each Provider that you register.

Follow these steps:

  1. Log in to the Master instance of Team Center.
  2. Click the Settings Tab.
  3. Click Security.
  4. Click Generate New Token.
    A dialog window appears.
  5. Fill out the Label (name) of your Provider and select System for the Type.
  6. Set the expiration date or select Never Expires.

  7. Click Generate Token.
    The system generates a new token.

    Important: For security reasons, you only see a token once. Store the token in a safe place before closing this dialog window. Do not disclose the token to unauthorized parties.

    The token now appears among the other tokens in the Security tab. You can Set Expiration of a token, Invalidate a token, or, Rename a token. The tokens are permanent and never disappear from the list in the Security tab. An invalidated token shows who and when invalidated the token.

Register Team Center with Enterprise Team Center Server

Connect a standalone Enterprise Manager or a MOM to the Master. In the following picture, an Enterprise Manager Tech-Canada connects to the Master Tech-ETC.

Video Admin

Follow these steps:

  1. Log in to the Provider instance of Team Center.

2. Click the Settings tab.

3. Click Enterprise.

4. Click Register this Team Center instance with Enterprise Team Center.
    A dialog window for the Team Center registration appears.

5. Enter the URLs and a security token.

The URLs are derived as follows:

  • Enterprise Team Center URL - http://<IP address or hostname of the server where the APM ETC Server is installed>:the port number that the web server of APM ETC Server listens on
  • Enterprise Team Center WebView URL - http://<IP address or hostname of the server where APM WebView is installed>:the port number on which WebView of APM ETC Server listens for HTTP traffic
  • WebView URL – http://<IP address or hostname of the server where the Provider WebView is installed>:the port number on which WebView of Provider Enterprise Manager listens for HTTP traffic
  • Provider API URL - http://<IP address or hostname of the server where the Provider Enterprise Manager is installed>:the port number that the web server of the Provider Enterprise Manager listens on
    Note: APM Enterprise Manager and APM WebView might not be installed on the same machine.

    Tip: If you are unsure of the hostname and the IP address of a server or the assigned port number, you can check the following properties in the IntroscopeEnterpriseManager.properties and IntroscopeWebView.properties files.

    • ETC URL - IntroscopeEnterpriseManager.properties on APM ETC Server:
      The property introscope.enterprisemanager.webserver.port defines the port number that the web server of APM ETC Server listens on.
    • ETC WebView URL - IntroscopeWebView.properties on APM ETC Server:
      The property introscope.webview.tcp.port defines port number on which WebView of APM ETC Server listens for HTTP traffic.
    • Provider WebView URL - IntroscopeWebView.properties on Provider Enterprise Manager:
      The property introscope.webview.tcp.port defines the port number on which WebView of Provider Enterprise Manager listens for HTTP traffic.
    • Provider API URL -  IntroscopeEnterpriseManager.properties on Provider Enterprise Manager:
      The property introscope.enterprisemanager.webserver.port defines the port number that the web server of Provider Enterprise Manager listens on.

The following graphic shows the Team Center Registration dialog:

6. Click Test configuration.  
    If the values are valid, a message Configuration is valid appears. You can register this instance.

7. Click register.

8. Restart the Enterprise Manager.

The Enterprise Manager has been configured as a Provider.

Note: If you add a new universe or connect a new provider, Experience cards are not automatically created. Automatic creation of Experience cards is only a part of installation or upgrade. For more information about Experience cards, see Configure Experience View.   

When you open the Provider instance of Team Center, you can only see the Enterprise and Security tabs. Team Center is running in provider mode. This Team Center instance is part of the Enterprise Team Center group. Functionality of this Provider instance of Team Center is limited to administration tasks only.

Note: For more information about registering servers, see TEC1129838 and TEC1096384.

Deregister a Provider from the Master on the Master Instance of Team Center

Follow these steps:

  1. Open the Master instance of Team Center.
  2. Click the Providers tab.
  3. Click the Deregister button.
    New buttons appear, Force removal and Cancel.
  4. Restart the Provider to complete the process of deregistration.
  5. In the Settings tab, go to Providers.
    You can now see that the status for the Provider is Unregistered.

Note: If the communication between Master and Provider is interrupted before deregistration is complete, you can force the removal of a Provider. Use the Force removal button.

Deregister a Provider from the Master on the Provider Instance of Team Center

Follow these steps:

  1. Open the Provider instance of Team Center.
  2. Click the Enterprise tab.
  3. Click Deregister this Team Center instance from Enterprise Team Center.
  4. Restart the Provider.
    You have deregistered the Provider from the ETC.

Note: If deregistration fails, a dialog window Deregistration failed, Do you want to force removal? appears. After a forced removal, you can reconnect a provider by following the normal registration process.

Cancel the Registration Process on the Master Instance or on the Provider Instance of Team Center

During the registration process, you can cancel the registration on the Master or the Provider. Click the Cancel registration button in the Master, Settings, Providers Tab or click Cancel the registration process in the Provider, Enterprise tab. You can cancel the registration process at any stage until you restart the Provider.

Cancel the Deregistration Process on the Master Instance or on the Provider Instance of Team Center

You can cancel the deregistration on the Master or the Provider at any stage until you restart the Provider. Click the Cancel deregistration button in the Master, Settings, Providers Tab or click Cancel the deregistration process in the Provider, Enterprise tab.

Set Maintenance Mode

We recommend that you set maintenance mode when you want to upgrade or configure a Provider. When a Provider is in Maintenance mode, the Master does not attempt to communicate with the Provider.

Follow these steps:

  1. Go to the Master instance of Team Center.
  2. Click Set Maintenance.
    No data is passed between the Master and Provider.

To return to the normal mode, click Cancel maintenance.

Note: Nodes from a provider in maintenance mode are missing from the ETC Map and Dashboard for the period that the provider is in maintenance mode.

View Master and Providers in the Map

Follow these steps:

  1. Go to the Map.
  2. Select a perspective No Group.
  3. Add new filter Source cluster.
    In the drop-down list, you can select the URLs of the Master or the Provider.
  4. To view data only from the Master, select the box Enterprise Team Center.
    The Map now only shows the components from the Master instance of Team Center.

Why Is Provider Not Showing? 

The provider is not online for the following reasons:

  • The Provider is in Maintenance mode. To return to normal mode, go to the Master instance of Team Center and click Cancel maintenance.
  • The system token for this Provider has expired. Generate a new token.
  • The Provider is unreachable. Communication channel to the Provider is interrupted.

Provider Registration States

Joining
Once you start the process of registering a Provider to the Master, the Provider is in state Joining. You can revert the process and can cancel the registration at this point. Once you restart the Provider, you are not able to cancel the registration anymore.

Leaving
Once you start the process of deregistering a Provider from the Master, the Provider is in state Leaving. You can revert the process and can cancel the deregistration at this point. Once you restart the Provider, you are not able to cancel the deregistration anymore.

The following image shows all possible connection states.

ETC Provider states

SecureStore

SecureStore is an interface that saves the data about Security Tokens into the APM Relational Database for the ETC Server. SecureStore provides encryption / hashing algorithms and secure storage of arbitrary information.

Registration Log

TeamCenterRegistration.log was added to the Enterprise Team Center logs directory. As the administrator, you can see who and when registered or deregistered a provider.
Example:

2/10/16 10:11:39.782 AM CET [abc.com:8081] http://abc:8081 is registering to master.

WebView does not support a unified view for all clusters in an Enterprise Environment. WebView access is still provided by cluster or a standalone Enterprise Manager. To view information in WebView, select the standalone Provider or MOM from the drop-down list in the top right corner of Team Center. WebView for that Provider opens in a new browser tab.

Was this helpful?

Please log in to post comments.

  1. Sergio Morales Correa
    2017-06-21 06:32

    Hello, Please add backward compatibility to this page, I have received this feedback from Ross from Development, see https://communities.ca.com/thread/241779611-etc-masterprovider-version-compatibility Thanks, Sergio

    1. Lucie Stehnova
      2017-06-21 07:12

      Hi Sergio,

      I spoke to Ross as well and will add the information.

      Thank you very much 

      Lucie