Documente Academic
Documente Profesional
Documente Cultură
2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. This product is covered by one or more patents listed at http://www.vmware.com/download/patents.html. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.
Contents
Installing VMware vCloud Usage Meter ................................................................................................................. 5
Software Requirements............................................................................................................... 5 Hardware Requirements ............................................................................................................. 5 Configuration Maximums ............................................................................................................ 5 Deploy VMware vCloud Usage Meter Through vCenter Server .................................................. 5 Deploy vCloud Usage Meter Through vSphere Host ................................................................... 7 Change Password and Time Zone Details.................................................................................... 8 Upgrading vCloud Usage Meter .................................................................................................. 9
Managing VMware vCloud Usage Meter ................................................................................................................ 9
Service Provider ........................................................................................................................... 9 vCenter Servers ........................................................................................................................... 9 Site Recovery Servers ................................................................................................................ 10 Outgoing Email Server ............................................................................................................... 10 Collector .................................................................................................................................... 10 Email Alerts................................................................................................................................ 11
License Management ........................................................................................................................................... 11
About Reports ........................................................................................................................... 17 Detailed Billing Report............................................................................................................... 17 Detailed Usage Report............................................................................................................... 17 Customer Summary Report ....................................................................................................... 18 2011 VMware, Inc. All rights reserved. Page 3 of 20
License Summary Report ........................................................................................................... 19 Product Report .......................................................................................................................... 19 Customer Product Report.......................................................................................................... 19 Generate a Report ..................................................................................................................... 20
Support ................................................................................................................................................................ 20
Software Requirements
You must have VMware vSphere to deploy VMware vCloud Usage Meter, and have a web browser to access the vCloud Usage Meter user web interface.
vSphere Requirements
VMware vCloud Usage Meter can be deployed on the following: VMware vSphere 4.0 and later releases
Web Browsers
VMware vCloud Usage Meter is an application that is tested and supported on the following Web browsers: Microsoft Internet Explorer 8 and later releases Mozilla Firefox 7 and later releases Google Chrome 12 and later releases
When working with large datasets of virtual machines and vCenter Server inventory objects, i.e. greater than 10,000 virtual machines and 2500 vCenter Server inventory objects respectively, it is recommended to have at least 750MB of RAM available on the client to page result efficiently.
Hardware Requirements
The systems on which VMware vCloud Usage Meter is installed must meet the minimum hardware requirements to install and run the application. VMware vCloud Usage Meter virtual appliance requires the following hardware specifications: o o o o 2.0GHz or faster Inter or AMD x86 processor 2.5GB or more RAM 40GB or more disk storage 10/100 Ethernet adapter (Gigabit recommended)
Configuration Maximums
Each vCloud Usage Meter appliance has been configured to support metering of 10 vCenter Servers 10,000 virtual machines. 1000 Customers 2500 vCenter Inventory objects
You can deploy VMware vCloud Usage Meter as a virtual appliance through VMware vCenter Server. Prerequisites o Download the OVA installation file from
What to do next Power on the virtual machine and configure virtual machine details.
Table 1: Supported vCenter Server Versions vCenter Server Versions VMware vCenter Server 4.0 VMware vCenter Server 4.0 Update 1 VMware vCenter Server 4.0 Update 2 VMware vCenter Server 4.0 Update 3 VMware vCenter Server 4.1 VMware vCenter Server 4.1 Update 1
Page 6 of 20
What to do next Power on the virtual machine and configure virtual machine details. Network details were not configured at OVF deployment and must be configured after VMware vCloud Usage Meter console appears. Select Configure Network and follow instructions on configuring new network settings. On completion of setting up network, interfaces will reset followed by a return to the VMware vCloud Usage Meter console. The webapp URL will be updated with new address in the format http://<IP-Address>:8443/um. Table 2: Supported vSphere Hosts Supported vSphere Versions VMware ESX 4.0 VMware ESX 4.0 Update 1
Page 7 of 20
Supported vSphere Versions VMware ESX 4.0 Update 2 VMware ESX 4.0 Update 3 VMware ESX 4.1 VMware ESX 4.1 Update 1 VMware ESXi 4.0 VMware ESXi 4.0 Update 1 VMware ESXi 4.0 Update 2 VMware ESXi 4.0 Update 3 VMware ESXi 4.1 VMware ESXi 4.1 Update 1 VMware ESXi 5.0
6. The webapp password must be initialized before it can be used. Run the command with no arguments for directions.
/opt/vmware/cloudusagemetering/scripts/webpass.sh
Execute the arguments for the role, service provider <s> or aggregator <a>, you wish to run as.
Example: /opt/vmware/cloudusagemetering/scripts/webpass.sh set s
Page 8 of 20
7. A password prompt will be displayed. Enter the password and hit return. 8. Type Exit to return to the virtual machine console and reset your time zone. 9. On the virtual machine console, navigate to Set Timezone and press Enter. By default, NTP has not been configured for virtual appliance. 10. Select your time zone and press Enter. 11. To reflect the changed time zone you must restart the tomcat service. 12. Navigate to the Login and press Enter. Enter credentials and at the prompt, Type service tomcat restart and press Enter to restart the Tomcat service.
Service Provider
All service provider details are required in order for the vCloud Usage Meter virtual appliance to collect and report on virtual machine and customer usage. Failure to enter details will result in failed vCenter collections in addition to incomplete monthly reports. Procedure 1. Click Manage Tab 2. Enter Company 3. Enter Contact Name 4. Enter Phone Number 5. Enter Email 6. Click Save when completed to commit changes. Dialog message will appear in upper left of browser window confirming service provider changes have been saved.
vCenter Servers
At least one vCenter Server must be added to collect virtual machine usage data. Please refer to the Software Requirements section for more details on the supported vCenter Server versions and number of vCenter Servers supported per vCloud Usage Meter virtual appliance. The vCloud Usage Meter does not support metering vSphere hosts directly Procedure 1. Click Manage tab 2. Click Add
Page 9 of 20
3. Enter IP Address 4. Enter User Name. Read-Only administrator privileges required. 5. Enter Password. 7. Click Save when completed to commit changes. Dialog message will appear in upper left of browser window confirming changes In order to test the vCenter Server address and credentials when saving, enable the Test Before Saving check box. If there is an error connecting to the vCenter Server, an error message will be displayed and the vCenter Server will not be added to the list for collections. The default value for the Test Before Saving check box is set to enabled.
Collector
Set the start time for the VMware vCloud Usage Meter to poll vCenter Servers. Default is 5 minutes after the hour and can be adjusted for every minute of the hour to not compete with other scripts working against the vCenter Servers.
Page 10 of 20
Click Test to verify that the collection process is working correctly. Email alerts must be set in advance to receive results.
Email Alerts
To monitor the metering of vCenter Servers, there is the option to receive email alerts after successful or failed collections. Procedure 1. Enter From Email. 2. Enter To Email. If more than one email address is to be entered, separate out email address with a comma (example: jdoe@vmware.com, ddoe@vmware.com). 3. Select whether successful or failed collection emails will be received. 4. Select Send a test email alert after saving to verify that the outgoing email server is working correctly and that the alerts will be sent. 5. Click Save when completed to commit changes.
License Management
License Sets
License Sets provides a mechanism to associate virtual machine vRAM usage with one or more vSphere license keys which can be used to group vRAM usage based on Aggregator, location, customer, or other organization structure required by the aggregator. Available licenses to use with License Sets are displayed as name or type of vSphere license, license code, vCenter Servers where license key is deployed, and number of hosts associated with each vSphere license.
Procedure for creating License Set 1. Click Licenses tab 2. Enter License Set name and click New. 3. Select newly created License Set 4. Select licenses to associate with License Set. Licenses can span more than one licenses set.
Procedure to delete License Set 1. Click Licenses tab 2. Select License Set 3. Click Delete 4. Confirm deletion of License Set. License Set is deleted.
Procedure to edit License Set 1. Click Licenses tab 2. Select License Set 3. Edit by changing the licenses associated with the License Set.
Page 11 of 20
License Categories
vSphere license keys deployed by service providers may have different billing characteristics and the vCloud Usage Meter provides the ability to indicate which vSphere license keys are billable by defining the licensing category. Fields defined in the license categories include the name or type of vSphere license, license code, vCenter Servers where license key is deployed, and default license categories defined below. VSPP License key obtained through VSPP and all virtual machines running on hosts with these keys are considered to be billable. Perpetual License keys obtained outside of the VSPP program and virtual machines running on hosts with these keys are not considered billable. Demo License keys that are not billable that can be used for environments such as demo systems and View deployments.
vSphere licenses keys will be updated after a successful vCenter query. Once the keys are available, the Category can be modified to represent the correct license category. By default, the Category is set to VSPP. If license key is no longer present in a vCenter Server, the license is removed from the licenses to manage in the License Categories. Changes made to the license categories are saved after modification.
Automatic Reporting
You can set up Usage Meter to automatically generate reports and email them to an Aggregator, or elsewhere. Service providers who report to multiple aggregators can set up an automatic report for each one, using a different license set for each (see Licenses). To select an automatic report, use the Name select control. The form on the right presents the report details. To create or change a report, enter details in the form and push Save. Use the Delete button to delete the selected report. Procedure to create Automatic Report
1. Click Automatic Reporting tab 2. Enter Name of Automatic Report 3. Select Reporting Day on which to generate reports 4. Select the Reports to Include 5. Select the License Set to associate with reports 6. Enter email sender and recipient 7. Click Save
Page 12 of 20
1. Click Automatic Reporting tab 2. Select Name of Automatic Report 3. Update Reporting Day, Reports to Include, License Set, or email 4. Click Save
Customer Management
The vCloud Usage meter provides the ability to add, edit, delete, export, and import customers that are using service provider resources. Customers details stored in a vCloud Usage Meter appliance are not shared among other vCloud Usage Meter appliances and must be exported and imported into in order to share changes.
Add Customer
Add a customer through the vCloud Usage Meter user interface.
Procedure for importing customers 1. Click Customers tab 2. Click Add and a new dialog window appears 3. Enter unique customer Name 4. Select Country 5. Enter Postal Code 6. Click Save
Delete Customers
Customers can be deleted from the vCloud Usage Meter by accessing the Customer tab and working with the existing customers. When deleting a customer from the vCloud Usage Meter, all Rules associated with the customers are also removed from the system.
Procedure 1. Select one or more customers to be deleted. 2. Click the Delete Multiple button. Button will display how many customers are being deleted. 3. vCloud Usage Meter will display confirmation dialog to confirm customer deletion. Click Yes to remove customers and Cancel will exit out of delete transaction.
Page 13 of 20
Import/Export Customers
Customer and rules can be imported into the vCloud Usage Meter via a tab separated file. This file can be manually generated or be an exported customers and customers rules list from another vCloud Usage Meter appliance. The Usage Meter allows for import of Customers only, Customers and Rules, or Rules only and duplicates are not permitted.
Procedure for importing customers 7. Click Customers tab 8. Browse to file to be uploaded and click Import 9. If import completes without error, a new page is displayed with the message Importing completed with no errors. Click Customer tab to return to the Customer management interface. Customers that are considered to be restricted are not allowed to be imported via the tab separated file and must be entered manually. If import of customers fails, an error message indicating the line number, text associated with the line producing the error, and the error message are displayed.
Procedure for exporting customers 1. Click Customers tab 2. Click Export All button 3. A new dialog window is presented in order to save the customers and customers rules as a tab separated text file.
Customer Rules
Customer rules enable the Service Provider to associate vCenter Server objects with a customers cloud infrastructure to enable monthly customer usage reporting as defined in the VSPP Program Guide and VSPP Product Guide. The vCloud Usage Meter provides the Service Provider with granular control of vCenter Server inventory where they are able link objects in the vCenter Server inventory from as high as the vCenter Server down to the individual unique ID for a virtual machine or IP address. Refer to the Reports section and Customer Summary Report to review customers monthly usage after creating rules.
Page 14 of 20
2. Enter Customer name. Customer name has autocomplete functionality enabled to assist with finding customer. After each letter entered there is a slight delay as the customer list is populated based on values entered. Complete name manually or select the customer from the filtered list provided to assign customer to work with. 3. Create Rules to be associated with customer using vSphere Inventory Tree (Option 1) The vSphere Inventory filter is linked to those vCenter Servers that the vCloud Usage Meter is collecting usage data for. By default, all objects in the vCenter Server inventory are collected for each vCenter Server. Objects displayed in the vSphere Inventory filter can then be reduced by entering text related to the customers vCenter Server objects followed by clicking Filter. The vCenter Servers, and objects contained within them, can then be expanded or collapsed by manually or clicking the Expand All or Collapse All buttons to display those objects that match the entered text. Select the vSphere Inventory Object associated with the customer. By using the vSphere Inventory Tree, a Unique ID or mapping between the vCenter Server ID and moref is created to link the customer to the associated vSphere Inventory object and the details of that mapping are displayed under the Create Rules section. If the mapping is correct, click Create and the Current Rules is updated with the new rule to be associated with the customer. Click Show customer virtual machines to view all virtual machines associated with all customer rules created. During customer rules creation, if there is a conflict with another customer rule an error message is displayed to the end user with customer and virtual machines affected and the rule is not created. Click Reset Filter to reset search criteria. 4. Create Rules to be associated with customer using Create Rules (Option 2) a. Select Object Type. Refer to the Supported methods for mapping customers to rules below for more details on methods permitted. b. Select Value Type. Exact String, Substring, Regular Expression, and CIDR Notation apply to all vCenter Servers registered with vCloud Usage Meter appliance. c. Enter Value to be associated with the customer
d. Click Create and the Current Rules are updated with the new rule to be associated with the customer. Click Show customer virtual machines to view all virtual machines associated with all customer rules created. During customer rules creation, if there is a conflict with another customer rule an error message is displayed to the end user with customer and virtual machines affected and the rule is not created.
Table 3: Supported methods for mapping customers to rules Unique ID Exact String Substring Regular Expression CIDR Notation
VM VM vCenter Name
X X X X
Page 15 of 20
Unique ID
Exact String
Substring
Regular Expression X
CIDR Notation
VM DNS Name IP V4 address Folder Resource Pool vApp Host Cluster Data Center vCenter Server X X X X X X X
X X X X X X X X X X
Generating Reports
The vCloud Usage Meter allows the end user to generate various reports to monitor and track resource usage for your vCenter Server and virtual machines. This chapter includes the following topics: About Reports Generate a Report Export a Report
Page 16 of 20
About Reports
There are 6 different reports that can be generated from the vCloud Usage Meter. Previous report executed will remain cached in browser until another report is generated or logout from vCloud Usage Meter Appliances
Table 4: Detailed Billing Report Details Report Column Time Service Provider Host DNS Name Description Day of the reporting month, hour, minute, and milliseconds Name of the service provider associated with the report Host identifier which can be IP address or FQDN depending on how the host was configured with vCenter Host memory size displayed in KB Configured virtual RAM for the virtual machine Billing virtual RAM for the virtual machine calculated from the amount of reserved RAM assigned to the virtual machine Number of CPUs assigned to the virtual machine Unique identifier for virtual machine to assist with identification and audit
Table 5: Detailed Usage Report Details Report Column Time Customer Description Day of the reporting month, hour, minute, and milliseconds Customer associated with record
Page 17 of 20
Description Host identifier which can be IP address or FQDN depending on how the host was configured with vCenter Host memory size displayed in GB vSphere license type associated with vSphere host Virtual machine name as listed in vCenter Server Virtual machine DNS name Configured virtual RAM for the virtual machine Billing virtual RAM for the virtual machine calculated from the amount of reserved RAM assigned to the virtual machine Number of CPUs assigned to the virtual machine Unique identifier for virtual machine to assist with identification and audit
Host RAM (GM) vSphere Licenses VM VC Name VM Hostname VM RAM (MB) Billing RAM (MB)
Table 6: Customer Summary Report Details Report Column Customer License Type Category Billable Billed vRAM (GB-Hour) Capped Billed vRAM (GB-Hour) Description Customer associated with usage License type being metered. vSphere license category If the vSphere license is billable and sent to aggregator Non-Capped Memory (GB-Hour) Capped Memory (GB-Hour) Used in billing calculation
Page 18 of 20
Table 7: License Summary Report Details Report Column Billable Category License Type Billed vRAM (GB-Hour) Capped Billed vRAM (GB-Hour) Description If the vSphere license is billable and sent to aggregator vSphere license category License type being metered. Non-Capped Memory (GB-Hour) Capped Memory (GB-Hour) Used in billing calculation
Product Report
This report provides information such the product being monitored, the metric being metered on, and the associated monthly usage. This report will be included in monthly reporting if Site Recovery Manage is used to protect customers virtual machines.
Table 8: Product Report Details Report Column Product Metric Type Value Description Product metered Metric being used to meter product Monthly usage for product
Page 19 of 20
Table 9: Customer Product Report Details Report Column Customer Product Object Description Customer associated with virtual machine Product metered Metric being used to meter product
Generate a Report
A report can be generated manually at any time and can be exported as a tab separated file or zip when a large number of records are returned. Procedure 1. Click Report tab. 2. Select Report Type 3. Select specific Customers, Countries, or Postal Codes or select All to return all records 4. Select License Set or leave blank to return all records 5. Select Month and Year 6. Per VM Memory Cap is defaulted to 24 GB, but can be modified by the end user 7. Click Browse to generate report or Export to save report to file
Support
Support logs for vCloud Usage Meter are available through the console at /var/log/usgmtr/* or available through the user interface at using the following procedure.
Procedure 1. Select Support tab 2. Click Get Appliance Log File 3. Save log file to specified directory Only the current log file is use exported. All log files can be accessed and exported through console.
vCloud Usage Meter, User Guide and FAQ available at: http://www.vmware.com/download/download.do?downloadGroup=UMSV2 Technical Support VMware GSS handles support for Service Providers and Aggregators with vSphere or vCloud entitlements Customers with no entitlements go to vcloudusagemeter@vmware.com http://communities.vmware.com/community/vmtn/vcd/vcloud_usage_meter
Page 20 of 20
VSPP Program and Pricing Updated guide coming online in March 2012 http://www.vmware.com/partners/partners.html Review release notes for a list of know issues
Page 21 of 20