VMware vrealize operations Management Pack FOR
IBM DB2
Installation & Configuration Guide
TABLE OF CONTENTS
1.  Purpose. .................................................................................................................................................................... 3
2.  Installation and Configuration Requirements. ..................................................................... 3
3.  Licensing Requirements. .......................................................................................................................... 3
4.  Installing the Management Pack .................................................................................................... 4
4.1  Uploading the Installation File............................................................................................. 4
4.2  Adding a License Key.................................................................................................................. 6
5.  Configuring the Management Pack............................................................................................... 7
5.1  Configuring IBM DB2 for Monitoring Metrics....................................................... 7
5.2  Enabling SSL......................................................................................................................................... 8
5.3  Enabling Virtual Machine IOPS metrics. .................................................................... 8
5.4  Creating an Adapter Instance and Credential. .................................................... 9
5.5  Validating Data Collection..................................................................................................... 12
6.  Appendix I: Management Pack Folders and Files....................................................... 13
NOTE: This document supports the version of each product listed, as well as all subsequent versions, until
a new edition replaces it.
You can find the most up-to-date technical documentation on the Blue Medora support site at:
http://support.bluemedora.com.
The Blue Medora website also provides the latest product updates. If you have comments about
this documentation, submit your feedback to: support@bluemedora.com.
2
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
1.  Purpose
The Blue Medora VMware vRealize Operations (vROps) Management Pack for IBM DB2 Installation and Configuration
Guide describes how to install and configure Blue Medora’s VMware vRealize Operations Management Pack for IBM
DB2.
2.  Installation and Configuration Requirements
Before installing and configuring the Management Pack for IBM DB2, ensure your system meets the following
requirements:
Table 1: Management Pack Installation & Configuration Requirements
vRealize Operations (vROps)
Requirements
IBM DB2 Requirements
Version(s)
vRealize Operations v6.0.x & v6.1.x,
Enterprise edition only
IBM DB2 versions 9.5+
Credentials
vROps username/password with access to
vRealize Suite API is required
IBM DB2 username/password
Connection
vROps hostname or IP address
IBM DB2 hostname (i.e., IP or DNS name of IBM
DB2 System)
NOTE: If your DB2 database system is set up to use SSL, you
must add the DB2 SSL certificate prior to adding your adapter
instance (refer to section 5.2, Enabling SLL, for details).
3.  Licensing Requirements
A license key will be provided by Blue Medora when the Management Pack is purchased and must be added as a
IBM DB2 Adapter License within vRealize Operations before the Management Pack can be configured and used.
Licensing for the Management Pack is based on the number of databases per adapter instance.
Refer to section 4.2, Adding the License Key, for details about validating your Management Pack license within
vRealize Operations.
3
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
4.  Installing the Management Pack
Installing the Management Pack in vRealize Operations involves completing the following tasks:
• Uploading the Installation File
• Adding the License Key
4.1  Uploading the Installation File
The Management Pack for IBM DB2 is installed using a .pak file.
4.1.1  Prerequisites
• Obtain the Management Pack installation file from http://www.bluemedora.com/products.
• Read the release notes that are included with the .pak file.
4.1.2  Procedure
1. Save the .pak file in a temporary folder.
2. Log in to vRealize Operations as an admin user.
3. Click the Home icon, then select the Administration navigation shortcut from the panel on the left.
Figure 1: Home > Administration
4
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
4. In the right panel, the Solutions tab will be displayed.
Figure 2: Solutions tab
5. Click the Add icon ( ) to upload the .pak file to the vRealize Operations server. In the dialog that appears,
browse to the location of the saved .pak file, then click Upload.
NOTE: The .pak file upload may take several minutes to complete. Status information appears in the Installation
Details text box throughout the installation process.
Figure 3: Select the .pak file to upload
5
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
6. Click the Next button when the upload has finished. Read the End User License Agreement (EULA) and click
the ‘I accept the terms of this agreement’ checkbox to accept, then click the Next button.
7. Click the Finish button when the installation process is complete.
NOTE: The installation utility creates the db2_adapter3 folder and db2_adapter3.jar file in the $ALIVE_BASE/
user/plugins/inbound folder. Refer to Appendix 1 for more information on folders and files.
4.2  Adding a License Key
The Management Pack requires a valid license for full operation. Complete the following steps to license the
Management Pack.
4.2.1  Install the License
1. In vRealize Operations Manager, navigate to Administration > Licensing > License Keys.
2. Click the Add icon (
). In the dialog that appears, select ‘DB2 Adapter’.
Figure 4: Add License
3. Enter your Blue Medora license key, then click Validate. If successful, “License key validated successfully”
will be displayed.
4.2.2  Add the License to a Group
NOTE: Adding a license to a license group is only necessary if using vROps 6.0.0. In later versions, the License
will automatically be added to a group.
1. Navigate to License Groups.
2. Select the license group ‘DB2Adapter Licensing’, then click the Edit icon (
).
3. Check the newly added license.
4. Enter a name for this license group, then click Next.
5. Select the resources to include/exclude in this group, then click Next.
6. Click Finish.
7. Navigate back to License Keys and click the Refresh License Usage icon (
6
).
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
5.  Configuring the Management Pack
Configuring the Management Pack for IBM DB2 includes the following tasks:
• Configuring IBM DB2 for Monitoring Metrics
• Enabling SSL (if necessary)
• Enabling VM IOPS Metrics
• Creating an Adapter Instance and Credential
• Manually Discovering Resources (if necessary)
• Validating Management Pack Data Collection
5.1  Configuring IBM DB2 for Monitoring Metrics
A few special configurations are required on the DB2 database side in order for the Management Pack to collect
metrics correctly.
1. Enable DB2 configuration parameter HEALTH_MON (i.e., turn on health indicators for instance and database
objects).
2. Enable switch for monitoring statements.
3. Set up permissions for Management Pack to query the lock waits administrative view.
4. Enable table monitoring (DFT_MON_TABLE) for the database you are monitoring.
To complete the above configurations, run the following commands by Command Line Processor (CLP) at the
db2 prompt:
1. db2==> update dbm cfg using HEALTH_MON on
2. db2 => update dbm cfg using DFT_MON_STMT on
3. db2 => update dbm cfg using DFT_MON_LOCK on
4. db2 => update dbm cfg using DFT_MON_TABLE on
To check if your changes are effective, run the following command:
db2==> get dbm cfg
The following is the output:
.....
.....
.....
Monitor health of instance and databases (HEALTH_MON) = ON
Default database monitor switches
Buffer pool
(DFT_MON_BUFPOOL) =
Lock
(DFT_MON_LOCK) =
Sort
(DFT_MON_SORT) =
Statement
(DFT_MON_STMT) =
Table
(DFT_MON_TABLE) =
Timestamp
(DFT_MON_TIMESTAMP) =
Unit of work
(DFT_MON_UOW) =
Monitor health of instance and databases
(HEALTH_MON) =
.....
.....
.....
7
OFF
ON
OFF
ON
ON
ON
OFF
ON
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
5.2  Enabling SSL
If your DB2 database system is set up to use SSL, you must add the DB2 SSL certificate prior to your adapter
configuration.
5.2.1  Procedure
1. Copy certificate to the vROps host.
2. Log in to vROps host as ‘root’.
] cd /usr/java/default
] bin/keytool -import -keystore lib/security/cacerts -file /path/to/
mydb2sslserver.arm
3. Create password when prompted (must be at least 6 characters).
4. Type ‘yes’ when asked to trust this certificate.
] service vmware-vcops restart collector
5.3  Enabling Virtual Machine IOPS metrics
To enable Virtual Machine IOPs metrics that populate the DB2 IOPS Dashboard within the Management Pack,
you must enable them via policy within vRealize Operations.
5.3.1  Prerequisites
• VMware vSphere Management Pack must be installed
• Management Pack for IBM DB2 must be installed
5.3.2  Procedure
1. Click on the Administration navigation shortcut (
), then click Policies.
2. Take note of the active policy listed in the Active tab, then click the Policy Library tab.
3. Select the active policy from the list.
NOTE: If a custom policy from another Management Pack is not your current active policy, the default will be
something like ‘vSphere Solution’s Default Policy (<timestamp>)’.
4. Click the Edit icon (
)
5. Select 2. Select Base Policies.
6. Select ‘Blue Medora Default Policy for DB2 Adapter’ under Override settings from additional policies:
7. Click Apply, then Save.
Figure 5: Edit Monitoring Policy > Select Base Policies
8
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
5.4  Creating an Adapter Instance and Credential
You must create an adapter instance and credential for the Management Pack in order to define the adapter type
and identify the database(s) from which the adapter instance will retrieve data.
5.4.1  Prerequisites
• Install the Management Pack for IBM DB2. Refer to section 4, Installing the Management Pack.
5.4.2  Procedure
1. Log in to vRealize Operations as an administrator.
2. Click on the Administration navigation shortcut (
). The Solutions view should automatically open.
3. Select ‘DB2 Adapter’ from the Solutions list.
Figure 6: Solutions List
9
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
4. Click the Configure icon (
). The Manage Solution window will appear.
Figure 7: Manage Solution Window
NOTE: If creating multiple adapter instances, click the Add icon (
) above Instance Name on the left.
5. In the Manage Solution window, enter the following information:
Adapter Settings:
• Display Name: A name for this particular instance of the Management Pack
• Description: Optional; most helpful for describing multiple adapter instances of the Management Pack
Basic Settings:
• Database Name(s): Name of DB2 database (can be comma separated if multiple databases are on the
same instance)
• Host: Hostname or IP address of DB2 database
• Port: Default port is 50000; can be overriden
• Credential: Click the Add icon ( ), then select the credential type (refer to Figure 7).
Advanced Settings:
• Collector: Automatically selected
10
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
Figure 8: Manage Credential
•
•
•
•
•
Credential Name: A name for this set of Management Pack credentials
User Name: User Name for DB2 system
Password: Password for DB2 system
vRealize User Name: vRealize Operations User Name
vRealize Password: Password associated with vRealize Operations User Name
NOTE: The vRealize user name/password must have access to vRealize Suite API.
6. Click OK to save your credential.
7. Click Test Connection to ensure vRealize Operations can connect properly to the DB2 system.
8. Click Save Settings to save your adapter instance configuration.
11
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
5.5  Validating Data Collection
After you add an IBM DB2 adapter instance, you will want to validate the data that it collects in vRealize
Operations.
5.5.1  Prerequisites
Add an IBM DB2 adapter instance. Refer to section 5.4, Creating an Adapter Instance and Credential, for
details.
5.5.2  Procedure
1. Select the Environment shortcut ( ). 2. Under Inventory Trees, select All Objects, then expand the DB2 Adapter objects list.
3. Select a resource from the list, then click the Troubleshooting tab and All Metrics view to validate values
against the data source.
Figure 9: DB2 Adapter Objects Troubleshooting
12
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
6.  Appendix I: Management Pack Folders and Files
The installer places the Management Pack files in the db2_adapter3 folder under the $ALIVE_BASE/user/plugins/
inbound/ folder as shown below.
Table 2: Management Pack Folders and Files
FOLDER/FiLe(S)
Folder/FILE(s)
Description
conf
dashboards (folder)
Contains .json files for Management Pack
Dashboards
describe.xml
Describes the Management Pack
describe.dtd
Used to validate describe.xml
images (folder)
Contains .png files for AdapterKind, ResourceKinds,
and TraversalSpec
open_source_license.txt
lib
13
oss_attribution.txt
Open source license file
reports (folder)
Contains .xml files for Management Pack Reports
reskndmetrics (folder)
Contains .xml files for Dashboard Metric configuration
resources (folder)
Contains resources.properties file
version.txt
Contains version information
views (folder)
Contains .xml files for Management Pack Views
Refer to lib folder for entire list
.jar files that contain the classes and resources used
to implement the Management Pack
Blue Medora VMware vRealize Operations Management Pack for IBM DB2 Installation & Configuration Guide
You can find the most up-to-date technical documentation on the Blue Medora
support site at: http://support.bluemedora.com.
The Blue Medora website also provides the latest product updates. If you
have comments about this documentation, submit your feedback to:
support@bluemedora.com.
Copyright © 2015 Blue Medora Inc. All rights reserved. U.S. and international copyright and
intellectual property laws protect this product. Blue Medora is a registered trademark or trademark
of Blue Medora in the United States and/or other jurisdictions.
The IBM name (including IBM DB2) and logo are trademarks or registered trademarks of
International Business Machines, Inc. in the United States and/or other jurisdictions. All other marks
and names mentioned herein may be trademarks of their respective companies.
Blue Medora
3225 N Evergreen Dr. NE Suite 103
Grand Rapids, MI 49525
www.bluemedora.com