Skip navigation
Share:|

For those users who work with the API, we have a new Knowledge Article regarding the valid conditions when creating a REST stream event subscription. These are updated in the documentation and we are sharing the details here with you via The Pulse! I know we have done a quick look at the REST API in the past, but as we had new information to share, we wanted to broaden the audience to the Community!

 

 

What are the valid conditions when creating a REST stream event subscription?
https://docs.bmc.com/docs/display/public/proactivenet96/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/display/public/tsim10/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/display/public/tsim105/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/display/tsim107/Using+the+Publish-Subscribe+REST+approach+to+receive+events

https://docs.bmc.com/docs/TSInfrastructure/110/using-the-publish-subscribe-rest-approach-to-receive-events-719680260.html

 


Slot Value DataType : STRING

Slot Value DataType : INTEGER

Slot Value DataType : LIST OF STRINGS

Data Type : STRING
SLOT LIST :

mc_ueid
mc_client_address
mc_location
mc_service
mc_host_class
mc_host
mc_host_address
mc_account
mc_object_class
mc_object
mc_object_uri
mc_object_owner
mc_tool_class
mc_tool
mc_tool_id
mc_tool_rule
mc_tool_key
mc_tool_sev
mc_tool_address
mc_tool_uri
mc_tool_suggestion
mc_origin_class
mc_origin
mc_origin_key
mc_origin_sev
mc_parameter
mc_parameter_value
mc_parameter_unit
mc_parameter_threshold
mc_event_model_version
mc_owner
mc_long_msg
msg
administrator
mc_relationships
mc_relation_source
mc_smc_id
mc_smc_alias
mc_smc_type
itsm_category
itsm_type
itsm_item
itsm_product_name
itsm_model_version
itsm_manufacturer
itsm_operational_category1
itsm_operational_category2
itsm_operational_category3
itsm_company
itsm_location
itsm_incident_id
itsm_incident_status
pn_device_name
mc_using_organization
mc_using_organization_id



Supported Filter Conditions :

CONTAINS
CONTAINS_IGNORECASE
WITHIN
CONTAINS_ALL
CONTAINED_IN
CONTAINS_ONE_OF
STARTS_WITH
ENDS_WITH
HASSUBSTRING
SUPERCLASS_OF
SUBCLASS_OF
NOT_EQUALS
STARTS_WITH_IGNORE_CASE
ENDS_WITH_IGNORE_CASE
NOT_EQUALS_IGNORE_CASE
MATCHES
AND
OR
NOT
EQUALS
EQUALS_IGNORE_CASE

Data Type : INTEGER
SLOT LIST :

mc_incident_time
mc_incident_report_time
mc_arrival_time
mc_local_reception_time
date_reception
duration
mc_timeout
repeat_count
mc_action_count
mc_date_modification
mc_cause
pn_detail_diag
pn_detail_diag_count



Supported Filter Conditions :

WITHIN
OUTSIDE
GREATER_THAN
GREATER_OR_EQUALS
SMALLER_THAN
SMALLER_OR_EQUALS
EQUALS
NOT_EQUALS
AGELIMIT
IN_RANGE
AND
OR
NOT

Data Type : LIST OF STRINGS
SLOT LIST :

mc_smc_impact
mc_priority
mc_original_priority
status
severity
mc_original_severity
mc_event_category
mc_event_subcategory



Supported Filter Conditions :

LIST_CONTAINS
AND
OR
NOT

Slots of type ENUMERATION are treated as a list of strings
The enumerations contain individual values as strings. So, to filter values LIST_CONTAINS can be used and for identifying individual values, any desired sting filter condition can be used.


SINGLE : essentially and INTEGER value. Never used external to the logic of cell itself.


REAL : Floating point or Decimal value. All the filters which apply on Integer values also apply on REAL values.

Enum : Enumerations of primarily string values

LIST_OF INTEGER : If a SINGLE/Integer value is not sufficient then a list of values can be used. The filter LIST_CONTAINS applies here as well owing to the data type being a list. The filtering on individual values on a list of integers will follow the filter conditions mentioned for numeric values.

LIST_OF REAL : If a REAL/Floating Point value is not sufficient then a list of values can be used. The filter LIST_CONTAINS applies here as well owing to the data type being a list. The filtering on individual values on a list of integers will follow the filter conditions mentioned for numeric values.

LIST_OF Enum : A LIST_CONTAINS condition can be used to find out individual enumerations in the list. Once an enumeration is fetched, LIST_CONTAINS can be again used to find out if enumeration contains a given STRING value. On individual values of an enumeration filter conditions of STRING data type can be applied.

 

Want to learn even more about REST API - check these links out

 

 

TSIM/BPPM - Examples of Event Enrichment using REST API and VMWare PowerCLI

This is a BMC Communities provided and supported example of configuring get_external which is a function (rule) which can run an external program and wait for its termination to continue to process the current event, using data retrieved through an interface object. The purpose of this posting is to show examples of how to use the get_external function within a cell (e.g. pncell, service or any remote event cell) to enrich events by running external an ETL (Extract, Transform and Load) using Pentaho's Communities Edition (PDI - OpenSource ETL).

https://communities.bmc.com/docs/DOC-39107

TrueSight Operations Management REST API for Event Management
BMC TrueSight 10 features a rich set of APIs that allow to interact with all the main aspects of the solution: Data, Events, Cis, Configuration.
https://communities.bmc.com/community/bmcdn/service_assurance/application_performance_and_analytics/blog/2015/10/15/truesight-operations-management-rest-api-event-management

 

TrueSight Operations Management REST API for Central Monitoring Administration
https://communities.bmc.com/community/bmcdn/service_assurance/blog/2016/03/31/truesight-operations-management-rest-api-for-central-monitoring-administration

 

TSIM/BPPM Create Technical Cockpit Reports in MS Excel using REST API - Example using JBoss Metrics
This is a BMC Communities provided and supported example of configuring an ETL which will query BPPM or TSIM via REST API and  collect aggregrate monitoring metric values for any number of days up to 1 month (maximum) and dump to a Pivot Table within an MS Excel workbook
https://communities.bmc.com/docs/DOC-39488

SIM/BPPM - Create vBlock Reports in MS Excel using REST API – Example
This is a BMC Communities provided and supported example of configuring an ETL which will query BPPM or TSIM via
REST API  and  collect aggregrate monitoring metric values for any number of days up to 1 month (maximum) and dump to a Pivot Table within an MS Excel workbook
https://communities.bmc.com/docs/DOC-39532

 

Rest API setup – Setting up a REST API environment - Video

 

If you are not familiar with REST API, here is a good link to get you started -https://communities.bmc.com/docs/DOC-44797

 

Any questions about REST API? Please open a ticket with Support and we will be glad to assist!

 

AMIGO.jpg

 

 

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.

The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here:

https://docs.bmc.com/docs/TSOperations/110/amigo-checklist-for-truesight-operations-management-724138985.html?src=search

 

Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

Computer.png

NEW Knowledge Articles for TrueSight! Check out these new articles available today!

 

 

000147069      How to use the API to list details for all the policies in TrueSight

 

000147076      ISN consuming high virtual memory, but resident memory value is as expected

 

000147485      "Make Global" is greyed out in the Edit Events Table View

 

000147541      Any action needed for TrueSight or BPPM with Meltdown and Spectre vulnerabilities?

 

000147961      "Unable to retrieve user policies" seen when attempting to login to the BPPM Administrator Console

 

000148035       Is it possible to run the command pw ha enable more than once?

 

000148107       Staging Adapter port cannot be empty


000148215       Cannot add some slots to Table View in TSPS

 

000148286       Is it possible to trigger BPPM/TrueSight remote action with timer?

 

000148311        How to stop TrueSight Self Monitoring alarms

 

 

 

 

 

Feedback.jpg

We want to hear from you.. what to do you want to see in our monthly blog post? What types of topics do you want to learn more about? Any feedback is appreciated.

 

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs

Share:|

As the year ends, we want to take time to thank all our customers and all our users of TrueSight, BPPM, and all our BMC products. We are grateful that you are using our tools to help enhance the workday. In Support, we strive to help you with any issues you face and we want to get you back up and running as soon as we can.

We can’t do it alone though, there is an entire Community of people and resources that help make application success possible.

 

It often takes a village… and ours is very diligent in making sure there is content and opportunity out there for the TrueSight/BPPM user. Here are a few resource references just in case you might need assistance.

 

Are you familiar with our TrueSight Operations Management Blog area in the BMC Community? If not, check it out, there are lots of great articles, videos, and tips

https://communities.bmc.com/community/bmcdn/service_assurance/blog

Videos - You can find more how-to videos on YouTube in the TrueSight Operations Management | How-To Videos playlist.

Hotfixes can be requested through a ticket to Support, some can be found here:

ftp.bmc.com/pub/BPPM/PATCHES/
ftp.bmc.com/pub/TSPS/PATCHES/
ftp.bmc.com/TSIM/PATCHES/

 

Regarding hot-fixes, it is best to check with Support to see which is the latest HF needed for your environment. Recent fixes include: BPPM 9.6 FP2 HF .027 is available and TS 10.7 Fix Pack 2 is available

All Fix Packs and Release Version files are available on our EPD site - https://www.bmc.com/available/epd.html

Training Opportunities can be found here
https://www.bmc.com/education/courses/truesight-infrastructure-management-training.html

 

Too many links to refer to? Check this out:

If you need all our various resources in one page, visit this link - https://docs.bmc.com/docs/productinfo/truesight-infrastructure-management or https://docs.bmc.com/docs/productinfo/truesight-operations-management

These pages have links to our Knowledge Base, Documentations, Frequently Asked Questions, and even Training Opportunities! These are great links and we hope you take advantage of having these resources at your fingertips.

If you see an opportunity to improve these resource options, please do let us know as we appreciate feedback.

 

Webinar Details:

Did you attend our latest TrueSight Webinar? The Connect with TrueSight Operations Management v11.0 Best Practices Webinar Series held another successful webinar on November 14th to provide a TrueSight 11.0 Overview. Missed the session? Click the link below and select the Recorded Session link to see what you missed.

Interested in attending future Webinar sessions or have suggestions for topics, please visit the link below to see upcoming Webinar dates and topics or to provide feedback for what you want to see!

Webinar Details

I know there will be several sessions in 2018, so please keep an eye on the link above.

 

AMIGO.jpg

 

Interested in upgrading to TrueSight 11.0?

Upgrading can be intimidating and time consuming, but the upgrade to TrueSight 11.0 can be made less painful with the use of our AMIGO program! Users are open to use the AMIGO reference to request assistance with reviewing your upgrade plans.

If you are thinking of upgrading, check out the upgrade documentation here

https://docs.bmc.com/docs/TSOperations/110/upgrading-722060436.html

 

Also, be sure to check whether you need to do a phased upgrade depending on your current product and version. There’s a quick chart to check at this link

https://docs.bmc.com/docs/TSOperations/110/supported-upgrade-paths-for-infrastructure-management-722060460.html

 

Finally, when upgrading from an earlier release that requires phased upgrades, consider the benefits of migrating. For more information about the pros and cons of migrating, see Benefits and risks to upgrades and migrations.

https://docs.bmc.com/docs/TSOperations/110/benefits-and-risks-to-upgrades-and-migrations-722060445.html

 

Regardless of where you fall in the upgrade/migrate path, let us help you!

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.

The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here:

https://docs.bmc.com/docs/TSOperations/110/amigo-checklist-for-truesight-operations-management-724138985.html?src=search

 

Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

 

Computer.png

 

Here are a few new Knowledge Articles added over the last month:

 

000146679 When upgrading TSPS to v11 the dataUpgrade.bat fails

000146337 Missing critical alerts because the event rules owner no longer exists

000146289 TrueSight Operations Management Reporting password stored in browser memory

000146691 "User does not have set environment variable permissions" seen when trying to install TrueSight on Linux

000146258 What is the best way to programmatically get the list of agents connected to all IS?

000146086 Is non CDB Architecture supported with TSIM?

000145851 How to permanently change the Device Details default view on the TSPS Console?

000146288 Is it possible to import/migrate baseline data from one BPPM/TSIM instance to another TSIM instance?

000146018 Configuration Error: Received decrypted password! It was encrypted upon receipt!

000146006 Backslashes (\) are getting ignored in a saved search when ITDA is launched from Tool Menu -> “Launch BMC TrueSight IT Data Analytics” in TSIM Console.

 

 

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs

 

 

happy-new-year-2018-tech-style-gif.gif

Share:|

Do you use policies? Do you find them easy to use? How would you like to see them improved? We want your feedback, please comment below or submit an Idea via the BMC Community to help us improve policy functionality to better meet your needs.

 

Here’s a quick overview of policies:

PATROL Agents collect performance data and generate events for availability metrics. A monitoring solution is a set of instructions that the PATROL Agent uses to monitor objects in your environment. For a PATROL Agent to monitor a system, it needs instructions and information about what to monitor, how and when to generate an alert or event, and where to send the data and events. Solution administrators and tenant administrators configure these instructions and information in policies. A policy is applied to the PATROL Agents based on conditions such as Agent name, Agent port, Agent version, Agent tag, and so on. If an Agent matches the conditions defined in multiple policies, then the configuration across the policies are applied to the Agent.

The following types of policies can be created:

  • Monitoring policy: To define and configure monitoring criteria and apply them to selected PATROL Agents. Some examples of monitoring criteria are configuring monitoring solutions on PATROL Agents, creating thresholds on Infrastructure Management servers, and copying baselines between similar instances of Infrastructure Management servers.
  • Blackout policy: To stop a PATROL Agent from performing certain actions such as stopping data collection, event generation, or recovery actions. This policy applies to PATROL Agents and the related data collection, events, and recovery actions. It does not apply to the behavior of the Infrastructure Management server. Before defining this policy, you must define the time frame for which you want the policy to be applicable.
  • Staging policy: To configure a PATROL Agent to communicate with the Infrastructure Management server by using a specified Integration Service. When a package is deployed, and installed, the PATROL Agent checks in through the staging Integration Service. When the PATROL Agent checks in, the Presentation Server evaluates the Agent selection criteria in a staging policy and uses that data to automatically assign a data collection Integration Service (or Integration Service cluster) to the PATROL Agent.

 

When new PATROL Agents check into the environment, because of the configured policies, the Agents automatically receive the appropriate configuration and begin monitoring according to it. As administrators, you need not take any additional steps to apply policies. When an existing policy is modified, the changes are automatically applied to the respective Agents without having to manually initiate the application of these changes. These capabilities significantly speed up and simplify the administration process assuming all policy configurations have been created appropriately. For more information about working with policies, see Managing policies

 

TrueSight uses Role-based access for policies

Authorization profiles enable role-based access (RBAC) to policy management. Each authorization profile is associated with one or more Remedy Single Sign-On realms and comprises user groups, roles and permissions, and objects. For more information, see Role-based access

 

By default, Solution Administrators have full access to all policies in all realms (tenants). Tenant Administrators have full access to all policies in their realm (tenant). Do you find the role based access suitable or do you see areas for improvement?

 

Use the Infrastructure Policies page to view and manage a policy. By default, Solution Administrators have full access to all policies in all realms (tenants). Tenant Administrators have full access to all policies in their realm (tenant). Certain policy management operations can only be performed by the owner of the policy. For more information about the different types of policies, see Policy management

 

To view the Infrastructure Policies page, in the navigation pane of the TrueSight console, expand Configuration and select Infrastructure Policies.

  See Also: Specifying objects in an authorization profile and Working with event management policies

 

To create, modify, or copy a policy

Depending on the type of policy that you want to create, in the Infrastructure Policies page, click the tab for that policy type.

  • To create a policy: Click the Main action menu and select Create Policy. Alternatively, click the Create Policy button. The Create Policy page is displayed where you can configure the policy as per your requirements.
  • To modify a policy: Click the action menu of the policy that you want to modify and select Edit. The Edit Policy page is displayed with the policy configurations that you can modify as per your requirements.

NOTES:

  • Only the owner of a policy (user who creates the policy) can modify the associated user group and sharing status of a policy.
  • A policy can be modified by only one user at a time and it will be locked for other users. A Solution Administrator can forcibly unlock a policy to modify it. Tenant Administrators can unlock policies within their specific tenants.
  • Users of the associated user group can view, enable, disable, delete, and modify the policy. They cannot modify the associated user group and sharing status of the policy.

To create a copy of a policy: Click the action menu of the policy that you want to copy and select Copy. The Create Policy page is displayed with the configurations of the copied policy. You can modify the configurations as per your requirements.

 

NOTE: If you are not a user of the associated user group in the original policy, then you need to first select a user group. If the selected user group does not have access to monitoring solutions or configuration tabs from the original policy, then they will not be available in the copied policy.

 

 

For more information, see the following topics:

Policy type

Reference

Monitoring

Defining a monitoring policy

 

Blackout

Defining a blackout policy

Staging

Defining a staging policy

 

 

To delete a policy

  1. Depending on the type of policy that you want to delete, in the Infrastructure Policies page, click the tab for that policy type.
  2. Ensure that the policy to be deleted is in disabled state. If not, click the action menu of the policy and select Disable.
  3. Click the policy action menu and select Delete.

To enable or disable a policy

  1. Depending on the type of policy that you want to work on, in the Infrastructure Policies page, click the tab for that policy type.
  1. Click the policy action menu and select Enable for an already disabled policy, or Disable for an enabled policy.

NOTE: Do not enable policies until they have been tested and validated in the development and test environments.

 

 

To share a policy with the associated user group or remove the applied sharing

You can share or remove sharing with the associated user group only for policies that you have created.

  1. Depending on the type of policy that you want to work on, in the Infrastructure Policies page, click the tab for that policy type.
  2. Click the policy action menu and select Share or Remove Sharing depending on the current sharing status of the policy.

To find or view a specific policy

  • Use any one or a combination of the following filters on the page to search for a specific policy:
  • Tenant filter by using the tenant action menu
  • Policy properties such as Enabled, Disabled, Shared, and Not Shared by using the Quick filters
  • Policy name by using the Policy search icon.
  • To view details of a policy, click the policy name.

 

That is a bit about policies and what you can do with them. We have seen many users who use policies and may use them extensively, so we do understand the importance of improving policy performance and scalability.

 

Common Policy Issues in Support

Over the years, we have seen a few types of issues with policy and policy management, here are a few of the more commonly seen issues;

 

  • Policies are not getting applied to Patrol Agent - We are facing issues where the policies created from CMA shows applied Patrol Agent and in Managed services it shows no policies are applied - this can show up as any variation of policies are not being applied. The cause varies and the recommendation is to collect the tssh dump export on the TSPS server and the PATROL Agent logs as we will need to confirm what is happening on both TSPS and PATROL Agent.

 

  • TSPS 10.5:Poll interval getting reset after saving the TSPS Policy and  TSPS 10.5:Timeout parameter getting reset after saving the TSPS Policy

        Inside "Infrastructure Policies" I modify the timeout parameter from 30 seconds to 60 seconds and save the policy. The message is "Policy is updated". However, the changes were                  not  saved. Solution: A point-fix for 10.5 was created to address this. If you encounter this issue, please contact BMC Support to obtain this hotfix

 

  • "This policy cannot be edited now because it is already open for editing by another user" seen when attempting to edit an Infrastructure Policy in TrueSight
    Solution: Hold SHIFT and ALT, then click on the three menu buttons for the Infrastructure Policy. This will give you an Unlock menu pick. Select that to fix the problem.

 

  • "The policy changes cannot be saved. Bad Request " error upon any attempt to create a simple policy in TrueSight 10.5

        Solution: There is a known issue with TS 10.x and TSCO 10.5 plugin

        There is a fix for the issue in the CHF for TSCO 10.5 available at: ftp://ftp.bmc.com/pub/perform/co/chf/10.5.00/

 

          Installation steps:

          1. Login in TSCO as an administrator

          2. Go to Administration >SYSTEM >Maintenance

          3. Upload and install the package 10.5.00.01.C00003_AS.patch using the "Upload patch or additional package file" section at the bottom of the page

          4. Wait until the installation of 10.5.00.01.C00003_AS.patch is completed (status = ENDED)

          5. Do the same steps #3, #4 for the package 10.5.00.01.C00003_EE.patch

          6. Go to Administration >VIEWS >Views and download the new version of the co-plugin

          7. Update the new version of the plugin in TSPS  with the steps reported here:

 

  • The Presentation server is unable to retrieve the Policy data. Contact your TrueSight Administrator

       The TrueSight.log shows:ERROR [Thread-39,EXECUTOR_POOL] CMA BMC_TS-CMA854101 Unable to retrieve policies

       java.lang.StringIndexOutOfBoundsException: String index out of range: -11

       Solution: This was seen in TrueSight 10.5.00 and a pointfix has been created, please contact BMC Support if you see this issue on 10.5.00

 

  • How to move BPPM 9.6 CMA policies to TrueSight?
    Solution: Here are the steps to export a CMA BPPM 9.6 policy and import it into CMA TS for any user

        ++++++++++++++++++++++++++++++++++++++++
      1) Export the policy from BPPM, this will create a .mo file with the policy defined in a json format 

      2) Open the .mo file in a editor

      3) At the bottom of each policy is a section which includes the following field names: name, id, type, agentSelectionCriteria, tenant, precedence,description, enabled
      4) Add the following three new fields to the policy json record: shared, associatedUserGroup, owner. Change the owner field to an ldap user
      "shared" : false,
      "associatedUserGroup" : "Administrators",
      "owner" : "admin",
       4a) Where
             owner - Username to which the ownership of this policy belongs to.
             associatedUserGroup - This should be one of the groups associated with owner.
             shared - this is to indicate if the policy is shared with other users from the above group.
       5) In the policy make sure the values for tenant (name, id) point to the correct SSO realm. In my test policy it looks like the following
                "tenant" : {
                "name" : "BmcRealm",
                "id" : "BmcRealm"
                 },
      6) Here is a sample of the policy section after the changes
                "precedence" : 100
                "name" : "Policy name",
                "id" : "b1f2ae2e-6b69-5aa2-1234-8a4dee93d18d",
                "shared" : true,
                "associatedUserGroup" : "Administrators",
                "owner" : "jdoe",
                "type" : "monitoring",
                "enabled" : false,
                "description" : "",
                "tenant" : {
                "name" : "BmcRealm",
                "id" : "BmcRealm"
                  },
                "precedence" : 100,
                "agentSelectionCriteria" : "agentName STARTS_WITH \"server_name\" "
       7) Copy this file to the TS server
       8) In a command window go to the following directory /truesightpserver/bin
       9) Invoke the following command. Note: just use the directory do not specify a file, the utility will import all .mo files in the directory
           cmapolicymigration.bat import -d <Directory location for the exported policy files>
           ++++++++++++++++++++++++++++++++++++++++

 

  • Without apparent reason, Monitoring policies in CMA get unexpectedly disabled, which stops the monitoring in all the applicable Patrol Agents.

        TrueSight 10 requires Atrium SSO for authentication. Internally a validation job is scheduled to run in TSPS every 30 minutes after TSPS restart. The policyValidationTask  and is

         designed  to disable the policies with associateUserGroup which is not present in SSO anymore. In this case, the policies are disabled even if only Atrium SSO server is down/stopped,             which should not be the case. (the policies can get disabled within between 1 and 30 minutes, depending on next planned execution of the validation task that can be see in CMA.log          file). BMC has created Defect ID QM001886940 to address this.

 

     Workaround

     Currently there is no config change available to stop/unschedule the policyValidationTask job, however to minimize the impact until the defect is addressed in coming release, we can                increase the time the validation task is executed.

 

     Below are the steps to increase the property that controls the validation task execution.

     The property that controls the validation task in TSPS server is 'policyValidationSyncPeriod'.

     This property has a  default value of 30 (minutes), so we can modify it to not launch every 30 mins but to launch for instance once per day (1440) or even to a bigger value (99999).       Follow the steps below:

 

                1. Open a CMD window in TSPS machine and change directory to TS_HOME\bin

                   (Ex. C:\Program Files\BMC Software\TrueSightPServer\truesightpserver\bin)

 

                2. Change the property value in TSPS to a higher value (for instance 1440 minutes which is 1 day, it can be even set it to much higher value) with command:

                   tssh properties set policyValidationSyncPeriod 1440

                   You can list and see the new value running command:

                   tssh properties list

 

                3. Stop and Start TSPS for the new value to take effect:

                   tssh server stop

                   and then run:

                   tssh server start

 

                4. After the config change, the first Validation task will be launched after the new number of minutes specified in the step #2

 

These are just a few of the types of issues we see. If you do have any questions or encounter issues with policies, roles, or anything TrueSight related, please do not hesitate to contact BMC Support.

AMIGO.jpg

 

Interested in upgrading to TrueSight 11.0?

Upgrading can be intimidating and time consuming, but the upgrade to TrueSight 11.0 can be made less painful with the use of our AMIGO program! Users are open to use the AMIGO reference to request assistance with reviewing your upgrade plans.

If you are thinking of upgrading, check out the upgrade documentation here

 

Also, be sure to check whether you need to do a phased upgrade depending on your current product and version. There’s a quick chart to check at this link

 

Finally, when upgrading from an earlier release that requires phased upgrades, consider the benefits of migrating. For more information about the pros and cons of migrating, see Benefits and risks to upgrades and migrations.

Regardless of where you fall in the upgrade/migrate path, let us help you!

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.

The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here

Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

Connect with TrueSight Operations Management Webinar Details

Did you attend our latest TrueSight Webinar? The Connect with TrueSight Operations Management v11.0 Best Practices Webinar Series held another successful webinar on November 14th to provide a TrueSight 11.0 Overview. Missed the session? Click the link below and select the Recorded Session link to see what you missed.

Webinar Recording

 

The next session is right around the corner, don’t miss - TrueSight Operations Management version 11.0 Architecture and Scalability - December 12th, 2017 – Check the link above closer to the date for registration information, or let us know here and we’ll add you to the invite list to make sure you’re notified. Comment below with your name and email address and we’ll send the invite directly to you!

 

TrueSight 10.7 users – Fix Pack 1 has been released

For anyone using 10.7 and who has not had the opportunity to, please plan to apply Fix Pack 1. The details for the fix can be found hereJ

Just a note of caution:

The 10.7 Fix Pack 1 includes the following cumulative hotfixes:

  • TrueSight Presentation Server 10.7.00.000.018
  • TrueSight Infrastructure Management 10.7.00.000.022

If you have already installed a hotfix later than these versions on a product, do not install 10.7 Fix Pack 1 on that product.

 

 

Computer.png

New Knowledge Base Content

Here are a few new Knowledge Articles added over the last month:

 

 

Header 1Header 2
000145493Compatibility of Patrol Reporting with Oracle DB12.2.0.1
000145240

Custom KM is not being seen in Global thresholds tab or the server threshold configuration window

000145110

Cannot load modules/mod_ssl.so into server: libssl.so.1.0.0: cannot open shared object file: No such file or directory" seen when trying to start httpd process on BPPM server

000144878Notification policy not sending emails for events MC_CELL_ACTION_RESULT shows exit code 0 
000144424jserver sending updates for PATROL_ENRICHMENT to cell yet no slots have changed. This causes the cell to become intermittently busy
000145112PORT_NON_ROOT_USER_VALIDATION_PORT message reports that the user does not have permission to use port number 80 during the TSOM 11.0 install
000144701Poor performance and response time from the Operations Console in IE after upgrading to BPPM 9.5 Service Pack 2
000144651How can we extract the BEM Match table information?
000145539Unable to De-register Child from CMA - One or more Integration Service is associated with Cluster
000144858Vulnerability remediation for BMC TrueSight 10.7

 

 

 

Feedback.jpg

 

Feedback Request:

We’re back with our monthly blog and we’re open to hearing your thoughts on topics and areas of concern which may be of benefit to you! Post your comments regarding what you want to see!

Share:|

TrueSight Operations Management Suite offers many features which will help ensure availability in your environment. One of the main features is high availability options. Does TrueSight offer high availability within its components? It sure does.

 

Many of the components used within the TrueSight Operations Management suite are HA capable. There have been improvements in the overall HA configuration and functionality and we continue to strive to make it easier for customers to setup an HA environment. When deciding whether to implement HA you would need to determine which components will be able to support the HA setup. The TrueSight Operations Management Suite has HA options for TrueSight Presentation Server, TrueSight Infrastructure Management, App Visibility Manager, Real End User Experience Monitoring Software Edition, and Atrium Single Sign On.

 

Are you familiar with HA? - High availability (HA) is a redundancy operation that automatically switches to a standby server if the primary server fails or is temporarily shut down for maintenance. HA enables the TrueSight component to continuously function so that monitoring of your mission-critical systems is continuously available. HA utilizes a load balancer software component as an HA proxy to switch operations between the primary and standby server.

 

What does the TSPS HA architecture consist of?

The HA architecture for the Presentation Server as well as Infrastructure require a primary server, secondary server, and a load balancer. It’s that simple. See the image below for the Presentation Server HA architecture

  • Primary server
  • Secondary server
  • Load balancer (HAProxy)

 

HAArchitecture.png

 

 

Why is a load balancer required?

In a successful HA deployment, the secondary server must take over when the primary server is not working, or the primary server is ready to take over, a load balancer is required to direct the client requests to the active server. The load balancer will act as a unified point of access for the Presentation Server.

 

When do I have to configure the HA setup? What if I installed all components already?

Customers have two options for configuring an HA environment:

  • Deploying in HA mode during the installation process
  • Deploying in HA mode post-installation

Both options are user friendly and both options allow for easy configuration of primary and secondary presentation servers. See this link for more details.

 

How is the transfer of the service between the active and standby Presentation Server handled?

In the Presentation Server HA mode, the secondary server becomes the active server if the primary server stops operating, due to an event that triggers a server shutdown. Once the primary server is up and running, it does not become the active server by default. The primary server is still in a standby mode. The service can be transferred back to the primary server, or the primary server can remain in standby mode.

Note: Do not stop the active server immediately after restarting the standby server. The cache synchronization takes time to complete and is dependent on your environment.

 

Is there a way to tell which server is the primary/active server on TSPS?

The tssh ha status command provides information about the primary and secondary servers and the current status.

From the <Presentation Server installation directory>\truesightpserver\bin directory, run the tssh ha status command. An example command output for the primary server is provided below:

Primary server

Real-time Stats details
==============================
Node State :> Active
Active since :> Oct 06, 2017 11:29 AM

Primary node details
------------------------------

TSPS FQDN :> xyz.bmc.com
Cache replication port :> 7800
Control port :> 8800

Secondary node details
------------------------------
TSPS FQDN :> xyz2.bmc.com
Cache replication port :> 7800
Control port :> 8800

Load Balancer
------------------------------
FQDN
:> lb123.bmc.com

 

 

What are some important limitations to note regarding the Presentation Server HA environment?

  • If the host name of the Presentation Server is mapped to the loopback address in the etc/hosts file, HA will not work. Ensure that the hosts file is not updated with the loopback address
  • If the primary and secondary servers are both disconnected from the network, you must restart both servers, and set one server to the active mode and the other server to standby mode.
  • The primary and secondary server must have identical setups, including the hardware platform, operating system, and post-installation configuration
  • The Infrastructure Management PATROL Repository is not replicated. Import the repository on both servers. For more information, see Importing the Infrastructure Management repository

 

TrueSight Infrastructure Management contains lots of moving parts, what can you tell me about the HA structure and requirements?

 

Consider the following requirements before you configure HA for Infrastructure Management.

 

Database

 

 

 

 

 

TrueSight Operations Management component

 

 

 

 

Third-party load balancer

 

 

 

Network

  • Application-level HA is supported only with an Oracle database. You cannot configure application-level HA with the embedded SAP SQL Anywhere database. If you are using the embedded SAP SQL Anywhere database, consider the HA cluster mode.
  • BMC recommends that you use Oracle RAC.

 

  • TrueSight Presentation Server version 10.7 and later.
  • Two TrueSight Infrastructure Management servers version 10.7 and later, designated as the primary and secondary Infrastructure Management servers.
  • The primary and secondary Infrastructure Management servers must have identical hardware and operating system configuration.
    See the hardware and operating system requirements.

 

 

 

  • A third-party load balancer with reverse proxy configuration support.
  • If using a software-based load balancer, you must install it on a separate server.
  • Tip: If you choose to use NGINX as the load balancer, you can use the attached nginx.conf file as a server configuration example.
  • Configure the load balancer such that the active node is determined based on the HTTP response of 200 and all data is routed to it

 

Ensure that:

  • Latency between the nodes is consistently not more than 20 ms
  • A minimum bandwidth of 20 Mbps is available at all times
  • Ensure that the following ports are available:

 

LoadBalancer.png

 

What does the Infrastructure Management HA architecture look like?

The TSIM HA setup is similar in design to the TSPS setup in that there is a primary server, secondary server, and a required load balancer. BMC does not provide a load balancer so this would be a third party load balancer.

 

HA deployment for Infrastructure Management

 

TSIMHA.png

 

In an HA deployment of Infrastructure Management, the load balancer is installed on a separate server and redirects requests to the active node. The load balancer provides a single point of access to the HA-enabled Infrastructure Management server. For details on installing and configuring the Infrastructure Management server for application high-availability review the details here

 

When we have TSIM running in ha mode how do we configure the publishing server and how does CMDB manage the cell communication?

You configure TSIM in HA mode without consideration of CMDB.  When you configure the CMDB integration in the TSIM Ops Console you just point to the CMDB server hostname or load balancer name if in AR server group.  This updates the pserver.conf file in %MCELL_HOME%\etc.   This is also done initially during installation of TSIM, see "Preparing for BMC Atrium CMDB integration".

 

Is it possible to install TrueSight Infrastructure Management server in an HA OS cluster mode?

Yes, it is possible, please see this link for more details.

 

I am planning to upgrade TSIM which is currently in HA mode, what do I need to know to upgrade?

Upgrading in HA cluster mode requires a two-part upgrade: one on the primary node and the other on the secondary node, which serves as the secondary node in the event of a failover. Click here for more details on the TSIM upgrade information. Click here for the TSPS upgrade information

 

How do I deploy other Infrastructure Management components in HA mode? For example, Data collection Integration Services, Staging Integration Service, Event management cell, PATROL Agent, etc?

The details for each component are listed here.

Note: It is important to review each component and its active/standby configuration as some components are active/passive and some are not.

 

If I have setup an HA TrueSight Operations Management environment and want to integrate other components, are there special instructions to consider?

Yes, if you have configured TrueSight Infrastructure Management for high availability, and are integrating it with the following products, you will need to perform the procedures detailed here. There are details for each of the components such as BMC Service Resolution, Atrium CMDB, Impact Integration Web Services server, My IT, and TrueSight IT Data Analytics.

 

Can the App Visibility Manager be configured for HA?

Yes it can.  An App Visibility Manager HA deployment comprises the following systems, each on a separate computer:

  • Active node
  • Standby node
  • Third-party load balancer

The following diagram shows more than one load balancing server, but you can configure one load balancer to manage the failover for all the different components. All communication to the App Visibility server components goes through that component's load balancer. The diagram shows only one App Visibility collector cluster; your system can have many.

 

HA deployment for App Visibility Manager

AppVisHA.png

 

 

In an HA deployment of App Visibility Manager, the load balancer is on a separate computer and redirects requests to the active server. In this way, the load balancer can provide a single point of access to the App Visibility server components.

  • When you install the App Visibility server, you can enable high availability for the App Visibility portal, App Visibility collector, or both.
  • To deploy an HA component, install the component twice to create a failover cluster, which is a pair of servers that work together to maintain high availability.
  • When you install a component, enable HA and provide details for its alternate node. Then run the installation utility on the second computer, enable HA, and provide details for its alternate node (that is, the first component).
  • The computers on which you install the component pairs must have the same hardware and operating system configuration.
  • The first server that joins the failover cluster is the active node, and its pair becomes the standby node.
  • When you install the App Visibility collector, provide details of a third-party load balancer for the collector pair. The load balancer information is required to establish communication between the App Visibility agents and the collector.

 

Where can I learn more about the high availability options for Real End User Experience Software Edition?

The details of HA configuration for this integration are located here. For the Real User Analyzer, do not configure the isolation response to switch power off. Also, BMC recommends that you test all failover targets to ensure that any Real User Collector feeds are available to the Real User Analyzer.

 

Is there a best practice document for TrueSight HA?

Yes, please see “Using ASSO with TrueSight FAQ including High Availability Best Practice (V1.0)” - Using ASSO with TrueSight FAQ including High Availability Best Practice (V1.0)

 

Is it possible to install BMC TrueSight 10 SSO High availability components on the same servers where TSPS is also installed in an HA fashion?

For details, please visit our Community Link - https://communities.bmc.com/docs/DOC-80597

 

What is one issue that you have seen repeatedly about High Availability setups?

One issue we do see periodically is a failure of the database service to startup after a failover. This issue is mentioned under our Troubleshooting page found here.

 

This blog post cannot possibly address all questions surrounding HA configuration in TSOM, but if you do have any questions or need help with HA setup, please contact Support for assistance as we will be glad to help you with your HA concerns.

 

Computer.png

 

New Content for our Knowledge Base

Here are a few of the newly created Knowledge Articles over the last month:

 

 

Knowledge Articles

What type of data/configuration/events are continuously synchronized between the 2 TSIM servers when installed in application HA mode

How to replace the SSL server certificates with certificates issued by a CA/Trusted Source within TrueSight 10 Components
Unable to add remote device or agent to BMC ProactiveNet Performance Management
Max Queue size breached errors encountered in BMC ProactiveNet Performance Management Suite 9.x Integration server was unable to connect due to full message queue errors
Is there a query to check on the devices MFD in TrueSight 10.7?
Is there a way to delete TSIM devices via the CLI or is there an API to delete devices?
Truesight Application Visibility data lost during the upgrade to TSPS 11.0

Unable to start Elasticsearch 1.7.1 error when migrating data from TSPS 10.7 to TSPS 11

HP OneView integration with Truesight/BPPM

TSPS missing Configuration menu

 

 

Feedback.jpg

 

Feedback Request:

We’re back with our monthly blog and we’re open to hearing your thoughts on topics and areas of concern which may be of benefit to you! Post your comments regarding what you want to see!

Share:|

Have you been waiting for TrueSight 11.0.00? If so, then wait no more, it has arrived! We are proud to announce the release of TrueSight 11.0.00. Proactive Notifications have gone out so if you are signed up to receive them, they were sent out yesterday. If you have not signed up for them, visit this link to stay “in the know” when new products are released, technical bulletins, patches, etc.. are released.

 

What’s new? This is what we all want to know about, why should I upgrade? What is new and different in this release? Here are the details regarding all the new features/improvements across the various components. This does not include bug fixes, other improvements, etc. If you are interested in corrected issues, please refer to the product component pages listed on this page.

 

We now have a direct upgrade path from ProactiveNet or Infrastructure Management 9.6.00.002. We have made this process much more streamline and easier for customers to implement. Users might need to migrate their ProactiveNet or Infrastructure Management data. If you are interested in upgrading from this version, please visit this link.

 

 

  • Remedy Single Sign-On – The authentication method many have been asking for is here! The TrueSight Presentation Server now supports Remedy Single Sign-On in place of Atrium Single Sign-On with the following authentication types:

                        Local

                        LDAP/AD

                        SAML v2

 

For more information, see Planning Remedy Single Sign-On deployment.

 

  • Discontinued support for Atrium Single Sign-On – It is important to note that with RSSO support, we are discontinuing support for ASSO so please make plans to use a supported authentication method.

 

The TrueSight Operations Management 11.0 and later no longer supports Atrium Single Sign-On.

 

 

  • Added operating system support - The various TSOM components have made changes in the Operating Systems which are supported. I post this here as it is important to note which OS versions are supported and which are not.

 

                    TrueSight Infrastructure Management - The TrueSight Infrastructure Management server now supports the following operating systems:

                    Red Hat Enterprise Linux version 6.9

                    SUSE Linux Enterprise Server 11 Service Pack 4

                    SUSE Linux Enterprise Server 12 SP 2

 

                    TrueSight Presentation Server - The TrueSight Presentation Server now supports the following operating systems:

                    Red Hat Enterprise Linux version 6.9

                    SUSE Linux Enterprise Server 11 Service Pack 4

                    SUSE Linux Enterprise Server 12 SP 2

 

                    Real End User Experience Monitoring Software Edition

                    The Real User Analyzer and Collector and the Cloud Probe, are supported on Oracle Linux version 7.0 operating system.

 

Along with the discontinued support for ASSO, we have also made changes in support for operating systems across the following components:

 

  • Discontinued operating system support - Along with the new support, we have discontinued support for several OS versions, so please make every effort to migrate to a supported OS if you are currently running on one of the OS versions below:

 

                    TrueSight Infrastructure Management - The TrueSight Infrastructure Management server no longer supports the following operating systems:

                    Red Hat Enterprise Linux version 7.0

                    Red Hat Enterprise Linux version 7.1

                    SUSE Linux Enterprise Server 11 SP 2

 

                    TrueSight Presentation Server - The TrueSight Presentation Server no longer supports the following operating systems:

                    Red Hat Enterprise Linux version 7.0

                    Red Hat Enterprise Linux version 7.1

                    SUSE Linux Enterprise Server 11 SP 2

 

                    Real End User Experience Monitoring Software Edition - The Cloud Probe component is no longer supported on the following operating systems:

                    CentOS 5.8 and later (64-bit)

                    Ubuntu 15.10

 

                    App Visibility Manger server - TrueSight App Visibility Manager components are no longer supported on the following operating systems:

                    App Visibility server components. The (portal, collector, and proxy) are no longer supported on following operating systems:

                    SUSE Linux Enterprise Server 11 SP 3

                    SUSE Linux Enterprise Server 11 SP 4

                    App Visibility agent for Java no longer supports 32-bit operating systems

                    App Visibility agent for .NET no longer support Windows 2008 SP2

 

 

  • Data monitoring enhancements - Now, let’s get to the monitoring improvements, that’s what we really want right?

 

    • Cross-Launch URLs - We now have the ability to launch context-aware applications from events. The idea being that as an administrator, you can gather data about issues by gathering data from applications based on the data in the events being received and lowering your overall mean time to repair. This is done through cross-launch URLs for applications and configured with a set of conditions (slot values) that must be present in the event for the URL to be accessible. Users do also have the option to create cross-launch URLs with no specific conditions (with no slots specified). For more information, see Configuring context-aware cross-launch URLs.

 

    • Server threshold for unique instances - As an administrator, while defining a monitoring policy, you can now set the server threshold for particular unique instances. We all know that there can be multiple instances associated with the same device and mutiple instances can exist with the same name, so this can be very confusing. In this scenario, defining the server threshold by specifying the instance name only or by specifying the instance name with the device name can result in the server threshold getting applied on all the instances. This feature enables you to specify the complete path to the monitor instance to avoid applying the server threshold on unintended instances.  For more information, see Defining a monitoring policy

 

    • PATROL Agent setup variable to limit the length of the PATROL Agent data - You can use the newly introduced PATROL Agent Setup variable /AgentSetup/textParameterLength to limit the length of the text string that is sent by the PATROL Agent to TrueSight Infrastructure Management.The PATROL Agent sends the monitored data to TrueSight Infrastructure Management in a text string format. For more information, see Limiting the length of the PATROL Agent data.

 

 

  • Usability Improvements - We are all looking for ways to make our day to day tasks easier. So we listened to feedback and made several key usability improvements which we think you will find very helpful. Here are the details about the latest improvements.

 

    • View event data annotation in the TrueSight console You can now use the TrueSight console to view the data annotation that is generated for an event in the PATROL Agent

EventDataAnnotation.png                                                                      For more information, see Viewing or adding notes to an event.

 

    • View text parameters in the TrueSight console - You can now obtain the performance metric data of a text parameter from the PATROL Agent in the TrueSight console

TextParameter.png                                                                            For more information, see Viewing monitor information in the TrueSight console.

    • View deployment status in the Managed Devices page - You can now view the deployment status of a knowledge module on the Managed Devices page

ManagedDevices.png

                                                                         For more information, see Managing Infrastructure Management devices from the TrueSight console.

 

    • Customization of configuration files - You can now override some of the default settings by customizing these configuration files on the TrueSight Presentation Server:
      • csr.conf
      • idxsrv.conf
      • dbsrv.conf

                    For information, see Customizing configuration files in the Presentation Server.   

 

****Special Note****
Your customization is retained when you upgrade TrueSight Presentation Server from version 11.0. This is a big concern for many of our users. For more information, see Preparing for the Presentation Server upgrade.

 

 

    • Configure CI Types as Services on the TrueSight console - As an administrator, you can now configure different CI Types as Services to monitor them on the Services page of TrueSight console. You can select either predefined CI Types or user-defined CI Types as services.

Services.png                                                                      For more information, see Configuring a CI Type as a service on the TrueSight console.

 

    • Search option for services on the TrueSight console - As a service operator, you can now quickly search for a specific service from a list of services on the TrueSight console

Services10.png

   .                                                                 For more information, see Searching for services in the TrueSight console.

 

    • Customized Services page on the TrueSight console - As a service operator, you can customize the Services page to suit your service viewing preferences. These settings are individual, user-based preferences and apply only to the Services page. You can set the maximum number of services to display, number of services to display on scroll, and auto-refresh-time through this service preferences setting.

Services1338.png                                                                      For more information, see Customizing the Services page on the TrueSight console.

 

 

  • Security Improvements - We have also listened to the concerns over security and have made several changes to ensure a secure environment when using TrueSight Operations Management 11.0.00

 

    • Last login time - We created a Last login time notification which displays the time of the last login. This notification can be closed manually by clicking the close button or by navigating to a different view on the console. When the user logs in for the first time, the notification is displayed as Last login time: Never. The last login option is disabled by default and you can enable this from the user preferences screen. For details, see Setting user preferences.
    • Change Password - A new Change Password option is available from the TrueSight console action menu. From the console  action menu, click Change Password and update the new password. The change password option is available only if you have logged in as a local user. The option is not available on the console if you are a non-local user. For example, an LDAP or SAML user is a non-local user. For details, see Setting user preferences.

    • Login and logout - A two-step logging in has been introduced.

      • 1.    The users are required to provide the application domain or tenant ID followed by the user credentials to log into the TrueSight console.

      • 2.    Remedy Single Sign-On login page is presented as the TrueSight console login page.

        • Important:The two-step logging in is applicable only for a multi-tenant environment. Only step 2 is applicable for a single tenant environment.

LoginDefault.pngFor details, see Accessing and navigating the TrueSight console.

      •     Logging out of the TrueSight console navigates back to the Remedy Single Sign-On login page.

 

    • Data confidentiality for applications monitored by App Visibility agents - As an application security administrator, you can now define a confidentiality policy to prevent sensitive code-level diagnostics information from leaving the monitored server computer. Sensitive information does not reach the network and is not displayed. The policy identifies method codes with confidential information and the hiding mode for the methods. For information about creating and managing confidentiality policies, see Configuring an App Visibility confidentiality policy to hide sensitive information. 
    • Updated ciphers for App Visibility Manager for improved security - For improved security, weak ciphers were removed and stronger ciphers were added to the App Visibility Manager server components (App Visibility portal, App Visibility collector, and App Visibility proxy). The default cipher string of the tomcat.ciphers property in the the portal.properties, collector.properties, and apm-proxy.properties files no longer include ciphers that are weaker and less secure. Ciphers in upgraded components are not changed. For information about changing ciphers, see Enabling communication between App Visibility agents and server components.
    • Secured communication between an email server and Infrastructure Management server - You can now secure the communication between an email server and an Infrastructure Management server by enabling SSL/TLS mode. To convert email to events, an email server needs to communicate with the Infrastructure Management server. For more information, see Setting up unread email as an event in the operator console.
    • New Managed Decryption Key utility for the Real End User Experience Software Edition Cloud Probe - You can now use a Managed Decryption Key utility to add the decryption key to copy decryption key certificate information to the Cloud Probe component of BMC Real End User Experience Software Edition. With this decryption key certificate information, the Cloud Probe can decrypt HTTPS encrypted traffic that is captured by the Cloud Probe. This utility works in either an Interactive or Batch mode.
        • In the Interactive mode, you enter a series of command on queue from the utility.
        • In the Batch mode, you enter a series of parameters that the utility automatically executes.

               For directions to use this utility, see Configuring Cloud Probe decryption keys and settings for traffic decryption.

 

 

  • License Usage Report - Finally, we have a couple of Administrative/License improvements

 

    • Consumption Data Report - TrueSight Operations Management now allows you to generate consumption-based usage reports to understand the value of your applications through their usage. The report gives you the ability to understand your consumption patterns for the following components:
        • Events
        • Configuration Items
        • Performance Data
        • IT Data Analytics
        • Synthetic Monitor

Consumption Data.png                                                                           For more information, see Viewing and exporting the Consumption Data report.

 

    • App Visibility and Synthetic Monitor Server Endpoints report - App Visibility and Synthetic Monitor now include a Server EndPoints usage report so you can view the details about the number of server endpoints you are using in App Visibility, or TEA Agents in Synthetic Monitor.

ServerEndpoints.png

                                                                    For more information, see Viewing and exporting the Server Endpoints license usage report for App Visibility portal.

 

 

With all these improvements who is ready to upgrade? – Wait, before you do, work with us to ensure a smooth upgrade. Remember we have our AMIGO offering to help you with your upgrade process review. What’s AMIGO you say?

 

AMIGO.jpg

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.

The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here:

Upgrading - BMC TrueSight Operations Management 11.0

 

Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

Computer.png

 

Frequently Read Articles    

Here is a listing of the most frequently read Knowledge Articles over the last month

 

 

000029178      How to manually synch HA cells

000124168      Validate pruning period is identical in TSPS/TSIM

000079437      Log KM not working properly for the latest file in Dynamic file monitoring

000141855      Intermittent Foreign key error on cleanup of Deployment Summary in TrueSight 10.5 reported and fixed with TSPS hotfix 10.5.00.001.007

000142981      "ORA-01031: insufficient privileges" seen in pronet_db.log after TSIM installation
000142729      Is there an audit report to see what users did in TSPS or TSIM 10.7?

000142894      HA secondary TSPS does not point to custom ASSO port

000142605      Error when implementing TSPS SSL certificate to address web browser, "Your connection is not private: NET::ERR_CERT_AUTHORITY_INVALID"

000142238      Unable to start Elasticsearch 1.7.1 error when migrating data from TSPS 10.7 to TSPS 11

000141502      Is there a Truesight integration to ServiceNow?

 

 

 

 

 

 

Feedback.jpg

 

 

Feedback Request:

We are open to hearing your thoughts on topics and areas of concern which may be of benefit to you! Post your comments regarding what you want to see!

 

 

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs

Share:|

Are you using ProactiveNet or TrueSight and have been asked to tune the environment for performance?

Is this really necessary? – The answer is YES – Tuning is very important to ensure continued performance of growing environments.

 

Perhaps you have been using the product for years and your original environment remains. This may or may not work for you based on the size of your environment and growth over the years. Proper maintenance of such large environments is crucial to keeping performance up to par.

 

Have you seen our FAQ regarding performance and scalability? If not, I would encourage you to visit the page and review the questions most users have regarding performance and tuning.

 

The most common question we see in Support is How do I know my system is overloaded?

There are several ways to determine if there are performance issues and if your system exceeds capacity.

The first thing to do should be to login to the TrueSight Console/ProactiveNet Operations Console and access the Performance Diagnostics Report

 

Login to the Operations Console->Options->Administration->Performance Diagnostics View and this will show you the number of monitored devices, instances, attributes, KPI attributes, components, and Events

 

Sample Performance Diagnostic Report

PerformanceDiagnostic.png

 

 

Then refer to the BMC TrueSight Documentation based on the type of environment you are using. Here are a couple of references – Sizing the Presentation Server and Sizing for Data and Event Management Environments

 

 

For example, here’s the sizing guideline for the TSIM 10.7.00

Sizing.png

There are also other values to compare based on the various components under the TSOM Suite

TSIM.png

IS.png

If your values are greater than the tested values, there are likely to be performance issues. BMC would recommend attempting to lower the load on the system perhaps filtering instances and removing any unnecessary monitoring.

 

The most common symptom of the load on the system exceeding capacity is that the analytical engine runs out of memory. If this occurs, OutOfMemory exceptions are logged in one of the files that are located in the <installationDirectory>\pw\pronto\logs directory:

 

If the OutOfMemory exception is caused by Rate or JServer processes, the log is in the ProactiveNet.log file.   If the OutOfMemory exception is caused by the agent controller process, the log is in the pronet_cntl.out file.

 

You can increase the MaxHeap value in one of the following files, located in the <installationDirectory>\pw\custom\conf directory:

 

    For the Rate process, pnrate.conf

    For the JServer process, pnjserver.conf

    For the agent controller, pnagentcntl.conf

 

The following list presents additional common issues that can arise when capacity is exceeded:

 

Gaps sporadically appear in data collection across all monitors, or artificial alarm delays occur after a threshold condition has been violated. You might also see gaps in the data shown in graphs. When this occurs, you might see pending, cache size limit exceeded, and dropping messages logged in the Infrastructure Management log file.

 

Gaps in data could result from memory issues or I/O bottlenecks. If you do not see OutOfMemory exceptions logged, the system probably has an I/O issue. Check the I/O status by looking at the percentage of the disk that is busy (for example, the iostat cmd on Solaris). If the system consistently shows that over 30%, the system probably has an I/O issue.

 

User response becomes much slower when using the web interface. If user response is slow for all interactions, the system has a problem with memory or CPU. If user response is only slow when graphing, the system probably has an I/O issue.

 

Check the out-of-the-box monitors that Infrastructure Management creates on the BMC TrueSight Infrastructure Management Server. If you see sustained (several minutes) CPU spikes above 80%, this usually indicates some resource issue, although not necessarily a lack of CPU.

 

For more help on Performance and Tuning, please refer to these links Tuning TSIM and Tuning TSPS

There is a listing of the main parameters which are used to tune these environments based on your use. Please be sure to revisit these values when your application grows. Instances and attributes can add up very quickly, particularly when monitoring filesystems or large environments.

 

Some of the common issues descriptions we see in Support which ultimately lead to performance tuning include – jserver consuming large amounts of CPU, jserver does not restart, slow performance, poor performance in the UI, data not collecting, java_cntl high consumption and pronet_cntl process down, etc…We do see a good number of customer environments which do require tuning. Part of the process of investigating these types of issue will usually include verification of hardware sizing, minimum requirements, sizing, and the current configuration, and log files (usually a pw dump 1), and possibly a heap dump. A heap dump will help Support determine the root cause of memory issues in your environment. The type of details will depend on which product component is experiencing the issue.

 

If you are experiencing any of the symptoms mentioned above, we would ask that you report them to Support and we will be able to assist you in reviewing the issue, the environment, and making recommendations for improved performance. We will do our best to get your system back up and running as soon as possible.  Remember to be proactive and tune your environment and monitor growth to keep ahead of the game when it comes to application resources.

 

 

 

Related Knowledge Articles

 

000130195    Where can I find the ProactiveNet Performance Management 9.6 Scalability Guidelines?

000115163    TSPS taking long time to start or performance issues with TSPS

000032098    How to configure/scale ProactiveNet (MaxHeap, RAM, etc.) on server components like jserver, rate, Agent Controller and remote ProactiveNet Agent

000106019    Max Queue size breached errors encountered in BMC ProactiveNet Performance Management Suite 9.5 and Integration server was unable to connect

000031308    How to customize Max Heap Size or other JVM parameters for ProactiveNet Processes?

000051500    Integration Service Agent configuration times out

 

 

 

 

 

Video.png

 

 

 

Here is a quick video with some TSIM performance tuning tips – Enjoy

 

We also have a BPPM Performance Diagnostics video for your review

 

Coming Soon.jpg

 

 

 

 

TrueSight Operations Management 11.00 is coming soon! We are excited to continue work to prepare for the release of TrueSight 11.00.

Keep watch for more details and announcements about the upcoming version. 

The release is right around the corner, contact your BMC Account Manager to discuss upgrade plans today!

 

Computer.png

 

Frequently Viewed Articles 

 

Here is a listing of the most frequently read Knowledge Articles over the last month

 

000102017   Windows Patrol Agent 9.6 doesn't startup after system reboot (corrupted streamcache)

000102508    TSPS events get orphaned after properly closing them in TSIM

000115512    Performance Data is not being collected by TrueSight Report Engine

000112240    ReportEngine Database is Running Out Of Disk Space Since the Purge Job is Failing

000104071    How to replace the SSL server certificates with certificates issue by a CA/Trusted Source within TrueSight 10 components

000025456    How to enable trace for publishing server for troubleshooting a publish problem

000015736    How to install and configure SNMP Adapter Config Manager?

000133890    How do I troubleshoot Service Resolution issues?

000079437    Log KM not working properly for the latest file in Dynamic file monitoring

000090143    In Patrol for Oracle KM, Oracle ETSM doesnt discover tablespaces

 

 

 

 

 

 

Feedback.jpg

Feedback Request:

We want to hear from you! Post your comments regarding what you want to see!

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs

Share:|

Are you currently using TrueSight Dashboards? If not, what’s keeping you from using them?

 

We want to hear from you regarding the use of Dashboards within TrueSight. Based on our research, we do see a rise in use of the dashboard feature within TrueSight and our goal is to make it more robust.

 

For those who are not familiar with TrueSight dashboards, here is a brief overview:

 

Dashboards are used to give your users a birds eye view of what matters most within your environment. Users can select dashlets to add to a dashboard. A dashlet displays a single graphic abo can sut a specific application or server. As you build your dashboard, you specify a dashlet template, and then configure it to the values for your systems. You can specify different types of dashlets or the same dashlet many times. The great part of the dashboard is that when the dashlet finds a problem, it serves as an access point to investigate and troubleshoot the root cause. Review our Dashlet library for more details and options.

 

Users can use the following dashlet templates to create dashboards that provide information about your infrastructure and services.

 

 

Users can create dashboards with one row, or as many rows as necessary. When creating and modifying dashboards, you can also change the order of the dashlets and rows in the dashboard. After you create a dashboard , you can also share the dashboards with others.

 

The ability to share dashboards enables members of work groups to create and maintain a single dashboard that they can all use. If you find a shared dashboard that you like, you can copy it and use it as is or modify it as necessary. Currently, dasbhoards have restricted sharing capabilities, but we hope to enhance that area of the feature. For instance, please see these links to vote up the Ideas created around dashboard sharing/administration https://communities.bmc.com/ideas/15950 - Share dashboards on Truesight Presentation Server to specific users or user groups and https://communities.bmc.com/ideas/12203  - Truesight: Dashboard Administration

 

Functionality within dasbhoards includes Adding, EditingDeleting, Copying, and Sharing. Any user can create a dashboard and by default the dashboard page is the page which comes up upon login. Dashboards can serve several business purposes, mostly providing a single pane to view to quickly check the status of the most import areas of monitoring.

 

Dashboards.png

dashboardAndDashlets.png

 

Here’s a quick video on how to create dashboards in TrueSight

 

 

Seems simple right? It really is very quick and easy to add a dashboard and share the dashboard for others to use. Give it a try and let us know what you think.

 

FAQ.jpg

 

Frequently Asked Questions – Dashboards (based on case work in Support)

 

Q: Why can't I see certain webpages displayed with the web page dashlet?

A:  If you having trouble with some webpages being displayed, this is an issue with the security configuration with X-Frame-Options headers.  Chances are the website and browser are preventing the content from being hosted in the browser's iframe container.  Our dashlet configuration page indicates:"URL * Not all browsers can display HTTP URLs in the dashlet."

For example, out of the box the website http://docs.bmc.com is capable of being displayed in the dashlet but http://www.google.com is not.

X-Frame-Options headers can be configured or bypassed either at the web server or at the browser level:

 

Server Level

See the following articles on X-Frame-Options

X-Frame-Options - https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options

Combating ClickJacking With X-Frame-Options - https://blogs.msdn.microsoft.com/ieinternals/2010/03/30/combating-clickjacking-with-x-frame-options/

 

Web Browser

For Chrome install an extension like Ignore X-Frame headers to see content without server side changes

 

 

Q: Does an admin user within TrueSight 10.x have the ability to manage other user's dashboards?

A: Currently, administrators can only manage their own Dashboards. Users can copy or share their Dashboards but if the user who created a shared Dashboard is disabled, the shared Dashboard is disabled.

 

An Idea has been submitted based on the current Dashboard administration where dashboards created by a user that subsequently leaves the company becomes an object ghosted in TSPS unable to be deleted.  There are open Ideas (Request for Enhancement) for TrueSight regarding dashboard functionality.

https://communities.bmc.com/ideas/12203

https://communities.bmc.com/ideas/15950

Please go vote up these Ideas 

 

Truesight: Dashboard Administration

1.The top of the list for this idea is to implement a level of dashboard administration outside of the individual users.  This means:

Adding a RBAC permission to the roles that allows for things like:

  • Adding removing dashboards.
  • Assigning Dashboards to security groups or globally
  • Editing any aspect of a Dashboard (including the name)

2. All dashboards should have a "date created" and "date last viewed" attribute.  There may be other useful attributes to consider:

  • This will allow reports to be run checking for stale dashboards
  • There should be a global administrative setting that says to delete any dashboards not accessed within "X" days so I don't have to manually clean them up.

3. Anyone with the Super User Role can do ANYTHING with ALL dashboards: edit, delete, assign, hide, etc.

4. Add Dashboard tab to Authorization Profile so dashboards can be assigned to groups instead of individuals

5. There should be a limit to the number of dashboards that a user can create.

 

Q: Why do I see the following on my TrueSight Presentation Server Dashboard? "Graph cannot be displayed currently as data for the selected attribute is not available or connectivity issues exist"

A: There are a different causes for this message:

- If the problem is corrected on restart, then contact BMC support for a fix for TSIM 10.5.  At the time of this writing, no hotfix for Fix Pack is available.

- If the message is not corrected by restarting, then the following is applicable:

Deleting & re-registering a TSIM on the TSPS will break existing dashboards.

TSPS keeps an internal ID of the TSIM components which the dashboards use. When the TSIM is deleted, these internal IDs are lost, thereby breaking the dashboards. If the TSIM is reconnected with the TSPS, the dashboards need to be recreated. This is tracked with Defect QM002002955.

 

Q: How do we configure a Dashboard to see a monitor as a Dial Gauge on TrueSight Presentation Server?

A: Dial Gauge icons for monitors are see in TrueSight Infrastructure Management 10.5+, see the following documentation link for details

https://docs.bmc.com/docs/display/public/tsim105/Creating+a+dial+gauge+graph+on+the+operator+console

The request for seeing the same option under TrueSight Presentation Server was noted as an Idea for enhancement

https://communities.bmc.com/ideas/15925

 

Q: We received a notification on a script that has a latency violation from the AM KM and TSIM. When looking at the dashboard, the application status is green.  Why? We have 5 applications configured in AVM for synthetic transaction monitoring and the dashboard status did not change from green to alert, what could cause this?

A: You can use the SLA to change the status of your applications in the TSPS console and you can also use the AM KM with TSIM to alert if an event threshold is breached n times in a series. The SLA is used in TSPS to update the application status. However, the SLA can only see the most recent 5 minute results window and cannot see anything that happened in the history of the application.  So if there is a failed result in the 5 minute period that could cause the SLA to trigger an event, then it will set application status to the appropriate value..

 

You may also have your AM KM set to trigger an event if an event threshold is breached n times in a series.  In this scenario, if an event is triggered, it will occur after n times.  Please remember that the SLA and AM KM are 2 separate items and report on the data in different manners. Below are a few use cases to demonstrate how the SLA and AM KM work (Please note that I am only discussing critical notifications in these use cases and not minor):

 

The AM KM is configured to alert if there is a failure 2 times in a row

The Execution Plan runs once every 5 minutes and takes 1 minute to complete

The SLA has the following configuration:

     1. Latency - 60 seconds

     2. Accuracy Errors- 35%

     3. Execution Errors - 35%

     4. Availability Errors - 35%

 

8:00 AM - Execution Plan starts

8:01 AM - Execution Plan stops with 1 Accuracy error

8:01 AM - AM KM sees 1 error.  No events are raised

8:05 AM - TSPS Console receives the results.  The SLA evaluates the results and sees 1 Accuracy error.  This means there is 100% failure.  This is higher than the 35%.  The Application status is set to red

8:05 AM - Execution Plan starts

8:06 AM - Execution Plan stops with 1 Accuracy error

8:06 AM - AM KM sees 1 error.  This is the second error in a row, so an event is raised and a notification is sent out as defined in the AM KM policy.

8:10 AM - TSPS Console receives the results.  The SLA evaluates the results and sees 1 Accuracy error.  This means there is 100% failure.  This is higher than the 35%.  The Application status is set to red..

 

As you can see in the above scenario, the Application status was changed to critical during the first run of the Execution Plan, but the user was not alerted by the AM KM until the 2nd run of the Execution Plan.

 

Let’s look at a second use case where a user receives a notification from the AM KM, but the application status remains green:

AM KM is configured to alert if there is a failure 2 times in a row The Execution Plan runs every  minute and takes 30 seconds to complete

 

The SLA has the following configuration:

     1. Latency - 45 seconds

     2. Accuracy Errors- 75%

     3. Execution Errors - 75 %

     4. Availability Errors - 75%

 

8:00:00 AM - Execution Plan starts

8:00:30 AM - Execution Plan stops with 1 Accuracy error

8:00:30 AM - AM KM sees 1 error.  No events are raised

8:01:00 AM - Execution Plan starts

8:01:30 AM - Execution Plan runs with 1 Accuracy error

8:01:30 AM - AM KM sees 1 error.  This is the second error in a row, so an event is raised and a notification is sent out as defined in the AM KM policy.

8:02:00 AM - Execution Plan starts

8:02:30 AM - Execution Plan succeeds

8:02:30 AM - AM KM sees 0 errors.  No events are raised

8:03:00 AM - Execution Plan starts

8:03:30 AM - Execution Plan succeeds

8:03:30 AM - AM KM sees 0 errors.  No events are raised

8:04:00 AM - Execution Plan starts

8:04:30 AM - Execution Plan succeeds

8:04:30 AM - AM KM sees 0 errors.  No events are raised

8:05 AM - TSPS Console receives the results.  The SLA evaluates the results and sees 2 Accuracy errors.  This means there is 40% failure.  This is lower  than the defined 75%.  The Application status remains green.

 

As you can see in the above scenario, the Application status was never changed because the combined results from the 5 minute results bucket did not meet the criteria for the SLA.  However, we did see 2 event threshold failures in a row, which means that the user was sent a notification from TSIM

 

 

We want to hear from you about what you would like to see added/changed in the dashboard feature function area. Reviewing the types of cases we have seen for dashboards most of the questions center around admin permissions and managing the permissions among various dashboards and sharing dashboards. Feel free to create new Ideas in the BMC Community to let us know how we can improve dashboards for you. Don’t want to add it yourself, contact Customer Support regarding new functionality and we will be glad to assist.

 

ShortOnTime.jpg

 

If you are interested in migrating to TrueSight 10.7 or upgrading to TrueSight 10.7, please take advantage of our free AMIGO program. Haven’t heard of AMIGO? Here are the details:

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.

The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here:

https://docs.bmc.com/docs/display/TSOMD107/AMIGO+checklist+for+BMC+TrueSight+Operations+Management

Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

Computer.png

 

 

New Additions to our Knowledge Base …

Here is just a glimpse of some of the articles which were added to our Knowledge Base for TrueSight and its components

 

000139286

TSIM application does not start on SUSE 12.2 with the following message: Some other startdwhouse is running

000139513

Can we use TSCO to authorize access for users of TrueSight Presentation Server?

000139166

Is there a way to set thresholds within TrueSight based on the time of day?

000139064

Does IBRSD.conf parameter usebppmnamefromibrsdconf need to be set for BSR 3.5.01?

000138972

Users with passwords longer than 15 characters are unable to reset password in BPPM 9.x

000138648

"Event Groups' is the default event group for all users. Please contact Administrator to give you relevant event group(s) permission" seen when clicking on TSPS -> Events

000138553

Deployment is stuck in the TSPS, showing "Uninstallation has started on Patrol Agent. Cannot abort now"

000139314

Schema Validation Error Upgrading BMC Report Engine

000139288

JSERVER.LOG Warning: Schedule job Pn_JobForEvery15Minutes is not working fine. Job execution failed seen repeatedly in TrueSight 10.7

000138975

SQL Anywhere Error -638 errors seen in the TrueSight.log file after upgrading to TrueSight 10.7

Feedback.jpg

 

 

Feedback Request:

We’re back with our monthly blog and we’re open to hearing your thoughts on topics and areas of concern which may be of benefit to you! Post your comments regarding what you want to see!

 

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs

Share:|

Have you made the transition to TrueSIght? If not, we definitely recommend you start planning now. TrueSight is the next generation product from the ProactiveNet Performance Management line. TrueSight is the enterprise wide solution for data and event management. TrueSight 10.7 was released March 28, 2017 and we have had several users successfully upgrade to this latest version.

TimeForAction.jpg

 

 

What is in it for you when you upgrade?

Other than the bug fixes, the latest code base, and improved stability, there are several new features in TrueSight. We continually strive to improve the end user experience and with that, we add new features which might be of interest to you.

 

Here are some of the top new features in 10.7:

 

OS Support
Added support for more OS versions for TrueSight Presentation Server and TrueSight Infrastructure Management components

•Red Hat Enterprise Linux 7.3 (64-bit)

•Oracle Linux Server 6.8 and 7.3 (64-bit)

•Microsoft Windows 2016 - Standard Edition and Datacenter Edition (64-bit)

(Don’t see your OS on this list.. submit an Idea to the BMC Community to request support for your OS)

 

 

PATROL Agent updates
Perhaps the most anticipated feature is the ability to update PATROL Agents more effectively! Have hundreds of Agents, need an easy way to update them?

Users are allowed to upgrade PATROL Agents to the latest version using the Deploy and Install packages functionality via the TrueSight console.

PA_deploy_scenarios.png
Instance-level filter for the PATROL Agent data

You can now configure an instance-level filter while adding monitor types in a monitoring policy. When you add an instance-level filter to a monitoring policy, you can choose to filter out the data, or events, or both. Based on the type of configured filters, PATROL Agents send the collected data and the generated events to the Infrastructure Management server.

 

Force deploy monitoring solutions for repair
You can now overwrite an existing installed solution with the same version from a deployable package without uninstalling the solution. This is useful if you feel that the installed KM file is corrupted.

Deploy monitoring solutions to multiple PATROL Agent instances
You can now deploy monitoring solutions to multiple PATROL Agent instances that are running on the same host.

Installation directory optional
If you do not know the correct installation directory while creating a deployable package, you can leave the field for specifying the installation directory blank. The correct directory is automatically selected through the BMC_BASE variable. The BMC_BASE variable also automatically selects the correct directory if you enter an incorrect installation directory.

 

High Availability
You can now install and configure a high-availability environment for Infrastructure Management to minimize downtime and eliminate a single point of failure. Your network administrator can configure Infrastructure Management for high-availability after installation so that the system automatically switches to a standby node if the active node fails or is temporarily shut down.

 

Group Management
New developments in the handling and management of Groups have been added in this release.

Users now have the option to add automatically synchronized groups as child groups

 

The TrueSight console provides an option to add an automatically synchronized group as a child group of a manual group that is created. You can select a child group from a list of manual and automatically synchronized groups. The automatically synchronized group names are displayed along with their associated Infrastructure Management server names enclosed in the parentheses

 

We also see the ability to see new filters in Groups and total monitors in Group Details views

 

•The Groups page now includes Manual and Synchronized filters. The existing Default group filter is replaced by these two new filters.

•The Groups page now includes the Show Group Type Filter option, which is supported from both the Tile and Table views. You access this new option from the  icon on the Groups page. 

•The Group Details page now includes a new Total Monitors count field, which displays the total number of unique monitors associated with a group and its subgroups.

 

New dynamic event groups filter type

You can use a new advanced filter type called dynamic event groups to combine events based on certain criteria or conditions. Dynamic event groups are set of events that are created dynamically based on event slot that you specify.

 

Create rule-based groups with multiple conditions
In TrueSight Infrastructure Management, you can now create advanced rule-based groups to monitor resources in an organized manner. You can add one or more rules, and set multiple conditions to select devices or monitors.


These are just some of the new features found in this release. I encourage you to review the full list here https://docs.bmc.com/docs/display/TSOMD107/10.7.00+enhancements and to start planning your migration/upgrade today!

Time.jpg

 

Short on time? It's too hard to plan the upgrade? Let us help you!

If you are interested in migrating to TrueSight 10.7 or upgrading to TrueSight 10.7, please take advantage of our free AMIGO program. Haven’t heard of AMIGO? Here are the details:

 

The BMC Assisted MIGration Offering, or AMIGO, is a program designed to assist our customers in planning and preparing for product upgrades from an older, to a newer supported version.  By engaging with BMC Technical Support Analysts, you will be provided with materials containing guidelines and best practices to aid in compiling your own upgrade plan. An upgrade expert will then review your plan, and offer advice and suggestions to ensure success through proper planning and testing.

The AMIGO program consists of a Starter Phase and a Review Phase.  Each phase is initiated by opening a support case, and ends when the case is closed.

In the Starter Phase, an AMIGO Starter case is opened.  Reference material will be provided and a call with a Technical Support Analyst will take place to discuss the details of your upgrade, and address any questions you may have.  The AMIGO Starter case will be closed, and the next step will be for you to prepare a documented upgrade plan.

In the Review Phase, an AMIGO Review case is opened preferably two weeks prior to a set upgrade date.  A call will be scheduled with an upgrade expert to review your detailed plan, providing feedback and recommendations, along with answers to any outstanding questions.  As needed, a follow up discussion with a Technical Support Analyst may take place for feedback after the upgrade is performed.


The AMIGO program includes:

» A “Question and Answer” session before you upgrade

» A review of your upgrade plan with Customer Support

» An upgrade checklist

» Helpful tips and tricks for upgrade success from previous customer upgrades

» A follow-up session with Customer Support to let them know how it went. This will help BMC to enhance the process.

 

To get started, please review the details here:

https://docs.bmc.com/docs/display/TSOMD107/AMIGO+checklist+for+BMC+TrueSight+Operations+Management


Then open a BMC Support issue containing your environment information (product, version, OS, etc.) and the planned date of the installation, if known. We will contact you promptly, and work with you to ensure a successful and timely outcome.

 

 

Have you heard the news about our Knowledge Base?  

Knowledge Base.png

 

 

Knowledge Base – How often do you use the BMC Knowledge Base to search for issues and fixes? Are you frustrated with trying to find the correct results for the products you are using?

Would you like to search the BMC Support Knowledge Base and only see results for just TrueSight/ProactiveNet or if you using these product predecessors, see results for just BEM/SIEM? If so, then take advantage of our pre-filtered search links:

 

Pre-filtered for TrueSight/ProactiveNet
Pre-filtered for BEM/SIEM

 

NOTE: You will need to be already logged into BMC Support Central for these URL's to work correctly

 

 

Computer.png

 

Top KAs for TrueSight and BPPM

Interested in the latest topics of interest in terms of most used Knowledge Articles? Head on over to this page for our Top 10 TrueSight/BPPM KAs referenced over the last month.

 

Feedback Request:

We’re back with our monthly blog and we’re open to hearing your thoughts on topics and areas of concern which may be of benefit to you! Post your comments regarding what you want to see!

 

Feedback.jpg

 

 

 

 

 

Looking for a previous blog posting? Find it here: BMC TrueSight Pulse Blogs

Share:|

Are you searching the BMC Support Knowledge Base and getting too many results for products you are not using?

 

Are you spending time having to unselect/select various products in the list?

 

Would you like to search the BMC Support Knowledge Base and only see results for TrueSight Reporting and other Reporting components? For example, if you are using the product predecessor, see results which include ProactiveNet Reporting. Perhaps you are interested in seeing results for BMC Performance Manager Reporting articles?

 

If answer to any of the above is YES then you need to use a pre-filtered URL for those specific products:

 

Pre-filtered for:

TrueSight Operations Management Reporting

TrueSight Reporting

ProactiveNet Performance Management Reporting

ProactiveNet Reporting

BMC Performance Management Reporting

BMC Performance Manager Reporting

 

NOTE:

You will need to be already logged into BMC Support Central for this URL to work correctly.

Share:|

Are you searching the BMC Support Knowledge Base and getting too many results for products you are not using?

 

Are you spending time having to unselect/select various products in the list?

 

Would you like to search the BMC Support Knowledge Base and only see results for just BMC Performance Manager Portal or are you interested in either the BMC Performance Manager Express monitoring solutions as well as the Portal, or just the monitoring solutions?

 

If answer to any of the above is YES then you need to use a pre-filtered URL just for those products:

 

Pre-filtered for BMC Performance Manager Portal

Pre-filtered for BMC Performance Manager Portal and BMC Performance Manager Express solutions

Pre-filtered for BMC Performance Manager Express Solutions

 

NOTE:
You will need to be already logged into BMC Support Central for these URL's to work correctly

Share:|

Are you searching the BMC Support Knowledge Base and getting too many results for products you are not using?

 

Are you spending time having to unselect/select various products in the list?

 

Would you like to search the BMC Support Knowledge Base and only see results for just TrueSight/ProactiveNet or if you using these product predecessors, see results for just BEM/SIEM?

 

If answer to any of the above is YES then you need to use a pre-filtered URL just for those products:

 

Pre-filtered for TrueSight/ProactiveNet

 

Pre-filtered for BEM/SIEM

 

NOTE:

You will need to be already logged into BMC Support Central for these URL's to work correctly

Share:|

Hi everyone!

 

Our next installment of our Connect with BMC Performance Manager Portal Webinar Series will be held on May 10, 2016 at 10 am Central time to 12 pm Central time

 

The topics of this Webinar will include:

Security Vulnerabilities, Oracle 12c Support, Portal Diagnostics

 

Please make plans to plans to attend!

 

We'll be sending out Webinar registration details about 2 weeks before, so be on the lookout for the invitation. We look forward to working with you!

 

 

 

 

Performance Manager Portal: Security Vulnerabilities, Oracle 12c Support, Portal Diagnostics

Share:|

You have probably heard of the Heart-bleed, the Poodle, the Ghost, the LogJam, and the Freak vulnerabilities as they are often referred to. Whether you prefer to refer to their CVE number or their nicknames, these nasty vulnerabilities are showing up on security scans recently and causing concern for many different applications. What does that mean for BPPM?

 

BMC ProactiveNet Performance Manager is not affected by many of these vulnerabilities. BPPM has not been impacted as much as some application.  This chart will show which vulnerabilities require action.

 

 

Vulnerability

CVE number(s)

Remediation

Heart-bleed

CVE-2014-0160

OpenSSL 1.0. through 1.0.1f (inclusive) branches are vulnerable OpenSSL 1.0.1g is NOT vulnerable OpenSSL 1.0.0 branch is NOT vulnerable OpenSSL 0.9.8 branch is NOT vulnerable BPPM 9.0 runs with Open SSL 1.0.0e so it is NOT vulnerable. BPPM 9.5 runs with Open SSL 1.0.1c and so IS vulnerable.

 

The patches for BPPM 9.5 on all supported platforms are available on ftp://ftp.bmc.com/pub/BPPM/PATCHES/9.5/HeartBleed_Patch. Please see the file ‘readme_BPPM_OpenSSL_Heartbleed_fix_PS.txt’ for installation instructions.

Injection Bug

CVE-2014-0224

CVE-2014-0221

CVE-2014-0195

CVE-2014-0198

CVE-2010-5298

CVE-2014-3470

BPPM Server 9.5 should be using OpenSSL 1.0.1g if it was patched due to "Heartbleed" bug.  

This 1.0.1g does have the "CCS Injection" bug, but it was found that BPPM server is not vulnerable to this "CCS Injection" bug because of how it is being used. 

 

Both the client and server have to be running OpenSSL for the "CCS injection" exploit to work. Since all browsers (IE,chrome,firefox,safari) do not use OpenSSL,  the BPPM web console https sessions are not vulnerable.

Shellshock

CVE-2014-6271

CVE-2014-7169

The BPPM server does not use bash internally; it uses only c shell or shell scripts.  BPPM is not affected by the Shellshock bug.

Poodle

CVE_2014_3566

BPPM is impacted and users should disable Apache SSL V3.0 in BPPM for POODLE vulnerability

1. Stop BPPM Server with "pw system stop"

2. For BPPM 9.5 and 9.6 versions -->  <BPPM HOME>\pw\apache\conf\extra\httpd-ssl.conf (Windows)

 

<BPPM HOME>/pw/apache/conf/extra/httpd-ssl.conf (Linux/Solaris)

 

For BPPM 9.0 and 8.6 versions -->  <BPPM HOME>\pw\ApacheGroup\Apache\conf\httpd-ssl.conf (Windows)

<BPPM HOME>/pw/Apache/conf/httpd-ssl.conf (Linux/Solaris)

 

3. Make the following change in the platform specific file.

Add the following line in the httpd-ssl.conf file in the "SSL Cipher Suite" section:

SSLProtocol all -SSLv2 -SSLv3

4. Restart the ProactiveNet Server with "pw system start"

Ghost

CVE-2015-0235

As this flaw stems from the glibc function and manifests itself via the gethostbyname() function, we have not found it to be exploitable in any BMC products.

Freak

CVE-2015-0204

CVE-2015-0291

BPPM is not affected - BMC TrueSight Infrastructure Management (formerly BMC Proactivenet Performance Management Suite) 9.5 and 9.6 - ships with export ciphers disabled

 

Only BPPM versions 8.6 and 9.0 are affected by this vulnerability. To disable the EXPORT ciphers for version 8.6 or 9.0, please follow these steps:

 

   1. Stop BPPM server with 'pw sys stop' command.

 

   2. Backup the file <BPPM HOME>\pw\apache\conf\extra\httpd-ssl.conf (Windows) or <BPPM HOME>/pw/apache/conf/extra/httpd-ssl.conf (Linux/Solaris)

 

   3. Modify the httpd-ssl.conf file and add "!EXP" to the SSLCipherSuite setting.  Remove "+EXP" if it appears.

 

   4. Start BPPM server with 'pw sys start' command

LogJam

CVE-2015-4000

BPPM is not affected.

 

Didn't see a vulnerability on the list? Please open a ticket with Customer Support and provide the CVE number or security scan results and we will investigate it for you.  Please also check our Knowledge Base regularly as we do update it when we find new vulnerabilities which require modifications to the product. Usually searching by CVE number will help find a given vulnerability.

 

 

 

 

 

If you would prefer to upgrade OpenSSL and Apache for BPPM 9.5+, you can use the following instructions if running on Windows.

 

How to upgrade BPPM 9.5 to use OpenSSL version 1.0.1i and Apache version 2.4.10 (or better) on a Windows server

 

Below are the steps to manually upgrade BPPM 9.5 to Apache 2.4.10 with OpenSSL 1.0.1i on a Windows server:

 

Note 1: These steps are for Windows operating systems only

Note 2: Please perform these steps on a BPPM server in a test environment before performing them on the production environment

 

Prerequisites:

Please ensure that you have installed the Visual C++ 2010 SP1 Redistributable Package x64 : VC10 SP1 vcredist_x64.exe

 

Step 1) Download Apache 2.4.10 (VC 10 win 64-bit) from http://www.apachelounge.com/download/ and unzip the file to a known location.

 

Step 2) Stop the BPPM application

 

Step 3) Make a backup of the \ProactiveNet\pw\Apache directory or you can make a backup of the \ProactiveNet and sub-directories

 

Step 4) Replace the Apache folder from Step 1 with the \ProactiveNet\pw\Apache directory

 

Step 5) Copy the following files from Apache backup from Step 3 and paste them at the respective location below:

 

-pw\Apache\conf\httpd.conf

-pw\Apache\conf\extra\httpd-ssl.conf

-pw\Apache\conf\extra\httpd-proxy.conf

-pw\Apache\conf\my-server.cert

-pw\Apache\conf\my-server.key

-pw\Apache\conf\TunnelAgent

 

Step 6) Restart the BPPM application

 

We do not have a set of instructions to upgrade the version of Apache/OpenSSL on Solaris; the basic steps are comparable with the specific differences being the locations of the files, folders, subdirectories.

 

The ApacheGroup/Apache directory structure is only for Windows.  On your Unix system, the Apache installation is in the pw/apache subdirectory shown in your output.  That's where you can update these files.

There aren't any separate instructions written up for Solaris.  It would basically be the same, some slight differences:

 

In the conf dir, there are server.crt and server.key, not my-server.crt and my-server.key.

There is no agentPem.crt.

 

The modules directory has mod_jk.so, not mod_jk-1.2.28-httpd-2.2.3.so.

 

For the openssl download, it looks to be available from unixpackages.com (and the site indicates that it has the updated versions that take care of the vulnerability.

 

BMC definitely recommends upgrading to the latest version of BPPM rather than patching the Apache/Open SSL versions as the latest product version has been certified by QA and any change to that environment may lead to problems or performance issues. The rule of thumb should be to consider the upgrade of BPPM before considering an upgrade of Apache/OpenSSL.

 

For any questions about the security vulnerabilities or any other Apache/OpenSSL concerns, please contact Customer Support for further assistance.

 

 

 

 

 

Newly Published Knowledge Articles - New Content has been added over the last month!

 

This is our opportunity to share with you some of the most recently created knowledge articles in case they may help you with something you would like to know more about.

 

KA426693 - Error adding CMA global threshold to a "Unix and Linux - HP-UX and Linux" or "Unix and Linux - Solaris and AIX" solution

KA426707 - Installation of Service Resolution on BPPM completes with warnings if the username/password for Oracle instance has been changed from the default of proact/proact

KA426607 - The cmapolicymigration utility will still try to connect to HTTP port 80 even if BPPM has been reconfigured so that Apache webserver uses a custom port

KA426917 - The cell initialization is taking a long time and is preventing BPPM from starting up

KA426748 - How can I close all events of the same severity from a command line?

KA426600 - If the operations console is idle for a small period of time, a blank Navigation Pane Option Error popup message appears. 

KA426616 - Why are the Remote Agents not appearing under Device -> RemoteAgent in the Admin console?

 

Popular Knowledge Articles - Here are some of our most commonly used articles over the last month!

 

KA357339 - How to configure/scale ProactiveNet (MaxHeap, RAM, etc.) on server components like jserver, rate, Agent Controller and remote ProactiveNet Agent.

KA399915 - Events are not seen in 9.x BPPM Collectors after KB is reload or Cell is restarted.

KA417354 - How to upgrade BPPM 9.5 to use OpenSSL version 1.0.1i and Apache version 2.4.10 (or better) on a Windows server?

KA425524 - On the SNMP Adapter Configuration Manager, when you push the publish button nothing happens and there is no message written to the lower window in the configurator screen.

KA409289 -After installing BPPM 9.5, LDAP user is unable to login - "BMC-BSW000609E Failed to find user groups for user xxxxxx"

 

 

 

Looking for a previous blog posting? Find it here:  BMC TrueSight Pulse Blogs

 

 

Feedback Request:

Help us help you! Use the rating system at the bottom of this blog to rate this post! Feel free to comment as well.
What topics would you like to see?

Share:|

There seems to have been some interest in both SCCM and SCOM monitoring in BPPM lately. Most people who have an interest in this type of monitoring know all too well the differences between SCCM and SCOM and which one is preferred depending on the monitoring environment, but let’s a quick look at both and then see how we can monitor these tools in BPPM.

 

Microsoft's System Center Operations Manager (SCOM) is a monitoring tool to give administrators the ability to monitor the health of their environments. SCOM is used to monitor the health and performance of everything from servers to individual applications in Microsoft Windows environments.

 

Microsoft’s System Center Configuration Manger (SCCM) is Microsoft's all-in-one systems management assistant; a self-service solution a designed to evaluate, deploy and update servers and devices in a variety of environments. SCCM provides administrators with the capability to manage all aspects of Windows-based desktops, servers and devices from a single hub, giving them even more control over their IT infrastructures.

 

Once the IT team has their Windows management system in place, let BPPM monitor it for you!

 

Does BPPM have an out of the box way to monitor SCOM performance?

 

BMC ProactiveNet Performance Management 8.6 SP3 and later supports SCOM 2012 monitoring. For more information, please see our online documentation about third party products. In the Admin console, you will the see the adapter name as "SCOM 2007" but you can still integrate it with SCOM 2012.

 

The BMC SCOM Adapter can monitor the following SCOM versions:

 

- SCOM 2007

- SCOM 2007 SP1

- SCOM 2007 R2

- SCOM 2012

- SCOM 2012 SP1

- SCOM 2012 R2

 

NOTE: SCOM 2012 has removed the Root Management Server (RMS); the Root Management Server (RMS) Emulator must be installed for the BMC SCOM Adapter to monitor SCOM 2012.

 

 

BPPM 9.6 SCOM support

BPPM 9.5 SCOM support

 

In order to help you determine what you would like to monitor, we have the SCOM Adapter Monitor Types Reporter tool. The SCOM Adapter Monitor Types Reporter tool is an executable program that provides an XML report of all devices, monitor types, and relevant attributes available on the SCOM server in the BMC ProactiveNet environment.

 

You must have .NET 3.0 or later installed for the application to run.

The SCOM adapter monitor types reporter information can be used for the following:

 

 

•Determine which attributes are relevant to various devices. By using this information, determine which attributes must be selected on the BMC ProactiveNet Operations Console for a particular device.

•Verify whether the SCOM Rule is collecting data on the SCOM server.

 

For each monitor type, an XML will be generated with the relevant data on the current directory.

For monitor types that are not used for collection (there is no device for those), no XML will be generated.

 

 

Does BPPM integrate the SCOM events as well as performance data?

 

1) The BPPM SCOM Adapter is an adapter to bring in data not events.

2) To bring in SCOM events into BPPM there are 2 options:

2a) BMC offers a 3rd party partner add-on "Seamless Technologies Event Integration for BMC ProactiveNet Performance Management" that can be used to bring in events. This can be found under BPPM suite on the EPD download site under ->BMC Event and Impact Management - License Add-on ->BMC Performance Management - >Third Party and Custom Analytics License Add-on

2b) Users can create their own mechanism within SCOM to msend events into BPPM.

 

 

How can I troubleshoot SCOM data collection issues?

 

Setting up SCOM Adapter debug is recommended, that way, we can see the communication attempts.

Here are the steps to collect debug.

 

  1. On the BPPM agent machine, open the scom.conf file located in the <installDirectory>\pw\monitors\shared\scom directory.

  2. Comment out the line "pronet.scom.ntdebugging.enabled=true" as this line is no longer used by the adapter.

  3. Change the following variable to true: dll.Logger.debugEnabled=false. This is the variable which enables the native debug.

  4. Enable debug for the agent with command 'pw debug on -a <Agent Name>'.

  5. Perform discovery and note the exact time you did this operation.

  6. Collect the entire log directory BPPMAgent\Agent\pronto\logs and send to Support

 

What about SCCM is it monitored in BPPM?

There is no 'out of the box' solution for SCCM but there are several options for creating a custom solution, see below:

 

Users can create their own custom KM using the following resources

Building a PATROL Knowledge Module Developers Guide

Advanced PATROL Knowledge Module Development

Event Adapters user guide (for SNMP monitoring)

REST api integrations

Additional REST api's (9.6)

 

We would also encourage the use of the BMC Community as other members may have had experience setting up monitoring for SCCM and may be able to offer assistance.

 

So while we do offer the SCOM adapter, we do not have a similar adapter for SCCM performance monitoring out of the box. The majority of the requests we receive are for SCOM data, but if you have an interest in SCCM monitoring, I would urge you to submit an Idea in the BMC Community to request investigation regarding possible monitoring options.

 

BMC Ideas is a way to provide enhancement requests within our growing BMC Community. We are offering you the opportunity to submit on and vote for your requests for enhancement for your favorite BMC Products!  Check out these short video presentations detailing how to get started with BMC Ideas.

 

"    Introducing Ideation

"   Accessing Ideas

"    Interacting with Ideas

"    Submitting Ideas

 

 

Computer.png

 

Newly Published Knowledge Articles - New Content has been added over the last month!

This is our opportunity to share with you some of the most recently created knowledge articles in case they may help you with something you would like to know more about.

 

KA425524 - On the SNMP Adapter Configuration Manager, when you push the publish button nothing happens and there is no message written to the lower window in the configurator screen.

KA425441 - Is it possible to force propagation of events to the jserver?  

KA425739 - BPPM Self Monitor KM shows ImpactManager process down when it is really running

KA425616 - How are multiple enumerated values represented in the BPPM CMA policy import file.

KA425403 - Event propagated from other cells to BPPM, mquery shows the event in BPPM, but user console does not show the event.

KA425317 - In the operations console, the event details pane is slow to update when selecting an event.

KA425245 - PATROL for Unix 9.13 install failed on a HP-UX .11.31 U ia64 when using the "BPPM repository version 9.6.02 - Base March 2015" package

 

 

Popular Knowledge Articles

KA419548 - How to clean up the Marked for Delete (MFD) sooner than the 7 days default period in BPPM 9.5 and 9.6?

KA423528 - Beta for BMC TrueSight Operations Management 10.0: CMA is not getting launch. Customer was not able to open CMA in 3 browsers (Mozilla, Chrome, IE)

KA296013 - How to manually sync HA cells

KA399534 - How to allow members of a BPPM user group to see events from devices.

KA328581 - How can I clear all events and alarms from BMC ProactiveNet Performance Manager Server?

 

Looking for a previous blog posting? Find it here: BMC TrueSight Support Blogs

 

Feedback1.jpg

Feedback Request:

Help us determine how we are doing. Use the rating system at the bottom of this blog to rate this post! Feel free to comment as well. We want to hear from you!

Share:|

We have seen a rise in interest regarding custom Knowledge Modules (KM) and importing them into BMC ProacitveNet Performance Manager (BPPM). While we have touched on this topic before, we can expand it a bit more with a few more details and even a Best Practices Document for future reference. The questions does come up from time to time about how to import the custom KMs so let’s refresh our knowledge and/or learn something new depending on your comfort level with custom KMs.

 

First off, if you have not done so, please watch the BPPM Webinar recording done by BMC’s own Hutson Meeks where he discusses this topic for BPPM. Enabling Custom Knowledge Modules for BPPM 9.5 can be found here:  https://communities.bmc.com/docs/DOC-31482

This presentation is very similar to the details in this post but Hutson provides his expertise and tips.

 

High-level Process Workflow

It is recommend that you enable custom KMs for BPPM 9.5 in three major phases in the order listed below.

 

 

1)    Data Collection Enablement

2)    Policy Configuration Management Enablement

3)    Menu Command Enablement

 

 

You should completely test and validate the results of each phase before moving on to the next phase.

 

 

NOTE: If you choose to not enable Policy Configuration Management or Menu Commands the KM can still collect data into the BPPM 9.5 server and the KM configuration can be managed by agent configuration settings defined as rules in the Configuration Variables section of a monitoring policy.

 

 

Required Tools

The following tools are required to support the process of enabling, importing, testing and enabling PATROL Knowledge Modules for BMC ProactiveNet Performance Management 9.5.

 

 

1) BPPM 9.5 Server with CMA installed and operational

2) BPPM 9.5 Integration Service node installed and operational

3) BPPM 9.5 PATROL Agent installed and integrated with the BPPM 9.5 infrastructure

4) PATROL Classic Console version 3.6.00.1 (version 3.6.00 with the patch applied) or higher

5) PCIG Utility (Available with the PATROL common installer v9.6 under …\bmc_products\tools\pcig\ )

6) A common compression utility such as zip delivered with RHEL 6.4

 

 

All of these tools should be installed in a development environment.  Do not attempt to configure KMs for BPPM 9.5 in a production environment.

 

 

Enabling Data Collection Workflow Steps in Detail

The following steps provide details covering the entire process of enabling data collection with a custom KM for BPPM 9.5.  These steps should be completed in the order listed.  Attention to specific details should be observed, and recommendations should be followed.  Failure to follow these steps may result in unexpected or unintended results.

 

 

1) Validate that the custom Knowledge Module monitors and collects data in PATROL as designed and expected.  This is irrespective of BPPM.

2) Install and configure the tools listed under the Required Tools section above.

3) Deploy the custom Knowledge Module to be enabled to a test agent and the PATROL Classic Console using the latest version of the console.

4) Launch the PATROL Classic Console in Developer mode and load the custom Knowledge Module.  Load any dependent Knowledge Modules as well.

5) Configure the agent to operate in non-Policy mode and ensure the agent is not connected to a BPPM Integration Service node.

6) Add meta data settings to the Knowledge Module.

AppPropertiers160.pngParameterPropers2.png

 

 

7) Save the KM.

8) Commit the KM.

9) Validate that the Knowledge Module continues to monitor properly in PATROL.

10) Exit the PATROL Classic Console

11) Edit or create the KML file.  This file should contain a list all *.KM files to be loaded like it has been used in previous versions of PATROL.  Additionally, it is a best practice to add values for both the MetaKMLDisplayName and the MetaKMLDiscription in the KML file as shown in the example below.

!PATROLV3.2.0   FF08BBD43AC9210A8C6C41C85A315D3F

!++

!

! PATROL Session Knowledge Module

!

!--

! MetaKMLDisplayName = "Log Values"

! MetaKMLDescription = “KM that monitors numeric values from log file annotations”

KM_LIST = {

    "LOG_VALUES.km"

}

! 9999

12) Edit the Knowledge Module file adding release and revision information to the header of the KM file.  This should include the following information.

•    RELEASE number

•    REVISION number

•    PACKAGE value

•    DESCRIPTION

•    PRODUCTCODE

Example data from a KM file is shown highlighted below.

!PATROLV3.6.00.1i 3EC3A0E66408BF2FDB85D058CB4597BBE7EC56BBDB4BCA4A2D59D74EE5B65E7F

!#MSG_DOMAIN    km_sec

!++

!

! PATROL Session Knowledge Module

!

!—

!RELEASE    1.0.00

!REVISION    00

!PACKAGE    plv

!DESCRIPTION    PATROL Knowledge Module for Log Values

!PRODUCTCODE    plv

!PRAGMA allow: all

NOTE:  Both the PACKAGE value and the PRODUCTCODE should be a unique value specific to the custom KM.  Do not use BMC Software package values and/or product codes.  You can get a list of currently used values in your environment from the BPPM server where CMA is installed and used.  A list of these values is in the solution_list.xml and Solution_Mapping.xml files.  You can find these files in the following directory on the BPPM server where CMA is installed.

 

On UNIX/Linux: $BPPM_SERVER_HOME/pw/pproxy/depot_directory/bmc_products

On Windows:     %BPPM_SERVER_HOME%/pw/pproxy/depot_directory/bmc_products

Review the content of these files on your system if you are not certain.

 

NOTE:  If you do not enter the release and revision information into the KM file(s) the related application classes will not be processed in the BPPM server.  When the agent connects to the IS node the application classes without release and revision information will be rejected and an error event will be generated as shown below.

 

UnableToPRocess.png

13) Copy all the files related to the custom Knowledge Module to a backup directory.

a.    KML file

b.    KM files

c.    PSL files

d.    LIB files

e.    Etc.

14) Apply agent configuration rules to the agent so that the custom KML is in the KM preloaded list and the agent is configured to connect to the BPPM 9.5 test Integration Service node.

15) Stop the PATROL Agent.

16) Delete all the files related to the Knowledge Module from their respective PATROL Agent directories and the PATROL Classic Console cache.  You will be reinstalling them using a silent install package that you create in the BPPM 9.5 CMA Deployable Packages Repository.

17) Create a subdirectory for the custom Knowledge Module under the location where you have installed the PCIG utility. For example if you installed the PCIG utility in the directory shown below, create a directory for the custom Knowledge Module there as shown.  In this example the custom Knowledge Module is named LOGVALUES.

LinuxOutput4.png

 

18) Create respective sub-directories for all the Knowledge Module files under the location where you have installed the PCIG utility.   See example below.

Output4.png

 

 

 

19) Copy all the Knowledge Module files from the backup location to their respective directories under the directory you created for the custom Knowledge Module.  If you are providing a default configuration settings in a PATROL agent configuration “cfg” file (or a filename.current file) copy the file to the lib directory under the directory you created for the custom Knowledge Module with the same name.  See example shown below.

Output5.png

 

20) Run the PCIG utility from the directory it is installed in and source the Knowledge Module files from the subdirectory you created for the custom Knowledge Module.  Enter the same syntax as shown below for all command line arguments.  In this example, the Knowledge Module files are in their respective subdirectories under the LOGVALUES directory as noted above.

./pcig -p plv -r 1.0.00 -s LOGVALUES/ -l ALL -t LogValues

The following table lists the command line arguments with the example values from the command above.  (This was run on Linux.Windows follows the same format.)

Table6.png

Argument    Purpose    Example    Comments

-p    product    plv    Enter a value that does not match or conflict with any other products.

-r    release number    1.0.00    Enter a 3 segment value.  Do not enter only one or two segments.  (For example 1 and 1.0 would not work.)

-s    location of all source files and their respective sub directories    LOGVALUES/    This is the top level directory under which custom KM files are stored.  The subdirectories must follow the same structure as a normal PATROL Agent and KM install.  This directory should be a subdirectory in the directory where you are running PCIG. Use this syntax exactly with the proper subdirectory name followed by a forward slash at the end.  The following is an example.  Suppose you are running the PCIG utility in /home/patrol to create a package for the “Log Values” custom KM.  The directory structure for the tag you are creating a package for would look like this:

 

/home/patrol/LOGVALUES

/home/patrol/LOGVALUES/lib

/home/patrol/LOGVALUES/lib/psl

/home/patrol/LOGVALUES/lib/knowledge

 

-l    comma separated list of supported OS types    ALL    Make sure this matches the Knowledge Module design

-t    product title name    LogValues    This is the name of the compressed ZIP file that is generated to be imported.

 

 

 

Note: Command line argument information can be displayed at a command prompt by running the PCIG utility with no arguments as shown.

[root@BPPMRHEL62-HM LINUX-X64-64]# ./pcig

PATROL Common Install generator v9.5.00 (build:20140921815)

Usage: pcig.exe -p product -r release -s source_path [-l os_list] [-t title] [-c]

-p <product>:  Required name (also specifies name of output ppf file without ".ppf")

-s <source_path>: Required path to package member files.  The files under <source_path> are copied to <dest_path>/products/<product_name> and gzipped, and their respective entries are added under the files section of the ppf.  The ppf and cat file are placed in  <dest_path>/Products/<product_name>, and a copy of the ppf is also placed in <dest_path>/Index/.

-r <release>: the version (vv.mm.rr) of the package to be used with BPPM in the format of.

-l <os_list>: comma separated list of OS types (possible values: AIX,SOLARIS,HP-UX,LINUX,WINDOWS,ALL,ALL-UNIX).

-t <title>: Product name, to be used on the BPPM CMA repository UI

 

The PCIG utility will create a bmc_products directory and a ZIP file for the solution.   Below is an example output when running the PCIG utility.

Output7.png

 

NOTE:  At the time this documentation was created the compressed ZIP file generated by the PCIG utility was not importable to the CMA Monitoring Repository.  To resolve this you should recursively compress the bmc_products directory that is created by the PCIG utility and import the ZIP file generated

21) Compress the bmc_products directory that was created by the PCIG utility into a ZIP file.  Do not attempt to use the folder compression capability that is built into Microsoft Windows.  Use a commonly used compression utility such as the zip command on Linux or 7-Zip on Windows.

Output8.png

 

22) Import the Zip file you created into the BPPM 9.5 CMA Monitoring Repository.  Import as a single solution.

Output9.png

 

23) Create a silent install package in the BPPM 9.5 CMA Deployable Package Repository.  Provide a unique and meaningful name for the package following configuration best practices.  Do not include the agent or any other KMs in the package.

 

Output10.png

 

24) Download the silent install package that you created for the Knowledge Module from the BPPM 9.5 CMA Deployable Package Repository and move it to the test managed node.

25) Run the silent installer for the package

26) Start the PATROL Agent.

27) Verify that the Knowledge Module application class(es) appear(s) as monitor type(s) in the BPPM server operations UI

Output11.png

 

28) Validate that data is being collected as expected.

 

Output12.png

 

Enabling Policy Configuration

Enabling policies for the KM configuration requires entering XML data into the Input tab of the properties for the KM container.  The screen shot below shows an example of the Input tab.

Output13.png

 

Practice and leveraging examples will help you learn what data is needed.  Note the following points.

 

 

1) Much of the structure and content of the XML data is the same for various KMs.  This includes the host configuration sections and various labels.  This means you can easily copy existing Input XML data and edit it to create the XML data for your custom KM.

2) XML data that is unique to your KM is mainly titles and content in the attribute sets that define the specific configuration settings for your custom KM.

3) The XML Input data is saved into the KM XML file.  It is not saved in a separate file to be managed with the PCIG utility.

This illustrates an example of Input XML data.  Only the data highlighted in blue text was edited from a copy, and an additional attribute was added.

 

NOTE: Notice the ID values in red text.  These values correspond to PATROL agent configuration variables.  When the policy is applied, PATROL Agent configuration variables that contain the ID values are created under the /ConfigData/<KM name> branch.  An example of the /ConfigData/<KM name> data is shown after the XML example.

 

 

<KMConfigurationMetadata>

<KMLevelConfiguration dataModelMajorVersion="1" dataModelMinorVersion="1">

</KMLevelConfiguration>

<ConfigurationParameters>

<ConfigurationParameter>

<List description="List of remote hosts" id="HOSTS" indexedBy="host" isMandatory="true" label="Host Log Values Configuration">

<AttributeSet description="Enter Host Name for which the specified configuration applies" i18nIdForDescription="4" i18nIdForLabel="3"  id="HostConfiguration" label="Host Details">

<Attribute>

<String default="localhost" description="Enter the Host Name" i18nIdForDescription="6" i18nIdForLabel="5" id="host" isMandatory="true" label="Host Name">

</String>

</Attribute>

<Attribute>

<AttributeSet id="LogValues" label="Log Values Configuration Options">

<Attribute>

<String default="" description="Enter the log instance to monitoring." id="LVInstance" isMandatory="false" label="Log Instance">

</String>

</Attribute>

<Attribute>

<String default="" description="Enter the alarm search string value." id="LVSearchString" isMandatory="false" label="Search String">

</String>

</Attribute>

<Attribute>

<String default="" description="Enter the data delimiter." id="LVDelimiter" isMandatory="false" label="Delimeter">

</String>

</Attribute>                 

</AttributeSet>

</Attribute>

</AttributeSet>

</List>

</ConfigurationParameter>

</ConfigurationParameters>

</KMConfigurationMetadata>

 

 

The PATROL configuration variables below illustrate content corresponding to the Input XML data above.

 

 

PATROL_CONFIG

"/ConfigData/LOG_VALUES/HOSTS/localhost/host" = { REPLACE = "localhost" },

"/ConfigData/LOG_VALUES/HOSTS/localhost/LVDemiliter" = { REPLACE = "2" },

"/ConfigData/LOG_VALUES/HOSTS/localhost/LVInstance" = { REPLACE = "MyTestLogPN0" },

"/ConfigData/LOG_VALUES/HOSTS/localhost/LVSearchString" = { REPLACE = "sessions" }

 

 

The policy configuration screen below illustrates the result of the Input XML data after it is imported as part of the KM into the CMA repository.

Output14.png

After you have entered the XML data, save the KM and work through the same packaging and import process using PCIG that you followed to enable the KM for data collection.  Test the policy configuration before moving on to enabling Menu commands.

NOTE:  Most KMs will need to be edited where the pconfig PSL command is used to interact with the agent pconfig database so that it leverages the PATROL agent configuration variables under the /ConfigData/<KM name> branch.  It is generally easier to configure the agent to collect data into the BPPM server in non-policy mode first, then apply the policy and finally edit the KM based on the agent configuration variables applied by the policy.

 

 

Enabling Menu Commands in the BPPM UI

The following steps illustrate how to enable Menu Commands in the BPPM UI.

 

 

1) Open the properties for the Menu Command and go to the Command tab.

2) Copy the command text and save it in a backup text file.

3) Click on the General tab and select Generate Auto ID as shown below.  Do not select the Annotate choice if the menu command prompts for user input. (Annotate can be used to automate the command.)

Output15.png

 

Click Yes to continue.  The command text can be copied from the backup file and pasted into the Command tab if it is lost.

4) After clicking Yes notice the Command ID is generated as shown in the example below.

 

Output65.png

5) The menu command function is saved as a file in the PATROL Console Cache PSL directory as shown in the example below.

 

Output17.png

6) Include the Menu Command ID <name>.lib file in the PSL source directory for PCIG.

7) Work through the same packaging and import process using PCIG that you followed to enable the KM for data collection and Policy configuration management.

8) Verify the Menu Command was created in the BPPM UI

Output18.png

General Recommendations

Do not use the Microsoft Windows compressed folders capability to compress the package.  Use a compression utility like 7-Zip.

 

Do not attempt to combine multiple KM solutions into one package.  Create separate packages for each.


Monitoring in BPPM will not function for Knowledge Modules which are not XML compliant and that are loaded on a 9.5 agent.

 

PSL code should be stored in PSL files using the "Save to file" option in the developer console while developing Knowledge Module.
This should be done instead of storing the code in the Knowledge Module files.  This will reduce the size of the XML file.

 

Keep in mind the XML file for the Knowledge Module is generated by the PATROL console and saved into the PATROL Console cache.

 

Start with a working Knowledge Module in PATROL.

 

Do not try to mix Knowledge Module development for monitoring and development/editing for BPPM 9.5 compatibility.  Work in a logical order.

 

Observe and follow general Knowledge Module development best practices.

 

Observe and follow general software development best practices.

 

Keep your code organized and follow the recommended process.  Do not jump ahead.  Do not skip steps.


Establish, document, and follow a version-revision numbering methodology.


Do not work though the enablement process in production.  Complete Knowledge Module enablement for BPPM 9.5 in a development and test environment before you import the final Knowledge Module solution package into production.

 

Do not use product names that match or conflict with other product names including BMC product names.


Do not use Knowledge Module names that match or conflict with other Knowledge Module names including BMC provided names.


Do not use package or solution names that match or conflict with other package or solution names including BMC provided names.


Maintain release and revision numbers properly.  This is especially important if you plan to have multiple release and/or revision numbers in use over time.

 

Use different names for the solution package created by the PCIG utility and the silent install package you create in the BPPM 9.5 CMA Deployable Package Repository.  This will help you keep track of the two files separately and not get them mixed up.  For example:

  1.   Name the file created by the PCIG utility based on the product name (Ex. plv.zip – “plv” is short for the custom KM solution named “Patrol Log Values”).
  2.   Name the deploy-able package according to the Knowledge Module name (Ex. LogValues.zip).

Be careful with text editors.  Do not use Microsoft WordPad or Microsoft Word for editing and saving files.  Use vi on Linux and UNIX.
Use Notepad or a programmer’s text editing utility like Notepad++ on Windows.  This will prevent the introduction of special characters that will cause issues.

 

Do not manually edit files except where recommended and required.


Start with a simple KM and learn the process before moving on to a more complicated KM.

 

It is a best practice to implement a container for each custom KM application class, especially if you expect multiple instances to be monitored.  This will improve UI navigation in BPPM so that all like instances are grouped into a container.

 

Make a backup of all KM related files before you begin editing.


Work in stages and take backups of each stage before moving on to the next stage.  For example get data collection working first, then move on to policy enablement, and finally enable menu commands.

 

Do not install or use other tools in the development environment that may interfere with the development process.  Examples include older PATROL Console versions, older BPPM infrastructure components that may be integrated with the test agent(s), PATROL Central, etc.

 

This entire Best Practices Document is available for download from our Knowledge Base under knowledge article KA400714

For more details about building and packaging custom see our online help: Building and packaging custom KMs.

For information about building a KM, see Building a PATROL Knowledge Module Developers Guide

Computer.png

 

 

Newly Published Knowledge Articles - New Content has been added over the last month!

This is our opportunity to share with you some of the most recently created knowledge articles in case they may help you with something you would like to know more about.

 

KA424135 - Cell loop and running 100% CPU while processing MC_SM_IMPACTS_REPORT event and deleting MC_SM_IMPACTS data instances.

KA424020 - BMC PATROL for Web URL Monitoring KM, after configuring an URL for monitoring, getting error 'handshake failure'.

KA424017 -  Is BPPM affected by the OpenSSL vulnerabilities CVE-2015-0204 and CVE-2015-0291?

KA422603 - Where is the send_trap utility in Windows?

KA423763 - What can we use instead of Tunnel proxy and TCP proxy in BPPM version 9.5 and higher?

KA422471 - Promotion from Impact Model Designer (IMD) is failing with the errors 'Publication for job ID null has failed'. and 'Promotion of Sandbox Changes has Failed. - Failed while doing promotion.' 

KA422559 - Tips for Email2Event problems

 

Popular Knowledge Articles

This list represents our most widely used knowledge articles, take a look to see if they may help you too!

 

KA403892 - Troubleshooting Guidelines for BPPM with Oracle Database

KA356644 - ProactiveNet Agent error - "java.lang.OutOfMemoryError: Java heap space"

KA287306 - How to Delete ProactiveNet Auto Sync Monitor Instances and devices from the system with respect to BMC Patrol Adapters?

KA316131 - What are the different ways of enabling cell trace?

KA352032 - Diagnosing problems with ProactiveNet PATROL Adapter without Service Integration

 

Looking for a previous blog posting? Find it here: BMC TrueSight Support BlogsBMC TrueSight Pulse Blogs

 

Feedback1.jpg

 

Feedback Request:

Help us determine how we are doing. Use the rating system at the bottom of this blog to rate this post! Feel free to comment as well. We want to hear from you!

Filter Blog

By date:
By tag: