Creating an application manually

As an application specialist, you can manually create application models in the TrueSight console by using devices and groups from BMC TrueSight Infrastructure Management, or devices discovered by BMC TrueSight App Visibility Manager, or a combination of components. You create the application model and define the relationships and dependencies between the components. The application generates events based on the event conditions that are specified with the devices.

To manually create an application that you can monitor, you add devices, groups, or both, and create dependencies between the components. To prevent the loss of data and configuration information, periodically back up your App Visibility databases.

Before you begin

To perform this procedure, you must have Application Administrator-level access.

To create a manual application model and add components

When you create an application, you add devices or groups to the application model. The devices or groups that you add are displayed as nodes model. You can connect the nodes and establish their hierarchy. When you click a node in the application model, details of the node are displayed in a configuration pane at the bottom of the page, as shown in the following figure:

In the TrueSight console, click Configuration > Applications.

On the Applications Management page, click the action menu icon and select Create Application.

Enter the following application details in the Create Application page:

Field	Description
Name	Enter an application name.
Type	(Read only) Because the application is being created manually, the type is Manual.
Synthetic	To enable synthetic monitoring, select ON. If you enable synthetic monitoring, then set up synthetic transaction monitoring after saving the application.
Description	(Optional) Enter an application description.
Importance	Set the importance of the application in your network. Importance is not calculated based on an algorithm. The default setting is Medium.
Status Computation Model	(Read only) Determines the algorithm that is used to compute the status of the application
Associated CI	To associate a Configuration Item (CI) to the application. For more information about how to associate a CI to the application, see Associating-an-application-to-a-service.

The parent node that contains the application name is displayed on the Model tab.

To add devices to the application you are creating, click Configure Devices.
In the Search for Devices box, you can search for devices that you want to add to the application. You can add devices belonging to Infrastructure Management or App Visibility.
Select a device in one of the following ways:
- Click Search to see a list of all available devices.
- Enter a device name, or part of a name, and click Search.
Select the devices that you want to add to the application and click OK.
Click Configure Groups and select groups in the same way that you select devices.
The devices and groups are displayed as unconnected nodes next to the application model.
Connect devices and groups in the application model:
1. Select a device or group you want as a parent of another node.
2. In the node configuration pane below the model, select child nodes under the Add/Remove Dependent Node(s) list.
3. If you want the event status of the child node to be reflected in the parent node, ensure that Enable Status Propagation is selected (it is selected by default). Otherwise, the status of the device is not reflected in the parent node.
4. If you select a group, you can select Enable the Group to be a Cluster, and then enter a value from 1 to 100 to calculate a quorum. The following video (3:49) illustrates how you can use the Quorum status computation model that is used to compute the group impact status in a manual application.
  The [expand] macro is a standalone macro and it cannot be used inline. Click on this message for details.
  This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it. https://youtu.be/nmd3uKwQ7Sw
  
  Click here to see examples of the quorum algorithm.
  
  Some content is unavailable due to permissions.
5. Click Done.
  The device or group is now a part of the application model with its own child and parent nodes.
Click Save.

The application is created and you can view the application model on the Model tab. Use the zoom feature on the right corner screen of the Model tab to zoom in and zoom out the application model.

Note

The nodes in application models are dependent on one another. When you create a model, you determine the dependency and whether the event status is propagated—that is, whether the status of a "lower" node influences the status of a "higher" node, and, ultimately, the status of the application. If you do not connect the nodes, or if events are not propagated, then the node status has no impact on the status of the application.

In an automatically created model, the nodes are automatically dependent and events are automatically propagated.

To create an App Visibility database backup file

Make a physical backup of the App Visibility PostgreSQL databases to protect your data and configuration information from loss. The output of a physical backup contains the data files that the App Visibility server can use directly, resulting in a faster recovery operation.

Warning

While it is always good practice to back up your App Visibility databases, to enable the recovery of data and configuration information for manually created applications with synthetic monitoring, backing up the database is vital. If the TrueSight Presentation Server and the App Visibility portal are unexpectedly disconnected, the manual application configuration information and data might be lost.

On the computer with the App Visibility portal or collector, navigate to the following directory:
- (Windows)
  collector_installationDirectory\collector\bin\db
  or portal_installationDirectory\portal\bin\db
- (Linux)
  collector_installationDirectory/collector/bin/db
  or portal_installationDirectory/portal/bin/db
If the portal and collector are installed on the same computer, they share a database, and you only need to perform the procedure in one place.
Run the following script:
- (Windows) create-pgsql-dump.bat
- (Linux) ./create-pgsql-dump.sh

The script creates a backup of the data in the avdb.dump file in the server component's installationDirectory\ADOP_DB\pgsql\backup directory.

For more information about making PostgreSQL database backup files, see Backup and Restore.

For instructions about database recovery, see Backing-up-and-recovering-the-App-Visibility-database.

Where to go from here

The created application is displayed in the Applications page, where you can view the health of applications in your network.

You can manually set up end-user monitoring, if you have not done so already, to analyze end-user data in the Application View.

Creating an application manually

Before you begin

To create a manual application model and add components

To create an App Visibility database backup file

Where to go from here

On this page