Adding and editing components

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 this procedure, 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 console_actionMenu2.pngnext to Components, and select Add Component.
  2. For the component type, select Infrastructure Management 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 default port number (443), 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. 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.

  8. Clear the Sync 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 Sync Events box checked. 

  9. Click Save.

To add an IT Data Analytics Server

Click here to expand...
  1. In the TrueSight console, go to Administration > Components, select the action menu console_actionMenu2.pngnext 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.

To connect an App Visibility portal to the Presentation Server

Click here to expand...

Add an App Visibility portal to the Presentation Server. In a multitenancy environment, add one portal per tenant.

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

Warning

Deleting an App Visibility portal is irreversible. You cannot add a previously deleted portal. Synthetic execution data is lost.

Do not connect a previously deleted 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.

  1. In the TrueSight console, go to Administration > Components, select the action menu console_actionMenu2.pngnext 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).

    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:

    • localhost is not a legal FQDN
    • bmc.com is not a legal FQDN
    • hostname.bmc.com is a legal FQDN
  4. Accept the Port number (default value 8100), 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, 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.

 

To edit a component's values

  1. In the TrueSight console, go to Administration > Components. From the Component list, select the action menu console_actionMenu2.png 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
  • Deleting an App Visibility portal is irreversible. You cannot add a previously deleted portal. Synthetic execution data is lost.
  • 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 console_actionMenu2.png 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 console_actionMenu2.png 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 do not see the data for your synthetic transactions. Do not reconnect a disconnected App Visibility portal.
Warning

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-data-providers-with-the-Presentation-Server

Configuring-App-Visibility-after-installation

Component-information

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*