VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR VCE Vblock · PDF file3 Blue Medora VMware vRealize Operations Management Pack for VCE Vblock Installation & Configuration Guide 1. Purpose

VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR

VCE Vblock

Installation amp Configuration Guide

2 Blue Medora VMware vRealize Operations Management Pack for VCE Vblock Installation amp Configuration Guide

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 httpsupportbluemedoracom

The Blue Medora website also provides the latest product updates If you have comments about this documentation submit your feedback to supportbluemedoracom

1 Purpose 32 Installation and Configuration Requirements 33 Licensing Requirements 34 Installing the Management Pack 4

41 Uploading the Installation File 442 Registering VMware vCenter Servers 643 Adding a License Key 6

5 Configuring the Management Pack 751 Creating an Adapter Instance 752 Adding System Library CAS credentials 953 Changing the Adapter collection interval (optional) 9

6 Objects Management 1161 Discovering Objects Manually 1162 Validating Data Collection 1363 Adding Objects Manually 1464 Adding a Maintenance Schedule 1565 Tagging Resources for Maintenance 15

7 Appendix I Management Pack Folders and Files 16

TABLE OF CONTENTS

1 PurposeThe Blue Medora VMware vRealize Operations (vROps) Management Pack for VCE Vblock Installation and Configuration Guide describes how to install and set up Blue Medorarsquos VMware vRealize Operations Management Pack for VCE Vblock systems

2 Installation and Configuration RequirementsBefore installing and configuring the Management Pack ensure your system meets the following requirements

Table 1 Management Pack Installation amp Configuration Requirements

vRealize Operations (vROps)Requirements

VCE VblockVision Requirements

Version(s) vRealize Operations v6x(Advanced amp Enterprise editions)

The Management Pack is compatible with the following VCE Vblock Systems bull 100 bull 200 bull 240 bull 300 bull 320 bull 340 bull 540 bull 700 bull 720 bull 740The Management Pack is compatible with VCE Vision Intelligent Operations software v262+

Credentials NA VCE Vblock System Library Administrator (CAS) User NamePassword

Connection vROps hostname or IP address Hostname of VCE Vblock system written in Fully Qualified Domain Name (FQDN) format

NOTE The total number of metrics being collected determines the resource requirements for the Management Pack Refer to the ldquoSystem Requirementsrdquo section in VMwarersquos vApp Deployment and Configuration Guide for vRealize Operations Manager 60 for details about metric collection resource requirements for vRealize Operations Manager and the adapter You can download the most recent version of the guide from VMwarersquos documentation site

3 Licensing RequirementsA license key will be provided by Blue Medora when the Management Pack is purchased and must be added as a VCE Vision Adapter License within vRealize Operations before the Management Pack can be configured and used Licensing for the Management Pack is per Vblock resourceRefer to section 42 Adding the License Key for details about validating your Management Pack license within vRealize Operations

4 Installing the Management Pack Installing the Management Pack in vRealize Operations involves completing the following tasks

bull Uploading the Installation Filebull Adding the License Key

41 Uploading the Installation FileThe Management Pack for VCE Vblock is installed using a pak file

411 Before you beginbull Obtain the Management Pack installation file from httpwwwbluemedoracomproductsbull Read the release notes that are included with the pak filebull Ensure you have administrator privileges to access the vRealize Operations Manager Administration portal

412 Procedure

1 Save the pak file in a temporary folder

2 Use a Web browser to navigate to the vRealize Operations Manager Administration portal and log in

NOTE The URL format is httpsltvROPS hostname or IP addressgt where ltvROPS hostname or IP address gt are the fully qualified domain name (FQDN) or IP address of the vRealize Operations Manager UI

3 Log in to vRealize Operations as an admin user

4 Click the Home icon then select the Administration navigation shortcut from the panel on the left

Figure 1 Home gt Administration

5 In the right panel the Solutions tab will be displayed

Figure 2 Solutions tab

6 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 name is VblockAdapter-60xxxxxxxxpak where xxxxxxxx is the product build number

The install process may take several minutes to complete The Installation Details Status panel displays the installation progress for each node in cluster The following screen capture shows a typical single node installation status screen

Figure 3 Select the pak file to upload

7 Click the Next button when the upload has finished Read the End User License Agreement (EULA) and click the lsquoI accept the terms of this agreementrsquo checkbox to accept then click the Next button

8 Click the Finish button when the installation process is complete

NOTE The installation utility creates the vcevision_adapter3 folder and vcevision_adapter3jar file in the $ALIVE_BASEuserpluginsinbound folder Refer to Appendix 1 for more information on folders and files

413 What to do nextbull Register VMware vCenter Servers in vRealize Operations Manager See section ldquo42 Registering VMware vCenter Serversrdquo for details bull Add an Adapter instance See Adding an Adapter instance for details

42 Registering VMware vCenter ServersThe Adapter shows the hierarchical relationship between a compute server and the VMware vSphere ESXi host running on that server This functionality requires that the vCenter Server that is managing the vSphere ESXi host be registered with vRealize Operations Manager If multiple vCenter Servers manage a single Vblock System then all vCenter Servers need to be registered with vRealize Operations Manager

See VMwarersquos vApp Deployment and Configuration Guide for vRealize Operations Manager 60 for complete details on how to setup and register multiple vCenter Servers with vRealize Operations Manager Each vCenter Server registration automatically creates a new VMware adapter instance in vRealize Operations Manager You can download the most recent version of the guide from VMwarersquos support site

43 Adding a License KeyThe Management Pack requires a valid license for full operation Complete the following steps to license the Management Pack

431 Install the License1 In vRealize Operations Manager navigate to Administration gt Licensing gt License Keys2 Click the Add icon ( ) In the dialog that appears select lsquoVCE Vision Adapterrsquo

Figure 4 Add License

3 Enter your Blue Medora license key then click Validate If successful ldquoLicense key validated successfullyrdquo will be displayed

432 Add the License to a Group

NOTE Adding a license to a license group is only necessary if using vROps 600 In later versions the License will automatically be added to a group

1 Navigate to License Groups2 Select the license group lsquoVblockAdapter Licensingrsquo then click the Edit icon ( )3 Check the newly added license4 Enter a name for this license group then click Next5 Select the resources to includeexclude in this group then click Next 6 Click Finish7 Navigate back to License Keys and click the Refresh License Usage icon ( )

5 Configuring the Management PackAn adapter instance must be added before Vblock system resources can be discovered You can create multiple adapter instances Every adapter instance requires its own System Library host

Configuring the Management Pack includes the following tasks

bull Creating an Adapter Instance bull Adding System Library CAS Credentialsbull Changing the Adapter Collection Interval (optional)

51 Creating an Adapter InstanceYou must create an adapter instance for each System Library host Unless manual discovery selected the adapter automatically discovers resources and begins querying them

511 Before you beginbull Install the Management Pack for VCE Vblock Refer to section ldquo4 Installing the Management Packrdquobull The Adapter connects to System Library hosts using Fully Qualified Domain Names (FQDNs) Check with your VCE Vision Administrator for the appropriate FQDNs

512 Procedure1 Log in to vRealize Operations as an administrator2 Click on the Administration navigation shortcut ( ) The Solutions view should automatically open3 Select lsquoVCE Vision Adapterrsquo from the Solutions list

Figure 5 Solutions List

4 Click the Configure icon ( ) The Manage Solution - VCE Vision Adapter window will appear

Figure 6 Manage Solution Window

NOTE If creating multiple adapter instances click the Add icon ( ) above Instance Name on the left

5 Enter the following information Adapter Settings

bull Display Name A name for this particular instance of the Management Pack bull Description Optional most helpful for describing multiple adapter instances of the Management Pack Basic Settings

bull For the System Library host name type the Fully Qualified Domain Name (FQDN case-sensitive) of the System Library host bull Select true in the Auto Discovery menu to allow auto-discovery of Vblock System components Select false to manually discover and add Vblock System components The Adapter has a predefined list of Vblock System components that are automatically discovered See Discovering objects manually for instructions for manually discovering Vblock System resources bull Select true in the Subscribe to Vblock System Events field to have the Adapter receive and process Vblock System events from System Library bull Select an existing Credential set or click Add icon ( ) to enter new credentials for the System Library CAS administrator See ldquo52 Adding System Library CAS credentialsrdquo for details

52 Adding System Library CAS credentialsUse this procedure to add System Library administrator credentials

521 Before you beginAsk an administrator for the user name and password needed to connect to a System Library host

522 Procedure1 Click Add icon ( ) for the Credential field in Manage Solution - VCE Vision Adapter window

Figure 7 Manage Credential

2 Type the CAS user name in the Credential name field It does not have to match the Adapter instance name 3 Enter your System Library CAS user name and password 4 Click OK to save your credential5 Click Test Connection to ensure vRealize Operations can connect properly to the Vblock system6 Click Save Settings to save your adapter instance configuration

53 Changing the Adapter collection interval (optional)Use this procedure to change the resource data collection interval of the Adapter to match or be less frequent than the collection interval for System Library The default collection intervals are five minutes for the Adapter and fifteen minutes for System Library

531 Procedure1 Under Administration select Environment Overview (Inventory Explorer in vROps 61+) expand Adapter Instances and select VCE Vision Adapter Instance Any VCE Vision Adapter instances are shown in the List tab2 Select an adapater instance and click Edit Object ( )

Figure 8 Adapter Instances gt Edit Object

3 In the Edit Object window that appears enter a collection interval in minutes in the Collection Interval (Minutes) field

Figure 9 Edit Object Window

4 Click OK 5 Edit any other VCE Vision Adapter instances as necessary

6 Objects Managementbull Discovering Objects Manually (if necessary)bull Adding Objects Manuallybull Adding a Maintenance Schedulebull Tagging Resources for Maintenancebull Validating Management Pack Data Collection

61 Discovering Objects ManuallyManual discovery allows you to import and monitor a subset of Vblock System hardware resources Manual discovery can be used if automatic discovery is disabled or if some hardware component groups are excluded from the automatic discovery process Use this procedure to add resources that are not discovered automatically

611 PrerequisitesCreate a Vblock system adapter instance and credential Refer to the previous section 51 Creating an Adapter Instance and Credential for details

612 Procedure1 Log in to vRealize Operations as an administrator2 Click the Administration navigation shortcut ( )3 Click Environment Overview in the navigator pane4 Under Adapter Instances select lsquoVCE Vision Adapter Instancersquo5 Click the Discover Resources icon ( ) to open the Discover Objects window

Figure 10 Environment Overview gt Adapter Instances

Figure 11 Discover Objects

6 In the Discover Objects window select the following informationbull The Collector to use

NOTE Unless you added additional collectors the only available collector is your vROps server

bull lsquoVCE Vision Adapterrsquo for Adapter Typebull The applicable Adapter Instancebull lsquoVblock Discoveryrsquo for Discovery Infobull Which Resource Kinds you want discoveredbull Whether Only New Objects (selectde-select checkbox) should be collected

7 Click OK to start the discovery process

8 The discovery process can take several seconds to several minutes When it has finished the Discovery Results window lists your resources

9 Double-click each resource kind that contains resources to add 10 Select options for each kind of resource (Refer to Table 2)

Table 2 Resource Options

11 Click OK The Discovery Results window closes and the new resources appear

OPTION DESCRIPTION

Import Import the resources but do not start collecting data Resources appear in the resource list as Not Collecting data is not stored analysis is not performed

Collect Import the resources and start collecting data When you select the Collect check box the Import check box is also selected

613 What To Do NextIf you did not select the option to start metric collection when you defined a resource you can start metric collection after the resource is defined To start collecting metrics for a resource choose the resources then click the Start Collecting icon ( )

62 Validating Data CollectionAfter you add an adapter instance you will want to validate the data that it collects in vRealize Operations

621 PrerequisitesAdd an adapter instance Refer to section 51 Creating an Adapter Instance and Credential for details

622 Procedure1 Select the Environment shortcut ( ) 2 Under Inventory Trees select All Objects then expand the VCE Vision Adapter objects list3 Select a resource from the list then click the Troubleshooting tab and All Metrics view to validate values against the data source

Figure 12 Adapter Objects Troubleshooting

63 Adding Objects ManuallyAdding resources manually allows you to add and monitor individual Vblock System resources This is can be used to add a hardware component without waiting for the discovery process to recognize it Use this procedure to add individual resources

631 Procedure1 Select Environment Overview in vRealize Operations Managers Environment menu 2 Click the Add Objects ( ) icon The Add Object Management window appears

Figure 13 Add Object Window

3 Fill out the fields as follows bull Type a Display name bull Type a Description bull Select lsquoVCE Vision Adapterrsquo in the Adapter Type menu bull Select a previously created Adapter instance in the Adapter Instance menu bull Choose a subset of the Vblock System resources in the Object Type menu bull Type a resource ID in the moID field

NOTE The moID is unique ID for each Vblock object More information is available on VCE SDK documentation

bull Enter the Vblock Serial Number To get the serial number connect using your browser to the System Library Host lthttpsltSystemLibraryHostgt8443fmvblockgt After authentication your browser will show an XML file similar to the following

ltvblocksgtltvblockgtltaliasgtVB-720ltaliasgtltdbIdgt8177ltdbIdgtltdescriptiongtVB-720 (Vblock 720w10k)ltdescriptiongtltmoIdgtVB700-975-318642ltmoIdgt ltmodelNamegtVblock 720w10kltmodelNamegtltoperStatusgtcriticalltoperStatusgt

ltserialNumgtVB700-975-318-642ltserialNumgt lt---The Vblock serial number is in bold

bull Specify a collection interval in minutes Leave it blank to accept the default of five minutes bull Choose whether or not to enable dynamic thresholding bull Click OK to add the resource

64 Adding a Maintenance ScheduleYou assign maintenance schedules to resources that are in maintenance mode at specific times which prevents vRealize Operations Manager from showing misleading data based on resources being offline or in other unusual states because of maintenance

641 Procedure1 In the left pane click Administration 2 Select Maintenance Schedules3 From the toolbar click the Add icon ( ) to add a maintenance schedule

Figure 14 Maintenance Schedules selection

4 Fill out the fields as follows bull Enter a name that describes the maintenance schedule bull Select a time of day when maintenance can begin bull Select a time of day when maintenance must stop bull Select the repeatable pattern of days when maintenance occurs within the times already specified bull Click Save

Figure 15 Manage Maintenance Schedules Window

65 Tagging Resources for MaintenanceThe Adapter does not collect metrics for network ports that are offline A network port that is offline is shown as a white box in the Heat Map and its collection state is ldquoNot Collectingrdquo

If a network port is offline for maintenance you can tag it as offline for maintenance instead of simply offline See ldquoCreating and Assigning Object Tagsrdquo in the VMware vRealize Operations Manager 60 Documentation for instructions for creating custom tags for offline network ports You can download the most recent version of the guide from the VMwarersquos documentation site

7 Appendix I Management Pack Folders and FilesThe installer places the Management Pack files in the vcevision_adapter3 folder under the $ALIVE_BASEuserpluginsinbound folder as shown below

Table 3 Management Pack Folders and Files

FOLDERFILE(S) FOLDERFILE(S) DESCRIPTION

conf dashboards (folder) Contains json files for Management Pack Dashboards

describexml Describes the Management Pack

describedtd Used to validate describexml

images (folder) Contains png files for AdapterKind ResourceKinds and TraversalSpec

open_source_licensetxt Open source license file

oss_attributiontxt 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 resourcesproperties file

versiontxt Contains version information

views (folder) Contains xml files for Management Pack Views

libRefer to lib folder for entire list jar files that contain the classes and resources used

to implement the Management Pack

Copyright copy 2016 Blue Medora Inc All rights reserved US 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 andor other jurisdictions

The VCE name (including VCE Vision and Vblock) and logo are trademarks or registered trademarks of VCE Corporation a subsidiary of EMC Corporation in the United States andor other jurisdictions All other marks and names mentioned herein may be trademarks of their respective companies

Blue Medora3225 N Evergreen Dr NE Suite 103Grand Rapids MI 49525wwwbluemedoracom

1 Purpose

2 Installation and Configuration Requirements

3 Licensing Requirements

4 Installing the Management Pack

41 Uploading the Installation File

42 Registering VMware vCenter Servers

43 Adding a License Key

5 Configuring the Management Pack

51 Creating an Adapter Instance

52 Adding System Library CAS credentials

53 Changing the Adapter collection interval (optional)

6 Objects Management

61 Discovering Objects Manually

62 Validating Data Collection

63 Adding Objects Manually

64 Adding a Maintenance Schedule

65 Tagging Resources for Maintenance

7 Appendix I Management Pack Folders and Files

NOTE This document supports the version of each product listed as well as all subsequent versions until a new edition replaces it

1 Purpose 32 Installation and Configuration Requirements 33 Licensing Requirements 34 Installing the Management Pack 4

41 Uploading the Installation File 442 Registering VMware vCenter Servers 643 Adding a License Key 6

5 Configuring the Management Pack 751 Creating an Adapter Instance 752 Adding System Library CAS credentials 953 Changing the Adapter collection interval (optional) 9

6 Objects Management 1161 Discovering Objects Manually 1162 Validating Data Collection 1363 Adding Objects Manually 1464 Adding a Maintenance Schedule 1565 Tagging Resources for Maintenance 15

7 Appendix I Management Pack Folders and Files 16

TABLE OF CONTENTS

412 Procedure

OPTION DESCRIPTION

1 Purpose

412 Procedure

OPTION DESCRIPTION

1 Purpose

412 Procedure

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

OPTION DESCRIPTION

1 Purpose

Documents

VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR VCE Vblock · PDF file3 Blue Medora VMware vRealize Operations Management Pack for VCE Vblock Installation & Configuration Guide 1. Purpose