vCenter Chargeback Manager Installation and Upgrade Guide vCenter Chargeback Manager 2.5.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 © 2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
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 18 Download and Extract the vCenter Chargebac
vCenter Chargeback Manager Installation and Upgrade Guide Uninstall Data Collector 57 Index 59 4 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 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. Also, do not add a vCenter Server 5.0 Update 1a server because of a known upgrade issue in vCenter Server. If you have a vCenter Server 5.0, vCenter Server 5.0 Update 1, or vCenter Server 5.
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 vCenter Chargeback Manager Database User Privileges in SQL Server After you create a database instance and a database user in SQL Server that vCenter Chargeback Manager can use, you must assign privileges to this user by running the following commands in SQL Server: CREATE ROLE CB_ADMIN_ROLE; GRANT ALTER ON SCHEMA :: DBO TO CB_ADMIN_ROLE; GRANT REFERENCES ON SCHEMA :: DBO TO CB_ADMIN_ROLE; GRANT INSERT ON SCHEMA :: DBO TO CB_ADMIN_ROLE; GRANT SELECT ON SCHEMA ::
vCenter Chargeback Manager Installation and Upgrade Guide Table 3-1.
Chapter 3 Install and Upgrade Prerequisites Table 3-2. vCenter Chargeback Manager Pre-Install Checklist Item Requirement Checked Hardware Configuration CPU 2.
vCenter Chargeback Manager Installation and Upgrade Guide Download and Extract the vCenter Chargeback Manager Installer You must first download the installer files and extract its contents on to the machine on which you want to install vCenter Chargeback Manager. You must run the installer on the local machine and not from a remote machine. Procedure 1 Download the installation-related files, vCenter-CB-version_number-build_number.zip, from http://www.vmware.com/products/vcenter-chargeback/overview.html.
Installing vCenter Chargeback Manager 4 After you have ensured that the minimum hardware and software requirements are met and the relevant preinstallation 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 databaserelated 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 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. If you select Windows Authentication for SQL Authentication Mode, you must provide the Windows user account name. The user name must be of the form DomainName\UserName. Also, the user must have the Log on as a service permission.
Chapter 4 Installing vCenter Chargeback Manager 9 Select the data collectors that you want to install and click Next. The Install vCenter Chargeback Manager Data Collector option is selected by default. You must have at least one instance of this data collector running and registered with the application for the database synchronization jobs to run. You can optionally choose to install the vCloud Director data collector and vShield Manager data collector.
vCenter Chargeback Manager Installation and Upgrade Guide 12 Review the information displayed on the Pre-Installation Summary screen, and click Install. The installer starts installing the various components and creating the database schema. If you are also installing the vCloud Director data collector, click OK in the dialog box. If the installation is successful, the URL for accessing the vCenter Chargeback Manager is displayed. 13 Note this URL, and click Done.
Chapter 4 Installing vCenter Chargeback Manager Procedure 1 Select Generate SSL Certificate from the Start > Programs > VMware > VMware vCenter Chargeback > vCenter Chargeback Manager Tools menu. The Generate SSL Certificate window is displayed. 2 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. 3 Provide the required certificate information and press Enter.
vCenter Chargeback Manager Installation and Upgrade Guide VMware vCenter Chargeback DataCollectorEmbedded Starting this service starts the data collector instance that was installed along with the vCenter Chargeback Manager. VMware vCenter Chargeback DataCollector Starting this service starts the data collector instance that was installed individually (in this case, the name of the instance is DataCollector) and not with the application.
Chapter 4 Installing vCenter Chargeback Manager Procedure 1 Select the relevant service menu from the Start > Programs > VMware > VMware vCenter Chargeback > vCenter Chargeback Manager Services menu.
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. 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.
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 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 external traffic information from vShield Manager for the following types of vCloud Director networks: n Private routed org networks n Routed vApp networks n Fenced vApp networks In the case that a routed or fenced vApp network is connected to a private routed org network, then the external traffic information of the corresponding virtual machine is recorded at both, the vApp network level as well
Chapter 6 Installing and Upgrading Data Collectors 5 Provide the path for the installation directory, and click Next. If the specified installation directory exists, ensure that it is empty. If the specified installation directory does not exist, the installer creates the directory. The install path must contain at least one folder. You cannot provide only the drive name. Also, the directory path must contain only ASCII characters.
vCenter Chargeback Manager Installation and Upgrade Guide 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. Install vCloud Director Data Collector If you want to integrate a vCenter Chargeback Manager instance with a vCloud Director instance, you must have a vCloud Director data collector instance installed and running.
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 databaserelated 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 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.
vCenter Chargeback Manager Installation and Upgrade Guide 58 VMware, Inc.
Index A S application, accessing 37 services application services 35 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.
