Copyright © 1995-2015 SolarWinds Worldwide, LLC. All rights reserved worldwide. No part of this document may be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the written consent of SolarWinds. All right, title, and interest in and to the software and documentation are and shall remain the exclusive property of SolarWinds and its respective licensors.
Table of Contents SolarWinds Virtualization Manager Administrator Guide 18 About SolarWinds 18 Contacting SolarWinds 18 Conventions 19 SolarWinds Virtualization Manager Documentation Library 19 Helpful tips and tricks 20 Chapter 1: Introduction 21 Why install SolarWinds Virtualization Manager 22 Key features of SolarWinds Virtualization Manager 23 Chapter 2: Installing SolarWinds Virtualization Manager Minimum requirements 25 25 Browser requirements 25 Virtual appliance requirements
SolarWinds Virtualization Manager Administrator Guide Uninstalling Virtualization Manager 43 Installing the Integrated Virtual Infrastructure Monitor (IVIM) 43 Preparing for the integration of Virtualization Manager 44 Integrating Virtualization Manager for a VMware environment Installing the SolarWinds Integrated Virtual Infrastructure Monitor in standalone mode Integrating IVIM with Virtualization Manager Possible issues during integration 45 47 49 50 Issues with credentials 50 Issues with impor
Table of Contents License management in Virtualization Manager version 6.
SolarWinds Virtualization Manager Administrator Guide Configuring HTTPS access only 80 Enabling Dynamic Memory on Hyper-V 2008 servers 80 Advanced setup 81 User management 82 Setting default dashboards for users 83 Using inventory filters 83 Using labels 84 Configuring SNMP 84 Configuring authentication servers 85 Adding an Active Directory authentication server 85 Adding an LDAP authentication server 86 Synchronizing the time of the AD and LDAP server and the SolarWinds Virtualization
Table of Contents Data rollup 100 Data retention 101 Aggregation 102 Infrastructure aging 102 Chapter 4: Key features 103 Dashboard 103 Explore 103 Capacity planning 104 Search 104 Common capacity management questions 104 How do I find performance bottlenecks? 105 How can I diagnose historic performance issues? 105 How do I create a virtualization capacity plan? 105 How can I solve VM sprawl, reclaim resources, and rightsize my virtual environment? 106 How much would it cost to m
SolarWinds Virtualization Manager Administrator Guide Fitment widget 116 Map widget 117 Notes widget 118 Performance Chart widget 119 RSS Feed widget 119 Top N widget 120 Trend widget 121 Customizing widgets 123 Portal integration 123 SolarWinds Orion server 124 OpenSocial portals 125 Microsoft SharePoint 126 Chapter 6: Business views 127 Trends 127 Trend operations 128 Creating trends 128 Data center visualizer 130 Historical performance analyzer charts 131 Capacity plan
Table of Contents Language syntax 141 Terms 141 Fields 141 Using wildcard searches 141 Using fuzzy searches 142 Using proximity searches 142 Using range searches 143 Using date searches 143 Boosting a term 144 Using Boolean operators 144 Grouping 146 Field grouping 146 Escaping special characters 146 Search query examples 146 Named fields 148 Example search queries 149 Using the query builder 161 Adding new filters 161 Common use cases 162 Chapter 8: Alerts 167 Scope
SolarWinds Virtualization Manager Administrator Guide Example Action 173 SNMP settings 176 Advanced settings 176 Accessing historical alert information 178 Using the Time Travel tool 178 Viewing the history of an alert 178 Viewing alert information for a specific resource 179 Chapter 9: Capacity planning 180 Planning basics 180 Using resource containers 180 Using usage profiles 183 When will I run out? 185 How much more can I add? 186 Calculating VM sizes 188 What if I add more r
Table of Contents Using detailed comparison by category 196 Chapter 11: Dependency maps 197 Using the initial context 197 Setting context 198 Understanding alerts 198 Adding items to a chart 198 Exporting data 199 Adding items to a list 199 Sorting items 199 Using Time Travel 199 Chapter 12: Content 201 Editing content 201 Adding and removing content 201 Importing content 202 Exporting content 202 Content types 202 Tags 204 Modifying the tags of a piece of content 204 Rem
SolarWinds Virtualization Manager Administrator Guide On-demand reporting 209 Scheduled report jobs 210 Downloading reports 211 Configuring schedules 211 Removing report jobs 212 Pausing and resuming report jobs 212 Using custom reports 212 Chapter 15: Custom labels 214 Creating labels 214 Modifying labels 214 Removing labels 215 Chapter 16: Notes 216 Adding notes 216 Viewing notes 216 Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor Account limitations
Table of Contents AppStack Environment View and AppStack Environment resource 229 Creating virtualization alerts in the Orion Alert Manager 229 Creating virtualization reports in the Orion Report Manager 230 Viewing related entities in the Orion web console 231 Viewing storage infrastructure information in the Orion web console 232 Monitoring hardware health in IVIM 233 Chapter 18: Integrated Virtualization Infrastructure Monitor resources 234 Active Virtualization Alerts 234 Applications on
SolarWinds Virtualization Manager Administrator Guide Percent Availability 242 Percent Memory Used 242 Predicted Datastore Space Depletion 242 Predicted VM Disk Depletion 243 Resource Utilization 244 Setup Virtualization Manager Integration 245 Storage Summary 245 Top Datastore I/O Latency 246 Top Datastore IOPS 247 Top VM IOPS 248 Top VM Latency 248 Top XX Datastores by Low Free Space 249 Top XX Hosts by CPU Load 250 Top XX Hosts by Network Utilization 250 Top XX Hosts by Number
Table of Contents Top XX VMs by Storage Consumed 257 Top XX VMs by Underallocated CPU 258 Top XX VMs by Underallocated Memory 258 Top XX VMs by Used Space 258 Usage MHz 259 Virtual Cluster Details 259 Virtual Disks and Related Storage Infrastructure 259 Virtual Machine Details view 260 Virtual Machine IOPS 260 Virtual Machine IOPS and Latency 260 Virtual Machine Latency 261 Virtualization Assets 261 Virtualization Asset Summary 262 Overall 262 VMware 262 Hyper-V 263 Virtualiz
SolarWinds Virtualization Manager Administrator Guide Appendix A: Troubleshooting Hyper-V discovery 269 Why does Virtualization Manager not receive information from Hyper-V Hosts? 269 Testing local WMI services 270 Testing WMI on the target server 270 Resetting the WMI counters 271 Testing remote WMI connectivity 272 Remotely testing WMI on the target server 272 Verifying the administrator credentials 273 Enabling Remote Procedure Call (RPC) 274 Verifying the firewall settings 276 Adding
Table of Contents Installing PowerShell 287 Connecting to Virtualization Manager 288 Searching in Virtualization Manager 288 Using configuration item references 289 Working with the vSphere PowerCLI 289 Cmdlets and scripts 289 Scripts 290 Using cmdlets 292 Appendix C: Using Perl SDK 305 Module installations 305 Downloading the Perl Client 305 Using the Perl Client 306 Writing your first script 306 Scripting tips 308 Using the provided example 308 17
SolarWinds Virtualization Manager Administrator Guide SolarWinds Virtualization Manager Administrator Guide About SolarWinds SolarWinds, Inc. develops and markets an array of IT management, monitoring, and discovery tools to meet the diverse requirements of today’s IT management and consulting professionals. SolarWinds products continue to set benchmarks for quality and performance and have positioned the company as the leader in IT management and discovery technology.
Conventions Conventions The documentation uses consistent conventions to help you identify items throughout the printed and online library.
Helpful tips and tricks Release Notes Provides late-breaking information, known issues, and updates. The latest Release Notes can be found at http://www.solarwinds.com. Helpful tips and tricks l When you are building usage trends from scratch, you can base new trends on already existing ones. Choose a trend under Explore > Content, and then modify the evaluation criteria to suit your needs. For more information about creating trends, see Creating trends.
Chapter 1: Introduction SolarWinds Virtualization Manager offers an easy-to-use, scalable virtualization management solution whose resources can also be integrated with other SolarWinds products on the Orion platform. SolarWinds Virtualization Manager provides visibility into virtual machines and their support infrastructure.
Chapter 1: Introduction Why install SolarWinds Virtualization Manager SolarWinds Virtualization Manager includes the following features and fulfills the following objectives. Search Oriented Provides a search-based introspection of virtualized workloads and the underlying infrastructure that supports them. This holistic view crosses virtual and physical boundaries to consolidate disparate data sources.
Key features of SolarWinds Virtualization Manager Multi-Discipline Facilitates broad problem isolation, forensics, performance management, and capacity and consolidation planning processes over the entire managed infrastructure. Business Views Applies analytics to show data center trends, performance correlations, and pie chart visualizations of your virtual infrastructure.
Chapter 1: Introduction l l l Real-time dashboards for forecasting, detecting, and troubleshooting capacity bottlenecks Integrated capacity planning for VMware and Microsoft Hyper-V Integration with SolarWinds Server & Application Monitor (SAM) and Orion Network Performance Monitor (NPM) l Performance monitoring l Chargeback and showback automation l Virtualization configuration management l Virtualization dashboards l Performance alerts l Performance monitoring and management 24
Chapter 2: Installing SolarWinds Virtualization Manager This topic contains information about the installation and uninstallation procedures for SolarWinds Virtualization Manager.
Chapter 2: Installing SolarWinds Virtualization Manager Software Requirements Supported browsers Internet Explorer 8 or later Mozilla Firefox 3.5 or later Google Chrome 8 or later Adobe Flash Adobe Flash Player 9 or later Virtual appliance requirements The following table contains the virtual appliance requirements for SolarWinds Virtualization Manager. Software or hardware Requirements Virtualization VMware vSphere 4.1 or later software VMware ESX or ESXi 4.
Virtual appliance requirements Software or hardware Requirements l l l vm.processorCount (as a result of the previous two missing properties) host.vSwitch.maxChimneyOffloads (as a result of the missing MaxChimneyOffloads property in the Msvm_ VirtualSwitch class) host.vSwitch.numLearnableAddresses (as a result of the missing NumLearnableAddresses property in the Msvm_ VirtualSwitch class) l l l host.vSwitch.port.
Chapter 2: Installing SolarWinds Virtualization Manager Software or hardware Requirements LANEndpoint l l l Msvm_SwitchPort class replaced by Msvm_ EthernetSwitchPort Msvm_VLANEndpointSettingData class replaced by Msvm_EthernetSwitchPortVlanSettingData Msvm_ResourceAllocationSettingData class replaced by Msvm_StorageAllocationSettingData CPU 2 GHz quad-core Virtual CPUs 4 vCPUs Memory 8 GB or more (For more information, see Memory requirements.
Master appliance l Orion integration l Federated collectors Master appliance Configure the following inbound ports for communication with the Virtualization Manager master appliance. Port Usage 443 or Performing auto-upgrade or version upgrade on federated col80 lectors, if federated collectors are configured.
Chapter 2: Installing SolarWinds Virtualization Manager Port Usage 8983 Access from federated collectors to the master appliance during initial setup. 443 HTTPS access to the Virtualization Manager user interface. 5480 HTTPS access to the Management Console. 61616 For Active MQ master-collector communication. 22 SSH access to the virtual appliance. Configure the following outbound ports, depending on the individual setup and the functions you use. Port Usage 162 Sending SNMP traps.
Federated collector Federated collector Configure the following inbound ports on the federated collector. Port Usage 5480 HTTPS access to the federated collector. 22 SSH access to the federated collector. Configure the following outbound ports on the federated collector. Port Usage 61616 Active MQ master-collector communication. 443 or 80 Performing auto-upgrade or version upgrade.
Chapter 2: Installing SolarWinds Virtualization Manager Port Usage 8983 Access from federated collectors to the master appliance during initial setup. Data collection Depending on the environment you poll, configure the following outbound ports on the master or the collector for data collection. Port Usage 443 Data collection from ESX hosts and vCenters. 7 Access to Hyper-V hosts that were added by using a fully qualified domain name. 135 WMI data collection from Hyper-V hosts or VMs.
Memory requirements Memory requirements SolarWinds Virtualization Manager has the following memory requirements based on the number of hosts and VMs. Number of ESX hosts Number of VMs Memory 100 1000 8 GB 125 1250 10 GB 150 1500 12 GB 175 1750 14 GB 200 2000 16 GB 200 < 2000 < Contact Support The minimum memory requirement is 8 GB, but your deployment may require more to handle peak memory demands.
Chapter 2: Installing SolarWinds Virtualization Manager 117 = 90 + 0.15 x 90 + 0.15 x 90 The number of ESX hosts above is guidance only, and is based on a typical corporate IT virtualization environment with approximately 10 VMs and one datastore per ESX host server. Higher density environments require larger memory sizes. Disk space requirements At least 200 GB of disk space is recommended so that you do not run out of storage too soon.
VMware account permissions e. Increase the Provisioned Size to the size you want. f. Click OK. 2. Restart the appliance virtual machine. To expand the disk on Microsoft Hyper-V, contact SolarWinds Technical Support. VMware account permissions SolarWinds Virtualization Manager can collect data from a VMware environment with any combination of the following: l VMware vSphere 4.1+ l VMware ESX or ESXi 4.
Chapter 2: Installing SolarWinds Virtualization Manager Software/Hardware Requirement evaluation purposes only: Windows 7 Windows 7 SP1 Windows 8 (except Standard edition) Windows 8.1 (except Standard edition) Windows 8.1 Update 1 (except Standard edition) CPU 3.0 GHz RAM 8 GB HDD 20 GB .NET Framework 3.5 SP1, 4.0.
Installing Virtualization Manager on VMware vSphere 4.1 or later the screens available within the vSphere, or Hyper-V client, but can differ slightly based on version. The SolarWinds Virtualization Manager appliance is available in two versions: .ova file for use with vSphere 4.1 and higher Hyper-V .zip file for use with Hyper-V server The following sections describe the typical installation steps and requirements for different versions of the virtual appliance.
Chapter 2: Installing SolarWinds Virtualization Manager free, but you will eventually exhaust this. For more information, see Disk space requirements. 9. Select a network, and then click Next. 10. To use DHCP to determine the IP address of the appliance, click DHCP, and then click Next. 11. To use a fixed IP address from the network pool, follow these steps: a. Click Fixed, and then click Next. b. Enter the fixed IP to reserve for the appliance, and then click Next. 12. Click Finish. 13.
Installing Virtualization Manager on Microsoft Hyper-V Server 2008 Installing Virtualization Manager on Microsoft Hyper-V Server 2008 This topic outlines the installation of SolarWinds Virtualization Manager as a Microsoft Hyper-V virtual appliance on Windows Server 2008. The interfaces described are a representation of the screens available within the Hyper-V Manager, but can differ slightly based on version. The Windows server must already be configured as described in Minimum requirements.
Chapter 2: Installing SolarWinds Virtualization Manager 11. Click OK. 12. Start the VM. 13. Right-click the virtual appliance in the inventory, and then click Connect. 14. Select Set Timezone and ensure that the appliance is set to the same time zone as the Hyper-V host server. 15. Use the arrow keys to select Configure Network, and then press enter. 16.
Installing Virtualization Manager on Microsoft Hyper-V Server 2012 Installing Virtualization Manager on Microsoft Hyper-V Server 2012 This topic outlines the installation of SolarWinds Virtualization Manager as a Microsoft Hyper-V virtual appliance on Windows Server 2012. The interfaces described are a representation of the screens available within the Hyper-V Manager, but can differ slightly based on version. The Windows server must already be configured as described in Minimum requirements.
Chapter 2: Installing SolarWinds Virtualization Manager 14. Right-click the virtual appliance, and then select Settings. 15. Select Network Adapter. Note: Using a Legacy Network Adapter may cause degradation in network connection: the web application might become inaccessible or the SSH connection may break down. To verify that your network adapter is working correctly, connect to the Virtualization Manager appliance by using the Hyper-V Manager, and then run the ifconfig command.
Uninstalling Virtualization Manager e. Enter the DNS Server 2. f. Enter a host name to use for the virtual appliance. g. Click Save Settings. 26. Click Proxy and enter proxy server information if necessary, and then click Save Settings. Uninstalling Virtualization Manager This topic outlines the uninstallation procedure of Virtualization Manager. Warning: The deletion is irreversible. Deleting the master appliance also deletes the database.
Chapter 2: Installing SolarWinds Virtualization Manager Web Console for SolarWinds Network Performance Monitor (NPM) or SolarWinds Server and Application Monitor (SAM). The following graphic shows the ports that are required for the integration to work properly. Preparing for the integration of Virtualization Manager Orion platform products poll for managed nodes to update status information. Depending on your polling method and Virtualization Manager environment, you may get different results.
Integrating Virtualization Manager for a VMware environment Integrating Virtualization Manager for a VMware environment In getting Virtualization Manager data for a specific virtual machine, IVIM presents Virtualization Manager with an identifier, asking for the virtual machine that matches. The identifier of IVIM is different from the identifier of Virtualization Manager.
Chapter 2: Installing SolarWinds Virtualization Manager For information about installing NPM, see the SolarWinds Network Performance Monitor Administrator Guide. For information about installing SAM, see the SolarWinds Server and Application Manager Administrator Guide. Note: If you do not have NPM or SAM installed, you can integrate IVIM with your Virtualization Manager instance.
Installing the SolarWinds Integrated Virtual Infrastructure Monitor in standalone 3. Under Virtualization Discovery, click Discover My Network, and then complete the wizard. 4. Click Settings > Virtualization Settings. 5. Click Setup Virtualization Manager Integration. 6. Enter the appropriate information about your Virtualization Manager instance. a. Enter the host name or IP address of the Virtualization Manager server.
Chapter 2: Installing SolarWinds Virtualization Manager To install the SolarWinds Integrated Virtual Infrastructure Monitor in standalone mode: 1. Log on as an administrator to the SolarWinds server on which you want to install the SolarWinds Integrated Virtual Infrastructure Monitor. 2. Launch the executable file. l l If you downloaded the product from the SolarWinds website, navigate to the download location, and then launch the executable file. You may need to run the file as an administrator.
Integrating IVIM with Virtualization Manager 8. Select the file system folder where you want to install SolarWinds Integrated Virtual Infrastructure Monitor, and then click Next. 9. Click Next on the Start Copying Files window. 10. Click Finish to close the installation wizard. 11. The SolarWinds Configuration Wizard is launched automatically. Click Next on the Welcome window to continue the basic configuration.
Chapter 2: Installing SolarWinds Virtualization Manager 2. Click Submit. Possible issues during integration During the integration process of Virtualization Manager and the SolarWinds Orion server, both applications keep running, and changes may occur in both environments, for example, nodes or data sources can be added or deleted. In these cases, it may happen that the data collected at the beginning of the synchronization process is no longer valid.
Issues with importing nodes to the SolarWinds Orion server Error message Explanation Could not use credentials from Vir- This message indicates a general error. tualization Manager/Orion. Check the error log for more information. Issues with importing nodes to the SolarWinds Orion server Error message Explanation Could not import node to Orion.
Chapter 2: Installing SolarWinds Virtualization Manager Error message Explanation Reconfiguring node to poll from parent Virtual Center failed. If there is a change in Virtualization Manager or in the SolarWinds Orion server during the integration process, the integration data becomes invalid. Reset the integration process to load valid data. If the issue persists, check the error log for more information.
Managing nodes in the Orion Web Console Error message Explanation to node [NAME] ([IP_ADDRESS]). + ERROR MESSAGE error message returned by the Probe job provides more details. Managing nodes in the Orion Web Console If you manage a node in the Orion Web Console as an addition to managing it in Virtualization Manager, you can make use of the following features: l l The ability to monitor CPU, Memory, Virtual Memory, Response Time, and Latency. The ability to assign Custom Properties to nodes.
Chapter 2: Installing SolarWinds Virtualization Manager l l Leverage the Real-Time Event Log Viewer, the Real-Time Process Explorer, and the Service Control Manager. Use network interface monitoring (for Windows only). Upgrading an existing virtual appliance To upgrade from Virtualization Manager 5.x to 6.x, you must first upgrade to Virtualization Manager 5.1.1, and then upgrade to 6.x from that version.
Upgrading on Hyper-V 6. Open a browser to https://ip_address:5480 where ip_address is the IP address or name of the SolarWinds Virtualization Manager VM. 7. Log in to the website using your SolarWinds Virtualization Manager credentials. 8. Click the Update tab. 9. Click Check Updates. 10. Click Install Updates, and then click OK. Note: If Virtualization Manager displays odd behavior after an upgrade, you may need to clear the browser cache. Upgrading on Hyper-V The appliance upgrade comes as an .
Chapter 2: Installing SolarWinds Virtualization Manager 10. Log on to the website using your SolarWinds Virtualization Manager credentials. 11. Click the Update tab. 12. Click Check Updates. 13. Click Install Updates, and then click OK. Note: If Virtualization Manager displays odd behavior after an upgrade, you may need to clear the browser cache.
Activating the license 3. Select hyper9-config-jaas.conf, and then click Edit. 4. Replace all of the existing content with the following, and then click Save. hyper9 { com.hyper9.security.auth.Hyper9AuthLoginModule required debug=true; }; h9kerberos { com.sun.security.auth.module.Krb5LoginModule required client=TRUE refreshKrb5Config=TRUE; }; 5. Click Restart, and then click Confirm Restart. 6. Log on to the regular SolarWinds Virtualization Manager website. 7.
Chapter 2: Installing SolarWinds Virtualization Manager in Activating a license key offline to manually upload your license, or contact SolarWinds Customer Service to reset your activation. Solving upgrade issues The following issues may occur during and after the upgrade procedure. Historical data is unavailable during the search index rebuild After the upgrade process has completed, the database search index is rebuilt.
Migrating from an existing virtual appliance to a new virtual appliance Migrating from an existing virtual appliance to a new virtual appliance With the migration tool you can move your data from an existing instance of Virtualization Manager to a new virtual appliance. Note: If the existing database is larger than 60 GB and you are migrating to a thinprovisioned virtual machine, ensure that the provisioned disk size is large enough to accommodate the data.
Chapter 2: Installing SolarWinds Virtualization Manager 7. Enter the host name or IP address of the existing virtual appliance that you are migrating from in the text field of Step 2. 8. Click Perform Migration. The migration tool moves your information to the new virtual appliance. Installing, updating and uninstalling a federated collector By using a federated collector, you can split the data collection tasks of SolarWinds Virtualization Manager between one or more remote servers.
Installing a federated collector Installing a federated collector The federated collector is distributed as a VMware virtual appliance OVF template. To deploy and configure a federated collector: 1. Extract the contents of the Collector .zip archive file. 2. In the VMware client, deploy the new federated collector appliance from the OVF template in the same way you deploy a SolarWinds Virtualization Manager server.
Chapter 2: Installing SolarWinds Virtualization Manager For more information, see Configuring data sources. Updating a federated collector Any federated collectors from versions earlier than 4.0 must be shut down and replaced with the new federated collector. To prevent having to remap existing collections to the new collector, reuse the previous Collector Display Name for the new collector. To keep the same display name for the new collector: 1. Log on to the VMware client as an administrator. 2.
Uninstalling a federated collector 12. In the Collector Hostname field, enter the host name you want to use for this collector. 13. In the Collector Display Name field, enter the display name of the previous collector. 14. In the SolarWinds Virtualization Manager Server Address field, enter the host name or IP address of the main SolarWinds Virtualization Manager. 15. Click Configure Now.
Chapter 2: Installing SolarWinds Virtualization Manager The section contains information about the following topics: l License management in Virtualization Manager version 6.2 l License management starting from Virtualization Manager version 6.1 l Using licenses from previous versions l Viewing your licensing status l Activating a license key online l Activating a license key offline l Excluding hosts from monitoring License management in Virtualization Manager version 6.
Activating the license on Virtualization Manager integrated with the SolarWinds 1. Install or upgrade the Virtualization Manager appliance. For installation instructions, see Installing Virtualization Manager as a virtual appliance, for upgrade instruction, see Upgrading an existing virtual appliance. 2. Activate the primary license key on the appliance. For license activation instructions, see Activating a license key online or Activating a license key offline.
Chapter 2: Installing SolarWinds Virtualization Manager Note: You can also activate the primary license key on the SolarWinds Integrated Virtual Infrastructure Monitor, and the secondary license key on Virtualization Manager. Upgrade: 1. Upgrade the Virtualization Manager appliance. For upgrade instructions, see Upgrading an existing virtual appliance. 2. Install the SolarWinds Integrated Virtual Infrastructure Monitor.
Activating the license on Virtualization Manager integrated with SolarWinds NPM 3. Activate the primary license key on Virtualization Manager. For license activation instructions, see Activating a license key online or Activating a license key offline. 4. Activate the secondary license key on the SolarWinds Orion server. Note: You can also activate the primary license key on the SolarWinds Orion Server, and the secondary license key on Virtualization Manager.
Chapter 2: Installing SolarWinds Virtualization Manager Upgrade: 1. Upgrade SolarWinds NPM or SolarWinds SAM. For upgrade instructions, see Upgrading SolarWinds Network Performance Monitor or Upgrading SolarWinds Server & Application Monitor. 2. Upgrade Virtualization Manager. For upgrade instructions, see Upgrading an existing virtual appliance. 3. Activate the primary license key on Virtualization Manager.
Using licenses from previous versions To modify the default settings: 1. Navigate to Setup > Advanced Setup. 2. Click System Properties. 3. To modify the default license update checking frequency, click in the Value column next to license.synchronizer.check.frequency. The minimum frequency is 24 hours. 4. To disable automatic license synchronization, click in the Value column next to license.synchronizer.enabled, and then set the property to false.
Chapter 2: Installing SolarWinds Virtualization Manager Activating a license key online If you can access the SolarWinds website from a computer that can also access SolarWinds Virtualization Manager, you can activate your license key online. To activate a license key online: 1. Log on to the SolarWinds Customer Portal at https://customerportal.solarwinds.com. 2. Under Licensing & Maintenance, click License Management. 3. Locate an unregistered Virtualization Manager activation key in your license list. 4.
Activating a license key offline 8. Copy the Activation Key from the Customer Portal, and then paste it into the Activation Key field of the SolarWinds Virtualization Manager License Information page. 9. In the Computer Name field, type localhost. 10. Provide your name, company name, email address and phone number. 11. Click Send Activation Request.
Chapter 2: Installing SolarWinds Virtualization Manager 12. Click Generate License File. 13. Click the license download link to download the license file. 14. Transfer the license file to the computer you are using to access SolarWinds Virtualization Manager. 15. Click Upload License File. 16. Select your license file, and then click Open.
Chapter 3: Administration and setup This topic contains information about administration and setup activities in two parts: Basic setup Basic setup is the process required to initiate the first Data Collection operations to populate the data repository. Data Collection is the enumeration of objects, such as VMs, on data sources, such as vCenter Servers or ESX hosts, and the process of gathering configuration and sample data from the enumerated objects.
Chapter 3: Administration and setup To run the Configuration Wizard: 1. Log on to SolarWinds Virtualization Manager. 2. Click Setup. 3. Click Configuration Wizard on the left menu. Filling in the SolarWinds registration The first step in basic setup requires you to register your software. Enter the email address you provided when registering to download the software. A valid email address is required to continue.
Configuring data sources l Username: The login name or user ID of the account. This is usually root, administrator, or some domain administrator account. l Password: The password for the given user name. l Domain: A domain associated with the credentials. l Description: A description of the credential set. After you entered the necessary information, click Save to add the credential to the Credential Pool. This returns you to the Credentials screen.
Chapter 3: Administration and setup l l Collector: If you have set up a federated data collector to use for this collection, select the federated collector. In other cases, select localhost. Validate Connections: An optional step to confirm that the data source is reachable. If you selected Hyper-V, provide the following information: l Group Name: A description of the Hyper-V host groups. l Network Address: The static IP address or fully qualified domain name of the data source.
Infrastructure aging Note: Configuration jobs should not occur more often than once per hour. For all practical purposes, the default setting of collection once every 12 hours is sufficient. Sample schedules default to run every 10 minutes and this is fast enough for most practical applications. For each collection schedule, you can modify the following information by clicking Change Schedule: l l l Start Time: Indicates the date and time from which to begin the data collection job.
Chapter 3: Administration and setup Active VMs Virtual machines which are accessible for data collection and are registered with their hosts or Virtual Center. This is the normal state for virtual machine records. These machines are searchable in the current and historical time frames. Stale VMs Virtual machines which are either inaccessible for data collection or unregistered with their hosts or Virtual Center for the defined "Active to Stale" interval.
Configuring the Storage Manager installation details l l l Authentication Password: The password for the email account used to send emails from this SMTP server. From Address: Sent emails arrive from this email address. Email Subject Prefix: Sent emails have this text as the beginning of their subject line. More text will be added after this prefix to describe the purpose of the email. Click Next after entering this information.
Chapter 3: Administration and setup At the end of the Configuration Wizard, the Configuration Summary screen is displayed. This screen displays the data collection schedules that are in progress and provides information about how the collections are performing.
Advanced setup 5. Under Memory Management, click Dynamic. 6. Set the amount of memory for Startup RAM and Maximum RAM. 7. Turn on the virtual machine. 8. If the guest operating system is Windows 7, log on to the virtual machine to complete the configuration. Advanced setup The yellow Advanced Setup link on the left menu of the Administration page opens the advanced setup menu.
Chapter 3: Administration and setup l l Configuring a mail server to send email alerts Configuring SNMP traps to integrate with a third party systems management tool l Configuring low-level system properties l Initiating tasks that perform maintenance You can accomplish these tasks by selecting their corresponding menu item under Advanced Setup on the Configuration page. User management To control user access to SolarWinds Virtualization Manager, select the Users menu option.
Setting default dashboards for users l Email: The email address for the user. l Description: A brief description of the user. Click Save to finish the process. Click Edit to edit the full name, email address, and description of the selected account. Click Change Password to enter and verify a new password for the selected account. Setting default dashboards for users New users get the standard default dashboards of SolarWinds Virtualization Manager.
Chapter 3: Administration and setup 3. Enter the Network address and Mask for your new inclusion list. 4. Click Save. You can add as many filters as you want to include multiple ranges of IP addresses. Using labels The Labels configuration page provides you with a quick way of creating a series of custom labels that you can apply to VMs and hosts. To create a label, click Add Label. For more information, see Custom labels.
Configuring authentication servers After saving a new Trap Host, click Send Test Trap to test the integration. SNMP trap receivers may need details of the Manager alert MIB (Management Information Base). Click MIB to view the entire SolarWinds Virtualization Manager MIB. Configuring authentication servers In the Authentication Server configuration page you can configure the Active Directory servers (Domain Controller), or LDAP servers that are used to authenticate Active Directory (AD) or LDAP users.
Chapter 3: Administration and setup 8. Optionally, to test the IP address of the server for connectivity, select the Validate Connections check box. 9. In the Realm Name field, type in uppercase the realm configuration name that was used when setting up the Active Directory server. You can obtain the realm name from your Active Directory administrator. 10. Click Save. Note: If you cannot log on, check the log file, and look for the following error message: [http-8080-5] INFO com.hyper9.security.auth.
Synchronizing the time of the AD and LDAP server and the SolarWinds 8. Optionally, to test the IP address of the server for connectivity, select the Validate Connections check box. 9. In the Search Filter field, type the LDAP query filter you want to use to map user accounts to the LDAP server entries. For example: (cn=*). 10. In the Search Base field, type the portion of the directory tree you want to search for LDAP users. For example: dc=example,dc=com. 11.
Chapter 3: Administration and setup 4. Click Edit Configuration. 5. Select ntp.conf, and then click Edit. 6. Customize the NTP settings, and then click Save. Adding AD and LDAP users to SolarWinds Virtualization Manager To automatically add the AD or LDAP users who log on to SolarWinds Virtualization Manager as authorized users, select Auto create New Users upon Authentication.
Editing system properties successive data collection jobs. The Active to Stale Interval defines the number of hours before a virtual machine goes from Active to Stale state. The Stale to Decommissioned Interval defines the number of hours before a virtual machine goes from Stale to Decommissioned state. create.private.content.only This property defines whether non-admin users can create content that is world readable and world writable.
Chapter 3: Administration and setup collection.vmware.skip_storagepath_samples If the value of this property is set to true, the storagePath related samples will not be collected in a VMware environment. Turning off the collection of storagePath samples results in improved performance. List of properties that may not be edited The following list contain system properties that should NOT be modified unless you are instructed to by SolarWinds Technical Support.
Configuring system maintenance Perform DNS Resolution to Validate VMs Dictates whether a reverse DNS lookup occurs before collecting data from VM guests. This setting is deprecated. data.multiplication Used for scalability testing and should NEVER be changed in a deployed system. Configuring system maintenance The System Maintenance configuration page contains functions for enhancing, maintaining, and troubleshooting the SolarWinds Virtualization Manager server.
Chapter 3: Administration and setup The following modules are available: l Add to App l View Notes l Export l Compare l Add to Chart l Map l Label l Plan l View Collected Data For example, if you right-click a virtual machine, and then click SolarWinds > Add to Chart, vSphere opens a performance analyzer window for that virtual machine. This plug-in also adds a SolarWinds option to the Management panel.
Configuring server logging Configuring server logging On the Server Logging configuration page you can enable debug-level verbose logging for several categories of loggable events. Reserve debug logging for troubleshooting only, as debug-level logging can fill up a disk very quickly. To enable debug-level logging, click Choose a Logging Category, and then select a category from the list. To disable debug-level logging, select a category in the Enabled Debug Logging Categories section, and then click Clear.
Chapter 3: Administration and setup Inexperienced users could cause serious damage to the system. When a user leaves the company, or otherwise should no longer have access to the root account, the system administrator should change the root password. Adding a self-signed SSL certificate To add a self-signed SSL certificate, perform the following steps. 1. Log on to the virtual appliance by using the console or an SSH connection. 2. Enter the following command: sudo su - root. 3.
Adding a self-signed SSL certificate If you do not use the domain name for the name, you will continue to receive certificate errors. 7. Type yes when prompted to confirm your new key information. 8. When prompted for the key password, enter the keystore password you entered before. 9. Modify the owner of the keystore by entering the following command, where mykeystore is the name of your keystore: chown hyper9.hyper9 /etc/hyper9/mykeystore 10.
Chapter 3: Administration and setup self-signed certificate. To preserve your configuration, create a backup of the server.xml file located in /usr/share/tomcat-X/conf under a different name (for example, server.xml.beforeupgrade). 15. Restart Tomcat by entering the following command: service tomcat6 restart If you receive "Untrusted site" errors after adding your certificate, see the KB article about Accepting an Unsigned Certificate.
Adding a certificate from a certificate authority l Your domain name instead of the first and last name l The name of your organizational unit l The name of your organization l The name of your city or locality l The name of your state or province l Your two letter country code 7. Enter yes when prompted to confirm your new key information. 8. When prompted for the key password, enter the keystore password you entered before. 9.
Chapter 3: Administration and setup 16. Import the new certificate be entering the following command, where mykeystore is the name of your new keystore and certificate_filename is the name of your certificate: keytool -import -alias tomcat -keystore mykeystore -file certificate_filename 17. Navigate to /usr/share/tomcat-X/conf, and create a backup of the server.xml file. 18. Open the server.xml file. 19. Edit the connector entity to include the keystore location.
Sample collection in a VMware environment Configuration data includes properties such as CPU speed, CPU or network interface count, and host name. By default, configuration data is collected in 12 hour intervals. Performance data includes properties such as total latency, CPU idle, and throughput. By default, performance data is collected in 10 minute intervals. Performance data is collected for new data sources immediately, but is not displayed until configuration data is collected.
Chapter 3: Administration and setup Virtualization Manager also calculates peak sample values. Peak values are the maximum values from the 20 second samples. For example, if the default 10 minute data collection interval is used, the peak value is the maximum value from the 30 values received in the previous 10 minutes. The sample values collected every 20 seconds are not stored in Virtualization Manager, because they represent a big amount of data.
Data retention l l l l l Hourly Rollup (peak): The highest values from the data collected during the last hour. Daily Rollup (peak): The highest values from the hourly rollups during the last 24 hour period. Weekly Rollup (peak): The highest values from the daily rollups during the last seven days. Monthly Rollup (peak): The highest values from the daily rollups during the last calendar month. Quarterly Rollup (peak): The highest values from the monthly rollups during the last quarter.
Chapter 3: Administration and setup Period Default retention period Latest values (raw data) 14 days (configurable) Hourly rollup 90 days (configurable) Daily rollup Indefinite Weekly rollup Indefinite Monthly rollup Indefinite Yearly rollup Indefinite Aggregation Aggregation combines the performance data collected during the same time across your virtual environment.
Chapter 4: Key features SolarWinds Virtualization Manager is a comprehensive virtual environment management solution that helps you solve VM sprawl, identify performance bottlenecks, plan for changing capacity requirements, and illustrate showback and chargeback. Virtualization Manager is pre-populated with industry best practice-based tools to enable you to more efficiently manage your virtual environment.
Chapter 4: Key features l What did my environment look like in the past? l What details are collected per resource? l How similar are two resources? Capacity planning By using the Capacity Planner tool you can create capacity plans. You can create what-if scenarios, visualize how long you can continue with your current load, or plan when to procure new resources.
How do I find performance bottlenecks? How do I find performance bottlenecks? Bottlenecked areas, where a single or limited number of items restrict the performance of a resource, can be identified using the administrator dashboard, alerts, or the Capacity Planner. The administrator dashboard hosts widgets that monitor various performance contention metrics such as CPU, memory, disk, I/O, and storage metrics. By using the dashboard, you can quickly view which areas per resource may need to be addressed.
Chapter 4: Key features How can I solve VM sprawl, reclaim resources, and rightsize my virtual environment? Virtualization Manager includes a VM sprawl dashboard that displays the number of unused, oversized, and undersized VMs over time along with other metrics useful in effectively utilizing your virtual environment. You can use business views to gather more information about which resources are overallocated and underallocated, which VMs are sized incorrectly, and which VMs are stale.
How much would it cost to move my virtual infrastructure to Amazon EC2? (/virtualMachine/memory <= 1740.8 and /virtualMachine/cpuCount <=5) then 211.7 else if (/virtualMachine/memory <= 7680 and /virtualMachine/cpuCount <=4) then 350.4 else if (/virtualMachine/memory <= 17510.4 and /virtualMachine/cpuCount <=6.5) then 452.6 else if (/virtualMachine/memory <= 15360 and /virtualMachine/cpuCount <=8) then 700.8 else if (/virtualMachine/memory <= 7168 and /virtualMachine/cpuCount <=20) then 846.
Chapter 5: Dashboards Dashboards form a single pane of glass to highlight important information about your virtual environment. Dashboards are customizable. SolarWinds Virtualization Manager contains a number of default dashboards. Depending on your data sources, not all dashboards are available. To view a different dashboard, select it from the More Dashboards list.
Chapter 5: Dashboards Admin - Desktop Provides a high level view of VMs running a desktop OS and related infrastructure. Administrator Provides a quick view of alerts, depleted resources, and virtual environment health for VMware, Hyper-V, or mixed environments. Capacity Planning Provides details about resources that are nearly depleted, and provides an overview of the capacity in the virtual infrastructure.
Dashboard basics Dashboard basics You can always return to the dashboards by clicking the logo at the top left of the SolarWinds Virtualization Manager application or by using the Recent tab to navigate to the dashboard. To view a different dashboard, select it from the More Dashboards list. To create a new dashboard, click New Dashboard. After naming the new dashboard, it is displayed as an empty dashboard.
Chapter 5: Dashboards Each dashboard contains a final widget with a blue plus sign (+) which you can click to add a new widget to the dashboard. This walks you through the configuration of the new widget depending on its type. Configuration options for each type of widget are covered in the following sections. Dashboards are another type of content in SolarWinds Virtualization Manager. You can view and manage all of your dashboards in the Content Manager.
Opening related content l Edit widget: Edit the options and properties of the widget. In most widgets you can configure the data columns that are displayed in the widget from the Columns tab. Other configurable options and properties are covered in the widget descriptions. l Export as PNG: Create a graphics file of the current widget state. l Resize: Resize the widget. l Copy Widget Link: Create a URL for the widget and copy the URL to the clipboard.
Chapter 5: Dashboards l Notes widget l Performance Chart widget l RSS Feed widget l Top N widget l Trend widget Alert Monitor widget By using Alert Monitor widgets, you can view some or all of the alerts configured in SolarWinds Virtualization Manager. Alerts are another form of content in the SolarWinds Virtualization Manager system. The bulk of the configuration for an Alert Monitor widget is similar to picking content for a Content Viewer widget. To add a new Alert Monitor widget: 1.
Consumption widget the Content Manager, and then select only that tag. 5. Save the alert. The only custom control for an Alert Monitor Widget is the Refresh link at the top of the widget. This reloads the alerts with their current status. Consumption widget Consumption widgets show the remaining virtualization resources based on the default usage profile and the default resource container. You can change both the resource container and the usage profile.
Chapter 5: Dashboards All content in SolarWinds Virtualization Manager has a type, tags, and an owner. To add a new Content Viewer widget, click the blue plus (+) widget at the end of every dashboard to add the widget manually. Select the type of content and optionally select the content with a given tag to display. Then choose an attribute to sort the content by.
Fitment widget You can also click the blue plus (+) widget at the end of every dashboard to add the widget manually. In this process, you are prompted for the Search Query from which you want to facet, and the type of entity (VM, host, datastore, cluster, or application) to search. You can enter the search query manually or load a saved query by using the Load query link. Next, select the facet property that will break down the search results into pie sections.
Chapter 5: Dashboards Fitment widgets are driven by a supply side and a demand side. The supply side is a Resource Container and defines the computing resources that are available in one or more hosts or all the hosts in one or more clusters. The demand side is called a Usage Profile and it defines the set of VMs that utilize the computing resources. For more information, see Capacity planning.
Notes widget The default map widget view displays all available VMs, hosts, datastores, clusters, and applications. To switch object types, click the object counter at the bottom. Widget options Click > Edit Widget to change the context. Open related Click to open the large map view with the current context. The Refresh link at the top of the widget reloads the list of content in the widget in case more has been created since the dashboard was last refreshed.
Chapter 5: Dashboards Performance Chart widget By using the Performance Chart widget you can place metrics on your dashboard. Note: New chart widgets are empty until you configure the chart details in the options. Widget options Click > Edit Widget > Chart to select the asset type, the asset, and the metric. Open related Click to plot the current metric on the larger chart view. RSS Feed widget By using the RSS Feed widget you can view any RSS feed on the dashboard.
Top N widget To configure the RSS Feed Widget, click the blue plus (+) widget at the end of a dashboard, and then provide the URL of the RSS feed you want to view in the widget. Click Save to view your new widget. The only custom control on the RSS Feed widget is the Refresh link at the top. Click this link to get a fresh version of the RSS feed and refresh the widget with new content.
Chapter 5: Dashboards To configure a Top N widget, click the blue plus (+) widget at the end of a dashboard to add the widget manually. Then specify the title of the widget, select the type of entity to display, and enter the search query used to get those items. This lets you see all or just a subsection of your virtual environment. You can enter the search query manually, or load a saved query by using the Load query (optional) link.
Trend widget Multi-trend tables provide a tabular view of trend data: To create a new Facet Historical Chart widget, find the trend in the Business Views section of SolarWinds Virtualization Manager. When you are viewing the trend, click Add Widget in the top right of the screen to save the trend as a widget. Pick the dashboard in which you want to place the widget, and then click Save. You can also click the blue plus (+) widget at the end of a dashboard to add the widget manually.
Chapter 5: Dashboards l Trailing Window (days): The amount of history to show on the historical chart. On the Trends tab, click Add Trend to add one or more trends. You can filter the list of trends by tag, ownership, or by a search term. For Historical Charts, you can choose to View the trend in detail. This launches into the trends of Business Views and displays a full screen version of the trend. Customizing widgets You can customize widgets from existing widget types.
SolarWinds Orion server This option provides a direct URL to a read-only view of the widget as well as the HTML source code to embed the widget in another web page. The URL is valid for the specific widget spot, not for the specific widget. For example, if you get the URL for the first widget, which could be a Top-N widget, and then you later put a Trend widget in the first spot, the URL will show the Trend widget. When you embed widgets in other HTML pages, provide at least 354 pixel width.
Chapter 5: Dashboards 6. Group the available resources by type, and then select Custom Resources. 7. Select Custom HTML, and then click Add selected resources. 8. Click Done in the Customize Page screen. 9. Click Edit on the Custom HTML widget. 10. Paste the HTML code copied from Virtualization Manager. 11. Click Submit. OpenSocial portals The OpenSocial dashboard standard of Google is a common way to share gadgets.
Microsoft SharePoint l Widget Token: This field is for the unique token for the widget. This is the last section of the widget URL after the = symbol. 3. Click Save to display the gadget. The result is a Virtualization Manager widget inside an OpenSocial portal. Microsoft SharePoint Microsoft SharePoint restricts flash content that can be placed into a generic HTML page editor. Complete the following steps to add the widget flash movie to your SharePoint page as a Web Part.
Chapter 6: Business views Business Views provide graphical representations of virtual infrastructure trends, historical performance, and make-up. They give a high level overview of the current performance and composition of your data center so that you can make business decisions about capacity planning, chargeback, and system security.
Chapter 6: Business views within each search result. You can change the default four hour interval to run searches more or less often, but this value typically should be the same as the configuration collection interval, because most trends are based on configuration data. You can change the default interval for the Hourly Interval for Trend Execution property in the System Properties screen. For more information, see Configuring system properties.
Creating trends To avoid building trends from scratch, you can base new trends on already existing ones. Choose a trend under Explore > Content, and then modify the evaluation criteria to suit your needs. The Trend creation screen consists of the following tabs: l l Scope: On this tab, the item type is automatically selected, and the Search Query field is pre-populated according to the search query you used. Criteria: To trend the number of search results over time, select Search result count.
Chapter 6: Business views segmentation for the operating system so that you see one trend line per segmenting value. After you finished setting up the details of the new trend, click Preview at the bottom of the screen to see the set of values that will be saved as trend values if you decide to run the trend. If the preview shows that the trend is set up correctly, click Save to persist the trend with a new name and an optional description, and begin tracking data center changes.
Historical performance analyzer charts display how an individual pie section breaks down according to a custom label. For example, if you have a custom label defined for each department, you can see the breakdown of the pie section according to this label by completing the following steps: 1. Click a pie section in the vm.host.hostname facet. 2. Select the "Department" custom field in the top left. 3. Click Apply.
Chapter 6: Business views l Net Packets Rx l Net Packets Tx To view data for any object, select one or more objects, and then click Add to Chart. This takes you directly to the performance chart. To add additional lines for comparison: 1. Click Add Line in the leftmost portion of the Performance Analyzer. 2. Select the line from the list. To change the time frame of the chart, click the start and end dates at the bottom of the Performance Analyzer.
Historical performance analyzer charts l : Click this control to view the individual component values that determine the overall value of this line. For example, viewing the component values for CPU usage displays the individual vCPU cores. If the line is made up of multiple components, only eight components are displayed on the chart. l : Click this control to view the component values as a stacked chart.
Chapter 6: Business views Capacity planning All lines on the performance charts include an optional "best fit" line that shows a flat line which best fits the points for that metric. To see the best fit line, select the Best Fit option at the top of the chart. The best fit line is based on a classic least squares linear regression calculation of the data points. It is only meaningful if there is an underlying long term trend in resource utilization.
Overlays l Config Collections: Displays an overlay of the configuration collection times. l Notes: Displays an overlay of notes. l Alerts: Displays a historical overlay of alert notifications.
Chapter 7: Search The search engine of Virtualization Manager has been specifically tailored to handle the challenges posed by searching large, in-depth, unstructured information sets, such as the data created from an operational virtualized environment. You can create search queries for any items of interest within the entire scope of the virtualized environment.
Chapter 7: Search performance, and utilization of the virtual infrastructure. This data repository is queried by the search service of Virtualization Manager, and the data is available for analysis. Several items on the dashboard perform a search and show results on the search page. The query for the search is pre-populated in the search bar. Many times, you can edit this search to modify the results. However, you can also create search queries from scratch.
Search details To save an executed search query: 1. Click Save as at the bottom of the main interface. 2. Specify the name, description, tags, and permissions for the search. Use the permission settings to specify the sharing of the search query with other Virtualization Manager users. You can choose from the following permission types: l Private: Only the user saving the search query has access. l World Writable: All users can view and modify the query. l World Readable: All users can view the query.
Chapter 7: Search Search result actions Select the check boxes next to one or more search result to see the available actions that you can execute on them. The action buttons launch into a new module of Virtualization Manager with the selected search results in context. The possible actions are the following: l Add to List: Adds the search results to the Active List. l Add Note: Places a custom note on the selected search results.
Search language basis for other activities, such as creating trends, alerts, or performance charts, or for data export, select an action. The search query actions are the following: l Create Alert: Creates a new alert based on the search query. l Trend Results: Creates a new trend based on the search query. l l l Export Results: Creates a spreadsheet of properties from the search results in the Data Export module. Plan: Creates a capacity plan from the search results.
Chapter 7: Search Language syntax The following sections contain information about the Virtualization Manager search query language elements, and about their usage. Terms There are two types of terms: single terms and phrases. A single term is a single word such as "vm" or "west". A phrase is a group of words surrounded by quotation marks, such as "vm west". You can combine multiple terms together with Boolean operators to form a more complex query.
Using fuzzy searches search looks for terms that match the search term with the single character replaced. For example, to search for "ESX3.0.1" or "ESX3.0.2" you can use the following search: ESX3.0.? Multiple character wildcard searches look for 0 or more characters. For example, to search for ESX, ESX3.0.2 or ESX3.5, you can use the following search: ESX* You can also use wildcard searches in the middle of a term.
Chapter 7: Search Using range searches By using range queries, you can match documents whose field values are between the lower and upper bound specified by the range query. Range queries can be inclusive or exclusive of the upper and lower bounds. Sorting is done lexicographically. For example, the following query finds documents whose mod date fields have values between 20020101 and 20030101, inclusive: mod_date:[20020101 TO 20030101] You can also use range queries with non-date fields.
Boosting a term Boosting a term Virtualization Manager provides the relevance level of matching documents based on the terms found. To boost a term, use the caret (^) symbol with a boost factor (a number) at the end of the term you are searching. The higher the boost factor, the more relevant the term will be. You can control the relevance of a document by boosting its term.
Chapter 7: Search document. This is equivalent to a union using sets. You can use the || symbol in place of the word OR. To search for documents that contain either "Microsoft Windows" or just "Microsoft", use either of the following queries: "Microsoft Windows" Microsoft "Microsoft Windows" OR Microsoft AND The AND operator matches documents where both terms exist anywhere in the text of a single document. This is equivalent to an intersection using sets.
Grouping Grouping You can use parentheses to group clauses to form sub-queries. This can be useful to control the Boolean logic for a query. To search for either "Microsoft" or "VMware" and "Server", use the following query: (Microsoft OR VMware) AND Server The previous query eliminates any confusion, and makes sure that a server must exist, and that either the term Microsoft or VMware may exist. Field grouping You can also use parentheses to group multiple clauses to a single field.
Chapter 7: Search Search query Results named rcarecords-2-test rca* Returns all VMs with any data containing a word starting with rca rcarecords-?-test Returns VMs named rcarecordsX-test where X can be any character rcarecords~ Returns VMs with any data containing strings similar to rcarecords vm.environmentFor.diskVolume.
Named fields Search query Results +Mail Server Any VMs with any data that must contain the string Mail but may also contain the string Server Mail NOT Server Any VMs with any data that may contain the string Mail but may not contain the string Server -Mail Server Any VMs with any data that must not contain the string Mail but may contain the string Server (Mail OR Web) AND Server Any VMs with any data that may contain the string Mail or Web in combination with the string Server Named fields Name
Chapter 7: Search Not all properties have a sub-property, therefore many named field searches use the following syntax: CI_TYPE.PROPERTY:VALUE. Example search queries The following section contains examples of the search syntax. vm.cpuCount:2 AND vm.memory:1024 This query searches for all virtual machines with two CPUs and 1024 MBs of memory as configured. The usage of MBs as the unit of measure for the memory field is specific to the named field implementation.
Example search queries Named field (without “vm.” qualifier) Description vCPUs configured diskDrives.capacity Capacity of configured virtual disk in MBs diskDrives.label Name of configured virtual disk environmentFor.cpus.description Description of CPU environmentFor.cpus.deviceId Processor number environmentFor.cpus.manufacturer Manufacturer of CPU environmentFor.cpus.name Name of CPU environmentFor.cpus.processorId ID of processor environmentFor.cpus.
Chapter 7: Search Named field (without “vm.” qualifier) Description environmentFor.networkAdapters.defaultGateway.ipV4Address IP address of default gateway for NIC environmentFor.networkAdapters.dnsServers.ipV4Address IP address of DNS server associated with NIC environmentFor.networkAdapters.ipAddress.ipV4Address IP address of NIC environmentFor.networkAdapters.macAddress MAC address of NIC environmentFor.networkAdapters.name Name of NIC environmentFor.networkAdapters.
Example search queries Named field (without “vm.” qualifier) Description device environmentFor.runningOS.computerName NetBIOS name for Guest OS environmentFor.runningOS.currentTimeZone Current time zone enabled for Guest OS environmentFor.runningOS.daylightInEffect Whether daylight savings time is in effect for the Guest OS environmentFor.runningOS.dnsHostname Host name in DNS of Guest OS environmentFor.runningOS.ntDomain Windows NT domain membership of Guest OS environmentFor.runningOS.
Chapter 7: Search Named field (without “vm.” qualifier) Description environmentFor.runningOS.paeEnabled Whether physical address memory extensions are enabled in Guest OS environmentFor.runningOS.partOfDomain Whether the Guest OS is part of a Windows NT domain environmentFor.runningOS.services.displayName Display name for service on Guest OS environmentFor.runningOS.services.name Internal registration name for service on Guest OS environmentFor.runningOS.services.
Example search queries Named field (without “vm.” qualifier) Description for service on Guest OS environmentFor.runningOS.services.type Type of service for service on Guest OS environmentFor.runningOS.systemType Type of physical system provided by virtual machine to Guest OS environmentFor.runningOS.versionInfo.buildNumber Build number of Guest OS environmentFor.runningOS.versionInfo.osVersion Version of Guest OS environmentFor.runningOS.versionInfo.
Chapter 7: Search Named field (without “vm.” qualifier) Description environmentFor.runningOS.versionInfo.servicePackMinor Minor version number of service pack level on Guest OS environmentFor.runningOS.versionInfo.version Version of Guest OS guestFamily Family of Guest OS guestFullName Full name of Guest OS guestId ID for Guest OS type hostname Host name of virtual machine hostserver.hostName Name of ESX host for virtual machine hostserver.
Example search queries Named field (without “vm.” qualifier) Description hypervisor identity.configFileName Name of VM configuration file identity.relativePathName Path name of VM folder in storage location identity.vmVendorName Vendor of hypervisor managedByServer IP address of management server entity managementServer.hostName Name of VirtualCenter managing ESX host running virtual machine managementServer.
Chapter 7: Search Named field (without “vm.” qualifier) Description machine manufacturer Virtualization infrastructure vendor memory Memory configured in MBs memoryOverhead Memory overhead in bytes model Type of virtualization infrastructure name Name of virtual machine networkAdapters.ipAddress.subnetMask Subnet mask of NIC snapshotSummary.dateCreated Date when snapshot was created snapshotSummary.description Description of snapshot snapshotSummary.
Example search queries Named field (without “vm.” qualifier) Description snapshot snapshotSummary.fullPath Full path of snapshot snapshotSummary.name Name of snapshot snapshotSummary.powerStateWhenTaken Power state of VM when snapshot was taken snapshotSummary.quiesced Quiescent state of VM when snapshot was taken suspendInterval Number of cumulative seconds suspended toolsVersion Version of VMtools running on virtual machine virtualDisk.
Chapter 7: Search Named field (without “vm.” qualifier) Description virtualDisk.controllerType Controller type for virtual disk virtualDisk.location File system location of virtual disk virtualDisk.location Location of VMDK virtualDisk.mode Storage mode for virtual disk virtualDisk.name Name of virtual disk virtualDisk.type File system type of virtual disk virtualMediaDevice. startConnected Connection state of virtual media device when VM is powered on virtualMediaDevice.
Example search queries Named field (without “vm.” qualifier) Description virtualMediaDevice.media Media type of virtual media device virtualMediaDevice.name Name of virtual media device virtualMediaDevice.type Type of virtual media device virtualNIC.adapterType Type of NIC virtualNIC.connected Connection state of NIC virtualNIC.macAddress MAC address of NIC virtualNIC.startConnected Connection state of NIC when VM is powered on virtualNIC.
Chapter 7: Search Named field (without “vm.” qualifier) Description number Using the query builder The query builder is an interactive tool with which you can construct complex search queries without having to memorize attribute codes, or learning the subtleties of the core query language. To start the query builder, click Advanced Search on the search bar. The query builder parses the text in the search bar. Each filter in the query text is rendered as an editable block.
Common use cases With the Add Label Filter you can add a filter based on the custom labels defined in Virtualization Manager. For more information, see Custom labels. By default, the query builder starts in form mode. Click Editor Mode to switch to edit mode, which shows the core query language, but still provides access to attribute search and sorting. After designing the search query, click Test to run the query in test mode.
Chapter 7: Search Issue Search query Number of X of Y (Dell 2950s) model:2950 AND “manufacturer: Dell, Inc.” All 3.0.x VMs hostServer/deviceProperties/value:3.0.* All 3.5.x VMs hostServer/deviceProperties/value:3.5.
Common use cases Vmotion Issue Search query VMs with media attached NOT $/virtualMachine/media/colSize:0 VMs with media attached virtualMediaDevice/connected:true NICs down NOT environmentFor/networkAdapters/status:Connected Cloning issues Issue Search query MAC address conflict on X environmentFor/networkAdapters/macAddress: 75:34:44:0b:48:19 AND NOT virtualNIC/macAddress: 75:34:44:0b:48:19 Time zone mismatch NOT environmentFor/runningOS/currentTimeZone:-300 VMs in time zone X environmentFor
Chapter 7: Search Guest OS issues Issue Search query OS version is X.Y environmentFor/runningOS/versionInfo/version:5.1.
Common use cases Issue Search query Hotfix VMs with patch conflict environmentFor/runningOS/componentUpdates/displayName:KB111111 AND environmentFor/runningOS/componentUpdates/displayName:KB222222 166
Chapter 8: Alerts Virtualization Manager uses alerts to monitor the environment for specified conditions, and to notify users or external systems about those conditions. You can configure alerts to fire when a specific condition arises, when it ceases to exist, or both. Virtualization Manager contains over 40 alerts by default to help you identify and highlight common problems in virtual environments.
Chapter 8: Alerts To disable an alert without removing it, navigate to Explore > Content, and then select an alert. Click Open at the lower left to open the Alert details page, and then click Disable in the lower right. The alert creation screen contains the following tabs: l Scope l Criteria l Notifications l Advanced settings Scope At the highest level, the scope describes what data you analyze, and defines the importance of the alert.
Criteria setting up every alert to evaluate on performance data, set the Evaluate on scope of the alert to match the data the alert analyzes. Criteria Alerts use criteria to evaluate data in the results of a search query, which is defined in the scope of the alert. The evaluation criteria includes the following: l l Base Alert On: The basis of the alert. This is either the Search result count or the Attributes within the search results. Triggers on: The rules based on which an alert is raised.
Chapter 8: Alerts search result is returned, but only if the search result is returned over a given time span. In this case, specify the time span in the Sustained Minutes field. Note: Because alerts are only evaluated when new data enter the system, set the Sustained Minutes to a period that matches the collection period for that data type. By default, performance data is collected every 10 minutes, and configuration data is collected every 12 hours.
Attributes l l Any: The alert fires if any attribute is returned. Range: The alert fires when the value of the attribute is outside of a specified range. If you select Range, the following additional options are displayed: l l l Select Less Than and Greater Than to define the range of values for which the alert should fire. The alert fires when the value is in the range, not outside of the range.
Chapter 8: Alerts field: sum(/virtualMachine/diskVolume/freeSpace) To get the cluster storage utilization, type the following in the Attribute field: (sum(/cluster/datastore/freeSpace) div sum(/cluster/datastore/capacity)) * 100 Notifications Configure an alert to fire a notification when it is lowered or raised or is active. You can configure the way an alert sends notifications of status changes on the Notifications tab.
Using alert actions Selected options Inactive Raised None - Active Email sent - Lowered Email sent Notify on consecutive events - Email sent Email sent Email sent Notify only when raised - Email sent - Both - Email sent Email sent - - To receive an alert in email, specify the email address in the Email To field. You can enter multiple addresses separated by a comma.
Chapter 8: Alerts 4. Select the action from the list. true ALERT alert-test Log Alert Summary Logs a summary of this alert's firing details to a file perl $MANIFEST_HOME/logAlert.
Example Action my $timestamp; my $alertId; my $loginToken; get_args(); my $client = Hyper9::Client->new( host => 'localhost:8983', ); #$client->{services_path} = '/single-vm'; $client->loginWithToken( username => 'admin', token => $loginToken, ) || die "Login failed\n\n"; my $alert = $client->getWorkspaceAsset(assetId=>$alertId); $client->logout(); my $status = ($alert->{raised} eq 'true') ? "RAISED" : "LOWERED"; open( LOG, ">>logAlert.log" ); print LOG $timestamp."\t".$alert->{name}."\t$status\t".
Chapter 8: Alerts l l l timestamp: The time stamp of the alert firing instance. This can be used to retrieve more details of this alert firing. alertId: The ID of the alert. This can be used to retrieve more details of the alert. loginToken: A short-lived one time use token that can be used to log in to the Hyper9 web service. The previous script uses the Perl Client (Hyper9::Client) module.
Advanced settings In the In Context Search Link grouping, you can define a search query which displays additional information about the resources for which the alert is raised. For example, if you have an alert defined on the Scope tab which is raised when the VMs under a host do not send a heartbeat, you can additionally set up a query on the Advanced tab for displaying the list of VMs. For information about displaying the results of the in context search query, see Accessing historical alert information.
Chapter 8: Alerts In the SNMP Trap OID Override field, you can specify a different OID for an alert if you do not want all alerts to use the same OIDs. The SNMP alerts is always prefixed by the SolarWinds Virtualization Manager enterprise OID. Click Save to persist your changes. Accessing historical alert information You can access historical alert information in the Explore module by using the Time Travel tool of the Map, viewing the resource details, or by viewing alert details.
Viewing alert information for a specific resource l Click the Plus icon to add the resource to a list. l Click the Map icon to place the resource in context on the map. l l If you defined an in context search query on the Advanced tab of the alert creation screen, click the Magnifier icon to view the results returned by that search query. If you specified a sort field on the Advanced tab of the alert creation screen as well, the results are displayed according to the defined sort field.
Chapter 9: Capacity planning Virtualization Manager includes a capacity planning module where you can see when your current virtual infrastructure will run out of resources, you can plan to add new VMs to your current infrastructure, and you can examine how new hardware will increase the capacity of your virtual infrastructure. Note: Virtualization Manager uses only shared storage in capacity planning calculations. Planning basics Capacity planning is driven by a supply side and a demand side.
Chapter 9: Capacity planning l disk space You can enter a resource container either directly from the Capacity Planning tab, or by running a search query. To define a resource container through search: 1. Search for hosts in the Search field. 2. Select one or more of the results. 3. Click Plan to enter the Capacity Planning module. The resource container is in the upper left of the Capacity Planning module.
Using resource containers This window provides the following options: l Click Show Profile to toggle screens to edit the Usage Profile in context. l Click Load to load a Resource Container that you saved previously. l l Click Save or Save as to save the resource container for future use. Resource containers are not saved by default. Click Show Details to get more details about the members of a resource container.
Chapter 9: Capacity planning Using usage profiles A usage profile is a group of Virtual Machines (VMs) that consume computing resources. The following primary resource consumptions are considered: l CPU l memory l disk space To define a usage profile, you can enter the Capacity Planning module directly from the Capacity Planning tab, or by running a search query. To define a usage profile through search: 1. Search for VMs in the Search field. 2. Select one or more of the results. 3.
Using usage profiles l l By creating a static list of VMs in the profile. By creating a dynamic set of VMs, by compiling a search query to search for either VMs or clusters. This query will be executed in real time for all capacity planning operations. The benefit of this approach is that you can constantly update your capacity plan based on a dynamic query. The disadvantage is that the calculations only happen after the query is executed.
Chapter 9: Capacity planning l l l Click Details to view all the calculations that went into the capacity plan. For more information about capacity planning details, see Showing the calculations and variables. Click Scatterplot to view the scatterplot graphs of IOPS. Click Summary to return to the Capacity Planning summary view which contains an overview of the resource container, the usage profile, and the capacity planning results.
How much more can I add? To generate a graph of the historic performance of CPU, memory, and disk utilization, click Consumption at the bottom of the Capacity Planning module. The utilization graph shows the actual consumed capacity of the resources within the Resource Container. The Consumption view consists of two parts: l l The large graphs show the historic values, and a best fit line.
Chapter 9: Capacity planning The calculations examine the availability of the following resources on hosts within the resource container: l CPU utilization l memory utilization l disk space consumption and disk IOPs l network consumption 2. Load a usage profile that contains VMs that are representative of the new VMs you want to add. The calculations examine the following consumption metrics of these VMs: l CPU l memory l disk space 3.
Calculating VM sizes l l Average VMs: This column displays the number of VMs you can add, based on the average resources consumed by VMs within the usage profile. Large VMs: This column displays the number of VMs you can add if you only add the largest VMs within the usage profile, which consume the most resources. For a more visual representation of the number of VMs you can add, click Capacity in the bottom of the Capacity Planning module. The bar chart on the left shows all the clusters or hosts.
Chapter 9: Capacity planning If the Usage Profile does not include clusters, the sizes are calculated based on all the averaged values per resource included in the usage profile. You can view these values in the Details view of the usage profile. Small: The minimum value of all the averaged values of the resources. Average: The average of all the averaged values of the resources. Large: The maximum value of all the averaged values of the resources.
Overloaded hosts Note: These options are saved in the resource container. To save your specifications, make sure that you save the resource container. The total extra resources that will be added to this resource container are the resources per host multiplied by the number of hosts. Any calculations outlined in the When will I run out? and How much more can I add? use cases consider these new resources as available when using this resource container.
Chapter 9: Capacity planning Calculation settings Any time you click Calculate, Virtualization Manager analyzes the load on the resource container, calculates the remaining capacity, and then determines how the usage profile would fit into the remaining capacity. You can modify the way capacity is calculated in the Calculation Settings. This section contains the following fields: l l l Mem Wastage: Spare memory due to non-uniform VM resource requirements.
Resource types l Disk I/O (IOPS): The IOPS measurement of the disk. l Net I/O (Mbps) To make the new settings take effect immediately, click Update at the bottom of the custom Calculation Settings. Resource types When viewing the resource consumption chart as described in the When will I run out? use case, the thresholds for a warning and an outage are configurable in the Resource Types section of the Capacity Manager.
Chapter 9: Capacity planning 3. Specify the days of the week when you want to collect performance data. 4. Click Update to save your changes. Note: The settings you specify are saved within the resource container. Showing the calculations and variables From the Summary page of the Capacity Planning module, you can also reach all the calculations that go into a capacity plan. To view the calculations: 1. Open the Capacity Planning module. 2. Click Details in the bottom right.
Chapter 10: Configuration comparison Virtualization Manager can retain historical data for performance, state, event, and configuration data, and can visualize this data in a manner that helps you understand the life cycle of virtual machines and hosts. Select one or two virtual machines or hosts from a search query result list on the search results page, and then click Compare for further historical analysis.
Chapter 10: Configuration comparison This page is comprised of several key details. The left column displays a list of categories of attributes that you can examine for comparison on a category by category basis. The degree of differences for each category is also displayed in a gauge to the left of the category name. The green represents similarities and the white space represents differences.
Using detailed comparison by category Multiple virtual machine or host comparisons help you understand changes that should have some degree of logical similarity such as parent-child relationships in cases of VM cloning, or similarly configured VMs such as cluster members. The Comparison overview screen also presents a graph of the degree of difference between each of the different categories of attributes to quickly identify attribute categories of interest.
Chapter 11: Dependency maps By using dependency maps, you can see one item in your virtual infrastructure and its relationship to the rest of the infrastructure. Dependency maps provide a way to see how problems in your environment may affect applications, services, or other areas of your virtual infrastructure. Dependency maps start with one or more items in context. Initially, the items in context appear in the top box.
Chapter 11: Dependency maps Only those virtual infrastructure items that are related to what is in context will be displayed on the dependency map. Setting context To reset the context, click Show Entire Environment on the left. This puts all clusters in your virtual environment in context. By definition, this means that each box contains all entities: VMs, hosts, datastores, and applications. To set the context to just a few items currently in the map: 1.
Exporting data 1. Select the small check box in the upper left of the items you want to add to a chart. 2. Click More in the upper right, and then select Add to Chart. 3. Select the chart to which you want to add the item. Exporting data To export data, perform the following steps: 1. Select the small check box in the upper left of the items you want to export. 2. Click More in the upper right, and then select Export. 3.
Chapter 11: Dependency maps accordingly, providing a historical view of the configuration and dependencies of your virtual infrastructure. Any Comparison or Add to Chart commands you run on objects while in Time Travel mode run in the context of the selected time period. Note: The Time Travel control is only available if there is a single object in the context box.
Chapter 12: Content The Content module of Virtualization Manager has two main sections. The left side is a content filter where you can drill down to exactly the type of content you want based on its attributes. You can filter the content in the viewer by Tags, Type, or User (Owner) and Permissions. The right side of the content viewer displays the content itself based on the filters that you have applied. You can sort any list of content, using the Sort by list on the top right of the content viewer.
Chapter 12: Content Any time you create and save content of any type in Virtualization Manager, it is displayed in the content manager with you as its owner. This is the most common way that content is created. SolarWinds may release periodic content updates and these new pieces of content can be imported into your system. Importing content To import content, perform the following steps: 1. Click Import Content in the lower right of the content viewer. 2. Select the file to import. 3.
Content types Content type Description Alerts Monitors incoming data and triggers notifications based on rules. Dashboards Collections of widgets available on the user's home page. Lists Collections of configuration items (CIs), such as VMs, hosts, datastores, clusters, and applications. Queries Search terms to find configuration items. Reports MS Excel or PDF output from canned reports or data export. Resource Containers Used by the capacity planning module to define the supply of resources.
Chapter 12: Content Tags In the Tags accordion content filter section on the left, you can filter content by tags. By default, this view has no tags selected, so it shows all content regardless of tags. Select one or more tags to filter the view to only show content with the specific tag. This way you can filter content to only see pieces that can help with a problem at hand.
Owner and permissions Owner and permissions For administrators, all content is accessible on the content management page. Non-administrator users only have access to their content and the publicly readable or writable content of other users. You can change the permissions on any content that you own or that is world writable. To modify permissions: 1. Select the content, and then click the Pencil button in the bottom left. 2. Select the permission type you want from the Permission list. 3. Click Save.
Chapter 13: Lists Lists, and more specifically, the Active List, provide a mechanism to group related objects into permanent collections to be reused at any time. Lists can contain VMs, hosts, clusters, datastores, and applications. For example, if you search for a specific set of VMs requiring a patch, you can add the results of the search to the Active List and save that list for future reference. This way you can use the list as a holding pen of VMs requiring the patch update.
Chapter 13: Lists You can continuously add items to the active list from multiple pages in Virtualization Manager. After you have completed finding and adding VM objects to the active list, you can review the items in the active list at any time by selecting the Explore module tab and clicking List. This brings up the current contents of the active list. This page works much like the search page in that each item and each group of items has check boxes next to it.
Chapter 14: Reporting There are two types of reporting possibilities in SolarWinds Virtualization Manager, On-demand reporting and Data exports. Reports can be configured to run on a periodic basis according to a schedule and are known as Scheduled report jobs. Data exports You can export the results of any search query or list to a Microsoft Excel spreadsheet in XLS format.
Chapter 14: Reporting 5. Select the attributes you want to export, either from the list, or by using the Filter field. 6. Click OK. 7. Repeat Steps 4 to 6 for every attribute that you want to export. 8. Click Run Export. As the report runs, it is displayed in the report schedules page. When it is completed, you can download the resulting report immediately, or you can refer to it at any point as a piece of content.
Scheduled report jobs To access the reporting interface: 1. Click Reporting. 2. Click On-Demand Reporting. The following scripted reports are available in SolarWinds Virtualization Manager: l Active Snapshots l Chargeback l Connected Media l Orphaned Files l Oversized VMs for a specific Cluster l Undersized VMs l Unused Templates l VM Aging l VM Free Space To execute any of the reports, select it either directly from the reports lists, or from the report categories listed on the right.
Chapter 14: Reporting in progress, and here you can also configure the jobs to run them on a periodic basis. The Report Schedules page has the following columns: l Scheduled l Running l Completed When a job is being executed, it is displayed in the Running column. Usually, a report that runs only once only stays in the Running column for a few seconds or minutes. When it has finished running, it is moved to the Completed column. The items marked in green in the Completed column ran successfully.
Removing report jobs GMT to describe the recurrence interval. Finally, you can choose an end date after which no more jobs will be run on this schedule. l Notifications: Here you can specify the users you want to notify of the completion of a job. You can enter multiple email addresses, separated by a comma. If the job is a report, the users on the notification list receive an email stating that the report completed, and the report itself is also attached to the email.
Chapter 14: Reporting 4. Specify the permission, name, description, and the associated tags of the new report. 5. Click Save. 6. To schedule when the report runs and who is notified when it has run, go to Reporting > Report Schedules. You can also create custom reports by using dashboard reports. To run a dashboard report: 1. Create a custom dashboard. 2. Click Create Dashboard Report in the top right of the dashboard. 3. Specify the permission, name, description, and the associated tags of the new report.
Chapter 15: Custom labels Labels provide a mechanism to insert business information into Virtualization Manager so that business data can be searched, exported, and compared. Labels are similar to custom fields in Virtual Center. You can define both the name of the label and assign a different value to one or more hosts or VMs. The new label becomes a part of the host or VM data so that it can be used throughout SolarWinds Virtualization Manager.
Chapter 15: Custom labels 1. Type the new value in the field next to the appropriate label. 2. Click Save changes. Removing labels To remove a label, perform the following steps: 1. Select the label from the list. 2. Click Delete a field. Note: If you remove a label, no history of the label or its value will remain. To search for a label, type the value of the label into the Search Query. Alternatively, you can also type the label name and value separated by a colon.
Chapter 16: Notes Notes are a mechanism to document details of VMs, hosts, clusters, datastores, and applications that cannot adequately be documented through other means. By annotating a virtual object, you can create a journal of running commentary on the life cycle of items in the virtual infrastructure. This is useful as it can be made to capture the reason why something changed, as opposed to the what, when, and how of changes.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor The following sections provide more information about the features available in the Orion Web Console.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor l Single Virtual Machine l Group of Virtual Machines l Virtual Machine Name Pattern l Single Virtual Host l Group of Virtual Hosts l Virtual Host Name Pattern l Single Cluster l Group of Clusters l Cluster Name Pattern l Single Datacenter l Group of Datacenters l Datacenter Name Pattern l Single Virtual Center l Group of Virtual Centers l Single Datastore l Group of Datastores l Datastore Name Patter
Virtualization thresholds 3. To limit an individual user account, complete the following steps: a. On the Individual Accounts tab, select the account you want to limit. b. Click Edit. c. In the Account Limitations section, click Add Limitation. d. Select the type of limitation you want to apply, and then click Continue. e. Define the limitation as directed on the Configure Limitation page that follows. f. Click Submit. 4. To limit a group account, complete the following steps: a.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor Objects with measurements that exceed the Warning Level threshold are displayed in red text. Objects that exceed the High Level threshold are displayed in red text with bold type. Using baselining Using the baselining feature, you can display baselines on different charts in the Orion Web Console.
Defining baselines vNode VIM virtual machines Statistics l CPULoad l MemLoad l CPUReady* l IOPSTotal* l IOPSRead* l IOPSWrite* l LatencyTotal* l LatencyRead* l LatencyWrite* l VIM datastores Network Usage Rate l IOPSTotal* l IOPSRead* l IOPSWrite* l LatencyTotal* l LatencyRead* l LatencyWrite* * - For the statistics marked with asterisk, baselines are only available if Virtualization Integration is enabled, and the vNodes contain data sent from Virtualization Manager.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor To define a baseline for an individual vNode: 1. Click Edit thresholds on the resource, and then select the thresholds you want to edit. 2. Select Override Global Orion Threshold or Set Dynamic Threshold, and then set either a static threshold, or click Use Dynamic Baseline Thresholds to define a formula for calculating a baseline. 3. Click Submit. To define a baseline for multiple vNodes at once: 1.
Understanding Object Statuses Note: To configure thresholds for, for example, all virtual machines under a given host, first select all vNodes, and then deselect the vNodes for which you do not want to define thresholds. Understanding Object Statuses The object statuses that are displayed in IVIM are determined automatically based on data polling. Additionally, by configuring Warning and Critical level thresholds you can determine when an object should reach Warning or Critical state.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor Status Applies to Machine Up l Host l Cluster l vCenter l Datastore l Unknown l Host l Cluster l vCenter l Datastore l Unreachable Unmanaged Virtual Machine Virtual Machine l Host l vCenter l Host l vCenter l Host The following tables provide information about the individual status icons and their meaning.
vCenter vCenter Status Icon Description Up The vCenter is connected and running without problems. Unknown The vCenter has not been polled recently. Unreachable The vCenter and the vCenter node cannot be polled. The parent node is down and it is not possible to connect to the vCenter. Unmanaged The vCenter is set as Unmanaged in the Manage Nodes page of IVIM. Could not poll The vCenter cannot be polled because of a connection or credentials issue.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor Cluster Status Icon Description Critical In a VMware environment, the cluster reached a critical level threshold in vSphere. In a Hyper-V environment, the cluster is reported as Up. Warning In a VMware environment, the cluster reached a warning level threshold in vSphere. In a Hyper-V environment, the cluster is reported as Up. Up There are no critical or warning level alerts active for the cluster in vSphere.
Host Status Icon for ESX Icon for (i) Hyper-V Description on the host is active in vSphere. Up The host is connected and running without problems. Unknown Either the host has not been polled recently, or the status is inherited from the parent object, and the parent vCenter is in an Unknown, Unmanaged, Unreachable, or Could not poll state. Unreachable The host cannot be polled. The parent node is down and it is not possible to connect to the host.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor Virtual Machine Status Icon for Icon for VMware Hyper-V Description Down - The Hyper-V virtual machine is shut down and is in a critical state. Shutdown The virtual machine is shut down. Critical The virtual machine reached a critical level threshold, or in a VMware environment, a critical alert on the virtual machine is active in vSphere.
AppStack Environment View and AppStack Environment resource AppStack Environment View and AppStack Environment resource Status Icon Description Down The item is shut down or is in a critical state. Shutdown The item is shut down. Critical The item is in a critical state. The item has reached a critical level threshold. Warning The item is in a warning state. The item has reached a warning level threshold. Up The item is running without problems. Unknown The item has not been polled recently.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor For information about creating and editing alerts in the Alert Manager, see Creating New Alerts and the related topics in the SolarWinds Orion Platform Administrator Guide. If IVIM is not integrated with Virtualization Manager, virtualization alerts are not available by default.
Viewing related entities in the Orion web console To be able to use virtualization reports in the Report Manager, IVIM and Virtualization Manager must be integrated. If the integration is removed, the default virtualization reports are not available in the Report Manager. For information about integrating IVIM with Virtualization Manager, see Integrating IVIM with Virtualization Manager.
Chapter 17: Using the SolarWinds Integrated Virtual Infrastructure Monitor l Virtual hosts l Virtual machines l Data stores Apart from the AppStack Environment view, you can also use the AppStack Environment resource. The AppStack Environment resource is available on the Details pages of individual entities, and it displays objects that are related to the particular entity whose Details page you are viewing.
Monitoring hardware health in IVIM Virtualization Manager, see Preparing for the integration of Virtualization Manager. For information about installing SRM, see Installing Storage Resource Monitor in the SolarWinds Storage Resource Monitor Administrator Guide. For detailed information about the features of SRM, see the Storage Resource Monitor Administrator Guide.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources The following sections provide detailed information about the specific Integrated Virtualization Manager resources that are available in the Orion Web Console. For information about integrating SolarWinds Virtualization Manager with SolarWinds Orion Platform products, see Preparing for the integration of Virtualization Manager.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Notes: l l A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share. To determine associations of VMs and datastores on Hyper-V environments, Virtualization Manager identifies what the system regards as the default location or datastore for vm and vhd files.
Datacenters with Problems To modify the view, click Customize Page at the top right corner of the view. Datacenters with Problems This resource provides a list of datacenters that experience problems, complete with the description of the problem.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Datastore IOPS and Latency This resource, available on the Datastore Details view, provides averages for the IOPS and latency for VMs using the datastores. The measure for IOPS shows averages for the set intervals. By default, the intervals are for the last hour, last 24 hours, and last 30 days. The measure for latency shows the average for the selected interval, in milliseconds.
ESX Host Details To view the exact memory load percentages at a given point in time, hover over the appropriate bar in the chart. Click Export to get a printable and exportable version of the chart. ESX Host Details This resource presents a table providing information about the selected ESX host, including its operational status, the physical memory installed on the host server, the number of VMs configured on the host server, and the vCenter through which the host is polling.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Hosts with Problems This resource provides a list of hosts that experience problems, complete with the machine type and the description of the problem.
Latency (Datastore and its Top VMs) Click Export to convert chart data into XLS or HTML format. You can adjust the title, the default zoom range, the time period, the sample interval, and the chart size in preparation for export. Notes: l l A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Click Export to convert chart data into XLS or HTML format. You can adjust the title, the default zoom range, the time period, the sample interval, and the chart size in preparation for export. Notes: l l A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share.
Percent Availability To view the number of running or not running VMs at a given point in time, hover over the appropriate bar in the chart. Click Export to get a printable and exportable version of the chart. Percent Availability This chart displays the availability of the cluster. To get a more detailed view of the cluster availability, click the zoom buttons, or move the slider at the bottom of the chart to cover the time period you want.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Click Edit to adjust the resource title and the maximum number of datastores to display. Notes: l l A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share.
Resource Utilization the default location or datastore for vm and vhd files. All VMs managed by a hypervisor are automatically associated with this default datastore. Resource Utilization This resource, available on the Virtualization Summary subview under an ESX host detail or a VM detail, provides the resource utilization values for nodes. The VM detail view of the resource shows the resource utilization values for a specific VM and its host.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources l Network utilization - This VM l Network utilization - Host l IOPS - This VM l Latency - This VM l CPU Ready - This VM Setup Virtualization Manager Integration This resource accepts input that integrates the Virtualization Manager server into the Orion Web Console of your Orion platform product. To integrate Virtualization Manager: 1. Enter the appropriate information about your Virtualization Manager instance. a.
Top Datastore I/O Latency Click Edit to adjust the type of information to display. Note: A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share. Top Datastore I/O Latency This resource, available on the Virtualization Storage Summary view, provides a graph of IO latency in milliseconds against a date or time period.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources the default location or datastore for vm and vhd files. All VMs managed by a hypervisor are automatically associated with this default datastore. Top Datastore IOPS This resource provides a graph of IOPS against a date or time period. Hover over a graph line to see details on all datastores at the data point (latency at the specific date and time). Hover over a node to see Datastore Info.
Top VM IOPS Top VM IOPS This resource provides a graph VM IOPS against a date or time period. Hover over a graph line to see details about all VMs at the data point (IOPS at the specific date and time). Hover over a node to see VM information.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Click Edit to adjust the zoom range (controlled by the slider), the amount of historical data to load (for example, Last 1 Day), and the sample interval (for example, 6 hours). Click Export to convert chart data into XLS or HTML format. You can adjust the title, the default zoom range, the time period, the sample interval, and the chart size in preparation for export.
Top XX Hosts by CPU Load assigned to share. l To determine associations of VMs and datastores on Hyper-V environments, Virtualization Manager identifies what the system regards as the default location or datastore for vm and vhd files. All VMs managed by a hypervisor are automatically associated with this default datastore. Top XX Hosts by CPU Load This resource ranks hosts by CPU utilization. Hover over a host name to see additional details about the host. To change how many hosts are listed: 1.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources To filter the host list based on properties: 1. Click Edit. 2. Enter the SWQL filter in the Filter Hosts field. For more information, see the Filter Syntax Guide in the Orion Platform Administrator Guide. Top XX Hosts by Number of Running VMs This resource ranks hosts by how many virtual machines each runs. Hover over a host name to see additional information about the host. To change how many hosts are listed: 1. Click Edit. 2.
Top XX Managed Virtual Guests by Current Response Time To filter the host list based on properties: 1. Click Edit. 2. Enter the SWQL filter in the Filter Hosts field. For more information, see the Filter Syntax Guide in the Orion Platform Administrator Guide. Top XX Managed Virtual Guests by Current Response Time This resource lists the guests with the worst response times. To change how many guests are listed: 1. Click Edit. 2.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources To filter the guest list based on properties: 1. Click Edit. 2. Enter the SWQL filter in the Filter Guests field. For more information, see the Filter Syntax Guide in the Orion Platform Administrator Guide. Top XX Managed Virtual Guests by Memory This resource lists the guests with the highest memory usage. To change how many guests are listed: 1. Click Edit. 2.
Top XX Managed Virtual Guests by % Packet Loss To filter the guest list based on properties: 1. Click Edit. 2. Enter the SWQL filter in the Filter Guests field. For more information, see the Filter Syntax Guide in the Orion Platform Administrator Guide. Top XX Managed Virtual Guests by % Packet Loss This resource lists the guests with the worst packet loss percentages. To change how many guests are listed: 1. Click Edit. 2. Enter the number of hosts to list in the Maximum Number of Hosts to Display field.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Notes: l l A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share. To determine associations of VMs and datastores on Hyper-V environments, Virtualization Manager identifies what the system regards as the default location or datastore for vm and vhd files.
Top XX VMs by Overallocated CPU Top XX VMs by Overallocated CPU This resource, available on the Sprawl view, provides a table with the following information about VMs with overallocated CPU: l Node l CPU (%) l CPU Recommendation (increase/decrease by) Hover over a VM to see details. Click Edit to adjust the number of VMs to display.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Click Edit to adjust the number of VMs and datastores to display. Notes: l l A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share. To determine associations of VMs and datastores on Hyper-V environments, Virtualization Manager identifies what the system regards as the default location or datastore for vm and vhd files.
Top XX VMs by Underallocated CPU Top XX VMs by Underallocated CPU This resource, available on the Sprawl view, provides a table with the following information about VMs with underallocated CPU: l Node l CPU (%) l CPU Recommendation (increase/decrease by) Hover over a VM to see details. Click Edit to adjust the number of VMs to display.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources l (Storage) Capacity l Storage Full By (date) Click Edit to adjust the maximum number of VMs to display. Note: A datastore refers to a VMWare datastore, Hyper-V local storage, or Hyper-V cluster shared volumes (CSV) that clusters, hosts, and VMs can be assigned to share. Usage MHz This chart displays how many CPU cycles are used by the cluster as a whole.
Virtual Machine Details view Virtual Machine Details view The Virtual Machine Details view contains resources which provide information about the status of the particular virtual machine and about how the virtual machine is related to other virtualization or storage entities in your environment. Besides viewing the status information, you can perform virtual machine management actions through the resources located in this view. To modify the view, click Customize Page at the top right corner of the view.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources l IOPS (Datastore and its Top VMs) l Virtual Machine Latency Click Edit to adjust the gauge style and size. Virtual Machine Latency This resource, available on the Node Details > Storage view, provides a graph of latency against adjustable intervals. Select the VM or host to see latency charted for the VM, host, or both.
Virtualization Asset Summary 5. Select any additional options required to monitor the VM, and then click Next. 6. Follow the remainder of the Add Node wizard to completion, and then click OK, Add Node. Virtualization Asset Summary This resource presents a table providing a high-level summary of your virtualized infrastructure. The information is broken down into the following sections, depending on your virtual environment. Overall Number of Hosts Indicates the total number of hosts you are monitoring.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources Resource Pools Indicates the total number of non-clustered hosts. ESX Hosts Indicates the total number of ESX hosts you are monitoring. Number of VMs Indicates the total number of VMs you are monitoring in your VMware environment, including information about the number of running VMs. Total Number of Physical CPU Cores Indicates the total number of CPU cores in your VMware infrastructure.
Virtualization Manager Tools Click Edit to adjust the number of items to display. Virtualization Manager Tools This resource provides links that directly navigate to Virtualization Manager tools such as the Virtualization Performance Explorer and the Virtualization Map, and put the selected object (datastore or virtual machine) in the context of the selected tool.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources 3. Expand the Integrated Virtual Infrastructure Monitor Settings grouping. 4. Modify the Virtual Machine Power Management and the Snapshot Management options, and then click Submit.
Virtualization Volume Details the default location or datastore for vm and vhd files. All VMs managed by a hypervisor are automatically associated with this default datastore. Virtualization Volume Details This resource is available on the storage volume details page, and provides the following information about the virtualization volume that is mapped to the storage volume: l Volume name l Datastore l Virtual Disk The resource also provides direct access to the Virtualization Storage Summary view.
Chapter 18: Integrated Virtualization Infrastructure Monitor resources VMs Powered Off for More Than 30 Days This resource, available on the Sprawl view, provides a table with the following information about VMs that have been powered off for more than 30 days: l Node l Configured Memory l Total Storage l Last Powered on (Date/Time) Hover over a VM to see details. Click Edit to adjust the number of VMs to display.
VMware Clusters with Problems l Title l Subtitle l Maximum number of objects to display l Filter by object status VMware Clusters with Problems This resource provides a list of clusters that experience problems, complete with the description of the problem.
Appendix A: Troubleshooting Hyper-V discovery The following section provides troubleshooting information for Hyper-V discovery and collection on Virtualization Manager.
Appendix A: Troubleshooting Hyper-V discovery Testing local WMI services Testing the local WMI ensures that the Hyper-V host can be monitored and queried remotely. The test software, WBEMTest, is included with Microsoft Windows operating systems. Testing WMI on the target server Complete the following procedure to check whether WMI on the target server is functioning correctly: 1. Log on to the target server with an administrator account. 2. Click Start > Run, type wbemtest.exe, and then click OK. 3.
Resetting the WMI counters 7. Select the Recursive radio button without entering a superclass name, and then click OK. 8. If the WMI class you are querying appears in this list, local WMI services are functioning correctly. Skip to the next topic and test remote WMI. 9. If the list does not appear or does not contain the WMI class you want, WMI is not functioning correctly. Continue reading this section to repair WMI services on the target server. 10. Click Close, and then click Exit.
Appendix A: Troubleshooting Hyper-V discovery at the Microsoft Knowledge Base. To manually reset the WMI counters: 1. Stop the Windows Management Instrumentation service. 2. Click Start, click Run, type cmd, and then click OK. 3. At the command prompt, type winmgmt /resyncperf, and then press enter. 4. At the command prompt, type wmiadap.exe /f, and then press enter. 5. Type exit, and then press enter to close the command prompt. 6. Start the Windows Management Instrumentation service. 7.
Verifying the administrator credentials IP address of the target server. 5. Type the user name and the password in the relevant fields, and type NTLMDOMAIN:NameOfDomain in the Authority field, where NameOfDomain is the domain of the user account specified in the User field. 6. Click Connect. 7. Click Enum Classes. Verifying the administrator credentials Only credentials that have administrator rights on the Hyper-V host have the necessary permissions to access the WMI services of the host.
Appendix A: Troubleshooting Hyper-V discovery Note: If you use a local user account that is added to the administrator group, you need to explicitly grant permissions in the WMI section. To add your monitor account to the local administrator group of a Windows Server 2008 computer: 1. Log on to the computer you want to monitor with an administrator account. 2. Navigate to Start > Control Panel > Administrative Tools > Computer Management > Local Users and Groups > Groups.
Enabling Remote Procedure Call (RPC) 4. Right-click Remote Procedure Call (RPC), and then click Start on the context menu. 5. Select Recursive without entering a superclass name, and then click OK. 6. If the WMI class list appears, remote WMI is functioning correctly. Go to Verifying the firewall settings, and then test your Virtualization Manager credentials. 7. If the list does not appear, remote WMI is not functioning correctly.
Appendix A: Troubleshooting Hyper-V discovery Verifying the firewall settings To allow Virtualization Manager to collect data, the following firewall rules must be enabled: l Core Networking l WMI DCOM-In If you connect to the Hyper-V host over a DMZ or otherwise employ a hardware firewall, you must make corresponding changes to your hardware firewall. If the Hyper-V host cannot respond to ping, either open port 7 or follow the instructions in Disabling ping discovery to disable ping.
Enabling the core networking rules Enabling the core networking rules Ensure that the core networking rules are enabled to collect information successfully from Hyper-V hosts. Note: These may be enabled by default. To allow core networking traffic through the Windows Firewall on Windows 2008 R2: 1. Log on to the computer you want to monitor with an administrator account. 2. Navigate to Start > Administrative Tools > Windows Firewall with Advanced Security. 3. Click Inbound Rules in the left navigation pane.
Appendix A: Troubleshooting Hyper-V discovery To allow WMI traffic through the Windows Firewall on Windows 2008 R2: 1. Log on to the computer you want to monitor with an administrator account. 2. Navigate to Start > Administrative Tools > Windows Firewall with Advanced Security. 3. Click Inbound Rules in the left navigation pane. 4. Click Windows Management Instrumentation (DCOM-In), and then click Enable Rule in the Action menu. To allow WMI traffic through the Windows Firewall on Windows 2008: 1.
Creating a new firewall rule to open the RPC ports 6. Select This program path, and then type %SystemRoot%\System32\dllhost.exe. 7. In Services, click Customize to ensure that Apply to all programs and services is selected, and then click OK. 8. Click Next 9. In Protocol type, select TCP. 10. In Local port, select RPC Dynamic Ports. 11. In Remote port, select All Ports. 12. Click Next. 13. Apply to any local and remote IP addresses, and then click Next. 14.
Appendix A: Troubleshooting Hyper-V discovery 8. Click Add Port. 9. Enter the RPC port range. 10. Click Change Scope, and then select Any computer. 11. Click OK. 12. Click OK again. Disabling ping discovery Virtualization Manager pings hosts before collection to quickly find or skip hosts. If port 7 is blocked, Virtualization Manager may fail to discover and collect information from Hyper-V sources. You can either open port 7 or disable the ping. To disable the ping: 1.
Configuring Distributed Component Object Model (DCOM) and User Account Though SolarWinds does not recommend altering this standard configuration, if you have a business case for doing so, then you can configure Virtualization Manager to omit SMBIOS IDs and build GUIDs based on ESX host names. Note: If you configure Virtualization Manager to omit SMBIOS IDs, you cannot rename hosts monitored by Virtualization Manager without creating an error state.
Appendix A: Troubleshooting Hyper-V discovery Item Need l Remote launch (default permission) l Local activation (limits permission) l Remote activation (limits permission) WMI Modify the CIMV2 security to enable and remote enable the Namespaces account used to access the server or workstation through WMI. Ensure the security change applies to the current namespace and subnamespaces.
Enabling account privileges in WMI 7. Click Edit Default, and then ensure the user account you want to use to collect WMI statistics has Local Access and Remote Access. 8. Click OK. 9. Click Edit Limits in the Launch and Activation Permissions grouping. 10. Ensure that the user account you want to use to collect WMI statistics has Local Launch, Remote Launch, Local Activation, and Remote Activation, and then click OK. 11.
Appendix A: Troubleshooting Hyper-V discovery 7. Click Edit, select This namespace and subnamespaces in the Apply to field, and then click OK. 8. Click OK on the Advanced Security Settings for CIMV2 window. 9. Click OK on the Security for Root\CIMV2 window. 10. Click Services in the left navigation pane of Computer Management. 11. Select Windows Management Instrumentation in the Services result pane, and then click Restart.
Testing the connection between the Hyper-V host and Virtualization Manager To verify the credentials, perform the following steps: 1. Log on to Virtualization Manager as an administrator. 2. Navigate to Setup > Credentials. 3. Select the Hyper-V credentials. 4. Click Edit. 5. Ensure that the user name, password, and domain are entered correctly. 6. Click Save.
Appendix A: Troubleshooting Hyper-V discovery 7. Enter a group name, and click Add Hosts. 8. Enter the IP address of the monitored Hyper-V host. 9. Click Save. 10. Click Save again to begin the first discovery job. The first time you add the host, discovery runs automatically. Running an existing discovery job To run an existing discovery job, perform the following steps: 1. Navigate to Setup > Discovery Jobs. 2. Select the discovery job you made. 3. Click Run Now.
Appendix B: Using PowerCLI SolarWinds Virtualization Manager Power CLI enables you to leverage the power of SolarWinds Virtualization Manager using Microsoft PowerShell. This section contains information about the following: l Installing PowerShell l Cmdlets and scripts l Using cmdlets Installing PowerShell Download the PowerShell Client installer from the SolarWinds Customer Portal. To download and install the PowerShell Client Installer: 1. Log on to the SolarWinds Customer Portal. 2.
Appendix B: Using PowerCLI When the installation is complete, select the SolarWinds Virtualization Manager PowerCLI in the start menu (or on your desktop, or QuickLaunch bar if you selected either of those options during installation), and double-click it. The following sections detail some of the tasks you can accomplish by using Microsoft PowerShell and SolarWinds Virtualization Manager.
Using configuration item references Note: The parameters are optional, meaning that you can show all the items in your result set. However, it can take a long time to display very large result sets. Using configuration item references Many of the operations you can perform with Virtualization Manager can involve hundreds or even thousands of virtual machines, host computers, and so forth. Because of this, most Virtualization Manager cmdlets accept and return "configuration item references.
Appendix B: Using PowerCLI Use the Get-Command built-in cmdlet to retrieve SolarWinds Virtualization Manager commands. You can also use the more precise Get-Command -pssnapin Hyper9.Powershell.Core or the shortcut Get-Command *h9*. For more information about a command, use the Get-Help built-in, or see Using cmdlets.
Scripts - This script synchronizes the folder and resource pool hierarchy of a VM along with the custom fields of both VMs and hosts to SolarWinds Virtualization Manager labels. vi2h9.
Appendix B: Using PowerCLI Using cmdlets The following table provides information about the syntax and usage of cmdlets. Area Cmdlet Description Syntax Example Basic session management ConnectH9Server Establishes a connection to the SolarWinds Virtualization Manager. This step is necessary before using any other cmdlets.
Using cmdlets Area Cmdlet Description Syntax Example OutBuffer ] Add-H9Credential [-Endpoint] [-User] [-Password] [[-Domain] ] [[Description] ] [] Add-H9Credential Adds a credential set for data collection. The available credential types are VirtualCenter, Host, and WMI. Get-H9Collector Get-H9Collector [] instances. In a standard environment, there will be only one collector.
Appendix B: Using PowerCLI Area Search and facet browsing Cmdlet Description Syntax Example source Center to the list of targets Virtualization Manager can collect against. ] [[-Collector] ] [[-Port] ] [[UnmanagedHost]] [[-StartNow]] [] AddH9Datasource 192.168.1.150 "Virtual Center on 192.168.1.150" $col[0] 443 Set-H9Query Sets or updates the active Set-H9Query [-Query] [[-CiType] ] [
Using cmdlets Area Cmdlet Description Syntax To modify the active search, use Set-H9Query. Example ending with 20: Get-H9Result 10 20 Active list integration Get-H9Facet Get-H9Facet [[-Path] ] Retrieves a list of facets [] for the active query. If a facet path is specified, the cmdlet retrieves the values for those facets. Get-H9Facet Add-H9List Adds an item to the active Add-H9List [-CiRef] [
Appendix B: Using PowerCLI Area Cmdlet Description Syntax cmdlet loads the list into the active list. You can retrieve the contents of the active list with the Show-H9List command. Label management Example 2008 list" to the active list: GetH9Content SavedList "VM 2008 list" | Set-H9List Clear-H9List Removes all items from the active list. Clear-H9List [] Clear-H9List Set-H9Label Applies a label to a configuration item (Virtual Machine, Host, Datastore, or Cluster).
Using cmdlets Area Cmdlet Description Syntax Example Set-H9Label "OS" "Windows" $vm Get-H9Label Clear-H9Label Returns a list of labels and values for the specified configuration item (Virtual Machine, Host, Datastore, or Cluster) reference.
Appendix B: Using PowerCLI Area Cmdlet Description Syntax (Virtual Machine, Host, Datastore, or Cluster). Example machine saved in the $vm variable: NewH9Note"Testing note" $vm Get-H9Note Retrieves notes for the specified configuration items (Virtual Machine, Host, Datastore, or Cluster).
Using cmdlets Area ing Cmdlet Description Syntax Example figurationItemReference> [] Machine, Host, Datastore, Cluster).
Appendix B: Using PowerCLI Area Cmdlet Description Syntax Example 0 $hst Retrieving and managing user content Get-H9Content Retrieves content items from SolarWinds Virtualization Manager (alerts, saved searches, lists, trends, and so on).
Using cmdlets Area Cmdlet Description Syntax tent [] command makes changes to content stored by SolarWinds Virtualization Manager. RemoveH9Content Removes content items from SolarWinds Virtualization Manager.
Appendix B: Using PowerCLI Area Cmdlet Description Syntax ization" Machine, Host, Datastore, or Cluster) associated with a currently firing alert. The command retrieves only the items associated with the most current execution of the alert. vSphere PowerCLI integration ConvertToH9Ref Converts a VI PowerCLI object to a SolarWinds Virtualization Manager GetH9Alertrefs $alarm ConvertTo-H9Ref [-Target]
Using cmdlets Area Cmdlet Description Syntax Example [-ErrorVariable ] [WarningVariable ] [OutVariable ] [OutBuffer ] Set-H9Property [-PropertyGroupName] [-PropertyName] [-Value] [-Verbose] [Debug] [ErrorAction ] [-WarningAction ] [ErrorVariable ] [-WarningVariable ] [OutVariable ] [OutBuffer ] Set-H9Property Simple doc- Get-H9Doc ument management Retrieves shallow document
Appendix B: Using PowerCLI Area Cmdlet Description Syntax figuration documents, stored between the specified dates.
Appendix C: Using Perl SDK If you do not already have Perl, download and install it. For Windows systems, we recommend using ActiveState's ActivePerl 5.16. Module installations The Perl Client ::Client module requires SOAP::Lite. To install SOAP::Lite on Linux or Mac versions of Perl, run the following command: sudo cpan install SOAP::Lite To install SOAP::Lite on Windows using ActivePerl 5.16, run the following command: ppm install http://ppm4.activestate.com/MSWin32x64/5.16/1603/P/PH/PHRED/SOAP-Lite-1.
Appendix C: Using Perl SDK Using the Perl Client The Perl Client module (Hyper9::Client) contains some inline POD (plain old documentation). To view the POD, navigate to the place where you extracted the Perl SDK archive and type the following command: Perldoc Hyper9/Client.
Writing your first script # Search for VMs configured with less than 1GB memory and retrieve their total # memory and memory usage at the same time my @results = $client->searchCustom( ciType => 'VirtualMachine', query => 'vm.memory:[0 TO 1023]', pageData => { pageSize => $pageSize, pageNumber => 1, }, sort =>{ sortField => 'vm.memory', sortDescending => 0, }, paths => ['vm.memory', 'vm.memload.
Appendix C: Using Perl SDK 6. Insert the following code into the script to log out: $client->logout(); 7. Save the searchMemory.pl file and run it using perl searchMemory.pl. The result should look something like the following: ryankruse$ ./searchExample.
Using the provided example The search example used previously is also provided in the Perl SDK .zip file, where it is called searchExample.pl.
