Getting Started with vFabric Suite VMware vFabric Suite 5.2 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-001013-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.2 ........................
iv vFabric Suite
About Getting Started with vFabric Suite 1 1. About Getting Started with vFabric Suite Revised October 16, 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 e. 5 Follow the prompts until you get to the Confirm Changes window, verify changes, and click Finish. 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 VMware 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.
6 vFabric Suite 6 Quick Start Guide
Overview of vFabric Suite 5.2 7 3. Overview of vFabric Suite 5.2 Cloud computing and IT as a service continue to transform application infrastructure and development. VMware® vFabric Suite™ embraces this change 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 Spring Insight Operations 1.8 Performance monitoring with realtime, multi-layered visibility into applications running on tc Server. Yes. Yes. vFabric Hyperic 4.6 Proactive performance management with complete and constant visibility into applications and infrastructure. Yes. Yes. vFabric GemFire 6.
Overview of vFabric Suite 5.2 Component and Version 9 Description vFabric Suite Standard Component vFabric Suite Advanced Component clouds and in dynamic virtual environments. vFabric tc Server 2.8 (Spring Edition) VMware® vFabric™ tc Server is 100-percent compatible with Apache Tomcat 7.
10 vFabric Suite application performance and reliability. You can size the Java heap to accommodate the peak workload, without wasting or running out of memory. Any excess memory is ballooned away and redistributed where it is needed. This capability lets you create more VMs and pack more tc Server instances onto a single vSphere host. It also reduces the likelihood of out-of-memory errors that can cripple applications. A new EM4J plug-in is available for the vSphere Web Client.
Overview of vFabric Suite 5.2 11 As part of Application Performance Manager, vFabric Hyperic is integrated with vFabric AppInsight. Together they provide an application operations dashboard that automatically models transactions across all application tiers, providing a critical realtime perspective on the true performance of dynamically scaling applications.
12 vFabric Suite • Deploy a Web application from an accessible file system, either local or remote. You can deploy to a single tc Runtime instance or to a predefined group of servers. • Manage the lifecycle of applications deployed to a single tc Runtime instance or group of servers. Application lifecycle operations include start, stop, redeploy, undeploy, and reload. Spring Insight Plug-In for Detailed Application Metrics vFabric Hyperic includes the Spring Insight plug-in.
Overview of vFabric Suite 5.2 13 • Horizontally scalable to thousands of cache nodes, with multiple cache topologies to meet different enterprise needs. The cache can be distributed across multiple computers. • Support for asynchronous and synchronous cache update propagation. • Optimized low latency distribution layer for reliable asynchronous event notifications and guaranteed message delivery. For new feature information, see vFabric GemFire Release Notes.
14 vFabric Suite Main features of vFabric Web Server: • Sample template that automatically configures vFabric Web Server for a tc Server 2.6 instance. • Precompiled builds that deliver up to 100% performance improvements, increasing uptime and reducing costs for hardware capacity. • Guaranteed binary drop-in bug and security-fix help for every supported platform, to reduce the time you spend on security issues.
Overview of vFabric Suite 5.2 15 For new feature information, see vFabric SQLFire Release Notes. vFabric Application Director 1.0 VMware® vFabric™ Application Director is a cloud-enabled application provisioning solution that accelerates and automates the configuration and deployment of multi-tier applications. vFabric Application Director is optimized for vFabric components, but is extensible to other components that may be part of your Spring application.
16 vFabric Suite database buffer pool to make memory available, and, when memory is available, accordingly increases the amount of memory dedicated to the buffer pool. • Higher default values for many critical settings compared with standard Postgres databases, including the settings for shared_buffers, checkpoint_segments, and wal_buffers. These defaults give you higher out-of-the-box performance than standard Postgres and a database that you can tune more easily according to workload.
Overview of vFabric Suite 5.2 17 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.
18 vFabric Suite • vFabric Administration Server enables you to easily install, provision, and manage vFabric tc Server, RabbitMQ, and GemFire on any number of computers on your network. The server includes a REST API for each vFabric product, which provides access to unique product features while maintaining a consistent management model across all products.
Overview of vFabric Suite 5.2 19 • Open Source Apache Tomcat support and support methodology • Open Source Apache httpd support and support methodology • Open Source RabbitMQ support and support methodology If your operating system is Red Hat Enterprise Linux (RHEL) 5 or 6, you can monitor the usage of the OSS components on your VMs. See RHEL: Optionally Configure VM to Track Open-Source Software Component Usage.
20 vFabric Suite 20 Overview of vFabric Suite 5.
vFabric Licensing 21 4. vFabric Licensing vFabric production licensing 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.
22 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.
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 • Create an ODBC data source that connects to the either the vCenter database system or a separate database system; be sure that only vFabric License uses this ODBC data source. vFabric License Server supports Microsoft SQL Server and Oracle databases. See Create the Microsoft SQL Server ODBC Data Source or Create the Oracle ODBC Data Source for details.
Installing vFabric Suite 25 5. Enter the login ID and password of the database user, and select the ODBC data source (DSN) that you created as a prerequisite to this procedure. 6. Click Install to proceed with the installation. The installer program installs the vFabric License Server, showing you a status of the installation as it performs its tasks. The installer program completes successfully when you see the message InstallShield Wizard Completed. 7.
26 vFabric Suite The SQL Server can be the one used by the vCenter Server or a different one, whichever works best for your environment. 6. Specify that you want SQL Server to verify the authenticity using a login ID and password entered by the user, then enter the Login ID and password of the SQL Server user. This database user must have privileges to load the schema. VMware recommends that you not specify integrated Windows authentication. 7.
Installing vFabric Suite 4. Select the Oracle driver from the list. Click Finish. 5. In the Oracle ODBC Driver Configuration window, enter a Data Source Name and Description of the data source. 27 Select the Oracle database system and database you want this data source to connect to from the TNS Service Name dropdown list. The entries in the list come from the c:\instantclient_11_2\tnsnames.ora file.
28 vFabric Suite Note: This procedure shows how to use version 5.0 of vSphere Client. 2. Select Home > Administration > Licensing to invoke the vCenter Licensing page, then click the Manage vSphere Licenses link in the top-right corner, as shown in the screenshot. 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.
Installing vFabric Suite 29 include Apache Tomcat, Apache HTTP Server, and RabbitMQ. See RHEL: Optionally Configure VM to Track Open-Source Software Component Usage. RHEL: Example Walkthrough of Installing Component From the VMware RPM Repository 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).
30 vFabric Suite • Launches the VMware End User License Agreement (EULA) acceptance and repository configuration script. • Outputs the EULA for you to read; you must answer yes to accept the terms and continue. 3. Use the yum search vfabric or yum search vmware command to view the list of vFabric components that you can install from the VMware repository. For example (output truncated for clarity): prompt# yum search vfabric ...
Installing vFabric Suite 31 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 vFabric Suite 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. For example, if you created a directory called /opt/vmware in the preceding step, and downloaded the Standard Edition file in the /opt/Downloads directory: prompt$ cd /opt/vmware prompt$ unzip /opt/Downloads/vfabric-tc-server-standard-2.8.0.RELEASE.
Installing vFabric Suite 2. 33 Execute the following yum command to install the OSS license agent: prompt# yum install vfabric-agent The yum command begins the install process, resolves dependencies, and displays the packages it plans to install. The yum command automatically choses the appropriate RPM package based on your architecture (32- or 64-bit). 3. Enter y at the prompt to begin the actual installation. If the installation is successful, you will see a Complete! message at the end.
34 vFabric Suite Uninstall vFabric License Server from vCenter Server Uninstalling vFabric License Server removes the Web application from the vCenter Tomcat instance, but it does not remove the vFabric licensing data from the database; you must perform that step yourself. Procedure 1. Log on to the Windows computer on which you are running vCenter Server and on which you installed vFabric License Server. 2. From the Windows Control Panel, start the window from which you add or remove programs.
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 use the vSphere client user interface to monitor the vFabric license usage; rather, you must use the commands described in this chapter.
36 vFabric Suite 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. Output is shown after the command. prompt> usage-over-periods.bat -startDate 09/01/2012 -endDate 09/4/2012 -period WEEKLY Period: WEEKLY License Key,Dates,Minimum Usage,Maximum Usage,Average Usage 123AA-123BB-123CC-123DD-123EE,"Sep 1, 2012 - Sep 7, 2012",2,4,3.
Monitoring vFabric License Usage Option Description -datacenter datacenter-name Displays current usage and capacity information for the specified virtual data center. -resourcePool resourcePool-name Displays current usage and capacity information for the specified resource pool. 37 Example The following example shows how to run the current-usage.bat Windows command to get a report of the total current vFabric license usage. prompt> current-usage.
38 vFabric Suite Example The following example shows how to view all the currently-installed vFabric and open-source components that the vFabric License Server is tracking and the number of virtual machines on which each component is installed, grouped by datacenter: prompt> current-versions.
Monitoring vFabric License Usage Option 39 Description You can specify only one of the following options: -group, -cluster, -datacenter, or -resourcePool. -resourcePool resourcePool-name Displays periodic usage information for the specified resource pool. You can specify only one of the following options: -group, -cluster, -datacenter, or -resourcePool. -period period Specifies the period that the report covers, such as daily or monthly, during the specified date range (see previous two entries).
40 vFabric Suite Syntax versions-over-periods.bat {-days days | range} [-group group | -cluster name | -datacenter name | -resourcePool name ] [-period p The following table lists the options for this command. Table 6.4. Options of usage-over-periods.bat Option Description -days number Specifies a date range in which the end date is today and the start date is the current date minus number of days. For example, use -days 90 to specify an approximate date range of the last three months.
Monitoring vFabric License Usage 41 versions-over-periods.bat -startDate 09/01/2012 -endDate 10/04/2012 -period MONTHLY The output will look something like the following: Period: MONTHLY Component Name,Component Version,Dates,Minimum Number of Machines,Maximum Number of Machines,Average Number of Machines VMware vFabric tc Server,2.8.0.RELEASE,"Sep 1, 2012 - Sep 30, 2012",0,0,0 VMware vFabric tc Server,2.8.0.RELEASE,"Oct 1, 2012 - Oct 4, 2012",0,1,0.53 Apache Tomcat,7.0.
42 vFabric Suite 2. Specify a range of dates by either entering the number of days previous to the current date, or entering a specific start- and end-date. 3. Specify the output of the report: either an HTML Web page that is rendered immediately, or a downloadable *.csv file that you can open in a spreadsheet program, such as Microsoft Excel, or import into a database application. 4. Click Create Report. 5.
Monitoring vFabric License Usage 43 The output shows the minimum, maximum, and average usage of the two license keys that have been installed in the vCenter Server. The date range is the last 90 days from the current day (in this case October 3, 2012.
44 vFabric Suite Prerequisites • If necessary, install a JDK or JRE on the VM on which the vFabric component is installed. Be sure the JAVA_HOME and PATH environment variables point to the JDK or JRE. For example, if you installed the JDK in /usr/java/jdk1.6.0_24, you can set the environment variables in the user's Linux profile as follows: export JAVA_HOME=/usr/java/jdk1.6.0_24 export PATH=$JAVA_HOME/bin:$PATH Procedure 1.
Monitoring vFabric License Usage 45 The locations of the events files might differ for your particular vFabric component, depending on how exactly you installed it. For example, to display event log information in readable fashion for a vFabric tc Server component in which the events file is in its default location, run the following (Linux): prompt$ cd /opt/vfabric/utils/vfabric-vfchksn-1.2.0.6 prompt$ ./vfabric-licensetool printevents -f /opt/vmware/vfabric-tc-server-standard/myserver/logs/vf.tc-events.
46 vFabric Suite 46 Monitoring vFabric License Usage
