Getting Started with vFabric Suite VMware vFabric Suite 5.1 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. EN-000899-00 You can find the most up-to-date technical documentation on the VMware Web site at: https://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. VMware products are 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.
Table of Contents 1. About Getting Started with vFabric Suite .................................................................................................. 1 Intended Audience ......................................................................................................................... 1 2. Quick Start Guide .............................................................................................................................. 3 3. Overview of vFabric Suite 5.1 ........................
iv vFabric Suite
About Getting Started with vFabric Suite 1 1. About Getting Started with vFabric Suite Revised May 29, 2012. Getting Started with vFabric Suite describes product concepts and initial setup tasks for VMware® vFabric Suite™ products. Read this documentation for an overview of vFabric Suite components; to familiarize yourself with the licensing infrastructure; and to see walkthrough procedures for installing vFabric Suite components.
2 vFabric Suite 2 About Getting Started with vFabric Suite
Quick Start Guide 3 2. Quick Start Guide This section guides you through the end-to-end process of installing vFabric Suite, or more specifically, installing one vFabric component on a Red Hat Enterprise Linux (RHEL) virtual machine in the context of vFabric Suite.
4 vFabric Suite e. Enter a name and description of the data source, then select the SQL Server and database instance you want this data source to connect to from the drop-down list. The SQL Server database system can be either the one used by the vCenter Server or a separate one, whichever works best for your environment. Click Next. f.
Quick Start Guide 5 The license keys are displayed in the main vCenter Licensing window under the name VMware vFabric Suite Standard|Advanced, depending on the vFabric Suite package you purchased. 6. Install the vfabric-5.1-repo-5.1 repository RPM on the RHEL VM. a. Log in to the RHEL VM as the root user (or user with sudo privileges) and start a terminal. b. Run the rpm command to install the vfabric-5.1-repo-5.
6 vFabric Suite 6 Quick Start Guide
Overview of vFabric Suite 5.1 7 3. Overview of vFabric Suite 5.1 The rise of cloud computing and IT as a service is driving dramatic changes in application infrastructure and development. VMware® vFabric Suite™ components embrace this shift by integrating the familiar Spring Developer Frameworks with a proven set of services that span the lifecycle of modern application development, deployment, and management.
8 vFabric Suite vFabric Suite Standard Component vFabric Suite Advanced Component Component and Version Description vFabric Hyperic 4.6 Proactive performance management with complete and constant visibility into applications and infrastructure. Yes. Yes. vFabric GemFire 6.6 Data management platform that provides real-time, consistent access to data across widely distributed cloud architectures. GemFire Application Cache Node is the vFabric Suite offering for vFabric GemFire. Yes. Yes.
Overview of vFabric Suite 5.1 9 vFabric tc Server 2.7 (Spring Edition) VMware® vFabric™ tc Server is 100-percent compatible with Apache Tomcat 7. It has all the runtime advantages of Tomcat, plus operational management, advanced diagnostics, mission-critical support, and unmatched visibility into Spring-powered applications — none of which are available in the open source product.
10 vFabric Suite machine and JVM are configured correctly for EM4J and see detailed information about the JVM process and memory usage. Alerts warn of EM4J configuration problems and suggest best practices. Spring Insight Operations 1.8 Engineered for vSphere, Spring, and Production Environments Spring Insight Operations gives you real-time, granular visibility into application behavior and performance in production environments.
Overview of vFabric Suite 5.1 11 • iPad and iPhone support. • Deeper integration with LDAP that enables the automatic import of existing LDAP user groups to preassign roles to users. • Auto-discovery across all operating systems that run on vSphere and in disparate run-time environments, from Java to .NET. • Bridges the gap between virtual and physical: compares guest and host metrics (CPU, memory, disk utilization); relates physical and virtual performance to individual applications.
12 vFabric Suite memory. Using dynamic replication and data partitioning techniques, GemFire offers continuous availability, high performance and linear scalability for data-intensive applications without compromising data consistency, even under failure conditions. Data virtualization provides data location transparency and decouples data access logic from applications. The vFabric Suite offering for vFabric GemFire is the Application Cache Node, which provides peer-to-peer functionality.
Overview of vFabric Suite 5.1 13 • Supports all modern messaging patterns: point-to-point (RPC style), point-and-shoot, publish-subscribe, multicast, and more. All are available as durable or non-durable message types. • Protocol-based for better interoperability. Other messaging systems are API based, which limits their interoperability. • Through protocol adapters, supports a full range of Internet protocols for lightweight in-browser messaging— including XMPP, SMTP, STOMP, and HTTP.
14 vFabric Suite Main features of vFabric SQLFire 1.0: • Enables applications to manage data entirely in memory through partitioning and synchronous replication that distributes data across numerous SQLFire members. • Optimized disk persistence mechanism with a non-flushing algorithm to maintain high performance in applications that require stable, long-term storage.
Overview of vFabric Suite 5.1 15 and manage vPostgres databases using the Data Director administration UI, or use vPostgres client tools to connect to vPostgres databases, load data, run scripts, perform backups, and run applications. (vFabric Suite does not include Data Director.) vFabric Postgres databases offer elastic database memory, database-aware high availability, and automated optimal database configuration.
16 vFabric Suite vFabric Administration Server for Easier Component Management VMware® vFabric™ Administration Server is a platform-independent, secure tool for installing, upgrading, provisioning, and managing vFabric products. It is a client/server service and RESTful Web Service implemented on HTTP. Because HTTP is ubiquitous, clients do not require specific libraries or protocols. You can write scripts in any language that can handle HTTP requests and responses.
Overview of vFabric Suite 5.1 17 • vFabric GemFire includes an HTTP session management module for tc Server that provide fast, scalable, and reliable session replication without requiring application changes. • Optimized for vFabric runtime components, vFabric Application Director provides a cloud-enabled application provisioning solution that accelerates and automates the configuration and deployment of multi-tier applications.
18 vFabric Suite 18 Overview of vFabric Suite 5.
vFabric Licensing 19 4. vFabric Licensing What type of licensing you get and how you activate it depends on whether you purchased your vFabric product(s) standalone or as part of a vFabric Suite package (Standard or Advanced). Production licensing in both cases requires a license key. A license key is an alphanumeric sequence of 25 characters that encodes details of the associated product, the license expiration date, the license capacity, and other information.
20 vFabric Suite Procedure 1. From the Drivers and Tools tab of the download page for vFabric Suite Advanced or Standard, download the vFabric License Check Tool utility ZIP file onto the computer on which you want to run it. The file is called vfabric-vfchksn-version.bin.zip. 2. Unzip the file into a directory. The utility and supporting files are unzipped into the vfabric-vfchksn-version child directory. 3. If necessary, install a JDK or JRE on the computer.
vFabric Licensing 21 License Usage Reporting The vCenter License Reporting Manager displays the capacity of your vFabric Suite license, although it does not keep track of the number of licenses currently assigned. To get the usage summary (both current and periodic) from the vFabric License Server, you run Windows commands or use a simple Web user interface. For details about how to monitor vFabric license usage, see Monitoring vFabric License Usage.
22 vFabric Suite 22 vFabric Licensing
Installing vFabric Suite 23 5. Installing vFabric Suite Installing vFabric Suite is a multi-step process. The high-level steps are: 1. Install the vFabric License Server on the same computer on which your existing vCenter Server is installed. 2. Activate your vFabric licenses. 3. Install individual vFabric components (such as vFabric tc Server) on one or more virtual machines (VMs).
24 vFabric Suite The installer program is called vFabric_License_Server-version.exe. Procedure 1. On the same Windows computer on which you are running vCenter Server, login as the Administrator user (or user with administrator privileges) if you have User Account Control (UAC) enabled. If UAC is disabled, you can login as any user. 2. Double-click the vFabric License Server installer program from Windows Explorer to start the installation.
Installing vFabric Suite 25 The installer program completes successfully when you see the message InstallShield Wizard Completed. 7. To view details of the installation, click Show the Windows Installer Log. Click Finish to complete the installation. 8. Restart your vCenter Server to enable the vFabric License Server changes. What to do next • Activate vFabric Suite licenses in your vCenter Server.
26 vFabric Suite that you create a separate database instance (also referred to as an Oracle database schema) for vFabric use so as to keep the data of the two products separate. This ODBC data source should be used only by vFabric License Server. This section provides instructions for the Oracle database system. Prerequisites • Install the appropriate Oracle ODBC driver on the vCenter Server Windows computer; you will use this driver to connect to your Oracle database.
Installing vFabric Suite 27 Guidelines for Creating the vFabric License Server Database Instance vFabric License Server fully supports using the database system associated with vCenter Server to store its license data. However, VMware recommends that you create a separate database instance for vFabric use so as to keep the data of the two products separate. (The term database instance refers to either an Oracle database schema or a Microsoft database.
28 vFabric Suite 3. Enter one or more license keys in the text window to the right, one license key per line. Enter an optional label. 4. Click the Add License Keys button. The license key shows up in the review window. 5. Repeat the preceding steps to add any additional license keys. 6. Click Next and follow the prompts until you get to the Confirm Changes window, verify changes, then click Finish.
Installing vFabric Suite 29 If your guest operating system is Red Hat Enterprise Linux (RHEL), VMware recommends that you use yum to install vFabric components from the VMware RPM repository. This section describes a typical example of installing vFabric tc Server on a VM with an RHEL guest operating system. The procedure shows typical steps but does not go into detail about the installation. For complete installation instructions, see the vFabric tc Server documentation.
30 3. vFabric Suite Use the yum search vfabric command to view the list of vFabric components that you can install from the VMware repository. For example (with sample output): prompt# yum search vfabric ... ======================================== Matched: vfabric ========================================= vfabric-eula.noarch : VMware vFabric 5.1 End User License Agreement vfabric-gemfire.noarch : VMware vFabric GemFire vfabric-hyperic-agent.noarch : VMware vFabric Hyperic Agent vfabric-hyperic-server.
Installing vFabric Suite 31 See the vFabric component-specific documentation for details. Windows/Linux: Example Walkthrough of Installing Component from Download Page After you install the vFabric License Server in your vCenter environment, you install one or more vFabric components on one or more virtual machines (VM). The vFabric License Server automatically keeps track of the number of VMs on which you install the components.
32 6. vFabric Suite Open a terminal (Unix) and create a directory to contain the tc Runtime component, such as /opt/vmware. For example: prompt$ mkdir /opt/vmware 7. Extract the tc Server distribution file into the new directory. This action installs tc Runtime; there is no installer program.
Installing vFabric Suite 33 2. From the Windows Control Panel, start the window from which you add or remove programs. On Windows XP, the window is called Add or Remove Programs. On Windows Server, the window is called Programs and Features. 3. Select VMware vFabric License Server in the list of programs and uninstall it. 4. If you want to unregister vFabric License Server from vCenter, enter the credentials of the vCenter user who has, at a minimum, the following vCenter privilege: • Extension.
34 vFabric Suite 34 Installing vFabric Suite
Monitoring vFabric License Usage 35 6. Monitoring vFabric License Usage vFabric Suite provides Windows command-line tools and a simple Web user interface to monitor vFabric license usage by the VMs. Note: Although you previously activated vFabric licenses using the vSphere client, you cannot yet use the vSphere client user interface to monitor the vFabric license usage; rather, you must use the commands described in this section.
36 vFabric Suite prompt> cd c:\Program Files\VMware\Infrastructure\vFabric Platform\Reporting 2. Run the desired monitoring command; see Command Reference for a table that lists all the commands along with their required or optional parameters. For example, run the usage-over-periods.bat command to display vFabric license usage over a period of time. You must specify the start and end dates of the time period, as well as the period, such as monthly or yearly. prompt> usage-over-periods.
Monitoring vFabric License Usage 37 Command Reference Table 6.1. vFabric License Server Monitoring Commands Monitoring Command current-usage.bat Description Displays the current vFabric license usage and capacity, organized by license key. By default, the command displays information for the entire vCenter Server. To group the output by cluster, resource pool, or data center, specify the -group cluster | resourcePool | datacenter parameter.
38 vFabric Suite Monitoring Command Description Note: Do not specify a period prior to when the License Server was installed; if you do, the average usage will not be accurate. To group the output by cluster, resource pool, or data center, specify the -group cluster | resourcePool | datacenter parameter. For example, to group by resource pool, specify -group resourcePool. The output will list the associated resource pool for each license usage entry.
Monitoring vFabric License Usage 39 https://host:8443/vfabric-license-server/report/create where host is the IP address or hostname of the Windows computer on which you installed the vFabric License Server into a vCenter Server. If your browser is on the same computer, you can use localhost over HTTP: http://localhost:8080/vfabric-license-server/report/create The following Web page appears: 2.
40 vFabric Suite The output shows the minimum, maximum, and average usage of the two license keys that have been installed in the vCenter Server. The period reflects the last 90 days from the current day (in this case May 1, 2012.) The bottom table lists all the vFabric components that the vFabric License Server is tracking, the version of the installed component, and the minimum, maximum, and average license usage for each component over the same period.
Monitoring vFabric License Usage 41 Procedure 1. On the VM on which the vFabric component is installed, download the vFabric License Check Tool from the Drivers and Tools tab of the download page for vFabric Suite Advanced or Standard. The file is called vfabric-vfchksn-version.bin.zip. 2. Unzip the file into a directory. The utility and supporting files are unzipped into the vfabric-vfchksn-version child directory. 3.
42 vFabric Suite 2011-11-28T11:16:40 [INFO] Component Instance "self" changed state to "on" at 2011-11-28T11:16:40. 2011-11-28T11:16:40 [INFO] Calculated new state for license with total available units = 65535, license type = local, expiration date = 2011-12-28T11:16:40, enforcement = soft, addons = It now has a total used count of 1. 2011-11-28T11:16:40 [INFO] Component Instance "self" changed state to "off" at 2011-11-28T11:16:40.
