bmc portal rn

Release Notes

BMC PortalVersion: 2.9.10September 23, 2011

BMC Software is releasing version 2.9.10 of the BMC Portal solution. These release notes provide information about the enhancements, resolved problems, and known issues in this version.

Overview of BMC Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2What’s new in BMC Portal 2.9.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Exclusion of BMC Exception Detector module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Updated support for BMC Impact Integration Web Services Server 7.4.00 . . . . . 4Discontinued support for BMC Impact Integration Web Services Server . . . . . . . 4Support for 64-bit BMC Performance Manager Portal . . . . . . . . . . . . . . . . . . . . . . . 4Biweekly blackout functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Support for 64-bit RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Support for Internet Protocol version 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Flexibility to configure threshold directions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Enhancement in BMC Performance Manager Portal command-line interface . . . 9Portal and RSM health monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Portal diagnostic tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Enabling parameter notifications to BMC Event Manager for offline and blackout

status changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Support for BMC Reporting Foundation 3.2.10 and Crystal Reports 2008 SP3

Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Support for virtualized platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Internationalization and localization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Corrected problems in BMC Performance Manager Portal and BMC Impact Portal 16Known issues and workarounds in BMC Performance Manager Portal. . . . . . . . . . . 19Requirements and supported resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Platforms supported by BMC Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29BMC Portal application server and web server system requirements . . . . . . . . . 31

NOTE Before you install the product, check the Customer Support website at http://www.bmc.com/support for

■ updated documentation (for example, flashes and technical bulletins)■ product downloads, patches, and fixes (PTFs)■ product availability and compatibility (PAC) data

*224420**224420*

*224420*

http://www.bmc.com/support

Overview of BMC Portal

Remote Service Monitor system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Updating the JDBC driver to support Oracle Database 11.2.0.2.0 . . . . . . . . . . . . . 34

Installation information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35How to obtain the product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Prerequisites for upgrading to BMC Portal 2.9.10. . . . . . . . . . . . . . . . . . . . . . . . . . . 35Downloading BMC Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36BMC Datastore supported versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Privileges required for the BMC Portal database instance . . . . . . . . . . . . . . . . . . . 40Installing the BMC Portal components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Product upgrade paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Upgrading to BMC Portal 2.9.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Upgrade and installation considerations for BMC Impact Portal . . . . . . . . . . . . . 48Product upgrade issues in BMC Impact Portal 7.4.01 . . . . . . . . . . . . . . . . . . . . . . . 50

Related information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Support for BMC Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Overview of BMC PortalBMC Portal provides a common, web-based interface for BMC modules. Each module provides programs that integrate with the BMC Portal server and other modules in BMC Portal. This integration provides data from multiple sources to a single, customizable entry point for viewing the status and performance of your infrastructure, exceptions, and environment.

This version of BMC Portal includes version 2.9.10 of the BMC Performance Manager Portal module and version 7.4.01 of the BMC Impact Portal module.

The BMC Performance Manager Portal module leverages agentless and PATROL Agent technologies to remotely monitor and report on the performance of your IT infrastructure. If you use BMC PATROL Agent 3.7.x or later in your environment, you can integrate its agent-based technology with BMC Portal.

The BMC Impact Portal module provides views of business services and shows how the status of these services is impacted when infrastructure components have problems. With these views, you can understand how infrastructure problems affect the business services used by your company. At any time, you can access pages that provide different views of your account and the objects that compose the account.

NOTE From version 2.9.00 of BMC Portal, the Exception Detector module is being withdrawn from BMC Portal as it is no longer supported. For more information, see the BMC Performance Assurance version 7.5.10 Release Notes.

2 Release Notes September 23, 2011

What’s new in BMC Portal 2.9.10

Table 1 shows the relationship between the features and the modules available in BMC Portal, as well as other BMC products required for the module.

For more information about the features in the BMC Portal modules, see the online Help and the documents described in “Related information” on page 52.

What’s new in BMC Portal 2.9.10BMC Portal has been enhanced with the following changes and new features.

Table 1 Relationship between BMC Portal features and BMC Portal module

Type of environment BMC Portal features

Module to select during installation

Other BMC products required

BMC Performance Manager (agentless)

Agentless monitoring provided by BMC Portal and the Remote Service Monitor (RSM) program

BMC Performance Manager Portal

Performance Managers

PATROL (agent-based)

Agent-based monitoring provided by BMC Portal, the RSM program, and PATROL Agents


PATROL Knowledge Modules and PATROL Agents

BMC Service Impact Manager

web-based common user interface for service impact management and reporting; centralized user administration

BMC Impact Portal BMC Impact Manager

Table 2 What’s new in BMC Portal modules

Module Enhancements

BMC Portal server “Exclusion of BMC Exception Detector module”

“Updated support for BMC Impact Integration Web Services Server 7.4.00”

“Support for virtualized platforms”

“Support for 64-bit BMC Performance Manager Portal”

“Biweekly blackout functionality”


“Support for 64-bit RSM”

“Support for Internet Protocol version 6”

“Flexibility to configure threshold directions”

“Enhancement in BMC Performance Manager Portal command-line interface”

“Portal and RSM health monitoring”

“Portal diagnostic tool”

“Enabling parameter notifications to BMC Event Manager for offline and blackout status changes”

“Support for BMC Reporting Foundation 3.2.10 and Crystal Reports 2008 SP3 Designer”

“Support for virtualized platforms”

BMC Portal Version 2.9.10 3

Exclusion of BMC Exception Detector module

Exclusion of BMC Exception Detector module

BMC Portal version 2.9.10 no longer includes the BMC Exception Detector module. From version 2.9.00 of BMC Portal, the Exception Detector module is being withdrawn from BMC Portal as it is no longer supported. For more information, see the BMC Performance Assurance version 7.5.10 release notes.

Updated support for BMC Impact Integration Web Services Server 7.4.00

Starting with BMC Portal 2.8.50, BMC Portal server can connect and send event notifications to the BMC Impact Integration Web Services Server version 7.4.00.

Discontinued support for BMC Impact Integration Web Services Server

BMC Portal server no longer supports versions 7.3.02 and earlier of BMC Impact Integration Web Services Server.

Support for 64-bit BMC Performance Manager Portal

This version of BMC Performance Manager Portal supports running the Portal application server in 32-bit mode on a 32-bit computer and in 64-bit mode on a 64-bit computer.

Biweekly blackout functionality

BMC Portal supports an additional option to schedule blackouts on biweekly (once every two weeks) basis. For example, you create a blackout at 08:00:00 A.M. on February 01, 2011 to run for two hours every other Tuesday at 10:00:00 A.M. The blackout runs on February 01, 2011, February 15, 2011, March 01, 2011, March 15, 2011, and so on.


Biweekly blackout functionality

NOTE The week for running biweekly blackout schedules starts on a Sunday and ends on a Saturday. If you create a blackout on a Tuesday, BMC Portal considers the preceding Sunday to be the date of commencement for the blackout. Future blackouts are scheduled based on this date.

EXAMPLE Consider the following normal biweekly blackout schedule:

Blackout created: Tuesday, January 25, 2011Start time: 10:00:00 A.M. on Sunday

In this case:

■ The product considers Sunday, January 23, 2011, to be the date of commencement for this blackout, which the product did not run.

■ The product schedules the next blackout on February 06, 2011, which is the first execution of this blackout.

■ The product continues to run blackouts on a biweekly basis (that is, on February 20, 2011, March 06, 2011, March 20, 2011, and so on).

EXAMPLE Consider the following biweekly blackout schedule using the Daylight Saving Time (DST) offset:

■ Blackout created on: Sunday, March 6, 2011Start time: 01:30:00 AM on Sunday for 1 hour

In this case:

— The product considers Sunday, March 6, 2011 to be the date of commencement for this blackout.

— The product schedules the next blackout on March 20, 2011. The product runs the blackout from 01:30:00 AM to 03:30:00 AM. However, in this case, due to DST offset, the clock reads 02:30:00 AM as 03:30:00 AM.

— The product continues to run blackouts on a biweekly basis (that is, on April 3, 2011, April 17, 2011, May 1, 2011, and so on).

■ Blackout created on: Monday, November 7, 2011Start time: 01:30:00 AM on Sunday for 2 hours

In this case:

— The product considers Sunday, November 6, 2011 as the date of commencement for this blackout, which the product did not run.

— The product schedules the next blackout on November 20, 2011, which is the first run of this blackout. The product runs the blackout from 01:30:00 AM to 03:30:00 AM.

— The product continues to run blackouts on a biweekly basis (that is, on December 4, 2011, December 18, 2011, January 1, 2012, and so on).


Support for 64-bit RSM

Support for 64-bit RSM

This version of BMC Performance Manager Portal supports running an RSM program in 64-bit mode on a 64-bit computer.

BMC Portal 2.9.10, by default, installs a new RSM in 32-bit mode on a 64-bit computer. Similarly, when an RSM is auto-upgraded from an earlier version during upgrade of BMC Portal 2.9.10, it is in 32-bit mode. You can change to 64-bit mode by using the RSM Maintenance tool. In an RSM cluster, only members in the same mode are supported.

For more information about how to use RSM Maintenance tool to change the mode of 32-bit RSM to 64-bit RSM version 2.9.10 and migrate elements from a 32-bit RSM to a 64-bit RSM, see the BMC Portal Installation Guide.

NOTE Before you change the RSM mode to 64-bit, consider the following requirements:

■ If you currently use, or plan to use, any of the following solutions, ensure that you use the indicated versions of solutions.

— BMC Performance Manager Express for Servers version 2.7.60— BMC Performance Manager Express for Databases version 2.8.00

It is important to upgrade the solutions to the indicated versions before changing the RSM mode to 64-bit. If you use any custom solutions that are created using BPMPDK and that use third party dlls, ensure that the third party dlls are 64-bit compliant. For more information, see the BMC Performance Manager Development and Certification Guide.

For instructions on downloading the solutions zip files, see “Downloading BMC Portal” on page 36.

For more information about testing for these solutions, see the corresponding release notes.

■ In an RSM cluster, members in the same mode are only supported. If the RSM for which you want to change the mode for is member of a RSM-cluster, ensure that the mode of other members in the cluster is also changed to the same mode. Similarly, if you plan to create a new RSM cluster, ensure you only add members that are in the same mode-32-bit or 64-bit.

■ If you have version 2.9.00 of BMC Portal and the RSM is running on 64-bit mode, after you upgrade to version 2.9.10 of BMC Portal, the RSM will continue to operate in the 64-bit mode.


Support for Internet Protocol version 6

Support for Internet Protocol version 6

From version 2.9.00, BMC Portal supports key infrastructure components to run on IPv6 networks. It also supports monitoring of remote elements and nodes monitored through PATROL Agents on IPv6 networks for BMC Performance Manager Solutions and PATROL Integration Performance Managers that are IPv6 compliant.

BMC Portal components for IPv6 support

You can achieve IPv6 support for the following BMC Portal components by installing the components on dual-stack hosts or IPv6-only hosts.

■ BMC Portal Application Server

■ BMC Portal Web Server

■ BMC RSM

■ Database (With Oracle® 11g Release 2 Enterprise Edition only) — If you use Oracle Real Application Clusters (RAC), deploy:

— RAC on IPv4 host

— Application server and web server on IPv4 or dual stack (address resolved should be IPv4)

For more information about installation of BMC Portal in an IPv6 environment, see the BMC Portal Installation Guide.

RSM clusters

In an IPv6 deployment, if RSM clusters are used, in a given cluster, all members must be in the same network, that is either in IPv4 only or IPv6 only or dual stack network. RSM cluster members across different types of network are not supported.

NOTE On Windows, in dual-stack networks, if you include an entry for the IPv6 address, host name, and FQDN in the %windir%\System32\drivers\etc\host file on the application server, clustering does not work.

Version 2.9.10 of BMC Portal does not support the pure IPv6 environment on Windows Server 2003.


Flexibility to configure threshold directions

BMC Performance Manager Portal and other BMC product integrations

If BMC Portal is deployed in an IPv6 network, support for BMC Portal and certified integrations with other BMC products are available only if BMC Portal components are on a dual stack network. BMC Portal integrations certified with other BMC products are not supported in case of IPv6-only network. BMC Portal components are supported on IPv6-only hosts only for stand-alone BMC Performance Manager deployments.

For IPv6 support status and details for any of the other products, see the relevant documentation of respective solutions.

Flexibility to configure threshold directions

For increased flexibility in threshold definition, BMC Performance Manager Portal enables you to change the default threshold order and select either the ascending or descending option as needed.

■ When you select Ascending, the warning and alarm values of the parameter are compared with set threshold values using the greater-than (>) operator.

■ When you select Descending, the warning and alarm values of the parameter are compared with set threshold values using the less-than (<) operator.

Every parameter has a default threshold direction. To change the default threshold direction, you can modify the parameter properties, or add or modify the application classes, elements, and element profiles.

For more information about how to change alarm definition of a parameter, element profile, or application class and a parameter, see the BMC Performance Manager Portal Monitoring and Management Guide.

EXAMPLE ■ When monitoring a number of processes:

— The default threshold order generates alarms when the process count is greater than a specific number.

— The flexibility in threshold definition allows changing the default value to descending and generating alarms when the process count is less than a specific number.

■ For the CPU load parameter, the higher the load, the slower the computer (the ascending value triggers an alarm).

■ For the available disk space parameter, the lower the amount of free space, the lower the amount of available space (the descending value triggers an alarm).


Enhancement in BMC Performance Manager Portal command-line interface

Enhancement in BMC Performance Manager Portal command-line interface

The addElements command option of BMC Performance Manager Portal allows unique control to define the specific object group that an element is added to. This option is applicable even if there are multiple object groups with the same name in the parent-child hierarchy (in single or across multiple nodes).

For more information about how to add elements using the addElements command, see the BMC Performance Manager Portal Monitoring and Management Guide.

Portal and RSM health monitoring

From version 2.9.00, BMC Portal includes additional self-monitoring of Portal and RSM components. The health of these components is monitored for some key parameters to detect and notify about approaching limits, and thus help to avoid potential breaches that could impact their health.

For more information, see the BMC Performance Manager Portal Monitoring and Management Guide.

Portal diagnostic tool

The BMC Portal diagnostic tool enables you to run on-demand diagnostic reports for various components including BMC Portal, RSMs, and Portal database. The report performs a health check against recommended best practices, diagnoses deviations, and suggests appropriate remedial actions.

For information about how to use the diagnostic tool, see the BMC Performance Manager Portal Monitoring and Management Guide.

Enabling parameter notifications to BMC Event Manager for offline and blackout status changes

In earlier versions of BMC Performance Manager Portal, BMC Impact Explorer did not receive notification for offline events within BMC Performance Manager Portal. Consequently, if a parameter fluctuated between critical, offline, unknown, and OK state changes during monitor off-on cycle or blackout cycle, the critical notification was kept open for BMC Event Manager and BMC Impact Explorer.


Support for BMC Reporting Foundation 3.2.10 and Crystal Reports 2008 SP3 Designer

Depending on the type of notification rule selected, the product enables you to receive an OFFLINE notification on BMC Impact Explorer if the element has been turned off using the monitoring off option within BMC Performance Manager Portal.

The drmop.notification.bem.blackoutoffline.enable property in drmop.properties file enables parameter notifications to BMC Event Manager for element monitor OFF status and blackout status changes in BMC Performance Manager Portal. For more information about the drmop.notification.bem.blackoutoffline.enable, see the BMC Performance Manager Portal Monitoring and Management Guide.

Support for BMC Reporting Foundation 3.2.10 and Crystal Reports 2008 SP3 Designer

This release of BMC Performance Manager Portal supports BMC Reporting Foundation 3.2.10 (which installs SAP® BusinessObjects 3.1 SP3) and Crystal Reports 2008 SP3 Designer. The BMC Reporting Foundation 3.2.10 supports the following operating systems:

■ Microsoft Windows Server 2008 R2 (64-bit)■ Microsoft Windows Server 2008 SP2 (32-bit)■ Microsoft Windows Server 2008 SP2 (64-bit)

The products are available for download from the BMC Electronic Product Distribution (EPD) website at http://webapps.bmc.com/epd.

To install BMC Reporting Foundation 3.2.10, see BMC Reporting Foundation Installation Guide version 3.2.10. To install Crystal Reports 2008 SP3 (Designer component), see BMC Knowledge Base article SLN000015135901.

NOTE You register to access additional documentation for SAP BusinessObjects at the SAP BusinessObjects Indirect Client Knowledge Center at https://websmp207.sap-ag.de/~sapidp/002006825000000284522008E/.

The site provides access to the following resources:

■ SAP BusinessObjects notes■ installation guides■ release notes


https://websmp207.sap-ag.de/~sapidp/002006825000000284522008E/

https://websmp207.sap-ag.de/~sapidp/002006825000000284522008E/

http://webapps.bmc.com/epd

Support for virtualized platforms

Support for virtualized platforms

BMC Portal now supports virtualization technology that provides a layer of abstraction between the computing, storage, and networking hardware, and the software that runs on it. For more information, see the Support Policy for Virtualized Platforms section under Review Policies on the BMC Customer Support website at http://www.bmc.com/support.

What’s new in BMC Impact Service Model Editor

The BMC Impact Service Model Editor product is an editing interface, integrated with the BMC Atrium CMDB, that you use to create and edit service model data in user sandbox data sets and then promote this data to the BMC Atrium CMDB production data set. From there, automated publishing sends the service model data to specified BMC Impact Manager cells.

In the BMC Impact Service Model Editor, you can find component instances that were identified with discovery tools, or you can create them, define relationships between those instances, specify which instances and relationships to distribute to your BMC Impact Manager instances, and specify the component level user permissions.

BMC Impact Service Model Editor has been enhanced with the following changes and new features:

Filtering user groups

With version 7.4.01 of BMC Impact Service Model Editor, you can filter user groups for a component instance. You can use the percentage (%) wildcard character to filter user groups and assign permissions to the filtered groups.

NOTE Before you can assign permissions to a component instance, you must specify the component type and assign a name to the instance.


Display only SIM cells capability

Display only SIM cells capability

With version 7.4.01 of BMC Impact Service Model Editor, you can choose to display only SIM cells from the available list of BMC Event Manager (BEM) cells and Service Impact Manager (SIM) cells. You can select this option by choosing Tools => Personal Options. Click the Other tab and in the Miscellaneous area, select Display Only SIM Cells.

For more information about this, see the BMC Portal Online Help.

Caching settings for Service Model Editor user authentication

You can now choose to change the default caching time settings for the BMC Impact Service Model Editor user authentication. By default, the caching time has been set to 5 minutes. BMC recommends that you keep this unchanged.

Increasing the caching time to more than 5 minutes will delay the authentication results derived (according to the caching time you set). For example, if you increase the caching time to 60 minutes and if, for a certain user, permissions get revoked or the user gets deleted, then this will not be reported until the next hour when the authentication will take place.

To change the default caching time settings

1 Navigate to the following directory where the smeserver.properties file is located:

■ Windows: <PORTAL_HOME>\appserver\websdk\tools\jboss\server\all\conf\properties\smsSme\smeserver.properties

■ Solaris: <PORTAL_HOME>/appserver/websdk/tools/jboss/server/all/conf/properties/smsSme/smeserver.properties

2 Paste the following text into the smeserver.properties file:

The value 5 denotes the caching time (in minutes). BMC Impact Portal will authenticate the user according to the caching time defined here. For example, if the value defined here is 5 minutes, BMC Service Model Editor will authenticate the user every 5 minutes after you have logged into BMC Service Model Editor.

#Defines the subject caching time in minutes. The smebackend code will cache the authenticated user for the time defined here.com.bmc.sms.sme.server.subject.caching.time.mins=5


Documentation updates for BMC Impact Portal

3 Edit this value to change the caching time as desired.

Documentation updates for BMC Impact Portal

The following updates supplement the information provided in the product documentation for BMC Impact Portal:

Enabling history events

BMC Impact Portal retains events in the Impact Portal database even after they have been removed from the BMC Impact Manager cell. This feature enables you to view older events those that have been cleaned up during the mcdb process. Navigate to the Events tab in the BMC Impact Portal and then select Events between time frame. You set the desired time frame and select Update to view the events.

Currently active events, the default selection, displays events from the BMC Impact Manager. The database cleanup settings for history events use the same configuration as the reports retention policy.

The history events feature is disabled by default. To enable this feature, make the following changes to the BMC Impact Portal and BMC Impact Manager cell:

1. From the BMC Impact Portal, navigate to the internal.properties file located at <BMCPortal_Home>\appserver\websdk\tools\jboss\server\all\conf\properties\smsConsoleServer\ and set the value of the following parameter to true:

2. Restart the BMC Portal Application Server service.

From the BMC Impact Manager cell, you must configure the BMC Impact Manager cells for event reporting. See the BMC Impact Solutions Installation Guide.

NOTE Before you make any changes to the smeserver.properties file, BMC recommends you to save a backup copy of it.

com.bmc.sms.consoleserver.eventProcessor.eventsFromDatabase=true


Adding custom slots for the EVENT class

Adding custom slots for the EVENT class

The history events feature as well as the Currently active events from the cell work for standard and custom slots of EVENT class. To add these custom slots, on the BMC Impact Portal, follow these steps:

1 Open the internal.properties file located at <PORTAL_HOME>\appserver\websdk\tools\jboss\server\all\conf\properties\smsConsole Server\.

2 Search for the com.bmc.sms.eventaggregator.event.customSlotNames parameter.

3 Add a custom slot name for the above parameter.

4 Save the file.

5 Open the application.properties file located at <PORTAL_HOME>\appserver\websdk\tools\jboss\server\all\conf\properties\smsIwc\.

6 Search the com.bmc.sms.iwc.event.table parameter.

7 Add the custom slot name with comma separated values that you have added in Step 3 on page 14. Ensure that the custom slot names specified in both the properties files are the same.

8 Save the file.

Specifying a column header for a custom slot

You can specify a column header for a custom slot by performing the following steps:

NOTE The All Events filter is not available under the history events feature.

NOTE Use comma separated values if more than one custom slot is available. Ensure that the custom slot name matches the one that you have specified in the custom EVENT class definition.


New default values for the Event Information and Severity filters

1 Open the kb_core_resource.properties file located at <PORTAL_HOME>\appserver\websdk\tools\jboss\server\all\conf\resources\en_US\smsConsole Server\.

2 Search the item SLOT.CORE_EVENT.mc_bad_slot_values=Bad Slot Values.

3 Add your custom slot with a proper header, for example, SLOT.CORE_EVENT.custom_slot=Custom Slot below the searched item.

4 Restart the BMC Portal Application Server service.

New default values for the Event Information and Severity filters

The new default values have been introduced for the Event Information and Severity filters. The new values are:

■ Event Information filter = Active - Impacting Events ■ Severity filter = Info or worse

To set the default event filters, perform the following steps:

1 Navigate to the application.properties file located at <BMCPortal_Home>\appserver\websdk\tools\jboss\server\all\conf\properties\smsIwc\ and change the value of the following parameters:

■ com.bmc.sms.iwc.event.defaultfilter.eventinfo ■ com.bmc.sms.iwc.event.defaultfilter.severity

2 Specify an index mapped with a sequence that you see in the event list for the Event Information and Severity filters as depicted in Table 3 and Table 4.

Table 3 Event Information - Index mapping

Event Information filter Index

Active Impacting Events 1

Unassigned Impacting Events 2

All Events 3

Table 4 Severity - Index mapping (part 1 of 2)

Severity filter Index

All Severities 1

Critical Only 2


Internationalization and localization

3 Restart the BMC Portal Application Server service.

Internationalization and localizationTable 5 lists the platforms on which BMC Portal runs and the languages in which you can view the product.

The online Help for all modules is displayed in English. The default language settings for BMC Portal users and administrators is English.

Corrected problems in BMC Performance Manager Portal and BMC Impact Portal

The following problems were reported in earlier releases of the product and have been corrected in this release.

Major or worse 3

Minor or worse 4

Warning or worse 5

Info or worse 6

Ok or worse 7

Table 5 Internationalization and localization support for BMC Portal modules

Module

French German Japanese KoreanSimplifiedChinese

Traditional

Chinese

Runs

a

a Product executes in the operating system for the specified language and can also acceptinput, run process, and display data in that language.

Vie

w

Runs

Vie

w

Runs

Vie

wb

b To display the user interface in a different language, users and administrators must log onand change the default language settings.

Runs

Vie

w

Runs

Vie

w

Runs

Vie

w


+ + + + + + + + +

BMC Impact Portal + + + + + + + +

Table 4 Severity - Index mapping (part 2 of 2)

Severity filter Index



Table 6 Corrected problems in BMC Performance Manager Portal and BMC Impact Portal (part 1 of 2)

Tracking ID Description

BMC Portal

QM001545863 When you installed the RSM program on a Microsoft Windows 2003 Service Pack 1 computer, the RSM was adversely affected by a memory leak caused by Microsoft WMI.

This issue has been corrected for Microsoft Windows 2003 Service Pack 2. For more information, see Microsoft Article ID 911262.

QM001603105 On Microsoft Windows, when you installed version 2.7.60 of BMC Portal Server, or upgraded from an earlier version of BMC Portal Server to version 2.7.60, the installation took more than 60 minutes.

QM001612198 If the initmemory and maxmemory Java Service Wrapper property did not have the same value, the Portal application server stopped running and you received OutOfMemory error message.

QM001640170 If you added an element by using Discover from BMC Atrium CMDB option, the host displayed the platform as bpm-platform-nt.

QM001653977 Refreshing CDE metadata took longer time than expected.

QM001654745 The Apache HTTP Server suffered from multiple vulnerabilities.

QM001656415 For Japanese locale, the translation in the RSM Installer was not correct.

QM001656662 Blackouts failed when the expired blackouts were not removed from the Portal.

QM001660056 Refreshing CDE metadata did not import all elements into the ELEMENT table.

QM001660518 Last Start Time shown on the Available Remote Service Monitors page of the Portal was deceptive because Last Start Time displayed the last time Portal re-established successful communication.

QM001661910 When you upgraded Portal to version 2.8, two core performance managers were in the Publishing or Upgrading state for hours and stopped working.

QM001662968 You received critical notifications only for the first and second rules if the state of a parameter were swapped, that is, from Critical to Warning and vice versa.

QM001668031 BMC Performance Manager 2.8 was unable to connect to BMC Atrium CMDB 7.6.03.

QM001669378 Redundant database calls were issued during the BMC Performance Manager Portal login process, causing a deterioration in performance.

QM001674383 The Portal installer did not load the dataset.arx and reconrules*.arx files automatically.

QM001676009 In floating dashboards, the business element pane was not refreshed.

QM001680702 The RSM was not generating a heap dump file if it encountered OutOfMemory errors.

QM001684820 A NullPointerException error occurred in the log if the product failed to find the application class.

QM001684823 An OutOfMemory error occurred in the log because of the incorrect FINEST login message.

QM001686857 BMCPortalMaintenanceTool incorrectly updated values in the jvmRoute parameter if you entered a blank space in the application server hostnames.

QM001691782 The Search functionality returned incorrect results.

QM001691786 Multiple bind requests were made at the time of LDAP authentication from BMC Performance Manager Portal.



QM001691788 The number of rows in the WEBSDK_ALERTJOB table and the number of entries in the scheduledJobMap_ data structure grew continuously, leading to OutOfMemory errors while sending notifications.

QM001697793 An application Instance was not deleted and it was causing lazy initialization exceptions in the Portal Log file.

QM001698015 When you created Shared credential using private key and started configuration of process element after successful discovery, you received an exception message and the element was not added.

QM001698203 If the element profile was removed from an element, the element thresholds, properties and credentials were not updated.

QM001698613 Data was lost during payload processing because there was an error in correct status mismatch code.

QM001699824 BMC Performance Manager Portal stopped working while rolling up the partitions on parameter value table if it had large count or retention.

QM001699836 A NullPointerException error occurred when the product sent notifications.

QM001699847 The Advanced Search feature with the Object Type defined as Tag returned elements that were not tagged with the particular tag.

QM001699861 The Advanced Search feature with the Object Type defined as Application Classes returned incorrect results.

BMC Impact Portal

QM001705108 The event slot vales got truncated as the value length was limited to 64 characters only. The value length has now been increased to support upto 4000 characters.

QM001713197 While creating a dashboard, when you selected an icon in the Image view editor, the corresponding properties in the right pane would sometimes not get displayed.

QM001716131 When the value of an Impact Portal event slot contained n apostrophe (') or a semi-colon (;) the value got truncated.

QM001564758 On stopping BMC Portal, you would get a Messaging Exception error in the Portal log file.

QM001685222 You could not export very large data files using the Export function in BMC Impact Service Model Editor to a location on your hard disk.

QM001691442 If an alias formula contained a comma (,) in the cell function then you could not edit it as the part of the formula after the comma would not get displayed.

Example: In the following alias formula, the portion after $1.TransactionName would not get displayed.

['sprintf("%s-%s",[substring($1.TransactionName,0,6),$1.AgentName])']

QM001720537 When the mc_ueid slot (the cell universal event ID) would be missing, BMC Impact Portal would not discard that event and instead store it in the queue.

QM001719917 The availability report was not being generated correctly for certain components of the BMC Impact Portal module.

Table 6 Corrected problems in BMC Performance Manager Portal and BMC Impact Portal (part 2 of 2)



Known issues and workarounds in BMC Performance Manager Portal


The following issues remain open in this release of BMC Performance Manager Portal. The table lists a tracking ID if BMC assigned one to the issue. If applicable for the issue, a workaround is also included.

Table 7 Known issues and workarounds in BMC Performance Manager Portal (part 1 of 11)


BMC Portal

QM001522553 When you use the Mozilla Firefox browser to access BMC Portal, sometimes the cursor does not appear in a selected text box.

QM001531571 In the BMC Portal log file, the error code is correct, but error messages appear as a series of question marks, as in the following example: BMC-MOP10011E:?????????????? ';'

QM001539557 Text parameters (for example, the Monitored Services parameter) are limited to 1,000 characters.

QM001544246 The History Status and the status of the elements in Tree View do not match.

QM001546435 The RSM connection is counted in the number of concurrent Portal users.

QM001546844 BMC Portal “torn off” page does not refresh.

QM001547674 The synchronization of the PAR file solutions and versions between BMC Portal and RSM is not automatic.

Workaround: Remove the PAR from the RSM and restart the RSM.

QM001551150 If you have very large file systems on Oracle Solaris, you must ensure that the POSIX df command is on your system, or the installation will not work.

QM001557073 When User Account Control (UAC) is enabled and you are a member of the Administrator Group, you cannot modify the properties files when the BMC Portal service is stopped.

Workaround: Perform the following steps:

1. From the Windows Start menu, select Run.

2. Type C:\Windows\system32, and press Enter.

3. Scroll down to and right-click notepad.exe.

4. Select Run as Administrator.

5. In the User Access Control dialog box, select Continue.

6. From the menu in Notepad, select File => Open, and browse to drmop.properties.

7. In the drmop.properties file, make the changes required, and save the file.

8. Restart the BMC Portal service.

QM001557394 The regex field remains dimmed (non-editable) when you override the profile.



BMC Portal (continued)

QM001557711 When you load the BMC Portal URL on Windows Server 2008 with UAC on, a certificate error is generated that states that the security certificate is not issued by a trusted authority.

Workaround:

1. In Internet Explorer (IE), select Tools => Internet Options.

2. Click Security, click Trusted sites, and then click Sites.

3. Clear the Require server verification (https:) for all sites in this zone check box.

4. In Add this website to the zone, where the current website is displayed (https://hostname.com), click Add.

5. In Add this website to the zone, enter the URL again, change https to http (http://hostname.com), and click Add.

6. Click Close, and close IE.

QM001558567 The inclusion and exclusion filter options for file systems do not show up on the Override option when the element is defined with an element profile.

QM001563674 When a collector is scheduled to retrieve data from an Object identifier (OID) that does not exist (but is defined in the MIB), the collector terminates with an error message.

Workaround: Remove OIDs that are defined in the MIB but that do not exist.

QM001570487 When performing the Notifications task, you cannot remove the Primary IIWS Host Server Name entry on the Provider tab.

QM001573793 When creating user names, you cannot use blank spaces, periods, or the following special characters: \ / “ [ ] : | < > + = ; , ? * @. BMC Portal accepts the user name and does not generate an error message, but the user name fails.






QM001558252 The BMC Performance Manager Portal is not inserting the Windows 2008 Operating System instances and the impact to disks into the Configuration Management Database (CMDB).

Workaround:

1. Open the CMDB console, and select the Class Manager tab.

2. Select Class Name BMC_OperatingSystem and click View.

3. Select the Attributes tab, and in the attribute name column, select OSType.

4. In the Class Information Window, select View.

5. In the Attribute Information window, select Characteristics.

6. Open the Values text box, add one of the following strings at the end, and leave one space at the end of the string.

For CMDB version 2.1, add the following string:

;Windows Vista;Microsoft® Windows Server® 2008 Enterprise;Windows 2008

For CMDB versions 7.5 and 7.6, replace Microsoft Windows Server 2008 with Microsoft® Windows Server® 2008 Enterprise; Windows 2008

7. Click Save.

8. In the ARSystemUser-Note dialog box, click OK.

9. On the Attribute Information page, click Close.

10. In Class Information, click Save.

11. In the Confirmation window, select Yes.

12. Refresh the Class Manager Console, and wait until the status becomes active on the class manager console for Class Name BMC_OperatingSystem.

QM001574023 You cannot delete element profiles that are linked to disabled users.

QM001702093 Application server cluster does not work for IPv6 for loopback IP address (for example 127.0.0.1).

For details, see the “Can JGroups bind to 0.0.0.0” question at http://community.jboss.org/wiki/JGroupsFAQ.

Workaround: Add the entry in the hosts file for the IPv6 address and fully qualified domain name.




http://community.jboss.org/wiki/JGroupsFAQ



QM001707464 After you upgrade to the latest version of BMC Portal, web server cluster is broken.

Workaround: Recluster web server using PortalKitMaintenanceTool.

QM001645297 The following issues can occur when RSM does not have sufficient disk space.

■ Solutions do not download automatically to RSM.■ Performance Manager upgrade left the associated elements left offline.

Workaround: Ensure that the RSM has sufficient disk space on %TEMP%, as well as on the drive where the RSM is installed.

1. Copy the solutions manually to the %RSM_HOME%\RSM<versionNumber>\server\rsm\solutions

For example: %RSM_HOME%\RSM29\server\rsm\solutions

2. Copy the solution on %BMC_PORTAL_KIT_HOME%\appserver\websdk\tools\jboss\server\all\solutions directory

3. Restart RSM.

4. Turn the monitoring for the element on, and then off.

QM001579903 BMC Portal displays truncated text in the user interface when the text string contains more than 1000 characters.

QM001580471 The BMC Portal installer invokes the Simplified Chinese language when setting up on Windows 2008 in a Traditional Chinese Hong Kong SAR environment.

Workaround: To ensure that the Traditional Chinese language is used during installation, change the system region and area to Taiwan.

QM001603260 A number of BMC temp files with zero kilobytes (0KB) are created in the temp folder.

Workaround: Delete the files manually.

QM001603473 A blank legend is displayed in the graphs for Solaris Zone and LDOM reports in the BMC Performance Manager Portal.






QM001604480 Whenever you restart the BMC Portal service, the drmop.applicationinstance.maxinactiveminutes time is reset, and the tallying of time to determine when an instance is considered inactive begins from that point.

For example, by default drmop.applicationinstance.maxinactiveminutes is set to 4320 minutes (or three days). If you restart BMC Portal after three days, all inactive instances are not deleted, even those that were inactive for 3 days. However, the inactive instances are deleted 3 days after BMC Portal is restarted (if they remain inactive and BMC Portal remains on).

Therefore, if you restart BMC Portal on a schedule or at a rate that occurs more frequently than the value of the drmop.applicationinstance.maxinactiveminutes property, the inactive instances will never be deleted. For example, if you regularly restart BMC Portal every night, and you set the max inactive minutes to 1440 minutes (one day) or more, the inactive instances will never be deleted.

QM001604606 When an element is in monitor off mode, or when an element comes out of blackout, if the monitor off mode or blackout duration exceeds the value of the drmop.applicationinstance.maxinactiveminutes property, the instances underneath the element are considered inactive. If you have the drmop.applicationinstance.enabledeleteinactiveinstance property enabled, these instances will be deleted. The default value of drmop.applicationinstance.maxinactiveminutes is three days.

QM001604607 When you attempt to stop the BMC Portal service on Windows, the BMC Portal service can time out during the procedure, and if this occurs, the status remains at “stopping the service.”

Workaround: Open Windows Task Manager, and click End Task, or reboot the computer.

QM001631504 While you add, modify, or delete the configuration for an application, element, element profile, and so on, you may receive the following message:

The last operation performed by this application has resulted in an exception. Either retry the operation or contact your system administrator.

Workaround: Even if the preceding message appears, the actual transaction may have been successful. After 5 minutes, verify the success of the transaction in BMC Portal. If the transaction was not successful, try performing the operation once again after 5 minutes.

QM001670400 Sentry solution upgrade for 500 elements with Element Profile does not work.

QM001681006 CMDB integration is not working when integrated with CMDB 7.6.03.

Workaround: Install AtriumCore 7.6.03 P001 patch as a fix.






QM001681007 Patrol integration with portal using higher security need manual changes in registry.

Workaround: Locate the esi_lib key under Patrol_agent and modify its value pointing to the location where bmcesi.dll is installed.

For example, C:\BMCSoftware\CI\common\security\bin_v3.0\Windows-x86\bmcesi.dll

QM001698424 BPMCLI commands fail on Solaris when simple one or two-character passwords are used. However, the same passwords are accepted when used to log on to BMC Portal.

QM001699652 If IPv4 is disabled on a dual stack RSM computer, it goes to Unknown state in BMC Portal.

Workaround: Perform the following steps:

1. Flush local DNS using the Ipconfig /flushdns command.

2. Restart service Remote Service Monitor.

QM001646792 When you try to log on to BMC Portal that has web servers clustered and all of the following conditions exist, the logon fails, displaying the HTTPS error message:

■ You are a new user and are logging into BMC Portal for the first time.

■ The primary web server is down, and therefore the primary application server is pointing to the secondary web server.

■ The HTTP port is blocked by the load balancer.

Workaround: Stop the secondary web server service while keeping the primary web server service running.

None You cannot use the following new properties that appear on the shared credentials wizard:

■ private key■ passphrase■ fingerprint

The GUI implementation of these shared credentials is complete, but the SSH Shared credentials tags have not been added to the solutions. Until the required tags have been added, if you try to use these properties, the following error message is displayed:

Problems connecting with Host: Cherry-a2f.bmc.com Port: 22 Protocol: ssh2 Message: Failed to provide the required ssh login inputs!: (Command Shell Paramlet).

However, you can use the SSH Shared credentials for the newly-created Performance Manager Editor (PME) solution (SSH Collector). If you want to use SSH Shared credentials for the existing PME solution (SSH Collector), then you must upgrade the solution once, with or without any changes.






QM001719249 Auto-upgrade of 64-bit RSM does not work while upgrading from version 2.9.00 to 2.9.10 of BMC Portal in the following scenario:If you have changed the 32-bit RSM (running on a 64-bit computer) to the 64-bit mode using the RSM Maintenance tool.

Workaround: Install patch version 2.9.00.0001 on version 2.9.00 of BMC Portal.For more information about installing the patch, see “Installing the Remote Service Monitor patch version 2.9.00.0001” on page 47

QM001713979 Version 2.9.00 of BMC Portal takes longer to start on the Solaris operating system as compared to versions earlier than 2.9.00 of BMC Portal.

BMC Impact Portal

QM000540747 The Desktop Status Indicator might display question marks when the jnlp file contains non-ASCII characters. For more information, see the Sun Microsystems website: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6205837.

SW00250831 When an admin or superadmin user logs on as a different user, the set status functionality is not available. When the user logs on directly, the functionality is available if the user has the appropriate permissions.

QM001532957 When only the BMC Impact Portal is installed the Elements link under the Configure tab should be disabled or not be displayed.

QM001552845 The Desktop Status Indicator displays an incomplete CI name if a CI contains special characters, such as < >.

QM001553069 When IAS is down or the Portal cannot connect to the IAS server, the Synchronize Users with IAS command appears to be successful even when it fails.

QM001554535 If you log onto the Portal from the superadmin-Accounts List, Desktop Status Indicator installation fails without displaying a failure message.

Workaround: Log in directly to the Portal and DSI installation is successful.

QM001556648 Running sim2cmdb to export a service model to the CMDB changes the mc_udid of CIs, so CIs that were available under Business Components are no longer available. Reports are also not generated correctly.




http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6205837


BMC Impact Portal (continued)

QM001556962 Changing the following quality measures resets reporting calculations so that reporting starts calculating from 90 days in the past:

■ changing the ignored state from Portal => Global Properties ■ changing the rolling summary period from Portal => Global Properties ■ changing the Time Zone from the Portal■ changing the outage definition from the cell ■ executing pinit

The number of hours the summarizer should resummarize in 1 hour is configured in %BMC_PORTAL_KIT_HOME%\appserver\websdk\tools\jboss\server\all\conf\properties\smsConsoleServer\internal.properties as com.bmc.sms.reportSummarizer.summarization.calculationMaxIntervals=24.

Workaround: You can reset the value as desired.

Note: Changing the quality measures can impact performance. Because the summarizer has more data to process, the server takes more time to summarize. A response to any request made during that time might be delayed.

QM001557396 After you open a report received in an e-mail message, the Certificate Acceptance screen continues to be displayed even after clicking Yes several times, and the images in the report are not displayed.

Workaround: Close the e-mail message and reopen it. The images are displayed.

QM001573678 When you start the BMC Impact Portal the first time after its installation, if the primary IAS for this installation is down, the BMC Impact Portal does not start even though the secondary IAS is running.

QM001564922 When you log into the BMC Impact Portal with full user access, for example, user/user and navigate to the Configure tab and select Service Model Editor, the SME login screen displays an error message, Login attempt failed. Check log for details.

Workaround: On the BMC Impact Portal server, right-click My Network Places and select Properties. Select the Advanced =>Advanced Settings menu item. Ensure that the network adapter that returns the IP address that you have listed for the BIP server is at the top of the list.

QM001576584 You cannot assign a User Group specific access to BMC Impact Manager from BMC Impact Portal if the mapped LDAP group has a hash (#) in the name.

QM001561633 When you add a note containing a semicolon for an event in the Notes tab on the BMC Impact Explorer side, the note is not populated on the SQL side and subsequently is not propagated to the database.

QM001573337 The Portal.log file displays a "No row with the given identifier exists" exception, when an element is selected which is removed from one object group but still present in other object groups.





BMC Impact Portal (continued)

QM001621097 When events are sent to Impact Portal containing slots which are too long, the ORA-12899 message is displayed. No further events are put into the Portal until the problem field is enlarged in the Oracle database.

Workaround: Enlarge the field in the Oracle database to accommodate the length of the slot name.

QM001644645 Components with non-alphanumeric characters in the name cause an Application Error when selected in the Desktop Status Indicator.

QM001675695 (Internet Explorer 7 or 8) The Set Status screen hangs intermittently.

Workaround: Use the Compatibility option in Internet Explorer 8, or use a different browser.

QM001648980 In a dashboard, the image editor does not display a previously added folder in the canvas view.

QM001677661 Image view editor fails to switch to custom image if Java version is 1.6.0_21 is installed.

Workaround: Install Java version is 1.6.0_18.

For Java 1.6.0_21, the product displays a warning when you open the Image View Editor. You can click No to ignore the warning and to select the custom image.

QM001679138 If the dashboard contains a custom image, after you delete the CI, the icon of the deleted CI is greyed out and visible on the dashboard.

BMC Impact Service Model Editor

QM001576251 If you create a new folder in the Console Navigation tree and then delete or rename the folder, the entire tree collapses.

Workaround: The tree still exists but you must re-expand it.

QM000499539 When you initially open the BMC Impact Service Model Editor on a localized system, if you create a component with a multibyte character name in the view, the multibyte characters are displayed as square marks.

Workaround: Click Tools => Personal Options and select a font that is appropriate for the current language locale.

QM000501503 When you specify a Windows style path for the log file during installation and then launch BMC Impact Service Model Editor from a UNIX system, the saved path information is not valid because a Windows style separator (\) is used instead of the UNIX style (/).

QM000507613 When you install BMC Performance Manager Portal first and then do an over-the-top installation of BMC Impact Portal, BMC Impact Service Model Editor cannot create a component instance.

QM000552003 When creating a component, entering string data into some fields of the Other tab (including Site, Region, and Company) sometimes fails and prevents input from being saved. This happens when ITSM is installed in the system along with SIM.

Workaround: Ensure that the Site, Region, and Company fields are valid and exist in the AR Company form.





BMC Impact Service Model Editor (continued)

QM000553667 Under certain circumstances, canceling the promotion of a service model might fail due to timing issues. After an object has been pushed to the reconciliation engine, it cannot be recalled by clicking Stop.

QM001530753 I18N—In Schedules, Costs Unit is hardcoded as U.S. dollars, which prevents you from using a local cost unit (for example, KRW for Korean currency).

QM001532145 For the Console Navigation Tree, reordering folders using the drag-and-drop method results in some of the folders subordinating themselves, causing an endless pyramid.

Workaround: To delete the endless pyramid, use a tool like SQLPlus (included with the datastore) to connect to the database using the BMC Portal account (default user ID and password: pe/pe) and issue the following SQL statement:

delete from WEBSDK_RELATIONSHIP where PARENT_GUID = CHILD_GUID

QM001532148 When you rename a folder in the Console Navigation Tree of BMC Impact Service Model Editor, the folder retains the original name in BMC Impact Service Model Editor and has the new name in BMC Portal.

Workaround: If you create another folder in BMC Impact Service Model Editor, the folder has the correct name in both BMC Portal and BMC Impact Service Model Editor.

QM001535721 You cannot delete aliases from components in BMC Impact Service Model Editor.

Workaround: To delete cell aliases:

1. In Remedy User, select CMDB Console, CMDB Home Page, CMDB Data.

2. Browse instances and search for the component with the incorrect alias (for example, ComponentAliases like %wrong_value%).

3. Select the component and click View.

4. On the first Custom tabs, locate the component alias field and change the value as needed.

QM001550315 After running BMC Topology Discovery (now called BMC Atrium Discovery) version 1.5 to discover CIs and then performing a synchronization with the BMC Atrium CMDB, promotion does not pick up changes in priority.

QM001576299 BMC Impact Service Model Editor Promotion dialog box does not exit if the same BMC Impact Portal user triggers promotion and publication operation from two sessions of SME concurrently.

QM001573777 The BMC Impact Service Model Editor incorrectly depicts BMC_Impact relationships with ImpactDirection Destination-Source. These relationships are depicted as BMC_Impact relationships with ImpactDirection Source-Destination. However, the relationships are published correctly.




Requirements and supported resources

Requirements and supported resourcesThis section provides release-specific information about requirements and supported resources for BMC Portal 2.9.10. For requirements that are specific to a module, see the section for that module in this document. The modules that you choose to install can add system requirements for BMC Portal.

Platforms supported by BMC Portal

Table 8 shows the supported platforms for BMC Portal. Support of a component on a particular operating system is designated by +. A blank cell indicates no support.

BMC Impact Service Model Editor (continued)

QM001663721 Duplicate slot entries are displayed under the Alias Formula attribute section for the following slots:

■ mc_host_class■ mc_host■ mc_host_address■ mc_object_class■ mc_object■ mc_parameter

This is a superficial display issue. You can select either of the duplicate parameters and it will work correctly.

QM001535688 In the Service Model Editor, the online Help for Impact Publishing Server is from version 7.0.02.

NOTE Version 2.9.10 of BMC Portal does not support the pure IPv6 environment on Windows Server 2003.




Platforms supported by BMC Portal

Table 8 Platform matrix for BMC Portal

Operating system Web

and

ap

plic

atio

n se

rver

s

Dat

abas

e se

rver

Web browsers

RSM

aa RSM applies to the BMC Performance Manager Portal module only; Table 10 contains specificsystem requirements for RSM.

Fire-fox

Internet Explorer

3.x 6.x 7.x 8.x

Oracle® Solaris 9 (64-bit), SPARC + + +

Oracle Solaris 10 (64-bit), SPARCb,e

b Zones (Solaris Containers) are supported on Solaris 10.

+ + +

Microsoft Windows 2003 Standard Server (32-bit and 64-bitc, d), SP2 or later

c References to 64-bit include AMD64 (which includes Opteron and Athlon) and Intel 64 (formerly known asIntel Extended Memory 64 Technology, or Intel EM64T and Xeon) architecture.

d By default, BMC Portal application server runs in 64-bit mode on a 64-bit platform. By default, RSM runs in 32-bit mode on a 64-bit platform. You can use the RSM Maintenance tool to change an RSM running in 32-bit mode to 64-bit mode. For more information, see “Support for Internet Protocol version 6” on page 7.

+ + + + + +

Microsoft Windows 2003 Enterprise Server (32-bite and 64-bitc, d), SP2 or later

+ + + + + + +

Microsoft Windows 2003 Datacenter Server (32-bit and 64-bitc, d), SP2 or later

+ + + + + +

Microsoft Windows 2003 Web Server (32-bit and 64-bitc, d), SP2 or later

+ + + + + +

Microsoft Windows 2003 R2, Enterprise Server (32-bit and 64-bitc, d) + + + +

Microsoft Windows XP, SP2 or later + + + +

Microsoft Windows Vista + +

Microsoft Windows 2008, Standard Server (32-bit and 64-bitc, d), SP1 or later

+ + + + +

Microsoft Windows 2008, Enterprise Server (32-bite and 64-bitc, d,e), SP1 or later

e This operating system is supported for IPv6.

+ + + + +

Microsoft Windows 2008, Datacenter Server (32-bit and 64-bitc, d), SP1 or later

+ + + + +

Microsoft Windows 2008 R2, Enterprise Server (64-bit) + + +

Microsoft Windows 7 + +


BMC Portal application server and web server system requirements


Table 9 lists the minimum system requirements for the application server and web server for BMC Portal 2.9.10. Disk space and memory requirements do not include the BMC Datastore. For these requirements, see the BMC Datastore Release Notes.

Table 9 BMC Portal application server and web server system requirements (part 1 of 2)

Resource Minimum requirements Comments

Platform Either of the following processors:

■ Intel compatible (32-bit) Pentium 4 processor or equivalent

■ AMD Opteron/Intel Xeon 64 EM64T processor (64-bit)

For 32-bit Portal

■ 2 CPU minimum■ 3.2 GHz processing speed (with

hyperthreading enabled)■ 4 GB RAM minimum

For 64-bit Portal

■ 4 CPU minimum■ 3.5 GHz processing speed (with

hyperthreading enabled)■ 4 GB RAM minimum

UltraSPARC IIIi equivalent or later ■ 2 CPU minimum■ 1.2 GHz processing speed ■ 4 GB RAM minimum

Disk space ■ Windows: 10 GB■ Solaris: 10 GB

■ A high-performance disk subsystem is recommended if you install your database on the same computer.

■ Solaris requires 250 MB in /var/tmp for the installation program.

Operating system

Windows Server 2003 (32-bit, 64-bit) ■ Requires a user account with administrator rights and permissions

■ Service Pack 2 or later; BMC recommends the latest service pack.

■ Windows Server 2008 (32-bit, 64-bit)

■ Windows Server 2008 R2 (64-bit)

■ Requires a user account with administrator rights and permissions

■ Service Pack 1 or later; BMC recommends the latest service pack

■ Solaris 9 (64-bit), Sparc■ Solaris 10 (64-bit), Sparc

The web server component requires the following items:

■ libiconv librarya

■ libuuid patchb



Third-party products

Running SMTP server (optional) The installation program verifies the presence of a running e-mail server.

Oracle J2SE Java Runtime Environment (JRE) on client computersc

The BMC Portal Help requires version 1.4.2 or later. If necessary, you can download the latest JRE from the Java download site at http://www.oracle.com/technetwork/java/index.html.

Network Time Protocol (NTP) (recommended) NTP continuously adjusts the time on a computer to match that of another computer, typically the atomic clock.

BMC Software products

None The BMC Atrium Configuration Management Database (BMC Atrium CMDB) is not required. However, BMC Performance Manager Portal can integrate with the following BMC Atrium CMDB versions. Apply the latest patch of the version.

■ 7.5■ 7.6■ 7.6.03■ 7.6.04

Web browser

One of the following browser versions:

■ Mozilla Firefox 3.x■ Microsoft Internet Explorer 6.x, 7.x, or 8.x

The Internet Explorer browser on Windows 2003 requires the medium security setting. Do not run BMC Portal with the high security setting.

a For the download locations of the libiconv library, see the BMC Portal Installation Guide.b For the download locations of the libuuid patch, see the BMC Portal Installation Guide. You must restart the

computer after you install the patch. c Full access to the BMC Portal Help requires the JRE on the computer that you use to access BMC Portal. If the

JRE is not installed, you can still access the Help, but some of its navigation tools are inoperable.

NOTE ■ BMC recommends that you install the BMC Portal application server and web server on

the same computer in an IPv6 environment.

■ BMC recommends that you do not install RSM and web server on the same computer.

■ Domain Name System (DNS) configuration should be correct. Ensure that the dual-stack RSM that is pointing to IPv6 Portal should be accessible by using IPv6 address.

Table 9 BMC Portal application server and web server system requirements (part 2 of 2)



http://www.oracle.com/technetwork/java/index.html

Remote Service Monitor system requirements

Remote Service Monitor system requirements

The BMC Performance Manager Portal module requires that you install at least one instance of the Remote Service Monitor (RSM) program. When installing the BMC Performance Manager Portal, ensure that the computers on which you want to install the RSM program meet the minimum system requirements listed in Table 10 on page 33.

Table 10 Minimum system requirements for the RSM program


Platform Either of the following processors:

■ Intel compatible (32-bit) Pentium 4 processor or equivalent

■ AMD Opteron/Intel Xeon 64 EM64T processor (64-bit)

For 32-bit RSM

■ 2 CPU minimum■ 2 GHz processing speed■ 2 GB RAM dedicated to RSM■ 10 GB disk space

For 64-bit RSM

■ 4 CPU minimum■ 2 GHz processing speed■ 4 GB RAM minimum■ 10 GB disk space

Operating system ■ Windows Server 2003 Standard Edition■ Windows Server 2003 Enterprise Edition■ Windows Server 2003 Datacenter Edition■ Windows Server 2003 Web Edition

Service Pack 1 or later; BMC recommends the latest service pack.

When you install the RSM program on a Windows 2003 (SP1) computer, RSM is adversely affected by a memory leak caused by Microsoft WMI.

For more information about this problem, see Microsoft Article ID 911262. Access the Microsoft Hotfix Page.

■ Windows Server 2008 Standard Edition■ Windows Server 2008 Enterprise Edition■ Windows Server 2008 Datacenter Edition■ Windows Server 2008 R2

Service Pack 1 or later; BMC recommends the latest service pack.

Third-party products

NTP (recommended but not required)a

a When installing the RSM program, install NTP on the BMC Portal server and on each of the RSM computers to ensure that the system clocks on the RSM computers are synchronized with the system clocks on the BMC Portal server.

NTP continuously adjusts the time on a computer to match that of another computer, typically the atomic clock.

PATROL Agent PATROL Agent 3.7.x or later BMC recommends PATROL Agent versions 3.7.x or later when using PATROL integration Performance Managers to obtain parameter values.


http://support.microsoft.com/default.aspx?scid=kb;EN-US;911262

http://support.microsoft.com/default.aspx?scid=kb;EN-US;911262

Updating the JDBC driver to support Oracle Database 11.2.0.2.0

Updating the JDBC driver to support Oracle Database 11.2.0.2.0

This section describes how to update the JDBC driver for Oracle 11g to support Oracle database 11.2.0.2.0.

To update the JDBC driver for Oracle 11.2.0.2.0 database

1 Download the JDBC driver for Oracle 11.2.0.2.0 from the following location to a temporary location on the application server:

ftp://ftp.bmc.com/pub/BPMPortal/oracle/ojdbc6-11.2.0.2.0.jar

2 Stop the BMC Performance Manager Portal application server service. For more information, see the BMC Portal Installation Guide.

3 Back up the following file to a different directory outside the BMC Performance Manager Portal Home directory and delete the original file from the following original location:

■ (Windows):%BMC_PORTAL_KIT_HOME%\appserver\websdk\tools\jboss\server\all\deploy\websdk.sar\lib\ojdbc14-10.2.0.4.jar

■ (Solaris):$BMC_PORTAL_KIT_HOME/appserver/websdk/tools/jboss/server/all/deploy/websdk.sar/lib/ojdbc14-10.2.0.4.jar

4 Copy the ojdbc6-11.2.0.2.0.jar that you downloaded in step 1 to the directory in step 3.

5 Restart the BMC Performance Manager Portal application server service. For more information, see the BMC Portal Installation Guide.

6 Open the BMC Performance Manager Portal log and verify the JDBC driver version by searching for the following text:

NOTE For information about support for Oracle Database 11g Release 2, see the July 16, 2010,third-party support document for version 2.8.00 of BMC Performance Manager Portal.

JDBC driver: Oracle JDBC driver, version: 11.2.0.2.0


ftp://ftp.bmc.com/pub/BPMPortal/oracle/ojdbc6-11.2.0.2.0.jar

Installation information

Installation informationThis section contains installation information for BMC Portal 2.9.10. For complete planning information and procedures for installing the BMC Portal, see the BMC Portal Installation Guide.

How to obtain the product

BMC Portal is available for download from the BMC Electronic Product Distribution (EPD) website at http://webapps.bmc.com/epd. To use the website, you must register and set up a user name and password.

If you do not have a current license for the product, contact a BMC sales representative by calling 800 793 4262. If you cannot download the product, contact a sales representative and request a physical kit.

Prerequisites for upgrading to BMC Portal 2.9.10

■ Before you upgrade to Portal 2.9.10, upgrade to version 2.7.10 of BMC Datastore.

■ Before upgrading to version to 2.9.10, you must change the Oracle System Global Area (SGA) size from 600 MB to 1,400 MB. If you are using a Windows 32-bit operating system, you cannot allocate more than 1,400 MB to Oracle SGA. However, you can increase the SGA past 1,400 MB on Solaris and Windows (64-bit).

■ Before you run the Portal on a 64-bit computer, consider the following requirements:

If you currently use, or plan to use, any of the following solutions, ensure that you use the indicated versions of solutions. It is important to upgrade the solutions to the indicated versions before upgrading to 64-bit Portal.

— BMC Performance Manager for Web Application Server version 2.9.20— BMC Performance Manager Express for SAP Solutions version 2.7.53— BMC Performance Manager Express for Hardware by Sentry Software version

2.7.25



Downloading BMC Portal


This section contains instructions for downloading the BMC Portal from the BMC Electronic Product Distribution (EPD) web page, http://webapps.bmc.com/epd.

Before you begin

Review the information about system requirements and open issues.

To download the BMC Portal components from the web

1 Create a directory in which to place the downloaded files.

2 If you plan to install the BMC Performance Manager Portal module, create a second temporary directory for the solution Performance Managers; otherwise, skip to step 3.

3 Go to https://webapps.bmc.com/signon/content/logon.jsp.

4 Enter your user ID and password, and click Submit.

5 Click Download Product.

6 On the Export Compliance and Access Terms page, provide the required information, agree to the terms of the agreements, and click Continue.

7 If you are accessing this site for the first time, create an EPD profile; otherwise, skip to step 8:

A Under Localized Languages, select the language for the patch release.

B Under Install Platforms, select the platforms to download for the patch.

C Click Save Profile.

NOTE On Windows computers, ensure that the directory is only one level into the directory structure. The EPD package creates a directory in the temporary directory when you extract the files, and the directory that contains the installation image should not be in a directory deeper than two levels into the directory structure.



https://webapps.bmc.com/signon/content/logon.jsp


8 In the Select Product step Licensed Products tab, if you have products listed, go to step 9. If you do not have any products listed, click Additional Products. If this does not generate a list of products, perform the following steps:

A Click Manage Support IDs to open the Manage My Support IDs window.

B If no Support IDs are listed, enter the ID and password for your products in Support ID and Support ID Password, and click Add.

C Click Back to My Entitled Products.

D If no products are listed, click Additional Products.

9 In the Select Product step, select BMC Performance Manager Portal, and click Continue.

10 In the Select Product Version step, select the product version to download, and click Continue:

A To filter the list by language, select a language from Product Languages.

B To filter the list by platform, select a platform from Product Platform.

C Select the products to download.

11 In the Download Files step, download the files and documentation for BMC Portal to the temporary directory that you created in step 1.

See Table 11 on page 38 for a list of the BMC Portal components.

If you download BMC Performance Manager Solutions 2.9.00, save these files to the directory that you created in step 1.

Before using BMC Performance Manager Solutions 2.9.00, see the BMC Performance Manager Solutions 2.9.00 Release Notes.

12 Using the release notes and the BMC Portal Installation Guide, carefully review the installation requirements and prerequisites for your platform.



Table 11 BMC Portal components

Components BMC

Perf

orm

ance

Man

ager

Por

tal

Windows platform

BMC Portal Infrastructure-Windows 2.9.10 +

BMC Performance Manager Solutions 2.9.00 +

BMC Datastore-Windows (32-bit and 64-bit) 2.7.10 +

BMC Performance Manager Operational Crystal Reports +

BMC Reporting Foundation 3.2.10 and Crystal Reports® 2008 SP3 Designer +

Third-Party Supplementary Materials Filesa

a not required for product installation.

+

Solaris platform

BMC Portal Infrastructure-Solaris 2.9.10 +

BMC Performance Manager Solutions 2.9.00 +

BMC Datastore-Solaris 2.7.10 +

Third-Party Supplementary Materials Filesa +

Documentation

Documentation for BMC Performance Manager Portal +

Documentation for BMC Performance Manager Solutions +

Documentation for PATROL Consoles and Infrastructure +

License information for BMC Performance Manager +

License information for BMC Reporting Foundation and Crystal Reports 2008 SP3 components

+

License Entitlement Notice for BMC Performance Manager +


BMC Datastore supported versions

BMC Datastore supported versions

This release of BMC Performance Manager Portal supports the following versions of Oracle databases for customers using BMC Datastore 2.7.10.

■ Oracle Database 10g Enterprise Edition with patch version 10.2.0.4.0 for customers using BMC Datastore 2.7.10

■ Oracle Database 11g Release 2 Enterprise Edition for the customers using their own Oracle licenses

In earlier releases of this product, BMC bundled Oracle as the BMC Datastore product. The BMC Datastore product is no longer available to new licensees of BMC Performance Manager Portal.

If you are a new customer, you need a separately purchased and licensed copy of Oracle to run BMC Performance Manager Portal. You must configure the Oracle instance by following the steps described in the BMC Portal Installation Guide.

If you are an existing customer and were active on a support contract before July 1, 2009, for any of the products listed in “Product list”, send an e-mail message to [email protected] to obtain a copy of BMC Datastore.

In the e-mail message, provide the following information:

■ Company name■ Valid support ID ■ BMC Datastore version■ BMC Datastore platform

NOTE To support Oracle 11g Release 2, you must update the JDBC driver for Oracle 11g. For more information, see “Updating the JDBC driver to support Oracle Database 11.2.0.2.0” on page 34.


mailto:[email protected]

Privileges required for the BMC Portal database instance

Product list

■ BMC Application Performance and Analytics■ BMC Enterprise Event Manager■ BMC Event and Impact Management■ BMC Event Manager■ BMC Event Manager - Enterprise■ BMC Event Manager - Original Package■ BMC Impact Explorer■ BMC Impact Manager■ BMC Impact Manager Adapters■ BMC Impact Manager Service Components (500 pack)■ BMC Impact Portal■ BMC Impact Stand-alone Node■ BMC Impact Web Console - Business User■ BMC Performance Analysis for Servers■ BMC Performance Assurance for Virtual Servers■ BMC Performance Management■ BMC Performance Management Reporting■ BMC Performance Manager Console■ BMC Performance Manager Reporting■ BMC Portal - Original Version■ BMC Proactive Service Desk Package■ BMC Service Impact Manager■ PATROL Integration for DashBoard■ PATROL Reporting for Networks■ BMC Performance Manager Portal■ BMC Performance Assurance for Servers

Privileges required for the BMC Portal database instance

The database user of the BMC Portal database instance (BMCPDS, by default) must have the following privileges. The instance can either be freshly installed or upgraded.

■ connect

■ resource

■ create materialized view

■ query rewrite


Installing the BMC Portal components

■ create view

■ select on dba_data_files

■ select on dba_temp_files

■ select on dba_jobs_running

■ select on dba_jobs

■ select on dba_scheduler jobs

■ alter database

Grant these privileges to the BMC Portal database user directly. Do not use a role to grant these privileges.


After you have downloaded the components, install the BMC Portal and BMC Datastore components.

To install the BMC Portal components

1 Navigate to the temporary directory that you created in step 1 on page 36.

2 To extract the BMC Datastore files from the archive in the temporary directory, uncompress all of the following files:

Windows 32-bit:

■ datastore_win32_disk1_of_4_ALL_2710.zip■ datastore_win32_disk2_of_4_ALL_2710.zip■ datastore_win32_disk3_of_4_ALL_2710.zip■ datastore_win32_disk4_of_4_ALL_2710.zip

WARNING ■ The alter database privilege is needed only to set

portal.history.reclaimdisk.enabled=true in the drmop.properties file.

■ For BMC Portal version 2.7.00 and later, these privileges are required for new and existing BMC Portal database instances, whether created in the BMC Datastore Oracle database or in a customer-licensed Oracle database. If these privileges are not granted, the BMC Portal installation fails.



Windows 64-bit:

■ datastore_win64_disk1_of_4_ALL_2710.zip■ datastore_win64_disk2_of_4_ALL_2710.zip■ datastore_win64_disk3_of_4_ALL_2710.zip■ datastore_win64_disk4_of_4_ALL_2710.zip

Solaris:

■ datastore_solaris_disk1_of_4_ALL_2710.tar■ datastore_solaris_disk2_of_4_ALL_2710.tar■ datastore_solaris_disk3_of_4_ALL_2710.tar■ datastore_solaris_disk4_of_4_ALL_2710.tar

The bmc_products directory is created and the files are extracted to the bmc_products directory.

3 To extract the BMC Portal files from the archive in the temporary directory, uncompress one of the following files:

■ Windows: bmc_portal_windows_ALL_2910.zip

■ Solaris: bmc_portal_solaris_ALL_2910.tar

The files are extracted to the BMCPortalKit directory under bmc_products.

4 Depending on the datastore you use, perform one of the following actions:

■ If you have the BMC Datastore, launch the BMC Datastore installation program, and follow the procedure for installing the BMC Datastore in the BMC Datastore Installation Guide and the BMC Portal Installation Guide:

— (Windows) From the bmc_products\BMCDatastore\disk1 directory, run setup.cmd.

— (Solaris) From the bmc_products/BMCDatastore/disk1 directory, run setup.sh.

■ If you have your own Oracle license, configure the Oracle instance by following the steps in the BMC Portal Installation Guide

5 After installing the BMC Datastore or custom datastore, launch the BMC Portal installation program:

■ (Windows) From the bmc_products\BMCPortalKit\Disk1 directory, run setup.cmd.

NOTE If you are using your own Oracle license, you do not need to download the BMC Datastore files.


Product upgrade paths

■ (Solaris) From the bmc_products/BMCPortalKit/Disk1 directory, run setup.sh.

6 Using the BMC Portal Installation Guide, follow the procedures for installing the BMC Portal application server, web server, modules, and Performance Managers.

■ The BMC Portal application server runs in 64-bit mode on a 64-bit computer, by default. For complete planning information and procedures for installing BMC Portal, see the BMC Portal Installation Guide.

■ The RSM runs in 32-bit mode on a 64-bit computer, by default. For complete planning information and procedures for installing the RSM program, see the BMC Performance Manager Portal Monitoring and Management Guide.

■ The BMC Portal web server runs in 32-bit mode on both 64-bit and 32-bit computers.

7 After completing the installations, you can delete the temporary directory and its contents.

Product upgrade paths

The BMC Portal 2.9.10 installation program supports upgrades of Portal components, including the RSM, directly from the following product versions:

■ BMC Portal 2.6.x■ BMC Portal 2.7.x■ BMC Portal 2.8.x■ BMC Portal 2.9.00

To upgrade from BMC Portal 2.5.x and earlier, you must first upgrade to BMC Portal 2.6.x or 2.7.x and then upgrade to 2.9.10.

NOTE ■ After you have installed BMC Portal, check the Customer Support website at

http://www.bmc.com/support to see the flashes, technical bulletins, and resolutions for the latest patches and hot fixes. Install the patches and hot fixes. Execute the BMC Portal Performance Managers (solution) upgrades only after installing the latest patches.

■ The BMC Portal 2.9.10 files that you downloaded from the BMC EPD web page might contain some or all of the patches listed on the product’s BMC Customer Support web page. If the EPD page shows that a patch is included in the product file, you do not need to obtain that patch.



Upgrading to BMC Portal 2.9.10

The installation program terminates if it detects any version of PATROL Express on the target computer.


For instructions for upgrading to BMC Portal 2.9.10, see the BMC Portal Installation Guide.

Upgrade issues for the BMC Performance Manager Portal

During upgrade from version 2.3 or earlier, the installation program converts the events and then purges any events older than 100 days. Because of the time required to convert events, if your BMC Portal has events older than 100 days, BMC recommends that you purge events before you start the BMC Portal upgrade.

NOTE ■ You must apply the latest applicable generally available (GA) or cumulative patch before

upgrading to the next version of the product. For example, when upgrading from 2.6, you must apply the latest GA patch to 2.6 before upgrading to 2.9.10. If the latest GA or cumulative patches have not been applied, the upgrade to 2.9.10 may fail.

■ When upgrading from version BMC Portal 2.5.x and earlier, see the BMC Portal Release Notes for the respective version. For example, if you are upgrading from version 2.3.x to 2.6.x, see the BMC Portal Release Notes for version 2.6.x for upgrade considerations.

■ If you are using BMC Impact Integration Web Services to send event notifications to BMC Impact Manager, and you plan to use the 7.4.00 version, then you must simultaneously upgrade to Portal 2.9.10. BMC Performance Manager Portal 2.9.10 does not support BMC Impact Integration Web Services Server versions earlier than 7.4.00.


NOTE ■ Before you upgrade BMC Portal, perform the procedure to move the RSM to 64-bit

computer while retaining the configuration changes. For more information, see BMC Portal Installation Guide 2.9.10.

■ When you upgrade from version 2.9.00 or any version before 2.9.00 to version 2.9.10, the mode in which your RSM and BMC Portal run will depend on the current operating system mode and JVM (Java virtual machine) mode.




Upgrading from BMC Performance Manager Portal 2.9.00, 2.8.x, 2.7.x, and 2.6.x

You can upgrade directly from BMC Performance Manager Portal 2.6.x to 2.9.10, 2.7.x to 2.9.10, and 2.8.x to 2.9.10 and 2.9.00 to 2.9.10.

If you configured the Continuous Data Export (CDE) utility to send data to an external datastore, copy the configuration files to locations outside of the installation path.

Use the backup of the sampleOra.properties or sampleDatafeedTarget.properties file as a reference for viewing the old data in the target database and the properties that are configured manually. You can then change the new properties files accordingly.

To reconfigure the CDE instance, or if you did not create backup copies of these files before upgrade, see “Configuring the datafeed utility” in the BMC Performance Manager Portal Monitoring and Management Guide.

BMC Atrium Discovery component classes

BMC Impact Portal, BMC Service Model Editor, and BMC Impact Explorer GUIs automatically load and display BMC Atrium Discovery (formerly known as BMC Topology Discovery and Dependency Mapping) discovered component classes. If you use custom icons, you must back up the custom icon folder before upgrading, because the upgrade overwrites the custom icon folder. The custom icons for these newly added component classes into the BMC Atrium CMDB are located in the component_icon.properties file at <BMCPortal_Home>\appserver\websdk\tools\jboss\server\all\conf\properties\smsConsoleServer\.

Installing the BMC Publishing Server patch version 7.4.01.01

When you upgrade to version 2.9.10 of BMC Portal, you must install patch version 7.4.01.01 on BMC Impact Publishing Server to make it compatible to version 2.9.10 of BMC Portal.

Version 2.9.10 of BMC Portal runs with version 5.0 of JBoss application server and 64-bit supported CMDB libraries which is not compatible with BMC Publishing Server installed in your CMDB integrated set up.

NOTE When upgrading from versions 2.4 or 2.5, you do not need to purge events before starting the upgrade.



To download the BMC Publishing Server patch version 7.4.01.01

1 Create a temporary directory on your computer.

2 From the Electronic Product Distribution (EPD) website, http://webapps.bmc.com/epd, select the Product Patches tab.

3 Locate the BMC Performance Manager Portal product and expand it to show BMC Performance Manager Portal 2.9.10.

4 Download and extract the BMC Impact Publishing Server-PABPS.7.4.01.01.zip file into the temporary directory that you created in step 1 on page 46. This file contains the following patch files.

■ pserver_bin_files.zip■ pserver_etc_files.zip■ pserver_lib_jboss.zip■ README.PABPS.7.4.01.01.txt

5 Complete the installation procedure described in install the BMC Publishing Server patch version 7.4.01.01

To install the BMC Publishing Server patch version 7.4.01.01

After you have downloaded and extracted the patch files, follow these steps to install the patch:

1 Stop the BMC Publishing Server.

2 Create a backup of the following directories:

■ %PSERVER_HOME%\etc ■ %PSERVER_HOME%\bin ■ %PSERVER_HOME%\lib\jboss

3 Copy the variables from the following backup (existing) files into the new files that you will find with patch version 7.4.01.01 as appropriate:

■ In the %PSERVER_HOME%\bin directory:

— For Windows: pserver.bat.bat and setenv_pcli.bat files

— For UNIX: pserver.sh and setenv_pcli.sh files

■ In the %PSERVER_HOME%\etc directory: template-pserver_service.conf file



4 Copy all the new files into the appropriate directories.

5 Ensure that you have the right permissions for all the files and they are accessible.

6 Restart the BMC Publishing Server.

Installing the Remote Service Monitor patch version 2.9.00.0001

This section provides the information that you need to successfully install patch version 2.9.00.0001 of BMC Portal from the BMC Electronic Product Distribution (EPD) website.

This patch must be installed on version 2.9.00 of BMC Portal only if you changed to 64-bit mode Remote Service Monitor (RSM) using RSM Maintenance tool in version 2.9.00 and now want to upgrade to version 2.9.10 of the product.

To download the RSM patch version 2.9.00.0001

1 Create a temporary directory on your computer.

2 From the Electronic Product Distribution (EPD) website, http://webapps.bmc.com/epd, select the Product Patches tab.

3 Locate the BMC Performance Manager Portal product and expand it to show BMC Performance Manager Portal 2.9.00.

4 Download the BMC PM Portal patch 2.9.00.0001 file into the temporary directory that you created in step 1 on page 47.

5 The BMC PM Portal patch 2.9.00.0001 file will be saved as 2.9.00.0001.zip on your computer. Extract the 2.9.00.0001.zip file on each computer running an RSM service. The 2.9.00.0001.zip file contains the following patch files:

■ %RSM_HOME%\patches\readme_2.9.00.0001.txt

■ %RSM_HOME%\RSM29\server\rsm\lib\patsdk-impl-2.9.00.0001.jar

NOTE You can rename the pserver.sh and setenv_pcli.sh files on UNIX to remove .sh in order to be able to continue running the commands as pserver and setenv_pcli.

NOTE You must create a backup of your old jar files in some other directory and ensure that these files are overwritten or replaced.


Upgrade and installation considerations for BMC Impact Portal

6 Complete the installation procedure described in install the RSM patch version 2.9.00.0001

To install the RSM patch version 2.9.00.0001

After you have downloaded and extracted the patch files, follow these steps to install the patch:

1 Create a backup copy of the following in a separate location, if it already exists on your computer in order to be able to restore back to the earlier files in event of an error:

■ %RSM_HOME%\patches

■ %RSM_HOME%\RSM29\server\rsm\lib\patsdk-impl-2.9.00_Build_345.jar

(%RSM_HOME% refers to the RSM installation folder. For example, C:\Program Files\BMCSoftware\Remote Service Monitor)

2 Stop the RSM Service.

3 Delete the %RSM_HOME%\RSM29\server\rsm\lib\patsdk-impl-2.9.00_Build_345.jar file located on your computer.

4 Extract the 2.9.00.0001.zip file into the %RSM_HOME% directory.

5 Ensure that the patsdk-impl-2.9.00.0001.jar file mentioned in step 5 on page 47 is placed in the %RSM_HOME%\RSM29\server\rsm\lib\patsdk-impl-2.9.00.0001.jar location.

6 Start the RSM service.


In addition to the requirements for BMC Portal, the BMC Impact Portal module has the following additional requirements.

Network requirements

Install the BMC Impact Portal, with its Service Model Editor (SME) and BMC Publishing Server components, in close network proximity to the computer or computers on which the datastore and BMC Atrium CMDB are installed. The components should be on the same LAN segment, if possible, or at least on the same LAN. They should not be separated over a WAN.



Specify size of the BMC Datastore for event reporting

If you plan to use event reporting, BMC recommends that during installation you select medium, at a minimum, or large for the BMC Datastore size.

Portal upgrade process for BMC Impact Solutions users

If you are upgrading BMC Impact Solutions, you must upgrade the BMC Portal using one of the following upgrade paths:

■ Upgrade from BMC Impact Portal version 7.3.01 to BMC Impact Portal version 7.4.01.



Preserving customizations that get overwritten during upgrade of BMC Impact Portal

The following customizations are overwritten when you upgrade the BMC Impact Portal:

■ custom icons■ custom status changes■ custom severity changes

To preserve these customizations, back up the following files before upgrading to the current version of the BMC Impact Portal:

■ For custom icons:

— %BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all/modules/smsIwc.sar/smsIwc.war/images/multiattribute/

— %BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all /deploy/websdk.sar/portal.war/images/icons/alerts/

NOTE If you are currently using BMC Impact Portal version earlier than 7.3.01, then BMC recommends you to first upgrade to version 7.3.01 of BMC Impact Portal and then upgrade to version 7.4.01.


Product upgrade issues in BMC Impact Portal 7.4.01

■ For custom status and severities:

— %BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all/conf/properties/custom_severities.properties

— %BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all/conf/properties/custom_statuses.properties

— %BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all/conf/resources/<lang>/custom_status_messages.properties

— %BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all/conf/resources/<lang>/ custom_severity_messages.properties

After upgrading to the current version of BMC Impact Portal, replace the files from the upgrade with the backed-up files that contain your customizations.

BMC Remedy AR Server user account requirements

The BMC Remedy AR Server user account that is required for connections between the BMC Impact Portal and BMC Impact Solutions must:

■ have a fixed license■ be a part of the Administrators group


In addition to the upgrade considerations described in the BMC Portal Installation Guide, consider the upgrade issues described in this section.

Customized icons are overwritten

If you have customized icons in the BMC Impact Portal, those customizations are overwritten when you upgrade the BMC Impact Portal. For more information, see the “BMC Atrium Discovery component classes,”.

BMC Atrium Discovery component classes

BMC Impact Portal, BMC Service Model Editor, and BMC Impact Explorer user interfaces automatically load and display BMC Atrium Discovery (formerly known as BMC Topology Discovery) discovered component classes. If you use custom icons, you must back up the custom icon folder before upgrading, because the upgrade overwrites the custom icon folder. The custom icons for these newly added component classes into the CMDB are located in the component_icon.properties file at <BMCPortal_Home>\appserver\websdk\tools\jboss\server\all\conf\properties\smsConsoleServer\.



Specifying icons when you create a custom class in CMDB

When you add a new class in the CMDB, for example, BMC_custom, you can specify an icon for this new class. The following procedure explains the configuration steps that must to be executed on the BMC Impact Portal side to specify the new icon.

1. Navigate to the component_icon.properties file located at <BMCPortal_Home>\appserver\websdk\tools\jboss\server\all\conf\properties\smsConsoleServer\.

2. Modify the component_icon.properties file to add the location of the icon as a value to the sms.component.icon.alternate.location parameter as shown.

sms.component.icon.alternate.location parameter = “C:\My Documents\Mynewicons”

3. Place the icon files, for example, BMC_custom_16.gif, BMC_custom_32.png, and BMC_custom_128.png, at the specified location, which is C:\My Documents\Mynewicons.

4. Restart the BMC Portal Application Server service.

If you now add any more custom classes and place their respective icons into the same location (BMC_custom), BMC Portal Application Server service does not need to be restarted, because the icons are picked up at runtime.

NOTE The image name must exactly match the CMDB class name. For example, if the class name is BMC_custom, the image names should be BMC_custom_16.gif, BMC_custom_32.png, and BMC_custom_128.png.

Additionally, the sizes of these three image files should be in the range of the other icons file sizes located at <BMCPortal_Home>\appserver\websdk\tools\jboss\server\all\data\smsConsoleServer\Image\Icon.

Do not confuse the Question Mark (?) icon provided by BMC Atrium Discovery for the BMC_PartnerLinkType CI class with the Unknown icon as these look similar.


Related information

Related informationThe following documents support the BMC Portal modules:

The latest BMC Portal information is available on the Customer Support website at http://www.bmc.com/support.

From the Customer Support site, you can perform several tasks, including

■ viewing the latest product documentation (manuals, release notes, flashes, technical bulletins, online Help, and parameter information)

Table 12 BMC Portal documentation

Module Document title

all modules BMC Portal Installation Guide

BMC Portal Getting Started

Creating, obtaining, and installing SSL certificates for the Portal web server installation notes


BMC Performance Manager Portal Monitoring and Management Guide

BMC Performance Manager Development and Certification Guide

PATROL Security User Guide

BMC Datastore Installation Guide

BMC Datastore Release Notes

BMC Impact Portal BMC Impact Solutions Release Notes

BMC Impact Solutions: Installation

BMC Impact Solutions Getting Started

BMC Impact Solutions Planning and Implementation Guide

BMC Impact Solutions Event Adapter User

BMC Impact Solutions Infrastructure Management Guide

BMC Impact Solutions Knowledge Base Development Reference Guide

BMC Impact Solutions Service Modeling and Publishing Guide

BMC Impact Integration for PATROL Enterprise Manager Installation and Configuration Guide

BMC Impact Integration for PATROL Installation and Configuration Guide

BMC Impact Integration Web Services Server Installation and Configuration Manual

BMC Impact Solutions Event Adapter User

TIP If you do not already have a user name and password that allow you to fully access the Customer Support website, you can register for a user name and password on the site.



Support for BMC Portal

■ subscribing to proactive alerts to receive e-mail messages that inform you of new release notes, flashes, and technical bulletins for your products

■ searching for existing product resolutions and frequently asked questions (FAQs)

Support for BMC PortalBMC provides the indicated levels of support for the following versions and releases of BMC Performance Manager Portal:

For more information about the latest support policies, see the Customer Support website at http://www.bmc.com/support.

If you have problems with or questions about a BMC product, see the Customer Support website at http://www.bmc.com/support. You can view or download product documents, find answers to frequently asked questions, and download products and maintenance. If you do not have access to the web and you are in the United States or Canada, contact Customer Support at 800 537 1813. Outside the United States or Canada, contact your local BMC office or agent.

Module and version Level of support


2.9.x full

2.8.x full

2.7.x full

2.6.x limited

2.5.x none

BMC Impact Portal

7.4.x full

7.3.x full

7.2.x full

7.1.x limited

7.0.x none




Support for BMC Portal

© Copyright 2011 BMC Software, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

SAP, SAP Business Objects, and Crystal Reports are trademarks or registered trademarks of SAP AG in Germany and in several other countries.

The information included in this documentation is the proprietary and confidential information of BMC Software, Inc., its affiliates, or licensors. Your use of this information is subject to the terms and conditions of the applicable End User License agreement for the product and to the proprietary and restricted rights notices included in the product documentation.

BMC SOFTWARE INC2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA• 713 918 8800Customer Support: 800 537 1813 (United States and Canada) or contact your local support center
