Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

Page tree

Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

Skip to end of metadata
Go to start of metadata

The following sections describe how to add a component, edit component properties, or delete a component from the Presentation Server:

Before you begin

To perform these procedures, you must have Deployment Administrator-level    privilege, or higher.

To add an Infrastructure Management Server

 Click here to expand...
  1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  2. For the component type, select Infrastructure Management Server.

  3. Enter a valid Host Name or IP Address.

    Notes

    • If the "Invalid Host Name or IP Address" message appears, re-enter a valid name or address. The name or address cannot start or end with a dash ( - ), contain any spaces, or exceed 63 characters.
    • If you plan to install Infrastructure Management in the high availability or disaster recovery mode, ensure that you specify a common alias name for both the primary and secondary servers.
  4. Select an HTTP or HTTPS protocol.
  5. Accept the default port number (443), or enter a new value.

  6. Select any of the listed tenants.
    The list includes each tenant defined in the Atrium Single Sign-On system.

  7. Enter a value between 1 to 10 in minutes for the Component Initialization Timeout (min) period.
    This is the time period that the Presentation Server tries to initialize a connection to the component. If the connection is not completed within the time period, the connection to the component will fail.

    Tip

    If the Infrastructure Management server contains a large number of groups, set the Component Initialization Timeout (min) period to 5 minutes. For more information, see Troubleshooting groups .

  8. Clear the Propagate Events box to stop propagation of events from the Infrastructure Management server to the Presentation Server.

    Note

    To enable propagation of events at a later time, delete the Infrastructure Management server and re-add it with the Propagate Events box checked.

  9. Click Save.

Note

If the Infrastructure Management Server is in high availability mode, ensure that the configured cluster name and host names of the primary and secondary Infrastructure Management servers are resolved with the proper IP addresses and reachable from the computer that hosts the Presentation Server.

After adding the Infrastructure Management Server component

 Click here to expand...

The following changes are observed on the TrueSight console after you add the Infrastructure Management Server component as shown in the figure:

Also, from Dashboards > Add Dashboard > Add Dashlets, you can see the Infrastructure Management Server dashlets listed as shown in the figure.

To add an IT Data Analytics Server

 Click here to expand...
  1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  2. For the component type, select IT Data Analytics Server.

  3. Enter a valid Host Name or IP Address.

    Note

    If the "Invalid Host Name or IP Address" message appears, re-enter a valid name or address. The name or address cannot start or end with a dash ( - ), contain any spaces, or exceed 63 characters.

  4. Select an HTTP or HTTPS protocol.
  5. Accept the Port default value (9443), or enter a new value.

  6. Select any of the listed tenants.
    The list includes each tenant defined in the BMC Atrium Single Sign-On system.

  7. Click Save.

After adding the IT Data Analytics component

 Click here to expand...

The following change is observed on the TrueSight console after you add the IT Data Analytics component as shown in the figure.

Also, from Dashboards > Add Dashboard > Add Dashlets, you can see the IT Data Analytics dashlet listed as shown in the figure.

To add the App Visibility Portal

 Click here to expand...

Add one and only one App Visibility portal for each tenant that you monitor with the Presentation Server. In a high-availability environment, the connection to a portal is through its load-balancing server.

In a system integrated with Infrastructure Management, associate the App Visibility portal with an Infrastructure Management Server cell to see the App Visibility events in the TrueSight console.

  1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  2. For the component type, select App Visibility Portal.

  3. In Host Name or IP Address enter a valid fully qualified domain name (FQDN).

    In a high-availability environment, enter the FQDN of the load-balancing server.

    Note

    If the "Cannot add App Visibility Portal using IP address or host name. Use fully qualified domain name instead." message appears, re-enter a valid FQDN. 

    • The name cannot start or end with a dash ( - ) or contain any spaces.
    • The name must be at least 3 segments separated by periods (.).
    • Each segment must not exceed 63 characters.
    • The name cannot be an IP address.

    Examples:

    (error) localhost is not a legal FQDN

    (error) bmc.com is not a legal FQDN

    (tick) hostname.bmc.com is a legal FQDN

  4. Accept the Port number (default value 8100), or enter a new value.
    In a high-availability environment, enter the port number of the load-balancing server.

  5. Select any of the listed tenants.
    The list includes each tenant defined in the BMC Atrium Single Sign-On system, and each tenant can have only one App Visibility portal.

  6. Under Custom Setting, choose one of the following event destinations:

    • Select an Infrastructure Management Server. 
      The list displays the Infrastructure Management Servers that are associated with the tenant that you selected.

    • Select Customize Cell Details, and enter the Cell Host, Cell Port (default value 1828), and Encryption Key for the cell.
      These settings are for the administration cell of an Infrastructure Management Server that is connected to the Presentation Server, or a remote cell that is itself connected to the administration cell of an Infrastructure Management Server connected to the Presentation Server. Only customized cells connected to an Infrastructure Management Server v10.x are supported.
    • Select No Event Channel Selected.
      With this option, no events are reported from the App Visibility portal.

7. Click Save.

After adding the App Visibility Portal component

 Click here to expand...

The following changes are observed on the TrueSight console after you add the App Visibility portal component as shown in the figure:

Also, from Dashboards > Add Dashboard > Add Dashlets, you can see the App Visibility manager dashlets listed as shown in the figure.

To add a Real User Analyzer 

 Click here to expand...
  1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  2. For the component type, select Real User Analyzer.

  3. Enter a valid Host Name or IP Address.

    Note

    If the "Invalid Host Name or IP Address" message appears, re-enter a valid name or address. The name or address cannot start or end with a dash ( - ), contain any spaces, or exceed 63 characters.
  4. Accept the Port default value (443), or enter a new value.

  5. Select any of the listed tenants.
    The list includes each tenant defined in the BMC Atrium Single Sign-On system.

  6. Under Custom Setting, enter a Username and Password for the Real User Analyzer.

  7. Click Save.


To add TrueSight Capacity Optimization 

 Click here to expand...

  1. In the TrueSight console, click Administration > Components.
  2. In the Components page, select the action menu next to Components, and select Add Component.

  3. For the component type, select Capacity Optimization.

  4. Enter a valid Host Name or IP Address.

    Notes

    If the "Invalid Host Name or IP Address" message appears, re-enter a valid name or address. The name or address cannot start or end with a dash ( - ), cannot contain any spaces, or exceed 63 characters.

  5. Select the Protocol as HTTPS or HTTP. The default is HTTPS. 
  6. Accept the Port default value (8280).

  7. Accept BmcRealm as the default tenant, or select any of the listed tenants. The list includes each tenant defined in the Atrium Single Sign-On system.

  8. Click Save.

    The Capacity Optimization component is added and is listed in the Components page.

    The Capacity Views folder is available in the left navigation pane of the console. You can start accessing the views.

    Note

    If Atrium Single Sign-On is not configured correctly with TrueSight Capacity Optimization, you get the following error when you try to access a capacity view: BCO_PS_ERR102: Unauthorized: Capacity Optimization access is denied, check your Atrium Single Sign On configuration.

    For information about configuring Atrium Single Sign-On with Capacity Optimization, see Configuring user authentication.

To add TrueSight Pulse 

 Click here to expand...
  1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  2. For the component type, select TrueSight Pulse.
  3. Enter a valid Host Name or IP Address. For TrueSight SaaS, enter truesight.bmc.com.

  4. Enter a valid Port number.

  5. Select any of the listed tenants (configured using Atrium Single Sign-On).

  6. Under Custom Setting, enter the following details:

    1. TrueSight Pulse Registered Email Id - The email address used to register an account on TrueSight Pulse.

    2. TrueSight Pulse API Key - The authentication token for the TrueSight Pulse account where the data will be sent.

      Tip

      The TrueSight Pulse API key for your account is available in the TrueSight Account Manager. Navigate to My Account > Product Security.

    3. Sync Interval (seconds) - The frequency used to sync data to TrueSight Pulse.

  7. Click Save.

To add TrueSight Intelligence 

 Click here to expand...
  1. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  2. For the component type, select TrueSight Intelligence.
  3. Enter a valid Host Name or IP Address. For TrueSight SaaS, enter truesight.bmc.com.

  4. Enter a valid Port number.

  5. Select any of the listed tenants (configured using Atrium Single Sign-On).

  6. Under Custom Setting, enter the following details:

    1. TrueSight Intelligence Registered Email Id - The email address used to register an account on TrueSight Intelligence.

    2. TrueSight Intelligence API Key - The authentication token for the TrueSight Intelligence account where the data will be sent.

      Tip

      To get the API token

      Your organization's account has a unique API token that must be used for authentication while sending data to TrueSight Intelligence.

      The TrueSight Intelligence API key for your account is available in the  TrueSight Account Manager . Navigate to My Account > Product Security.

      783028008

    3. Sync Interval (seconds) - The frequency used to sync data to TrueSight Intelligence.

  7. Click Save.

To add a TrueSight Intelligence Metric Adapter

 Click here to expand...
  1. Ensure that you have installed the TrueSight Intelligence Metric Adapter. See Integrating with TrueSight Intelligence for metric data

  2. In the TrueSight console, go to Administration > Components, select the action menu next to Components, and select Add Component.

  3. For the component type, select TrueSight Intelligence Metric Adapter.
  4. Enter a valid Host Name or IP Address of the host where the TrueSight Intelligence Metric Adapter is installed.

  5. Select the protocol HTTP or HTTPS.
  6. Enter the Port number that you configured for the TrueSight Intelligence Metric Adapter.

  7. Select the tenant to which you want to associate the TrueSight Intelligence Metric Adapter.

  8. Under Custom Settings, enter the following details:

    1. TrueSight Intelligence Server Host Name - The host name of the TrueSight Intelligence server.
    2. TrueSight Intelligence Registered Email ID - The email address used to register an account on TrueSight Intelligence.

    3. TrueSight Intelligence API Token - The authentication token for the TrueSight Intelligence account where the data will be sent.

      Tip

      To get the API token

      Your organization's account has a unique API token that must be used for authentication while sending data to TrueSight Intelligence.

      The TrueSight Intelligence API key for your account is available in the  TrueSight Account Manager . Navigate to My Account > Product Security.

      783028008

    4. Poll Interval (Seconds) - The data collection frequency (120-3600 seconds) from TrueSight Infrastructure Management.

  9. Click Save.

To edit a component's values

  1. In the TrueSight console, go to Administration > ComponentsFrom the Component list, select the action menu  next to the component's name and select Edit.
  2. Complete the changes in the component's settings and click Save.

Note

After a component is added to the list, the Host Name/IP Address and Tenant cannot be changed. To configure these fields, delete the component from the list and re-enter it with the revised settings.

To delete a component

Warning

When you delete a component, the configuration information for dashlets related to that component is lost. You need to reconfigure the dashlets after re-adding the component.

  1. In the TrueSight console, go to Administration > Components. From the Component list, select the action menu  next to the component's name and select Delete.
  2. To begin the deletion process, click OK.

The component's status is changed to Deleting. The process to delete the component can take several minutes, and is removed from the list after the deletion process is completed. 

When you delete a component, you are also deleting the relevant devices and  groups that are used in a monitored application . You must also delete the application or delete empty nodes from the application .

Note

When you delete a component whose status is not connected, the deletion fails and an error is displayed. Select the action menu  again and select Force Delete to ensure deletion.

Restart any component that you force delete before re-adding it.

When you force delete an Infrastructure Management server, the Presentation Server entry in the mcell.dir file of the Infrastructure Management server is not deleted. Manually delete the Presentation Server entry and restart the Infrastructure Management server.

If you delete a tenant from the BMC Atrium Single Sign-On , you must also delete any component configured to use that tenant.

If you delete an App Visibility portal, App Visibility retains all of its configurations and data, and continues to collect data. The Execution Plans for synthetic transactions continue to run as scheduled.

  • To stop Execution Plans from running, stop the App Visibility portal service . The TEA Agents will gradually stop all Execution Plans associated with the portal.
  • If you reconnect the portal to the same Presentation Server, you will see all of your data as before.

Note

Do not connect the App Visibility portal to another Presentation Server or associate the portal with a different tenant. Automatically generated applications are carried over, compromising data isolation, and manually created applications can show unexpected results or errors.

Related topics

Registering the component products with the Presentation Server

Configuring App Visibility Manager components after installation

Component information

6 Comments

  1.  

    1.  

      1.  

  2.  

    1.  

      1.