Professional Documents
Culture Documents
BMC Portal
Version: 2.9.10 September 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.
NOTE
Before you install the product, check the Customer Support website at http://www.bmc.com/support for
s s s
updated documentation (for example, flashes and technical bulletins) product downloads, patches, and fixes (PTFs) product availability and compatibility (PAC) data
Overview of BMC Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Whats new in BMC Portal 2.9.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Exclusion of BMC Exception Detector module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Updated support for BMC Impact Integration Web Services Server 7.4.00 . . . . . 4 Discontinued support for BMC Impact Integration Web Services Server . . . . . . . 4 Support for 64-bit BMC Performance Manager Portal . . . . . . . . . . . . . . . . . . . . . . . 4 Biweekly blackout functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Support for 64-bit RSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Support for Internet Protocol version 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Flexibility to configure threshold directions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Enhancement in BMC Performance Manager Portal command-line interface . . . 9 Portal and RSM health monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Portal diagnostic tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Enabling parameter notifications to BMC Event Manager for offline and blackout status changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Support for BMC Reporting Foundation 3.2.10 and Crystal Reports 2008 SP3 Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Support for virtualized platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Internationalization and localization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Corrected problems in BMC Performance Manager Portal and BMC Impact Portal 16 Known issues and workarounds in BMC Performance Manager Portal. . . . . . . . . . . 19 Requirements and supported resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Platforms supported by BMC Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 BMC Portal application server and web server system requirements . . . . . . . . . 31
*024422* *024422*
*224420*
Remote Service Monitor system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Updating the JDBC driver to support Oracle Database 11.2.0.2.0 . . . . . . . . . . . . . 34 Installation information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 How to obtain the product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Prerequisites for upgrading to BMC Portal 2.9.10. . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Downloading BMC Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 BMC Datastore supported versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Privileges required for the BMC Portal database instance . . . . . . . . . . . . . . . . . . . 40 Installing the BMC Portal components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Product upgrade paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Upgrading to BMC Portal 2.9.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Upgrade and installation considerations for BMC Impact Portal . . . . . . . . . . . . . 48 Product upgrade issues in BMC Impact Portal 7.4.01 . . . . . . . . . . . . . . . . . . . . . . . 50 Related information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Support for BMC Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
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.
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.
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. Table 1 Relationship between BMC Portal features and BMC Portal module BMC Portal features Module to select Other BMC during installation products required
BMC Performance Manager Portal BMC Performance Manager Portal BMC Impact Portal Performance Managers PATROL Knowledge Modules and PATROL Agents BMC Impact Manager
Type of environment
BMC Performance Agentless monitoring provided by BMC Manager (agentless) Portal and the Remote Service Monitor (RSM) program PATROL (agentbased) Agent-based monitoring provided by BMC Portal, the RSM program, and PATROL Agents
BMC Service Impact web-based common user interface for Manager service impact management and reporting; centralized user administration
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.
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
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.
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, 2011 Start time: 10:00:00 A.M. on Sunday In this case:
s s s
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:
s
Blackout created on: Sunday, March 6, 2011 Start 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, 2011 Start 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).
NOTE
Before you change the RSM mode to 64-bit, consider the following requirements:
s
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.
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.
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)
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.
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.
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.
EXAMPLE
s
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).
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.
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:
s s s
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.
NOTE
You register to access additional documentation for SAP BusinessObjects at the SAP BusinessObjects Indirect Client Knowledge Center at https://websmp207.sapag.de/~sapidp/002006825000000284522008E/. The site provides access to the following resources:
s s s
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.
10
NOTE
Before you can assign permissions to a component instance, you must specify the component type and assign a name to the instance.
11
To change the default caching time settings 1 Navigate to the following directory where the smeserver.properties file is located:
s
Windows:
<PORTAL_HOME>\appserver\websdk\tools\jboss\server\all\conf\properties\s msSme\smeserver.properties
Solaris:
<PORTAL_HOME>/appserver/websdk/tools/jboss/server/all/conf/properties/smsSm e/smeserver.properties
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.
12
NOTE
Before you make any changes to the smeserver.properties file, BMC recommends you to save a backup copy of it.
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: com.bmc.sms.consoleserver.eventProcessor.eventsFromDatabase= 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.
13
NOTE
The All Events filter is not available under the history events feature.
2 Search for the com.bmc.sms.eventaggregator.event.customSlotNames parameter. 3 Add a custom slot name for the above parameter. 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.
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.
14
New default values for the Event Information and Severity filters
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.
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:
s s
Event Information filter = Active - Impacting Events Severity filter = Info or worse
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 filter Active Impacting Events Unassigned Impacting Events All Events
Table 4
15
Table 4
Severity filter Major or worse Minor or worse Warning or worse Info or worse Ok or worse
French Runsa View Module BMC Performance Manager Portal BMC Impact Portal
a
+ +
+ +
+ +
+ +
+ +
+ +
Product executes in the operating system for the specified language and can also accept input, run process, and display data in that language. b To display the user interface in a different language, users and administrators must log on and change the default language settings.
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.
16
Corrected problems in BMC Performance Manager Portal and BMC Impact Portal
Table 6
Tracking ID BMC Portal
Corrected problems in BMC Performance Manager Portal and BMC Impact Portal (part 1 of 2)
Description 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.
QM001545863
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. 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. If you added an element by using Discover from BMC Atrium CMDB option, the host displayed the platform as bpm-platform-nt. Refreshing CDE metadata took longer time than expected. The Apache HTTP Server suffered from multiple vulnerabilities. For Japanese locale, the translation in the RSM Installer was not correct. Blackouts failed when the expired blackouts were not removed from the Portal. Refreshing CDE metadata did not import all elements into the ELEMENT table. 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. When you upgraded Portal to version 2.8, two core performance managers were in the Publishing or Upgrading state for hours and stopped working. 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. BMC Performance Manager 2.8 was unable to connect to BMC Atrium CMDB 7.6.03. Redundant database calls were issued during the BMC Performance Manager Portal login process, causing a deterioration in performance. The Portal installer did not load the dataset.arx and reconrules*.arx files automatically. In floating dashboards, the business element pane was not refreshed. The RSM was not generating a heap dump file if it encountered OutOfMemory errors. A NullPointerException error occurred in the log if the product failed to find the application class. An OutOfMemory error occurred in the log because of the incorrect FINEST login message. BMCPortalMaintenanceTool incorrectly updated values in the jvmRoute parameter if you entered a blank space in the application server hostnames. The Search functionality returned incorrect results. Multiple bind requests were made at the time of LDAP authentication from BMC Performance Manager Portal.
QM001612198
QM001661910 QM001662968 QM001668031 QM001669378 QM001674383 QM001676009 QM001680702 QM001684820 QM001684823 QM001686857 QM001691782 QM001691786
17
Corrected problems in BMC Performance Manager Portal and BMC Impact Portal
Table 6
Tracking ID
Corrected problems in BMC Performance Manager Portal and BMC Impact Portal (part 2 of 2)
Description 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. An application Instance was not deleted and it was causing lazy initialization exceptions in the Portal Log file. 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. If the element profile was removed from an element, the element thresholds, properties and credentials were not updated. Data was lost during payload processing because there was an error in correct status mismatch code. BMC Performance Manager Portal stopped working while rolling up the partitions on parameter value table if it had large count or retention. A NullPointerException error occurred when the product sent notifications. The Advanced Search feature with the Object Type defined as Tag returned elements that were not tagged with the particular tag. The Advanced Search feature with the Object Type defined as Application Classes returned incorrect results. 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. 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. When the value of an Impact Portal event slot contained n apostrophe (') or a semi-colon (;) the value got truncated. On stopping BMC Portal, you would get a Messaging Exception error in the Portal log file. 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. 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])']
QM001691788
QM001697793 QM001698015
QM001720537 QM001719917
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. The availability report was not being generated correctly for certain components of the BMC Impact Portal module.
18
Known issues and workarounds in BMC Performance Manager Portal (part 1 of 11)
Description
QM001539557
QM001544246 QM001546435 QM001546844 QM001547674
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 2 of 11)
Description 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. 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.
QM001563674
QM001570487 QM001573793
When performing the Notifications task, you cannot remove the Primary IIWS Host Server Name entry on the Provider tab. 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.
20
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 3 of 11)
Description 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 QM001702093
You cannot delete element profiles that are linked to disabled users. 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.
21
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 4 of 11)
Description 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.
s s
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 QM001580471 BMC Portal displays truncated text in the user interface when the text string contains more than 1000 characters. 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.
22
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 5 of 11)
Description 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. 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.
QM001604607
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 QM001681006
Sentry solution upgrade for 500 elements with Element Profile does not work. CMDB integration is not working when integrated with CMDB 7.6.03. Workaround: Install AtriumCore 7.6.03 P001 patch as a fix.
23
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 6 of 11)
Description 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\Windowsx86\bmcesi.dll
QM001698424 QM001699652
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. 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:
s s
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:
s s s
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.
24
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 7 of 11)
Description 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
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. 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. 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. When only the BMC Impact Portal is installed the Elements link under the Configure tab should be disabled or not be displayed. The Desktop Status Indicator displays an incomplete CI name if a CI contains special characters, such as < >. 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. 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.
SW00250831
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.
25
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 8 of 11)
Description Changing the following quality measures resets reporting calculations so that reporting starts calculating from 90 days in the past:
s s s s s
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=2 4. 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. 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 QM001561633 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. 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. 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.
QM001564922
QM001573337
26
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 9 of 11)
Description When events are sent to Impact Portal containing slots which are too long, the ORA12899 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 QM001675695
Components with non-alphanumeric characters in the name cause an Application Error when selected in the Desktop Status Indicator. (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 QM001677661
In a dashboard, the image editor does not display a previously added folder in the canvas view. 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. 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 (/). 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. 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.
QM000507613
QM000552003
27
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 10 of 11)
Description 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. I18NIn Schedules, Costs Unit is hardcoded as U.S. dollars, which prevents you from using a local cost unit (for example, KRW for Korean currency). 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
QM001530753 QM001532145
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. 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. 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.
QM001576299
QM001573777
28
Table 7
Tracking ID
Known issues and workarounds in BMC Performance Manager Portal (part 11 of 11)
Description Duplicate slot entries are displayed under the Alias Formula attribute section for the following slots:
s s s s s s
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.
29
Table 8
Operating system
Oracle Solaris 9 (64-bit), SPARC
b,e
3.x + +
6.x
7.x
8.x
+ + + + + + +
+ + + + +
+ + + +
+ + + + +
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-bit or later
c, d
+ ), SP1 + + + + + + + +
+ + + + +
+ + + + + + +
Microsoft Windows 2008, Enterprise Server (32-bite and 64-bitc, d,e), SP1 or later 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
a
RSM applies to the BMC Performance Manager Portal module only; Table 10 contains specific system requirements for RSM. b Zones (Solaris Containers) are supported on Solaris 10. c References to 64-bit include AMD64 (which includes Opteron and Athlon) and Intel 64 (formerly known as Intel 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. e This operating system is supported for IPv6.
30
Table 9
Resource Platform
BMC Portal application server and web server system requirements (part 1 of 2)
Minimum requirements Either of the following processors:
s s
Intel compatible (32-bit) Pentium 4 processor or equivalent AMD Opteron/Intel Xeon 64 EM64T processor (64-bit)
2 CPU minimum 3.2 GHz processing speed (with hyperthreading enabled) 4 GB RAM minimum
4 CPU minimum 3.5 GHz processing speed (with hyperthreading enabled) 4 GB RAM minimum 2 CPU minimum 1.2 GHz processing speed 4 GB RAM minimum 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. Requires a user account with administrator rights and permissions Service Pack 2 or later; BMC recommends the latest service pack. Requires a user account with administrator rights and permissions Service Pack 1 or later; BMC recommends the latest service pack
s s s
Disk space
s s
Windows: 10 GB Solaris: 10 GB
Operating system
s s
s s
Windows Server 2008 (32-bit, 64-bit) Windows Server 2008 R2 (64-bit) Solaris 9 (64-bit), Sparc Solaris 10 (64-bit), Sparc
s s
s s
31
Table 9
Resource
BMC Portal application server and web server system requirements (part 2 of 2)
Minimum requirements Running SMTP server (optional) Comments The installation program verifies the presence of a running e-mail server.
Third-party products
Oracle J2SE Java Runtime Environment (JRE) The BMC Portal Help requires version 1.4.2 or later. If necessary, you can download the latest on client computersc JRE from the Java download site at http://www.oracle.com/technetwork/java/in dex.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.
s s s s
Web browser
The Internet Explorer browser on Windows 2003 requires the medium security setting. Do not run BMC Portal with the high security Mozilla Firefox 3.x Microsoft Internet Explorer 6.x, 7.x, or 8.x setting.
a b c
For the download locations of the libiconv library, see the BMC Portal Installation Guide. For the download locations of the libuuid patch, see the BMC Portal Installation Guide. You must restart the computer after you install the patch. 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
s
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.
s s
32
Comments
For 32-bit RSM
s s s s
Intel compatible (32-bit) Pentium 4 processor or equivalent AMD Opteron/Intel Xeon 64 EM64T processor (64-bit)
2 CPU minimum 2 GHz processing speed 2 GB RAM dedicated to RSM 10 GB disk space
Operating system
s s s s
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.
s s s s
Windows Server 2008 Standard Edition Windows Server 2008 Enterprise Edition Windows Server 2008 Datacenter Edition Windows Server 2008 R2
NTP continuously adjusts the time on a computer to match that of another computer, typically the atomic clock. BMC recommends PATROL Agent versions 3.7.x or later when using PATROL integration Performance Managers to obtain parameter values.
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.
33
NOTE
For information about support for Oracle Database 11g Release 2, see the July 16, 2010,thirdparty support document for version 2.8.00 of BMC Performance Manager Portal.
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:
s
(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:
JDBC driver: Oracle JDBC driver, version: 11.2.0.2.0
34
Installation information
Installation information
This 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.
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 (64bit). 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
35
To download the BMC Portal components from the web 1 Create a directory in which to place the downloaded files. 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.
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.
36
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.
37
Table 11
Components 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 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 Files 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
a
Filesa
+ + + + + + +
38
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
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.
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 ProductionControl@BMC.com to obtain a copy of BMC Datastore. In the e-mail message, provide the following information:
s s s s
Company name Valid support ID BMC Datastore version BMC Datastore platform
39
Product list
s s s s s s s s s s s s s s s s s s s s s s s s s s
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
40
s s s s s s s
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.
WARNING
s
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.
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:
s s s s
41
Windows 64-bit:
s s s s
Solaris:
s s s s
The bmc_products directory is created and the files are extracted to the bmc_products directory.
NOTE
If you are using your own Oracle license, you do not need to download the BMC Datastore files.
3 To extract the BMC Portal files from the archive in the temporary directory,
uncompress one of the following files:
s s
4 Depending on the datastore you use, perform one of the following actions:
s
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:
s
42
6 Using the BMC Portal Installation Guide, follow the procedures for installing the
BMC Portal application server, web server, modules, and Performance Managers.
s
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.
NOTE
s
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 products 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.
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.
43
NOTE
s
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. 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.
The installation program terminates if it detects any version of PATROL Express on the target computer.
NOTE
s
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
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. 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.
44
NOTE
When upgrading from versions 2.4 or 2.5, you do not need to purge events before starting the upgrade.
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.
45
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.
1 Stop the BMC Publishing Server. 2 Create a backup of the following directories:
s s s
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:
s
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
46
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.
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. NOTE
You must create a backup of your old jar files in some other directory and ensure that these files are overwritten or replaced.
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:
s s
6 Complete the installation procedure described in install the RSM patch version
2.9.00.0001
%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)
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.
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.
48
Upgrade from BMC Impact Portal version 7.3.01 to BMC Impact Portal version 7.4.01. Upgrade from BMC Impact Portal version 7.3.02 to BMC Impact Portal version 7.4.01. Upgrade from BMC Impact Portal version 7.4.00 to BMC Impact Portal version 7.4.01.
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.
Preserving customizations that get overwritten during upgrade of BMC Impact Portal
The following customizations are overwritten when you upgrade the BMC Impact Portal:
s s s
To preserve these customizations, back up the following files before upgrading to the current version of the BMC Impact Portal:
s
%BMC_PORTAL_KIT_HOME%/appserver/websdk/tools/jboss/server/all
/deploy/websdk.sar/portal.war/images/icons/alerts/
49
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.
50
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.
51
Related information
Related information
The following documents support the BMC Portal modules: Table 12
Module all modules
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 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
The latest BMC Portal information is available on the Customer Support website at http://www.bmc.com/support.
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.
From the Customer Support site, you can perform several tasks, including
s
viewing the latest product documentation (manuals, release notes, flashes, technical bulletins, online Help, and parameter information)
52
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)
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.
53
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 INC 2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA 713 918 8800 Customer Support: 800 537 1813 (United States and Canada) or contact your local support center
54