BMC Performance Manager Portal Webinar Series Local - India, Bangalore: +91 (0) 80 6127 5134 Local - India, Mumbai: +91 (0) 22 6150 2334 Local - Ireland,

BMC Performance Manager Portal Webinar Series Local - India, Bangalore: +91 (0) 80 6127 5134 Local - India, Mumbai: +91 (0) 22 6150 2334 Local - Ireland, Dublin: +353 (0) 1 437 0560 Local - Israel, Tel Aviv: +972 (0) 3 721 9373 Local - Italy, Milan: +39 02 9978 1800 Local - Italy, Rome: +39 06 8743 4377 Local - Japan, Tokyo: +81 (0) 3 4578 6733 Local - Latvia, Riga: +371 6601 3678 Local - Lithuania, Vilnius: +370 5205 5590 Local - Luxembourg, Luxembourg: +352 2786 0224 Local - Malaysia, Kuala Lumpur: +60 (0) 3 7724 0847 Local - Mexico, Mexico City: +52 55 4777 2663 Local - Netherlands, Amsterdam: +31 (0) 20 262 0137 Local - New Zealand, Auckland: +64 (0) 9 929 1884 Local - Norway, Oslo: +47 21 95 32 33 Local - Poland, Warsaw: +48 (0) 22 295 36 31 Local - Portugal, Lisbon: +351 21 120 9698 Local - Romania, Bucharest: +40 (0) 21 529 1340 Local - Russian Federation, Moscow: +7 495 620 9818 Local - Singapore, Singapore: +65 6416 9957 Local - Slovakia (Slovak Republic), Bratislava: +421 (0) 2 3278 6632 Local - Slovenia, Ljubljana: +386 (0) 1 888 8397 Local - South Africa, Johannesburg: +27 11 589 8382 Local - Spain, Madrid: +34 91 080 0153 Local - Sweden, Stockholm: +46 (0) 8 4030 4953 Local - Switzerland, Geneva: +41 (0) 22 555 0258 Local - Switzerland, Zurich: +41 (0) 44 556 8481 Local - Taiwan, Taipei: +886 (0) 2 2650 7292 Local - United Kingdom, London: +44 (0) 20 8150 0796

Participant Passcode: 351920

US iPhone 1-click: 1-913-312-0414,,351920# Int'l Toll and US Cell Phone: 913-312-0414 US/CAN Toll free: 800-811-8824 Local - Australia, Brisbane: +61 (0) 7 3123 0047 Local - Australia, Canberra: +61 (0) 2 6111 2007 Local - Australia, Melbourne: +61 (0) 3 9034 3217 Local - Australia, Sydney: +61 (0) 2 9038 0410 Local - Austria, Vienna: +43 (0) 1 2675 904 Local - Bahrain, Manama: +973 1619 9040 Local - Belgium, Brussels: +32 (0) 2 303 2273 Local - Brazil, Sao Paolo: +55 11 3181 3948 Local - Bulgaria, Sofia: +359 (0) 2 491 6411 Local - Canada, Montreal: +1 514 669 6112 Local - Canada, Toronto: +1 647 426 9209 Local - China: +86 400 120 2693 Local - China: +86 400 120 26 93 Local - Czech Republic, Prague: +420 234 147 003 Local - Denmark, Copenhagen: +45 78 78 79 63 Local - Estonia, Tallinn: +372 622 5742 Local - Finland, Helsinki: +358 (0) 9 7479 0101 Local - France, Lille: +33 (0) 359 69 03 42 Local - France, Lyon: +33 (0) 426 10 30 24 Local - France, Paris: +33 (0) 1 70 71 29 53 Local - Germany, Berlin: +49 (0) 30 2555 5430 Local - Germany, Frankfurt: +49 (0) 69 1200 9864 Local - Germany, Munich: +49 (0) 89 1436 7911 Local - Hong Kong, Hong Kong: +852 3008 0383 Local - Hungary, Budapest: +36 1 577 9957

BMC Performance Manager Portal Webinar Series Int'l toll free - Korea, Republic Of: 003 0813 1654 Int'l toll free - Korea, Republic Of: 00798 14 800 4574 Int'l toll free - Latvia: 800 03 656 Int'l toll free - Lithuania: 88 003 0200 Int'l toll free - Luxembourg: 800 25 164 Int'l toll free - Malaysia: 1800 81 2644 Int'l toll free - Mexico: 001 800 514 1058 Int'l toll free - Monaco: 800 93 304 Int'l toll free - Netherlands: 0 800 024 9645 Int'l toll free - New Zealand: 0 800 440 611 Int'l toll free - Norway: 800 191 83 Int'l toll free - Panama: 00 800 226 7179 Int'l toll free - Peru: 0800 55 444 Int'l toll free - Philippines: 1 800 111 00400 Int'l toll free - Poland: 00 800 112 41 37 Int'l toll free - Portugal: 800 819 382 Int'l toll free - Russian Federation: 810 800 2544 1012 Int'l toll free - Singapore, Singapore: 800 101 1738 Int'l toll free - Slovakia: 0800 606 314 Int'l toll free - Slovenia: 0 800 80815 Int'l toll free - South Africa: 0 800 999 562 Int'l toll free - Spain: 900 941 991 Int'l toll free - Sweden: 02 079 3671 Int'l toll free - Switzerland: 0 800 896 853 Int'l toll free - Taiwan: 00 801 126 826 Int'l toll free - Thailand: 001 800 12 066 3284 Int'l toll free - Trinidad and Tobago: 800 205 7179 Int'l toll free - United Arab Emirates: 800 017 7175 Int'l toll free - United Kingdom: 0 800 051 7166 Int'l toll free - Uruguay: 000413 598 2551 Int'l toll free - Venezuela: 0 800 100 2525

Participant Passcode: 351920

US iPhone 1-click: 1-913-312-0414,,351920# Int'l Toll and US Cell Phone: 913-312-0414 US/CAN Toll free: 800-811-8824 Int'l toll free - Argentina: 0800 666 2571 Int'l toll free - Australia: 1 800 635 764 Int'l toll free - Austria: 0800 295 994 Int'l toll free - Bahamas: 800 205 6295 Int'l toll free - Belgium: 0 800 72 785 Int'l toll free - Brazil: 0800 891 8445 Int'l toll free - Bulgaria: 00 800 115 1110 Int'l toll free - Chile: 123 0020 9601 Int'l toll free - China, Northern Region: 10 800 714 1853 Int'l toll free - China, Southern Region: 10 800 140 1378 Int'l toll free - Colombia: 01 800 518 0504 Int'l toll free - Czech Republic: 800 142 277 Int'l toll free - Denmark: 8088-6980 Int'l toll free - Dominican Republic: 1 888 751 4437 Int'l toll free - France: 0 800 914 669 Int'l toll free - Germany: 0 800 182 4414 Int'l toll free - Greece: 00 800 161 2205 1068 Int'l toll free - Hong Kong: 800 908 710 Int'l toll free - Hungary: 06 800 184 72 Int'l toll free - India: 000 800 100 7363 Int'l toll free - Indonesia: 001 803 011 2660 Int'l toll free - Ireland: 1 800 760 204 Int'l toll free - Israel: 1 80 945 2068 Int'l toll free - Italy: 800 873 593 Int'l toll free - Japan: 00531 12 0058 Int'l toll free - Korea, Republic Of: 003 0813 1654 Int'l toll free - Korea, Republic Of: 00798 14 800 4574

—December 8, 2015

BMC Performance Manager Portal Webinar Series

BMC Portal Script Availability

BPPM/TrueSight BMC Portal Adapter Best Practice

Did you miss our last Webinar?

• Thank you to all who attended our second BMC PM Portal Webinar covering Best Practices in BMC Performance Manager Portal in July

• If you were unable to attend our last Webinar, but are interested in reviewing Webinar and materials, please visit our post in the BMC Community i.e. https://communities.bmc.com/community/bmcdn/service_assurance/performance_management/blog/2015/07/29/connect-with-bmc-performance-manager-portal-best-practices-details

• Remember our Best Practices and Portal Quick Tune guides are living documents and may change periodically so please visit the links often to download the latest version ftp.bmc.com/pub/BPMPortal/BMC_Performance_Manager_Portal_Best_Practices_Guide.docx ftp://ftp.bmc.com/pub/BPMPortal/Portal_quick_Tune.txt

• Today’s topics are BMC Portal Scripting Availability and BPPM/TrueSight BMC Portal Adapter Best Practice. The Portal database provides a vast array of information and only a Portal Jedi can gain access to the galaxy of information and fetch important data to generate meaningful reports using scripts. True Jedi’s can master the art of the Portal Adapter to transition to TrueSight!

Copyright © BMC Software 2015

https://communities.bmc.com/community/bmcdn/service_assurance/performance_management/blog/2015/07/29/connect-with-bmc-performance-manager-portal-best-practices-details





ftp://ftp.bmc.com/pub/BPMPortal/BMC_Performance_Manager_Portal_Best_Practices_Guide.docx



ftp://ftp.bmc.com/pub/BPMPortal/Portal_quick_Tune.txt



What is Portal Scripting?• BMC Performance Manager Portal engineers have written a great number of scripts which are

functional and informative for users to collect data from the portal database.

• Portal scripts are SQL scripts written to pull data from directly from the Portal database. The scripts are executed using the DatastoreCliBMCPDS utility. All scripts require access to the database using the Portal database user, default user is ‘pe’.

• Scripts have been written to cover some database maintenance as well as collect data about the elements, applications, parameters, and thresholds.

• Scripts are run from the Portal database server. Configure the DatastoreCliBPMCDS utility as per the BMC Portal Installation Guide – section Configuring the BMC DatastoreCLI


Why Portal Scripting?The benefits to running scripts against the portal database are many:

• Quick and easy to collect data – while the Portal is still running. There is no need to stop the application or shutdown the database

• Script output is usually in HTML format and can be opened and edited in MS Excel

• Scripts are flexible and customizable by you to meet your needs

• Scripts can also be setup to run regularly against the Portal database via batch or cron jobs

These are some of the benefits to using scripts with the Portal. We will review several of our most commonly used scripts.


How to run the scripts• Scripts are installed by default at location %BMC_PORTAL_KIT_HOME%\appserver\util\

BPM_Datastore_Utility\scripts• Users would need to copy the script over to the Portal database server . Copy the script to the scripts

folder - %DATASTORE_HOME%\utility\BPM_Datastore_Utility\scripts or %ORACLE_BASE%\utility\BPM_Datastore_Utility\scripts • Execute the DatastoreCliBMCPDS.bat or .sh file from the DATASTORE_HOME\utility\

BPM_Datastore_Utility directoryFor example:DatastoreCliBMCPDS portalDBUserName portalDBpassword remove_expired_blackout

• Include any arguments if necessary• When the script is complete, the output file is generated in the same directory the script was run


Types of ScriptsDatabase Maintenance• DBA/Oracle instance details

Application Specific/System Configuration Reporting• Functional - BMC PM Portal database schema data

[Account, Application Classes, Instances, Parameters, thresholds, etc]• Continuous data extraction - CDE database schema data

[Data transfer scripts]


Database Maintenance ScriptsMostly useful when the retention is changed or many elements are deleted in Portal.

DatastoreCliBMCPDS "sys" "sys as sysdba" quick_reclaim_diskResizes all the data files to minimum extent allocation possible. Does not executes table and index shrink on any tables.

DatastoreCliBMCPDS "sys" "sys as sysdba" reclaim_diskResizes all the data files to minimum extent allocation possible. Executes table and index shrink on all the tables except the history tables.

DatastoreCliBMCPDS"sys" "sys as sysdba" full_database_shrink_reclaim_disk

Resizes all the data files to minimum extent allocation possible. Executes table and index shrink on all the history tables. It is very performance intensive SQL. If needed to be executed, please do it in maintenance window.

The reclaim_disk.log or quick_reclaim_disk.log or full_database_shrink_reclaim_disk.log are generated in the same folder where the BMC DatastoreCLI script was executed. Any of the script can be stopped if it takes longer than 6 hours.**The scripts execute the Oracle resize, deallocate and shrink space utility and it does not guarantee full disk space reclaim.

Automating the quick_reclaim_diskOptionally the quick_reclaim_disk can be scheduled. But it needs a grant.

grant alter database to PortalDBUser.

%BMC_PORTAL_KIT_HOME%\appserver\websdk\tools\jboss\server\all\conf\properties\drmop\drmop.properties

portal.history.reclaimdisk.enabled=true

Functional - BMC PM Portal database schema data

Picture to be inserted here

Deleting expired blackouts

Deleting expired blackouts

DatastoreCliBMCPDS portalDBUserName portalDBpasswordremove_expired_blackout

Any existing expired blackouts are deleted, and their details are stored in thenewly created remove_expired_blackout.html file.

To restore deleted expired blackouts, enter the following command:DatastoreCliBMCPDS portalDBUserName portalDBpasswordrestore_deleted_expired_blackout

If you delete expired blackouts multiple times, you can restore only the expired blackouts that were removed during the last deletion.

Forcing summarization for last dayAs per Portal Best Practices guide, please set portal.history.parameter.externalsummarization.enabled=true

DatastoreCliBMCPDS portalDBUserName portalDBpasswordmanual_external_summarization

Above will do the re-summarization for the last 1 day of granular data.

If the range needs to be changed, modify the manual_external_summarization.sql for the range of (DateFrom, DateTo)e.g. (sysdate-1-1/24, sysdate-1/24)Or for specific dates using following example( to_date('2015-11-10','YYYY-MM-DD'), to_date('2015-11-12','YYYY-MM-DD'))

Monitoring Portal database jobs and database procedures

DatastoreCliBMCPDS portalDBUserName portalDBPassword progress 2DatastoreCliBMCCDE CDEDBUserName CDEDBPassword progress 2

In the preceding commands, 2 represents the number of days for which you want to fetch the login messages from the PORTAL_LOG table. The preceding commands generate the progress.log file. Check the error messages in the log file.

Monitoring Portal database jobs and database procedures

Sample logs

2015-11-28 06:18:1010:- INFO: COMPUTE_OTHER_TABLES:- starting analyze table PARAMETER_INSTANCE_AGENT compute statistics

2015-11-28 06:18:2828:- INFO: COMPUTE_OTHER_TABLES:- completed analyze table PARAMETER_INSTANCE_AGENT compute statistics

2015-11-29 01:34:1919:- INFO: Entered EXTERNAL_SUMMARY for summarization from partitions >=2015-11-10 12:30:00 UTC to to Partitions <=2015-11-12 12:00:00 UTC (Local timestamp with GMT Offset=-12.00) Date range (Local)= from 2015-11-10 00:30:00 to 2015-11-12 00:00:00

2015-11-29 01:34:2727:- INFO: Exit EXTERNAL_SUMMARY for summarization from partitions >=2015-11-10 12:30:00 UTC to to Partitions <=2015-11-12 12:00:00 UTC (Local timestamp with GMT Offset=-12.00) Date range (Local)= from 2015-11-10 00:30:00 to 2015-11-12 00:00:00 max summarization date is 2015-11-27 19:00:00 Local Time

Checking CDE or HDE error messages

Checking CDE or HDE error messagesOn the day following the BMC Performance Manager Portal application server restart, run the reports on the CDE or HDE database to ensure that the data has been successfully transferred on the database.If there is no data in the reports, execute the progress DatastoreCLI on BMCCDE.

Checking CDE or HDE error messages

DatastoreCliBMCCDE CDEDBUserName CDEDBPassword progress 2

2015-01-30 22:00:0505:- ERROR: cde_util_proc.maintain_parameter_detail -1658 ORA-01658: unable to create INITIAL extent for segment in tablespace DATAFEED



Get list of application class with local override.



DatastoreCliBMCPDS portalDBUserName portalDBPassword get_local_application_class_list "%AccountPattern%" "%ElementPattern%" "%ApplicationClassPattern%"

e.g. get_local_application_class_list.sql "%My Account%" "%iBMC%" "%ping%"e.g. For getting all listing get_local_application_class_list.sql "%%" "%%" "%%"


Consolidated Application Collection Status Error reportDatastoreCliBMCPDS pe pe find_acs_errors "%internalApplicationNamePattern%“ "%ACSErrorTextPattern%“This command generates an find_acs_errors.html fileExamples1) DatastoreCliBMCPDS pe pe find_acs_errors "%windows%" "%credentials%“2) DatastoreCliBMCPDS pe pe find_acs_errors "%solaris%" "%%“3) DatastoreCliBMCPDS pe pe find_acs_errors "%%" "%%"

Report for element, account, RSM, parameter along with the thresholdsDatastoreCliBMCPDS pe pe export_element_configuration_detail "GroupPattern“ "AccountPattern""ElementPattern“

This generates the export_element_configuration_detail.html file listing thedescriptions of the following details:

■ Elements and thresholds that have inherited the element profile values andelements that have not over-ridden the element profile values.

■ Elements and thresholds that have inherited element profile values andelements that have over-ridden the element profile values.

■ Elements and thresholds that do not use element profile values

Report for element, account, RSM, parameter along with the thresholds

■ Account ■ AccountStatus ■ GroupName ■ GroupHierarchy ■ ElementName ■ RSM ■ RSM Cluster ■ ElementProfileName ■ Application ■ AppclassHierarchy ■ ApplicationSource

■ ApplicationInstanceName ■ SolutionName ■ ParameterName ■ ParameterActivate ■ ProfileOverridden ■ AlertAfterNTimes ■ AlarmEnabled ■ WarningEnabled ■ WarningMinValue ■ AlarmMinValue ■ ThresholdProperty ■ UsingRegex

Report with separate sections for element profile and Not using/override report.DatastoreCliBMCPDS pe pe export_configuration_info "%nameOfTheObjectgroup%“ "%nameOfTheAccount%"This generates the export_element_configuration_detail.html file listing thedescriptions of the following details:

■ Elements and thresholds that have inherited the element profile values andelements that have not over-ridden the element profile values.

■ Elements and thresholds that have inherited element profile values andelements that have over-ridden the element profile values.

■ Elements and thresholds that do not use element profile values

Report with separate sections for element profile and Not using/override report.export_configuration_info.html

■ ACCOUNT ■ PROFILENAME (If this exists) ■ GROUP_NAME ■ ELEMENT_NAME ■ APPLICATIONNAME ■ INSTANCENAME ■ PARAMETER_NAME ■ WARNINGMINVALUE

■ WARNINGENABLE ■ ALARMMINVALUE ■ ALARMENABLE ■ ALERTAFTERNTIMES ■ ALERTQUALIFIER ■ GROUPHIERARCHY (Complete

hierarchy for the groups separated by '/') ■ APPCLASSHIERARCHY (Complete

hierarchy for the instances separatedby '/')

Turn threshold on/off

• Changes the threshold for the element not using element profile.• If element profile is used, it overrides itDatastoreCliBMCPDS portalDBUserName portalDBPassword disableWarningFlag applicationClassPattern parameterNamePattern elementNamePattern accountPatterne.g.DatastoreCliBMCPDS pe pe disableWarningFlag "%C:%" "%Space%" "%Windows%“ "My Account“**It needs RSM restart or Element Monitor off and on to make the changes take effect.

Turn threshold on/offThe following command disables the alarm threshold for the Available Space parameter, for all application instances, for all the elements that contain the string Solaris, and for all accounts:DatastoreCliBMCPDS pe pe disableAlarmFlag "%%" "Available Space" "%Solaris%“ "%%“

The following command sets the value of the Alert After N Times attribute to 9 for the application instances that exactly match the string C:, the Available Space parameter, and all the elements in the Super account:DatastoreCliBMCPDS pe pe setAlarmAfterNTimes "C:" "Available Space" "%%“ "Super" 9

Get current value of the threshold

To get the current value for the Alert After N Times attribute for a parameter, and to check whether warning or alarm is enabled for the parameter, enter the following command.

DatastoreCliBMCPDS portalDBUserName portalDBpassword checkAlertFlag applicationClassPattern parameterNamePattern elementNamePattern accountPattern

checkAlertFlag output

Removing orphan element data from CDE

This is applicable for users who have enabled the external CDE

DatastoreCliBMCDE cdeDBUserName cdeDBPassword delete_removed_elements_from_cde

This will delete the data from Element, Application and parameter table for the elements which does not exists in Portal.**Please confirm your business need before executing this. Some users need the orphan data for old reporting.

Filling data gap in CDE tables

Due to some accident if data transfer did not happened, you can force the granular data transfer to CDE database

Step 1) DatastoreCliBMCPDS portalDBUserName portalDBPassword manual_schedule_transfer_cde NumberOfDaysToTransferDatae.g. Following will transfer last 2 days of datamanual_schedule_transfer_cde 2

Step 2) DatastoreCliBMCDE cdeDBUserName cdeDBPassword manual_schedule_import_cde

Filling data gap in HDE tables

Due to some accident if data transfer did not happened, you can force the granular data transfer to HDE database

Step 1) DatastoreCliBMCPDS portalDBUserName portalDBPassword manual_schedule_transfer_hde NumberOfDaysToTransferDatae.g. Following will transfer last 2 days of datamanual_schedule_transfer_hde 2

Step 2) DatastoreCliBMCDE cdeDBUserName cdeDBPassword manual_schedule_import_hde

Change the date range instead of the last days data gap filling

Edit the manual_schedule_transfer_cde.sqlexec cde_util.TRANSFER_CDE(to_date(‘2015-11-10’,’YYYY-MM-DD’), to_date(‘2015-11-12’,’YYYY-MM-DD’));

Edit the manual_schedule_transfer_hde.sqlexec cde_util.TRANSFER_HDE(to_date(‘2015-11-10’,’YYYY-MM-DD’), to_date(‘2015-11-12’,’YYYY-MM-DD’));

Account report

DatastoreCliBMCPDS portalDBUserName portalDBpasswordget_account_info

It displays the Account Name, Status, Count of active users, elements and count of RSM. It shows both Active and Inactive.

Blackout report

DatastoreCliBMCPDS portalDBUserName portalDBpasswordget_blackout_info

It displays the blackout details, type of blackout and its parent hierarchy. Report is consolidated for all the accounts.

Blackout report

Notification rules report

DatastoreCliBMCPDS portalDBUserName portalDBpasswordfind_notification_rule_details

It displays the Infrastructure objects notification rule details, type of notification and the recipient of the notification alert and the various objects associated to it.

FTP Location for the newly created scripts

ftp://ftp.bmc.com/pub/BPMPortal/scripts



Pediag report: current_portal_activity.html

Pediag report:elements-last-collected-data.html

Pediag report:impact-portal-data.html

Pediag report: oracle_specific_log.html

Pediag report: oracle_specific_log.html Retention Settings

Pediag report: oracle_specific_log.html Retention Settings (part 2)

Pediag report: oracle_specific_log.html Redo Log Switch Rate and Size

As per Oracle: “A rough guide is to switch logs at most once every twenty minutes.”http://docs.oracle.com/cd/B14099_19/core.1012/b14001/dbtuning.htm#BCGGBFFB

http://docs.oracle.com/cd/B14099_19/core.1012/b14001/dbtuning.htm#BCGGBFFB

http://docs.oracle.com/cd/B14099_19/core.1012/b14001/dbtuning.htm#BCGGBFFB

Pediag report: oracle_specific_log.html Key Tablespace Metrics

Pediag report: portal_specific_log.html

Pediag report:portal_specific_log_proactive.html

BMC Performance Manager BMC Portal Adapter• The BMC Performance Manager BMC Portal Adapter allows users to pull parameter data

from the Portal into BMC ProactiveNet (BPPM) or BMC TrueSight.

• The interface for the BMC Portal Adapter configuration is in the Administrator Console within BMC ProactiveNet Performance Manager and TrueSight.

• Before getting started with the BMC Portal Adapter, there are a few differences in terminology we need to touch on.

BPPM/TrueSight vs BPM Portal TerminologyBPPM Term BPM Term Description

Device Element Most commonly, a managed node – computer/host

Monitor Application Class A collection of 2 or more metrics/parameters which are logically related to the same monitored entity.

Group Group A collection of devices/elements defined by the end-user (not to be confused with user groups).

Instance Instance A specific occurrence of an application class representing a monitored entity in the customer environment.

Attribute Parameter A measurement of a monitored entity; part of an application class definition

Monitor ID/Instance ID GUID Global Unique Identifier - unique key for each instance of an element, application, or parameter

BMC Performance Manager BMC Portal Adapter

• An Important Note: Alert thresholds defined in the Portal are not imported into BMC TrueSight/ProactiveNet

• There are two ways to implement alerting for Portal within BMC TrueSight/ProactiveNet a) Configure the Portal to use IIWS to send events to a BMC

TrueSight/ProactiveNet Event Manager Cell (Recommended)b) Manually configure Thresholds in BMC TrueSight/ProactiveNet for the Portal

parameters

BMC Performance Manager BMC Portal Adapter Parameter Data Workflow Event Data Workflow

BMC Portal Adapter PrerequisitesBefore you begin to configure the Adapter for BMC Performance Manager Portal, ensure that:• The Latest GA Service Pack has been applied to the Portal. If the appropriate BMC Portal fix

(patch) is not applied, the BMC ProactiveNet Administration console displays the following message while creating a new or editing an existing adapter:"ProactiveNet is unable to create the BMC BMC Portal Adapter because the configured BMC Portal does not have the required Instance Level Query patch installed. Please contact BMC Support to obtain the required patch for BMC Portal."

• The Portal is up and running.• The user account used to connect the Adapter to the Portal:

• Exists on the Portal• Is the same user account used to add the desired elements to the Portal

• The steps to configure the BMC Portal Adapter can be found in our documentation here:https://docs.bmc.com/docs/display/public/btsim96/Adding+an+adapter+for+BMC+Performance+Manager+Portal

https://docs.bmc.com/docs/display/public/btsim96/Adding+an+adapter+for+BMC+Performance+Manager+Portal

https://docs.bmc.com/docs/display/public/btsim96/Adding+an+adapter+for+BMC+Performance+Manager+Portal

BPPM BMC Portal Adapter – Best Practice

• In medium to large environments, configuring one Adapter to pull all Portal information into BPPM/TrueSight is not recommended.

• Do not exceed 20,000 instances per Adapter.

• DO NOT DELETE devices created by the BMC Portal Adapter manually from the BMC TrueSight/ProactiveNet Administration Console unless directed to do so by BMC Support to resolve a particular scenario.

• Understand the difference in function between the Select Application Classes for Import vs Select Application Classes for Auto-Sync screens

BMC Portal Adapter – Best Practice

• On the Select Application Classes to Import screen, you can import all application classes at once or a few at a time as you create Adapters.

• Application Classes with green check marks have already been imported.

• Application Classes with a green check mark and a pad lock are currently in use.

• Application Classes with an empty check box have not been imported yet.


• There are many ways to organize your Portal Adapters. General examples might be:

• Adapter based on OS type• Adapter based on Database type• Adapter Solution type

• Do not exceed 20,000 when selecting the application classes.

• Select ONLY those Application Classes you want to Auto-Sync for this particular Adapter.

• You can get as creative as you like. Just be sure to stay consistent..


• Another option to reduce the number of instances is to use the Include and/or Exclude Filters.

• Include filters will include only those instances that match the specified criterion.

• Exclude filters will exclude only those instances that match the specified criterion.

• You can filter by Device, by Instance or by both Device and Instance


• Schedule the Adapters to Auto-Sync only as often as needed to pick up any changes made to the Portal environment.

• Schedule multiple Adapters to run at different times.

• Options available for scheduling the Adapters:

Periodic: Enables a schedule of auto-sync poll periods at a specific poll interval. For example, every 24 hours.

Daily: Enables an auto-sync poll period at a specific time in a day. For example, every day at 5.00 AM.

Weekly: Enables scheduled auto-sync poll periods on a specific day of the week. For example, every Sunday at 11:50 AM

Known Issues -BMC Portal Adapter Users cannot delete the BMC Portal Adapter - Attempts to delete the BPPM BMC Portal Adapter via the Admin Console fail with the following error: "Failed to delete the adapter <nameofadapter>". Please see the logs for details. The workaround is to restart BPPM server components and then once it comes back up try deleting the adapter before doing anything else. It works.

Consistently Receiving "Monitor type discovery timed out" when trying to add the BMC Portal AdapterPlease refer to the following page for MaxHeap recommendations:https://docs.bmc.com/docs/display/public/proactivenet96/Tuning+recommendations+for+data+and+event+management

“503” error encountered while querying through web services. A firewall exists between the Portal Webserver and the ISN. The Portal Web server is usually isolatedResolution: BPPM/TS and Portal components are merged into one subnet, the same subnet of the Portal Web server.

NOTE: When you restart the Portal you should also restart the ISN. This will keep the Portal and BPPM/TS synchronized.There is a Defect\RFE raised to improve the portal adapter performance and to remove the need to restart the ISN servers on every restart of Portal server.

https://docs.bmc.com/docs/display/public/proactivenet96/Tuning+recommendations+for+data+and+event+management

Known Issues -BMC Portal Adapter “Premature End of File” error when creating a BMC Portal Adapter

• ProactiveNet uses the Portal Web Services to discover monitor types and instances. • The error "Premature end of file“ can impact either of these two processes. • This error occurs when there is an incomplete web service (XML) response from the Portal. • By incomplete we mean the response from Portal may be completely blank or the XML response is not structured properly. • If this error occurs during the monitor type import, then the Portal Adapter cannot import new types, unless this error is

resolved.• If this error occurs during instance discovery of any one monitor type, instance discovery will not be stopped but will be ignored

for the instance and will continue to next monitor type. • If this error occurs repeatedly for one monitor type, instances for that monitor type may not be updated until this problem is

resolved.While we do not know the root cause of the issue, restarting the BMC Performance Manager Portal application server(s) resolves the issue.NOTE: When you restart the Portal you should also restart ISN. This will keep the Portal and BPPM/TS synchronized.

Defects with the BMC Portal AdapterID Summary Details

QM001885487 Customers should not have to restart the IS Agent each time they restart BMC Portal when using the BMC Portal Adapter

Whenever Portal is restarted it is mandatory to restart the IS Agent. The Integration Service Nodes using the BPPM BMC Portal Adapters should not have to be restarted each time the Portal is restarted and vice versa.

QM001885851 BPPMs BMC Portal Adapter should not create duplicate devices in PNet when the monitor instances are moved from one BMC Portal Adapter to another

When users edit the BMC Portal Adapters to change the distribution of monitored instances from one adapter to another, this creates a duplicate device in BPPM. This is a defect as the adapter should be able to determine the device already exists and just re-associate the device with the new adapter. Work around: Refer to Knowledge Article 000099816

QM001885953 BPPM BMC Portal Adapter GUI should enforce instance limitations. If we document that 20000 instances per Adapter can be used, enforce it.

When adding instances to the BPPM BMC Portal Adapter - the limit per the documentation is 20000 but the GUI should enforce that and not let the user get themselves into an overloaded IS Agent situation. BPPM 9.5 and its interaction with the adapter does have a limit and enforces it, 9.6 does not enforce it.

QM001886840

Attempts to delete the BPPM BMC Portal Adapter fail with the following error: "Failed to delete the adapter <nameofadapter>". Please see the logs for details.

When attempting to delete the BPPM BMC Portal Adapter, the delete fails every time with the error below. "Failed to delete the adapter <nameofadapter>". Please see the logs for details.

QM001886841 Problems with BPPM and BMC Portal Adapter - Auto-sync hangs

The auto-sync process for the BPPM BMC Portal Adapter hangs periodically and does not complete.

Troubleshooting the BMC Portal Adapter• If you see no data from the Portal in BPPM or TrueSight , please verify that data points are indeed being

collected in the Portal. If there is no data in BPM Portal then there will not be data in BPPM/TrueSight. Then it is a matter of troubleshooting the Portal data collection issue.

• If data is present in the Portal and not in BPPM or TrueSight, collect the following debug output:Portal Side –

1. Stop the portal2. Rename current portal.log file under %BMC_PORTAL_KIT_HOME%\appserver\websdk\tools\jboss\server\all\log\ to

portal.old3. Add the following logger entries in %BMC_PORTAL_KIT_HOME%\appserver\websdk\tools\jboss\server\all\conf\

properties\logging.properties file.com.bmc.patrol.portal.ws25.handlers.level=FINESTcom.bmc.patrol.portal.ws.impl.level=FINESTcom.bmc.patrol.portal.ws25.impl.level=FINESTcom.bmc.patrol.portal.ws.handlers.level=FINEST

4. Save the file5. Start Portal

Troubleshooting the BMC Portal AdapterBPPM/TS Side:1. Run the following pw command to turn debug on/off for the ProactiveNet Agent running the Portal Adapter: Debug on: pw debug on --a <agent_name/agent_ip_address> Debug off: pw debug off --a <agent_name/agent_ip_address>2. Run the following pw command to turn debug on/off for the jserver: Debug on: pw debug on --p jserver Debug off: pw debug off --p jserver3. Once debug is enabled, edit the adapter and run a manual auto-sync. If an error screen is encountered, please send to BMC Support the following:

a screenshot of any errors displayed in the UItar/zip of <BPPMAgent_Install>\Agent\pronto\logs\*tar/zip of <BPPMServer_Install>\pw\pronto\logs\debug\jserver.logtar/zip of $BMC_PORTAL_KIT_HOME/webserver/tools/apache-openssl/logs/*tar/zip of $BMC_PORTAL_KIT_HOME/appserver/websdk/tools/jboss/server/all/log/*

Portal AMIGO Program


The BMC Performance Manager Portal Assisting Migration Operations (AMIGO) program is designed specifically to help you upgrade with ease. The purpose of the program is to help you review the upgrade plan you put together and to see where areas of concern may be. The AMIGO program includes:

• A review of the upgrade plan you develop with BMC Customer Support• An upgrade checklist to ensure success• A "Question and Answer" session before you upgrade• Helpful tips and tricks for upgrade success based on previous experience• A follow-up session with BMC Customer Support after you perform the upgrade to discuss the outcome

Refer to our Knowledge Base for Article #000011570 to view the details and Checklist of details needed for an upgrade. This information will help you to "jump start" your upgrade planning.

If you would like to be a candidate for the AMIGO program, please contact BMC and open a Support issue referencing the AMIGO program and provide the following:Products and Versions involvedDate of planned upgrade(if known)

000011570

Portal Webinar Series – Next Topic


We want to hear from you!

• Please do make any suggestions or recommendations and we will be glad to accommodate.• We plan to have another Webinar in March 2016 so help us identify the next Webinar Series topic. • Please visit the BMC Community - https://communities.bmc.com/thread/139536 to provide details about

Portal topics of interest.• We will continue to provide webinars to offer assistance, and we are interested in your ideas!

https://communities.bmc.com/thread/139536

https://communities.bmc.com/thread/139536

Q & A

Documents

BMC Performance Manager Portal Webinar Series Local - India, Bangalore: +91 (0) 80 6127 5134 Local - India, Mumbai: +91 (0) 22 6150 2334 Local - Ireland,