ProactivePack User & Administration Guide V24.03
Version 24.03
Release notes and notices
Planning
Concepts
ProactivePack is a web-based application that provides administrators and users of BMC TrueSight ...
Architecture
The logical architecture of the solution is as follows. Core component ...
Deployment options
At high-level, ProactivePack can be deployed in 3 ways : The standard product installation con...
General HW and SW Prerequisites
Consider using the ProactivePack appliance or container deployment and skip this part. See Deploy...
Additional prerequisites by module
QuickQueries Prerequisites Consider using the ProactivePack appliance or container and skip this...
Required network ports
The following table summarizes communication ports that need to be open between the different Pro...
Installing & Upgrading
Installation
Consider using the ProactivePack appliance or container deployment and skip this part Serve...
Upgrading from version 21.05 and above
Direct upgrade is possible from version 21.05 onwards, using the ProactivePack console : - ...
Upgrading from earlier versions
There is no direct upgrade path, some manual steps are involved : We assume that the current i...
Configuration basics
Initial configuration 1. Open the ProactivePack console. By default, the “LOCAL” authenti...
Using, Configuring & Administering
Console usage
Login/Logout To logout : - Click on your avatar icon in the top toolbar - ...
General administration procedures
Stopping and starting ProactivePack ProactivePack only “runs” when its web server is running. A...
General configuration
Module reference The main configuration file for ProactivePack module is $PRODUCT_HOME/config/cu...
Security
Introduction The security of ProactivePack uses a system of users and groups to determine what p...
Quick Queries for TrueSight
Overview
Introduction The « Quick Queries » module allows the easy generation of event graphs and reports...
Creating Quick Queries
Common parameters The graph type is chosen from the main selector : All types of quick q...
Creating Query Sets
Dashboards Dashboards let you combine several saved QuickQueries into single pages that can be s...
Scheduling Queries and Reports
Queries and reports can be sent over email on a periodic basis. For this, open the context menu...
TrueSight dashboard integration
In order to integrate ProactivePack Dashboards or Queries in TrueSight Presentation Server, you c...
Database import
The Quick Queries module can be used to query events from a database. In that case, events must o...
Virtual slots
Introduction Virtual slots allow the transformation of “real” slot values into “virtual” values ...
Cross-launch
it is possible to configure custom actions to ease the creation of DDA entries based on events s...
Module Reference - QuickQueries
The main configuration file for the Quick Queries module is $PRODUCT_HOME/config/custom/QuickQuer...
Security - QuickQueries
All permissions must be set in the configuration file of the groups (either using the console or ...
Calendar for TrueSight
Overview
The « Calendar » module provides a simple interface to generate “TIME_FRAME” objects on a target ...
Creating a calendar
In order to create a timeframe, you can use the Calendar module: Recurrence details will be...
Module Reference - Calendar for TrueSight
Custom parameters include : Parameter Description Default/typical value ...
Security - Calendar for TrueSight
The “Calendar” module requires the “View” permission to view calendars, the “Add” permission to a...
Blackout for TrueSight
Overview
The blackout management module allows the definition of event and CI blackouts from a web interfa...
Managing the host list
In the standard object blackout, host values can be suggested in two independent ways, as shown i...
Advanced configuration
Help pages In order to help users understand what they need to input, help files can be added. ...
Custom blackouts
Custom blackout templates can be created using the using the file $PRODUCT_HOME/ /config/custom/c...
Managing blackouts using the event API
Two main ways of communication can be used to send events to the cell and manage blackouts. Depen...
Blackout profiles
Blackout profiles provide a simple yet powerful way to create complex blackout conditions. Multip...
CI blackouts
Users who have the AllowImpactMode permission can create blackouts on Service model CI. Proactive...
Module reference - Blackout for TrueSight
As for other modules, the main configuration files are in $PRODUCT_HOME/config but are overriden...
Security - Blackout for TrueSight
Parameter Description Default/Typical Values AllowActionBLACKOUT...
Data Editor for TrueSight
Overview
Data Editor is an open, versatile module that provides: · Web-based create/update/delete...
Creating a new module
You can create as many new “virtual” Data Editor modules as you need. Each virtual module will po...
Configuring Data Editor
You can define additional parameters for any Data Editor module such as: · Labels for th...
Excel import/export
The contents of a DDA table can be exported from the “View” dialog, in excel or csv format. The u...
Backup/Restore
ProactivePack offers a backup/restore capability directly from the “View” page of any Data Editor...
Module Reference - Data Editor for TrueSight
Parameter Description Default/typical value [<Module Name>] section ...
Security - Data Editor for TrueSight
A series of permissions can be configured at group or user level to provide advanced control on w...
DDA Replication for TrueSight
Overview
The « DDA replication » module provides a simple interface to create and run replication tasks. ...
Running replications
From the console A replication task is simply executed by calling the “TriggerReplication” actio...
Module Reference - DDA Replication for TrueSight
Refer to the Data Editor reference section for common parameters. Custom parameters include : ...
Security - DDA Replication for TrueSight
Refer to the Data Editor security section for details.
Calendar for BHOM
Overview
BMC Helix Operations Management Blackout policies provide the ability to define a recurrence for ...
Creating a calendar
The steps to create a calendar are similar to those defined in Creating a TimeFrame. i The optio...
Module Reference - Calendar for BHOM
Custom parameters include : Parameter Description Default/typical value ...
Security - Calendar for BHOM
The “Helix Calendar” module requires the “View” permission to view calendars, the “Add” permissio...
Data Editor for BHOM
The Helix Data Editor module allows users to manage the enrichment data as used in “Advanced Enri...
Overview
The Helix Data Editor module allows users to manage the enrichment data as used in “Advanced Enri...
Creating a new module
By default, automatic discovery of the dynamic enrichment tables in BHOM is enabled – a module wi...
Configuring Data Editor
You can define additional parameters for any Helix Data Editor module such as: · Labels ...
Test Events
Users with the AllowTestEvent permissions can test the enrichment policy by sending test events d...
Module Reference - Data Editor for BHOM
Parameter Description Default/typical value [<Module Name>] section ...
Security - Data Editor for BHOM
A series of permissions can be configured at group or user level to provide advanced control on w...
Blackout for BHOM
Overview
The Helix Blackout module provides easy management of BMC Helix Operations Management blackout po...
Module reference - Blackout for BHOM
Parameter Description Default/typical value BlackoutConvertionSlots...
Security - Blackout for BHOM
Parameter Description Default/Typical Values AllowActionREOPEN ...
Self-Service Monitoring Portal (SMP)
Overview
The Self-Service Monitoring Portal addresses two important use cases around the configuration of ...
Initial configuration
Module configuration - TrueSight To allow ProactivePack to connect to TrueSight for SelfService ...
Reporting
Concepts The Self-Service Monitoring Portal lets you easily build queries and reports. ...
Monitoring Configuration
Concepts Monitoring Catalog The monitoring catalog contains a certain number of mon...
Database information page
The single-entry point to manage the SMP database is the “Manage database” tile in the ProactiveP...
Module reference - SMP
Parameter Description Default/typical value [SelfServiceMonitoringPort...
Security - SMP
Permission Description Default/Typical values Configure Allows co...
Test Manager
Overview
With Test Manager, developers and testers can define and run test scenarios to verify that event ...
Defining and running tests
1. You define Test sets by adding a new “test set” from the Test Manager main window : ...
Module reference - Test Manager
Parameter Description Default/typical value [TestManager] section ...
Security - Test Manager
Parameter Description Default/Typical Values Add Provides abil...
Scheduler
Overview
The scheduler module acts as simplified interface into the Windows TaskScheduler or the Linux “cr...
Creating a job
Navigate to “Scheduler -> Add” · In the first screen “Command Options”: Sche...
Module reference - Scheduler
Parameter Description Default/typical value [Scheduler] section ...
Security - Scheduler
The following permissions can be set to control access to the Scheduler functions Pe...