Embed Size (px)
Citation preview
AVG Business Managed Workplace®
Hyper-V® Service Module Integration Guide
TABLE OF CONTENTS
Where to Get More Help ..............................................................................................................................4Contact Us ....................................................................................................................................................4Documentation ...................................................................................................................................... 4Technical Support................................................................................................................................... 5AVG Partner Portal ................................................................................................................................. 5
Technical Information .........................................................................................................................5Training ...............................................................................................................................................5Partner Forum ....................................................................................................................................5
About Microsoft Hyper-V .............................................................................................................................2User Requirements and Setup......................................................................................................................2
Applying the Microsoft Hyper-V Policy Module ..................................................................................... 3Understanding the Terminology ..................................................................................................................4Viewing the Hyper-V Dashboards ................................................................................................................4
Multi-Site Overview Dashboard ............................................................................................................. 4To view the Hyper-V Multi-Site Overview dashboard.........................................................................5
Site Page Dashboard............................................................................................................................... 5To view the Hyper-V Site Page dashboard ..........................................................................................5
Host Overview Dashboard...................................................................................................................... 5To view the Hyper-V Host Overview dashboard .................................................................................6
Guest Overview Dashboard.................................................................................................................... 6To view the Hyper-V Guest Overview dashboard ...............................................................................6
Viewing Hyper-V Data..................................................................................................................................6Viewing a List of Managed Hosts Across All Sites................................................................................... 7Viewing Details About Hyper-V Windows Events .................................................................................. 7
Identifying and Addressing Issues ................................................................................................................8Viewing Hyper-V Alerts .......................................................................................................................... 8Viewing Hyper-V Errors .......................................................................................................................... 9
Performing Guest State Management .......................................................................................................10Managing Hyper-V Snapshots....................................................................................................................10
Creating a Snapshot ............................................................................................................................. 11Applying a Snapshot ............................................................................................................................. 11Reverting a Virtual Machine to the Previous Snapshot........................................................................ 12Deleting a Snapshot and Snapshot Subtrees........................................................................................ 12
Managing Hyper-V Service Module Reports ..............................................................................................13Creating Hyper-V Reports..................................................................................................................... 13
Accessing Hyper-V Support Resources .......................................................................................................14
1
2 U s e r G u i d e
WELCOME
This guide provides you with the procedures required to integrate Hyper-V with AVG Managed Workplace.
3
Where to Get More HelpSetup Guide Contains instructions about how to install and configure Managed Workplace.
User Guide Provides detailed information about Managed Workplace. It’s designed to be used as a reference in your everyday work.
Quick Start Guide This tutorial guides new users through the process of creating a site and setting up monitoring in Managed Workplace.
Online Help Contains all the information from the User Guide optimized for use online.
Integration Guide: Service Desks Contains the procedures required to integrate Professional Services Automation (PSA) tools or service desks with Managed Workplace.
Service Module Integration Guides Includes instructions for installing and using the service modules available for installation in Managed Workplace.
Release Notes Provides last-minute information about the product and documentation. May also include a list of resolved issues and updated or unique installation information for that version of Managed Workplace.
Domain Configuration Document Contains an overview of domain configuration.
Knowledgebase Contains hundreds of articles to help you use Managed Workplace, including self-guided troubleshooting tools, advanced topics, and answers to frequently asked questions. To explore the Knowledgebase, log into the AVG Partner Portal and in the main menu, click Technical.
Training AVG offers a series of live and on-demand technical training courses for all registered Partners. For more information, click here. (You must log into the Partner Portal to access the Training.)
Contact UsDocumentation
We are committed to making your experience with our product the best it can be. If you find any errors or omissions in our documentation, or have suggestions for improving it, write to us:
4 I n t e g r a t i o n G u i d e
Technical SupportSupport hours and contact information can be found on the AVG Partner Portal:
AVG Managed Workplace Technical Support
AVG Partner PortalClick this link to access the AVG Partner Portal, and then log in with your Username and Password.
Technical InformationTo find technical information such as documentation, product downloads, a searchable of resolved issues, feature request forms, and knowledgebase articles, log into the AVG Partner Portal and in the main menu, click Technical.
TrainingTo find training information, including live and ‘on demand’ training, a list of courses, course descriptions and a course calendar log into the AVG Partner Portal and in the main menu, click Training.
Partner ForumTo view or participate in discussions about Managed Workplace, log into the AVG portal and select Community.
I n t e g r a t i o n G u i d e 5
MICROSOFT® HYPER-V®
A service module is an enhanced policy module that includes dashboards, monitors, reports and scripts. Service modules enable AVG Managed Workplace to integrate with different software vendors. The service module covered in this chapter is for Microsoft® Hyper-V®.
This section provides detailed information about the following topics:
• About Microsoft Hyper-V
• User Requirements and Setup
• Understanding the Terminology
• Viewing the Hyper-V Dashboards
• Viewing Hyper-V Data
• Identifying and Addressing Issues
• Performing Guest State Management
• Managing Hyper-V Snapshots
• Managing Hyper-V Service Module Reports
• Accessing Hyper-V Support Resources
You can find more information about Microsoft Hyper-V at the following URL: http://www.microsoft.com
1
About Microsoft Hyper-VMicrosoft Hyper-V is a virtualization system that allows you to set up clusters of host machines and virtual guest machines. By creating and managing a virtual environment, you can reduce costs, improve server availability, and increase the efficiency of your computing environment.
The Hyper-V service module gives you direct access to view and manage your Hyper-V virtual IT infrastructure, presented in the form of dashboard views, reports, and alerts. You can also execute commands from within Managed Workplace to manage guests and take snapshots.
See “Using Service Modules” in the User Guide or online help
User Requirements and SetupThe Hyper-V service module supports Hyper-V hosts running the following versions of Microsoft Windows:
• Microsoft Hyper-V Windows Server 2012
• Microsoft Hyper-V Windows Server 2012 R2
• Microsoft Hyper-V Windows Server 2008 R2
• Microsoft Hyper-V Windows Server 2008
• Microsoft Windows 8
• Microsoft Windows 8.1
To install the Hyper-V service module, you must be running Managed Workplace 2013 R1 FP2, at a minimum.
Additionally, you must ensure the following requirements are met:
• You must install the Hyper-V service module, which is available in Update Center. The service module adds one new policy module to the system, to monitor host servers. You can then add this policy module to a policy set, or apply them to the corresponding groups or devices to begin monitoring. See “Using Service Modules” in the User Guide or online help.
• For a site to be monitored with the Microsoft Hyper-V service module, PowerShell must be installed on the Onsite Manager server and on each host machine. If PowerShell is not installed, a notification message will appear in the service module dashboard. The Hyper-V service module supports all versions of PowerShell except PowerShell 1.0.
• The role for the user working with Microsoft Hyper-V through Managed Workplace must have permissions to device management and reporting.
2 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
By default, Administrators, Technicians and Service Managers are configured with these permissions. See “Setting Permissions for a Role” in the User Guide or online help.
• The user account for the user working with Microsoft Hyper-V must have object access to apply the policy modules to the host machine at a site. See “Setting the Objects a User Account Can Access” in the User Guide or online help.
Applying the Microsoft Hyper-V Policy ModuleThe Hyper-V service module includes the following policy module:
• Microsoft Windows Server Hyper-V Technology Policy Module for Service Module
This policy module monitors performance counters and Windows Events on VM hosts, and contains hundreds of alert configurations to alert on the following types of events:
• guest shutdown
• a guest consuming excessive memory, potentially causing a performance breakdown
• failure during snapshot creation.
For information on viewing Hyper-V alerts, see Viewing Hyper-V Alerts on page 8.
You can access this policy module from within the service module itself.
1 In Service Center, click Configuration and then click Service Modules.
2 From the list of service modules, select Hyper-V.
3 To apply monitoring to the Microsoft Windows Server Hyper-V Technology policy module:
a Click Microsoft Windows Server Hyper-V Technology.
b To add the policy module to a policy set, under Policy Set Membership, click Add. Select the policy set, and click Add.
c To apply the policy module to a group, click Microsoft Windows Server Hyper-V Technology. Click the Manual Application tab, and then under Applied Groups click Add. Filter on the Group Type, if desired. Select the group and click Add.
d To apply the policy module to a device, click Microsoft Windows Server Hyper-V Technology. click the Manual Application tab, and then
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 3
under Applied Devices click Add. Filter the list of devices. Select the device and click Add.
Note: When applying the policy module, you must ensure that the devices to which it is applied, whether through policy sets, groups, or manually added devices, are valid host devices. If the policy module is applied to non-host devices, then some of the monitors will collect data for these devices and present it in the service module dashboards. For example, memory available, memory page faults, etc.
Understanding the TerminologyThe following terms are used in the Microsoft Hyper-V service module dashboards:
Host The server on which one or more virtual machines are installed. The host machine provides the hardware that supports the guest virtual machine.
Guest The virtual machine that resides on a host. Guest virtual machines run a separate, independent operating system.
Snapshot A file that captures the data, hardware, and configuration of a guest virtual machine.
Subtree Every iteration of a snapshot. Snapshots are accessible in the Hyper-V Manager console, and are stored in a tree format with the original snapshot at the root.
Viewing the Hyper-V DashboardsOn the Hyper-V dashboards, you can get a summary view about the configuration and status of virtual environments across all sites or at a specific site. You can also drill down to view detailed information about a host or a guest.
There are four Hyper-V dashboards available.
Multi-Site Overview DashboardThis dashboard provides an at-a-glance look at the top 5 hosts for average CPU usage and memory usage, in the form of bar charts.
The banner at the top of the Multi-Site Overview dashboard provides links to information about active alerts and managed hosts from all sites.
The Multi-Site Overview dashboard also includes links to drill down to the Site Page dashboard to view more information about a specific site.
4 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
To view the Hyper-V Multi-Site Overview dashboard1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
See Also Viewing Hyper-V Alerts on page 8
Viewing a List of Managed Hosts Across All Sites on page 7
Creating Hyper-V Reports on page 13
Site Page Dashboard
The Hyper-V Site Page dashboard provides links to information about Hyper-V Windows Events detected by the Hyper-V policy module.
The banner at the top of the dashboard provides links to alerts and errors detected at the site.
You can also drill to detail about host machines at the site, and generate a Site Hyper-V Summary report that displays information about the host configuration, CPU and memory consumption, and the types of Hyper-V events generated, including critical and error events.
To view the Hyper-V Site Page dashboard• On the Central Dashboard, click the Hyper-V icon for a site:
Tip: You can also access the Hyper-V site dashboard from the Hyper-V multi-site dashboard, by clicking the site name.
See Also Viewing Details About Hyper-V Windows Events on page 7
Host Overview Dashboard
The Hyper-V Host Overview dashboard provides details about a host machine, including line charts to illustrate average CPU usage, average disk IOPS, and average memory page faults.
The Host Memory Configuration and Host CPU Configuration sections provide further details about the device:
Hyper-V icon
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 5
The banner at the top of the page includes links to alerts and errors detected on the host machine.
You can also view a list of guests, and drill to detail about each guest, which opens the Guest Overview dashboard.
To view the Hyper-V Host Overview dashboard• From the Hyper-V Site Page dashboard, in the Managed Hosts table, click
one of the host name links.
See Also Viewing Hyper-V Alerts on page 8
Viewing Hyper-V Errors on page 9
Guest Overview Dashboard
The Hyper-V Guest Overview dashboard provides summary details about a guest machine, including identification details, status summary, services status, and memory configuration.
You can also create, apply, and revert to snapshots, and delete them as needed.
Finally, the Guest Overview dashboard includes links to change the guest state.
To view the Hyper-V Guest Overview dashboard1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 In the Managed Hosts table, click a host machine name.
5 In the Guests table, click a guest machine name.
See Also Performing Guest State Management on page 10
Managing Hyper-V Snapshots on page 10
Viewing Hyper-V DataThe Hyper-V service module dashboards include several links to allow you to drill to more detail about the data that is presented, to better understand the configuration and setup of virtual environments across your managed sites.
6 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
Viewing a List of Managed Hosts Across All SitesThe Hyper-V Multi-Site dashboard includes a link to display a list of managed hosts across all sites. From this page, you can click to view a table that lists each managed host, and includes information on the host name, site in which it is located, current status, and the number of active alerts.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 Click the number under the Managed Hosts heading.
4 Optionally, do one of the following:
• To go to the Site Page dashboard for a managed host, click a site name.
• To view active alerts on the host, click the alert number in the Active Alerts column.
Tip: You can also access the list of hosts from the Service Modules overview page, by clicking Status and then Service Modules. Under Hyper-V, click the number beside Managed Hosts.
Viewing Details About Hyper-V Windows EventsThe Hyper-V Site Page dashboard provides a summary of the Hyper-V Windows Events detected on managed hosts at the site. You can drill to details about each event type, or you can click All to view all of the events detected.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 In the Active Hyper-V Event Summary - Last 7 days section, click one of the following:
• All
• Error
• Warnings
• Information
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 7
Identifying and Addressing IssuesThe Hyper-V service module dashboards notify you of potential issues, in the form of alerts and errors.
Viewing Hyper-V AlertsThe Hyper-V dashboards display the number of alerts reported by Managed Workplace.
Alerts are triggered according to the monitoring and alerting configuration set in the Hyper-V policy module. Alerts notify you of informational and warning events, such as a virtual machine starting successfully or the Hyper-V Image Management service stopping.
Alerts can be viewed across all sites, at a specific site, and at the host machine level. When you click to view alerts, you can then take several actions:
• view more details about the alert category
• go to the Site Management page or the Device Overview page to investigate
• click to view and optionally change the alert configuration
• create a trouble ticket
• clear or suppress alerts
To view alerts across all sites1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 Click the number below the Active Alerts heading.
To view alerts at a specific site1 On the Central Dashboard, click the Hyper-V icon for a site.
2 Click the number below the Active Alerts heading.
To view alerts for a hostYou can view the alerts triggered by a host device from both the Host Overview dashboard and the Guest Overview dashboard; when viewing the Guest
Hyper-V icon
8 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
Overview dashboard, the Host Active Alerts number reflects the number of alerts detected on the machine hosting the guest device.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 Scroll down to the Managed Hosts table.
5 Click a host machine name.
6 Click the number below the Host Active Alerts heading.
Viewing Hyper-V ErrorsThe Hyper-V service module also monitors for Windows critical and error events generated by the Hyper-V Host Manager. The monitors are configured to display errors in the service module dashboards when an issue occurs that might require remediation, such as a Hyper-V launch or clustering failures.
Errors can be viewed at a specific site and at the host machine level.
To view errors at a specific site1 On the Central Dashboard, click the Hyper-V icon for a site.
2 Click the number below the Error Events (Last 7 days) heading.
To view errors for a hostYou can view the errors discovered on a host device from both the Host Overview dashboard and the Guest Overview dashboard; when viewing the Guest Overview dashboard, the Host Error Events (Last 7 days) number reflects the number of errors detected on the machine hosting the guest device.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 Scroll down to the Managed Hosts table.
5 Click a host machine name.
6 Click the number below the Host Error Events (Last 7 days) heading.
Hyper-V icon
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 9
Performing Guest State ManagementThe Guest Overview dashboard includes links to change the state of the virtual machine, which is useful when preparing to take a snapshot, or when performing remedial work. For example, you can pause or turn off a guest machine while you change its configuration, and restart the machine for changes to take effect.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 Scroll down to the Managed Hosts table.
5 Click a host machine name.
6 Scroll down to the Guests table.
7 Click a guest machine name.
8 Under Guest State Management, click one of the following links:
• Start
• Turn Off
• Pause
• Reset
• Resume
• Revert
• Shut Down
• Save
• Delete Saved State
Note: The Revert link is only available if the guest has saved snapshots. The Delete Saved State link is only available if the guest is currently in a saved state.
Managing Hyper-V SnapshotsThe Hyper-V service module lets you create snapshots of virtual machines from within Service Center. Snapshots capture the hardware configuration, data, and state of a virtual machine, which you can then use to revert the machine to a previous state.
10 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
Additionally, you can apply or revert to a snapshot, view a list of the snapshots you have created, and delete the snapshots you no longer need.
Creating a SnapshotWhen you create a snapshot in the Hyper-V service module, it is automatically named by combining the time stamp and the virtual machine name. For example, JSMITH - (10/15/2013 - 2:43:56 PM), where JSMITH is the virtual machine name. Snapshots are stored on the host machine, and can be accessed using the Hyper-V Manager.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 In the Managed Hosts table, click a host machine name.
5 In the Guests table, click the name of the virtual machine on which you want to create the snapshot.
6 In the Snapshot Management area, click Create Snapshot.
When the snapshot is being created, the following notification message appears at the top of the screen:
Command executed successfully: Command started.
Note: The snapshot information appears in the Available Snapshots table after the next asset scan, which can take up to 15 minutes.
Tip: You can view a list of the snapshots you’ve created in the Available Snapshots table. This table also lists the snapshots that were created using the Hyper-V Manager. From this table you can apply the snapshot you have created.
Applying a SnapshotThe Available Snapshots table, located on the Guest Overview dashboard, lists all of the snapshots that you can apply to the virtual machine.
Note: You cannot apply a snapshot when a virtual machine is running. To apply a snapshot, the virtual machine must be saved and turned off.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 In the Managed Hosts table, click a host machine name.
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 11
5 In the Guests table, click the name of the virtual machine on which you want to apply a snapshot.
6 Scroll down to the Available Snapshots table.
7 Click the Apply link for the snapshot you want to apply.
When the snapshot has been successfully applied, the following notification messages appears at the top of the screen:
Command executed successfully: Command started.
Reverting a Virtual Machine to the Previous SnapshotYou can revert a virtual machine, which returns its configuration and state to the previous snapshot in relation to the guest’s current position in the snapshot tree. You can view the snapshot tree location of the current state in the Hyper-V Manager.
Any modifications made to the configuration of the virtual machine since the last snapshot was taken are discarded during the revert process.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 In the Managed Hosts table, click a host machine name.
5 In the Guests table, click the name of the virtual machine on which you want to apply a snapshot.
6 In the Snapshot Management area, click Revert.
Deleting a Snapshot and Snapshot SubtreesYou can delete a snapshot or an entire snapshot subtree. A subtree is every iteration of a snapshot that was created, starting with the root node containing the original snapshot. When you delete a snapshot, as opposed to the snapshot subtree, you are deleting only the latest version of the snapshot.
1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Managed Sites table, click a site name.
4 In the Managed Hosts table, click a host machine name.
5 In the Guests table, click the name of the virtual machine on which you want to delete a snapshot.
12 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
6 Scroll down to the Available Snapshots table.
7 Beside the snapshot you want to delete, click one of the following:
• Delete
• Delete Subtree
Managing Hyper-V Service Module ReportsWhen you install the Hyper-V service module, several reports are also installed in Service Center.
Creating Hyper-V ReportsThe Hyper-V service module includes four reports that you can generate to demonstrate how you are monitoring and managing the virtual environments in your customer’s network.
Multi-Site Hyper-V Summary Displays an overview of Hyper-V hosts in the selected sites, including host configuration and resource consumption.
Site Hyper-V Summary Displays an overview of Hyper-V hosts in the site, include host configurations and resource consumption.
Host Hyper-V Summary Displays Hyper-V host information including configuration and performance details.
Host Hyper-V Guest Summary Displays Hyper-V Virtual Machine Guest details for a Hyper-V host.
You can view these reports from the Hyper-V dashboards, or you can access them from the Reports list.
Note: If you delete one of these reports, then the report links on the Hyper-V service module dashboards won’t work. However, you can re-import it from the partner portal. See “Importing a Report from the Partner Portal” in the User Guide or online help.
To create the Multi-Site Hyper-V Summary report1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 In the Multi-Site Summary Report, area, click the Multi-Site Hyper-V Summary link.
4 Specify the time period and click Preview.
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 13
To create the Site Hyper-V Summary report1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 Scroll down to the Managed Sites table.
4 Click a Site name to open the Site Page dashboard.
5 Under Reports, click the Site Hyper-V Summary link.
6 Specify the time period and click Preview.
To create the Host Hyper-V Summary or Host Hyper-V Guests Summary report1 In Service Center, click Status and then click Service Modules.
2 Click the Hyper-V link.
3 Scroll down to the Managed Sites table.
4 Click a Site name to open the Site Page dashboard.
5 Scroll down to the Managed Hosts table.
6 Click a Host name to open the Host Overview dashboard.
7 Under Reports, click one of the following:
• Host Hyper-V Summary
• Host Hyper-V Guests Summary
8 Specify the time period and click Preview.
Accessing Hyper-V Support ResourcesFor your convenience, links to the following Hyper-V support resources are provided in all of the Hyper-V service module dashboards:
• Microsoft Support
• Microsoft Partner Site
• Hyper-V Forum
• Hyper-V Online Help
• Microsoft Download Center
14 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
1 In Service Center, do one of the following:
• On the Central Dashboard, click the Hyper-V icon for a site.
• In Service Center, click Status and then click Service Modules. Click Hyper-V on the right sidebar.
2 Under Support Resources, click the link for the support resource you want to access.
Hyper-V icon
I n t e g r a t i o n G u i d e M i c r o s o f t ® H y p e r - V ® 15
16 M i c r o s o f t ® H y p e r - V ® I n t e g r a t i o n G u i d e
U s e r G u i d e 17
© 2015 AVG Technologies. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, without the prior written permission of AVG Technologies. While every precaution has been taken in the preparation of this document, AVG Technologies assumes no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein.
Managed Workplace is a registered trademark of AVG Technologies.
VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions.
Adobe and Acrobat are registered trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Microsoft, Windows, and Windows Server are trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries.
All other brands, product names, company names, trademarks, and service marks are the properties of their respective owners.
This guide was updated on October 20, 2015 11:03 am
