vCenter Chargeback Manager Installation and Upgrade Guide vCenter Chargeback Manager 2.6.0 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
vCenter Chargeback Manager Installation and Upgrade Guide You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2013 VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc.
Contents About the Guide 5 1 Introduction to vCenter Chargeback Manager 7 What Is Chargeback 7 Chargeback Solution for Virtual Environments Overview of vCenter Chargeback Manager 8 Supported Product Integration 9 7 2 System Requirements 11 Hardware Requirements 11 Software Requirements 12 3 Install and Upgrade Prerequisites 15 Network Management Prerequisites 15 Database Management Prerequisites 16 Other System Prerequisites 18 Pre-installation Checklist 19 Download and Extract the vCenter Chargebac
vCenter Chargeback Manager Installation and Upgrade Guide Uninstall Data Collector Index 4 57 59 VMware, Inc.
About the Guide The vCenter Chargeback Manager Installation and Upgrade Guide provides information about installing and ® upgrading VMware vCenter Chargeback Manager. This book also describes how to install and upgrade the different data collectors. Intended Audience This book is intended for anyone who wants to install or upgrade vCenter Chargeback Manager.
vCenter Chargeback Manager Installation and Upgrade Guide 6 VMware, Inc.
Introduction to vCenter Chargeback Manager 1 vCenter Chargeback Manager is an end-to-end cost reporting solution for virtual environments using vSphere. vCenter Chargeback Manager can also be used with VMware vCloud Director. Before you install and start using vCenter Chargeback Manager, an understanding of what is chargeback and about chargeback solutions for a virtual environment would be helpful.
vCenter Chargeback Manager Installation and Upgrade Guide To support chargeback, the virtual environment and the chargeback solution must provide ways to measure resource usage and associate the usage with a specific pricing model. The chargeback solution must also support the use of different pricing models so as to charge the various departments or cost centers differently.
Chapter 1 Introduction to vCenter Chargeback Manager vCenter Chargeback Manager runs on an Apache Tomcat server instance. Users interact with vCenter Chargeback Manager through a load balancer (Apache httpd Server). vCenter Chargeback Manager connects to the vCenter Chargeback Manager database that stores application-specific information, such as the defined chargeback hierarchies, pricing models, users, roles, and so on.
vCenter Chargeback Manager Installation and Upgrade Guide VMware vShield Manager To obtain the usage data associated with the network entities from your vCloud Director setup in to vCenter Chargeback Manager, you must install and configure the vShield Manager data collector. This enables metering and charging for external network bandwidth. VMware vCenter Operations Manager vCenter Chargeback Manager can be integrated with vCenter Operations Manager to generate dashboard reports on vSphere inventories.
System Requirements 2 Before you install vCenter Chargeback Manager, you must ensure that the minimum hardware and software requirements are met. This chapter includes the following topics: n “Hardware Requirements,” on page 11 n “Software Requirements,” on page 12 Hardware Requirements The system on which vCenter Chargeback Manager is installed must meet the minimum hardware requirements for installing and running the application.
vCenter Chargeback Manager Installation and Upgrade Guide Software Requirements Other than an operating system, you must have a database management system and a Web browser installed to run and access vCenter Chargeback Manager.
Chapter 2 System Requirements n Adobe PDF Reader plug-in for Internet Explorer VMware vCenter Server vCenter Chargeback Manager supports the following vCenter Server releases: n vCenter Server 5.5 n vCenter Server 5.1 n vCenter Server 5.0 Update 1b n vCenter Server 4.1 and later releases n vCenter Server 4.0 and later releases IMPORTANT We recommend that you do not add a vCenter Server 5.0 or vCenter Server 5.0 Update 1 server to vCenter Chargeback Manager because of a known memory leak issue.
vCenter Chargeback Manager Installation and Upgrade Guide 14 VMware, Inc.
Install and Upgrade Prerequisites 3 Before installing or upgrading vCenter Chargeback Manager, you must peform few pre-installation tasks.
vCenter Chargeback Manager Installation and Upgrade Guide Alternately, you can use the fully-qualified domain name (FQDN) for all the servers and databases that vCenter Chargeback Manager communicates with. IMPORTANT In the case of a multi-homed machine, you can configure vCenter Chargeback Manager with only one interface.
Chapter 3 Install and Upgrade Prerequisites You must provide the details of the database and database user when installing vCenter Chargeback Manager. The installer uses these details to create the database schema and objects. Also, vCenter Chargeback Manager and the data collector authenticates in to the database by using this database user account to perform the necessary database operations.
vCenter Chargeback Manager Installation and Upgrade Guide Maximum Number of Connections to the Database The vCenter Chargeback Manager and corresponding data collectors, including the vCloud Director data collector and vShield Manager data collector, connect to the vCenter Chargeback Manager database to read and write data. You must configure the database to ensure that the maximum number of connections can be made to the vCenter Chargeback Manager database by each of the components.
Chapter 3 Install and Upgrade Prerequisites n Ensure that MSI Installation is enabled. Before you start the installation, you must ensure that MSI installation is enabled on the machine. If not, you must manually install Microsoft Visual C++ 2005 Redistributable Package (x86) before running the vCenter Chargeback Manager installer. n Ensure that port exceptions are configured on the Windows firewall.
vCenter Chargeback Manager Installation and Upgrade Guide Table 3‑2. vCenter Chargeback Manager Pre-Install Checklist (Continued) Item Requirement Database user name and password User name of the database user who has privileges to create and delete schema, as well as to read from and write to the database. Password for this user If you are using Windows Authentication for a Microsoft SQL Server database, then you must have the Windows user account name.
Installing vCenter Chargeback Manager 4 After you have ensured that the minimum hardware and software requirements are met and the relevant pre-installation tasks are completed, you can install vCenter Chargeback Manager. vCenter Chargeback Manager can be installed as a stand-alone instance or you can create a cluster of vCenter Chargeback Manager instances.
vCenter Chargeback Manager Installation and Upgrade Guide n Installs the application. n Installs the data collector, which synchronizes the vCenter Chargeback Manager database with the vCenter Server databases. NOTE If the installation fails due to some reason, the uninstaller is automatically invoked and all the components installed till the failure occurred is removed.
Chapter 4 Installing vCenter Chargeback Manager Option Description Database Port (Optional) The port on which the database service is listening for requests. If the port number is not specified, the installer uses the default port. For an Oracle database, you must specify the TNS listener port if you are not using the default port 1521. For an SQL Server database, specify the database instance port if you are using a static port.
vCenter Chargeback Manager Installation and Upgrade Guide Option Description Load-Balancer Port An unused port through which vCenter Chargeback Manager can communicate with the load balancer (Apache Server). Server Instance Name A unique user-defined name for the vCenter Chargeback Manager instance. This name is used by the load balancer to identify the instance. Ensure that the instance name contains only ASCII characters. If the specified ports are free, the next screen is displayed.
Chapter 4 Installing vCenter Chargeback Manager 11 (Optional) If you have a vCloud Director 1.5.x setup, enter the corresponding vCloud Director database-related information, and click Next. Option Description Database Type The type of database used to create the vCloud Director database. The permissible values are ORACLE and SQL Server. Database URL The IP address of the system on which the vCloud Director database is installed.
vCenter Chargeback Manager Installation and Upgrade Guide 14 To generate your own SSL certificate, click Generate my own SSL Certificate. A command-line window is displayed. a Provide a pass phrase for the default key and press Enter. You are prompted to enter the pass phrase three more times. Provide the same pass phrase and press Enter each time. b Provide the required certificate information and press Enter.
Chapter 4 Installing vCenter Chargeback Manager The load balancer ensures that the vCenter Chargeback Manager instances are serving equal number of concurrent sessions. New sessions are distributed to the instances in a round-robin fashion. Also, if one of the instances fails, any request currently being serviced by that instance is automatically redirected to another instance in the cluster.
vCenter Chargeback Manager Installation and Upgrade Guide Option Description Database Port (Optional) The port on which the database service is listening for requests. If the port number is not specified, the installer uses the default port. For an Oracle database, you must specify the TNS listener port if you are not using the default port 1521. For an SQL Server database, specify the database instance port if you are using a static port.
Chapter 4 Installing vCenter Chargeback Manager 10 If a vCloud Director Data Collector is already present in the cluster, then a dialog stating that you provide the same vCloud Director setup details is displayed. Click OK. 11 If you chose to install the vCloud Director data collector, provide information about the vCloud Director setup, and click Next. Option Description vCloud Director Hostname/IP or URL Static IP address or the FQDN of the machine on which the vCloud Director setup is running.
vCenter Chargeback Manager Installation and Upgrade Guide 14 Review the information displayed on the Pre-Installation Summary screen, and click Install. The installer starts installing the various components. If the installation is successful, the URL for accessing the vCenter Chargeback Manager application and the information required to add this installed instance to the cluster is displayed. 15 Note this information, and click Done.
Chapter 4 Installing vCenter Chargeback Manager You can uninstall a vCenter Chargeback Manager instance but retain the database. You can then move the database to a new location and re-install vCenter Chargeback Manager and the load balancer on different machines. When re-installing vCenter Chargeback Manager, you must provide the database details of the relocated vCenter Chargeback Manager database.
vCenter Chargeback Manager Installation and Upgrade Guide Option Description SQL Authentication Mode This option is applicable only for SQL Server databases. For an SQL Server database, the authentication type can be either SQL Server Authentication or Windows Authentication. Database Username The name of the database user. The database user must have privileges to create and delete schema, as well as read from and write to the database.
Chapter 4 Installing vCenter Chargeback Manager Option Description Load-Balancer Port An unused port through which vCenter Chargeback Manager can communicate with the load balancer (Apache Server). Server Instance Name A unique user-defined name for the vCenter Chargeback Manager instance. This name is used by the load balancer to identify the instance. Ensure that the instance name contains only ASCII characters. If the specified ports are free, the next screen is displayed.
vCenter Chargeback Manager Installation and Upgrade Guide Option Description Database Port (Optional) The port on which the database service is listening for requests. If the port number is not specified, the installer uses the default port. You must specify the TNS listener port if you are not using the default port 1521. Database Name Name of the database in which vCloud Director stores the applicationspecific data. This must be the service name and not the SID.
Chapter 4 Installing vCenter Chargeback Manager d Provide the pass phrase and press Enter. e Press any key to complete the process and close the window. An SSL certificate is successfully installed. If you click Generate default SSL Certificate, an SSL certificate with default values is generated. You are not prompted for any information. Press any key, when prompted, to close the command-line window.
vCenter Chargeback Manager Installation and Upgrade Guide Services Related to the vCenter Chargeback Manager When vCenter Chargeback Manager is installed, by default, a load balancer is installed. You can install one or more data collector instances too. The services related to the vCenter Chargeback Manager and its corresponding components must be started for the application to function properly.
Chapter 4 Installing vCenter Chargeback Manager If you start the vCenter Chargeback Manager service, before starting the corresponding database service, then you must manually restart the vCenter Chargeback Manager service after restarting the database service. If vCenter Chargeback Manager, the corresponding database, and the data collectors are installed on different machines, then you must individually start each of the services.
vCenter Chargeback Manager Installation and Upgrade Guide 38 VMware, Inc.
Upgrading vCenter Chargeback Manager 5 You can upgrade an existing vCenter Chargeback Manager setup to the latest version of vCenter Chargeback Manager. If you are using vCenter Chargeback Manager 2.0 or later version, then you can directly upgrade your existing setup to vCenter Chargeback Manager 2.5.1. However, if you have a vCenter Chargeback 1.5 or later setup, then you must first upgrade to vCenter Chargeback Manager 2.0 before upgrading to vCenter Chargeback Manager 2.5.1.
vCenter Chargeback Manager Installation and Upgrade Guide n The logs are configured with unrestricted growth mode. Else ensure that you have provided sufficient space for the logs to grow. We have observed the logs to grow by 20GB when migrating the vCenter Chargeback Manager database with 100 million rows in our test environment. n The Stats Synchronization job of all the data collectors for each vCenter Server added to vCenter Chargeback Manager is completed successfully before you start the upgrade.
Chapter 5 Upgrading vCenter Chargeback Manager 4 Click Upgrade to 2.5.1 in the Alert dialog box. 5 If the vCenter Chargeback Manager database is an SQL Server database, the installer displays the Database Configuration screen. You can choose to change the SQL Authentication Mode option on this screen. If you select Windows Authentication, ensure that you provide the Windows user account name in the form DomainName\UserName. Also, the user must have the Log on as a service permission.
vCenter Chargeback Manager Installation and Upgrade Guide Option Description Database Username The name of the database user. The database user must have privileges to read the vCloud Director database objects. If you have provided a JDBC URL with Windows Authentication for an SQL Server database, this database user account is not used for logging in to the database. However, you must provide the database user account information. Database Password Password for the user name that you have provided.
Chapter 5 Upgrading vCenter Chargeback Manager 5 Run the vCenter Chargeback Manager installer on the machine on which you want to install the vCenter Chargeback Manager instance. During the install provide the details of the retained vCenter Chargeback Manager database and the newly installed load balancer details. Ensure that you select the Install vCenter Chargeback Server option during the installation. VMware, Inc.
vCenter Chargeback Manager Installation and Upgrade Guide 44 VMware, Inc.
Installing and Upgrading Data Collectors 6 vCenter Chargeback Manager interacts with the vCenter Server and vCenter Server database through a data collector. The data collector synchronizes the information in the vCenter Chargeback Manager database with that in the vCenter Server database. Other than the data collector that interacts with the vCenter Server database, vCenter Chargeback Manager provides two more data collectors.
vCenter Chargeback Manager Installation and Upgrade Guide The vShield Manager data collector fetches the network statistics from the vShield Manager for the networks included in the vCloud Director setup.
Chapter 6 Installing and Upgrading Data Collectors 4 Select Create New Data Collector, provide a name for the data collector instance, and click Next. The default name is DataCollector. Ensure that the data collector instance name contains only ASCII characters and starts with 'DataCollector'. 5 Provide the path for the installation directory, and click Next. If the specified installation directory exists, ensure that it is empty.
vCenter Chargeback Manager Installation and Upgrade Guide 8 Note this URL, and click Done. NOTE If the installation fails, the uninstaller starts automatically and removes all the components installed. What to do next After you install a separate data collector, the data collector service starts and runs automatically. You can manually start and stop the service from the Start > Programs > VMware > VMware vCenter Chargeback menu.
Chapter 6 Installing and Upgrading Data Collectors 6 Provide the details of the vCenter Chargeback Manager database that the data collector must synchronize with the vCloud Director database, and click Next. Option Description Database Type The type of database used to create the vCenter Chargeback Manager database. This can be either SQL SERVER or ORACLE. Database URL The IP address or host name of the system on which the vCenter Chargeback Manager database is installed.
vCenter Chargeback Manager Installation and Upgrade Guide 8 (Optional) If you have a vCloud Director 1.5.x setup, enter the corresponding vCloud Director database-related information, and click Next. Option Description Database Type The type of database used to create the vCloud Director database. The permissible values are ORACLE and SQL Server. Database URL The IP address of the system on which the vCloud Director database is installed.
Chapter 6 Installing and Upgrading Data Collectors Install vShield Manager Data Collector If you integrate a vCenter Chargeback Manager instance with a vCloud Director instance, you must have a vShield Manager data collector instance installed and running to fetch the network statistics from vShield Manager. You can install a vShield Manager data collector instance along with vCenter Chargeback Manager or separately using the vShield Manager data collector installer.
vCenter Chargeback Manager Installation and Upgrade Guide 6 Provide the details of the vCenter Chargeback Manager database that the data collector must synchronize with the vCloud Director database, and click Next. Option Description Database Type The type of database used to create the vCenter Chargeback Manager database. This can be either SQL SERVER or ORACLE. Database URL The IP address or host name of the system on which the vCenter Chargeback Manager database is installed.
Chapter 6 Installing and Upgrading Data Collectors What to do next After you install a vShield Manager data collector instance, the vShield Manager data collector service starts and runs automatically. You can manually start and stop the service from the Start > Programs > VMware > VMware vCenter Chargeback menu. Upgrade Data Collectors Upgrading a vCenter Chargeback Manager instance does not automatically upgrade the standalone data collector instances associated with it.
vCenter Chargeback Manager Installation and Upgrade Guide 54 VMware, Inc.
Uninstalling vCenter Chargeback Manager 7 You can uninstall vCenter Chargeback Manager and the corresponding components by running the uninstaller. The uninstaller removes the vCenter Chargeback Manager and the corresponding component files from the system. You can optionally choose to remove the data from the database. If you have installed the load balancer and vCenter Chargeback Manager on different machines, then you must run the uninstaller on both the machines.
vCenter Chargeback Manager Installation and Upgrade Guide 3 (Optional) If you chose to empty the vCenter Chargeback Manager database, click Continue. 4 Click Continue to confirm the uninstallation. 5 Click Done. What to do next If you uninstall an instance that is part of a cluster, ensure that you manually remove the entries corresponding to the instance from the load balancer.
Chapter 7 Uninstalling vCenter Chargeback Manager 4 Option Description Database Name Name of the database in which vCenter Chargeback Manager stores the application-specific data. For Oracle Database, ensure that you provide the service name and not the SID. SQL Authentication Mode This option is applicable only for SQL Server databases. For an SQL Server database, the authentication type can be either SQL Server Authentication or Windows Authentication.
vCenter Chargeback Manager Installation and Upgrade Guide 58 VMware, Inc.
Index A S application, accessing 37 services application services 36 manage 36 system requirements database management systems 12 hardware 11 operating systems 12 software 12 vCenter Server 12 web browsers 12 C chargeback definition 7 non-virtual environment 7 virtual environment 7 D data collector about 45 install vCenter Chargeback Manager Data Collector 46 install vCloud Director Data Collector 48 install vShield Manager Data Collector 51 uninstall 57 upgrade 53 definition, chargeback 7 I install
vCenter Chargeback Manager Installation and Upgrade Guide 60 VMware, Inc.
