This documentation supports the 21.05 (12.2) version of BMC Discovery.To view an earlier version of the product, select the version from the Product version menu.

Business Application Instance node

A Business Application Instance (BAI) node is a datastore node which represents a running instance of a known business application running in the environment. This node type is composed of a number of Software Instances and/or other Business Application Instances.

Business Application Instance lifecycle

Business Application Instance nodes are created, maintained and destroyed by patterns. Business Application Instance nodes always have a relationship to the Pattern node corresponding to their maintaining pattern.

If a pattern is deleted, any Business Application Instance nodes it is maintaining are immediately destroyed (as are all other nodes it might be maintaining).

Creation/update

When a pattern declares the existence of a Business Application Instance node, it must provide a key for it. If the key matches the key of an existing BAI node, the node is updated, otherwise a new BAI node is created.

Removal

Business Application Instance node can be destroyed either manually or automatically.

To remove a Business Application Instance node manually, find the necessary Business Application Instance, select it in the list and pick Destroy from the Actions list.

Automatic removal happens according to the following scenario

Business Application Instance node patterns normally trigger on the creation or modification of Software Instance or Business Application Instance nodes. In this case, the Business Application Instance nodes are removed using the Cascade removal type; when the triggering Software Instance node or Business Application Instance node is destroyed, the destruction is cascaded to the Business Application Instance. See Cascade Removal.

The situation where the primary data provenance (triggering) SI ages out, that is, not discovered for seven scans and ten days is unlikely as another SI would become primary. The same situation might occur through manual deletion, though this is considered unlikely in a production system.

If a Business Application Instance node is created by a pattern triggered on a node kind other than a Software Instance node or Business Application Instance node, BMC Discovery has no automatic removal behavior. Patterns must be used to explicitly destroy any such Business Application Instance node.

Business Application Instance attributes

The attributes on a Business Application Instance node are as described in the following table:

UI Name
Attribute Name and Type

Description

Type
type string

Business Application type.

Instance
instance string

The application's own name for this instance.

Full Version
version string

Full-resolution version.

Product Version
product_version string

Version publicised by the vendor.

Release
release string

Release name.

Edition
edition string

Edition.

Service Pack
service_pack string

Service pack.

Build
build string

Build number.

Patch
patch string

Patch level.

Revision
revision string

Revision.

Support Email
support_email string

Email address for support.

Support Phone
support_phone string

Phone number for support.

Support Website
support_website string

Web site for support.

Not displayed in UI
_explicit_removal string

Pattern that has taken over removal in place of standard removal.

Key
key string

Globally unique key.

Name
name string

Primary name.

Short Name
short_name string

Short name.

Description
description string

Description of the element.

URL
url string

URL for information about the element.

Business Continuity Critical
business_continuity_critical boolean

If true, element is critical to operation of the business.

Supported by 3rd Party
third_party_support boolean

True if the element is supported by a third party.

Synonyms
synonyms list:string

Other names for the element.

External Identifiers
external_ids list:string

Identifiers for this element in other systems.

Business Application Instance relationships

The relationships on a Business Application Instance node are as described in the following table:

Destination

Relationship

Description

Services This Depends On

Dependant:
Dependency:
DependedUpon:
BusinessService

Services on which this application depends.

Services Depending Upon This

DependedUpon:
Dependency:
Dependant:
BusinessService

Services that depend on this application.

Applications This Depends On

Dependant:
Dependency:
DependedUpon:
BusinessApplicationInstance

Applications on which this application depends.

Applications Depending Upon This

DependedUpon:
Dependency:
Dependant:
BusinessApplicationInstance

Applications that depend on this application.

Database This Depends On

Dependant:
Dependency:
DependedUpon:
Database

Database that this application depends on.

Contains Services

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
BusinessService

Services that form components of this application.

Contains Applications

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
BusinessApplicationInstance

Business applications that form components of this application.

Part Of Service

ContainedSoftware:
SoftwareContainment:
SoftwareContainer:
BusinessService

Services of which this application is a component.

Part Of Application

ContainedSoftware:
SoftwareContainment:
SoftwareContainer:
BusinessApplicationInstance

Higher-level business applications of which this application is a component.

Contains Software Instances

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
SoftwareInstance

Software Instances contained in this application instance.

Contains Virtual Machines

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
VirtualMachine

Virtual Machines contained in this application instance.

Contains Software Components

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
SoftwareComponent

Software Components contained in this application instance.

Contains Software Clusters

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
SoftwareCluster

Software Clusters contained in this application instance.

Contains Load Balancer Services

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
LoadBalancerService

Load Balancer Services contained in this application instance.

Contains Databases

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
Database

Databases contained in this application instance.

Contains Namespaces

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
Namespace

Namespaces contained in this application instance.

Contains Deployments

SoftwareContainer:
SoftwareContainment:
ContainedSoftware:
Deployment

Deployments contained in this application instance.

Hosts

AggregateSoftware:
HostedSoftware:
Host:
Host

Hosts where this instance is running.

Part of Functional Component

ContainedFunctionality:
FunctionalContainment:
FunctionalContainer:
FunctionalComponent

Functional Components that contain this Business Application Instance.

Functional Components

FunctionalContainer:
FunctionalContainment:
ContainedFunctionality:
FunctionalComponent

Functional Components contained in this Business Application Instance.

MFParts

AggregateSoftware:
HostedSoftware:
Host:
MFPart

MFParts where this instance is running.

Details

ElementWithDetail:
Detail:
Detail:
Detail

Details of this application.

Collections

Member:
Collection:
Collection:
Collection

A collection which this Business Application Instance is a member of.

Administrative Collections

Member:
Collection:
Collection:
AdminCollection

An administrative collection which this Business Application Instance is a member of.

Model Definition

Element:
Maintainer:
Definition:
ModelDefinition

Model Definition for this Application.

Not displayed in UI

Element:
Maintainer:
Pattern:
Pattern

Pattern that is maintaining this application instance.

Not displayed in UI

InferredElement:
Inference:
Primary:
SoftwareInstance

Software instance from which the existence of this application was inferred.

Not displayed in UI

InferredElement:
Inference:
Contributor:
SoftwareInstance

Software instance from which one or more attributes of this application were inferred.

Associated Software

InferredElement:
Inference:
Associate:
SoftwareInstance

Software instance related in some way to this application.

Not displayed in UI

InferredElement:
Inference:
Primary:
BusinessApplicationInstance

Application instance from which the existence of this application was inferred.

Not displayed in UI

InferredElement:
Inference:
Contributor:
BusinessApplicationInstance

Application instance from which one or more attributes of this application were inferred.

Associated Applications

InferredElement:
Inference:
Associate:
BusinessApplicationInstance

Application instance related in some way to this application.

Not displayed in UI

Primary:
Inference:
InferredElement:
BusinessApplicationInstance

Application instance inferred to exist due to this application.

Not displayed in UI

Contributor:
Inference:
InferredElement:
BusinessApplicationInstance

Application instance contributed to by this application.

Not displayed in UI

Primary:
Inference:
InferredElement:
BusinessService

Service inferred to exist due to this service.

Not displayed in UI

Contributor:
Inference:
InferredElement:
BusinessService

Service contributed to by this service.

Not displayed in UI

AttachmentContainer:
Attachment:
Attachment:
Attachment

A file attached to this element.

Status

ElementInCategory:
ElementCategory:
Category:
LifecycleStatus

The lifecycle status of this element.

Recovery Time

ElementInCategory:
ElementCategory:
Category:
RecoveryTime

The recovery time specified for this element.

Family

ElementInCategory:
ElementCategory:
Category:
Family

Family of this element.

Organizational Unit

OwnedItem:
Ownership:
Owner:
OrganisationalUnit

The Organizational Unit that this element belongs to.

Location

ElementInLocation:
Location:
Location:
Location

Location of this element.

Support Manager

OwnedItem:
Ownership:
SupportOwner:
Person

The person or owner responsible for the support of this element.

Business Owner

OwnedItem:
Ownership:
BusinessOwner:
Person

The person or owner responsible for this element from a business perspective.

IT Owner

OwnedItem:
Ownership:
ITOwner:
Person

The person or owner responsible for this element from an IT perspective.

Business Application Instance expressions

The expressions on a Business Application Instance node are as described in the following table:

Name

Expression

Description

Favorite

 favorite : isFavorite(#)

Favorite status

 

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