Getting Started with vFabric Suite VMware vFabric Suite 5.3 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 © 2013 VMware, Inc. All rights reserved. This product is protected by copyright and intellectual property laws in the United States and other countries as well as by international treaties. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents.
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.3 ........................
iv vFabric Suite
About Getting Started with vFabric Suite 1 1. About Getting Started with vFabric Suite Revised April 23, 2013. 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 in a vSphere environment, 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.3 7 3. Overview of vFabric Suite 5.3 Cloud computing and IT as a service continue to transform application infrastructure and development. VMware® vFabric Suite™ drives 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 Component and Version vFabric Suite Description vFabric Suite Standard Component vFabric Suite Advanced Component distributed cloud architectures. GemFire Application Cache Node is the vFabric Suite offering for vFabric GemFire. vFabric Web Server 5.3 Precompiled and pretuned Web server and load-balancing service that dynamically routes requests to an application server for processing. vFabric Web Server is fully compatible with Apache Web Server. Yes. Yes. vFabric RabbitMQ 3.
Overview of vFabric Suite 5.3 9 • Hyperic- Spring Insight integration enables you to move from Hyperic to Insight, in the same application context, to diagnose the underlying problem. See tc Server Plug-In for Easier Management and Monitoring. • vFabric GemFire includes an HTTP session management module for tc Server that provide fast, scalable, and reliable session replication without requiring application changes.
10 vFabric Suite tc Server harnesses the power of traditional JEE architectures while eliminating their complexity and performance drawbacks, making it easier, faster, and more cost-effective to build and run cloud-ready applications. With its lean architecture and small, 10MB memory footprint, tc Server requires significantly fewer resources than conventional servers, which allows for greater server density in virtual and cloud environments.
Overview of vFabric Suite 5.3 11 For new feature information, see vFabric EM4J Release Notes. Spring Insight Operations 1.9 Spring Insight Operations gives you real-time, granular visibility into application behavior and performance in production environments. It is a Web application that runs with tc Server Spring Edition and is a separate download. Insight Operations graphs the health of an application over time for the entire cluster and for each server in the cluster.
12 vFabric Suite • Single unified dashboard for managing and monitoring performance across all application tiers. • tc Server plug-in for easier, remote management and monitoring of multiple tc Server instances and applications. See tc Server Plug-In for Easier Management and Monitoring. • Spring Insight plug-In for in-depth application monitoring. The plug-in makes it easier to discover whether a problem is infrastructure or application-related.
Overview of vFabric Suite 5.3 13 metrics associates the application to currently monitored Hyperic resources such as application servers, database servers, the operating system, and specific resource types. By providing all of this information on one screen, Hyperic makes it easier to pinpoint whether the problem is infrastructure- or application-related.
14 vFabric Suite HTTP Session Replication The GemFire HTTP Session Management Module provides fast, scalable, and reliable HTTP session replication for vFabric tc Server, Oracle WebLogic Server, and Apache Tomcat with minimal or no application changes. Depending on your usage model, you can replicate session data across multiple peers, partition data across multiple servers, distribute session data across a WAN, or manage your session data in many other customizable ways. vFabric RabbitMQ 3.
Overview of vFabric Suite 5.3 15 • Guaranteed binary drop-in bug and security-fix help for every supported platform, to reduce the time you spend on security issues. • Fast installation process that gets you up and running in minutes: consistent installation and directory structure across all operating systems, seamless integration with existing infrastructures, and no preset installation requirements. • Easy installation of multiple instances of on a single server.
16 vFabric Suite vFabric Application Director 5.0 (Provisioning) 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.
Overview of vFabric Suite 5.3 17 • Checksums performed by default on each write operation to tables and indexes, ensuring that when vPostgres retrieves data, the data is clean. • Allows you to configure the required crash-recovery Service Level Agreement (SLA), and tunes the checkpoint parameters dynamically as it monitors performance.
18 vFabric Suite 18 Overview of vFabric Suite 5.
vFabric Suite Licensing 19 4. vFabric Suite Licensing vFabric Suite Standard and vFabric Suite Advanced packages are licensed on a per-machine and average-usage basis. This chapter explains how vFabric Suite licensing works. Subtopics vFabric Licensing Terminology How Licensing Works Check the Validity of an Existing License Key vFabric Suite Licensing Terminology To understand vFabric licensing, review the related terminology: • license key. vFabric Suite production licensing requires a license key.
20 vFabric Suite You obtain a pool of licenses that you activate by adding only one license key to the vFabric License Server. Rather than installing a license key on each machine, you register one license key that represents the number of license units that you have purchased. See Activate vFabric Suite Licenses. To check the validity of a license key, see Check the Validity of an Existing License Key.
vFabric Suite Licensing 21 prompt> vfabric-licensetool.bat checkserial [options] serial-number You can specify the following options: • -f input-filename : Read the license key from a text file called input-filename rather than from the command line. • -o output-filename : Print results to a file called output-filename rather than to the standard output. • -? : Print usage information.
22 vFabric Suite 22 vFabric Suite Licensing
Installing vFabric License Server and Activating Your License 23 5. Installing vFabric License Server and Activating Your License Before you install vFabric Suite components, you need to install vFabric License Server and activate your vFabric Suite license. 1. Install vFabric License Server. How and where you install the License Server depends on your environment: • Install vFabric License Server on the same Windows machine on which you installed VMware vCenter Server.
24 vFabric Suite Prerequisites • Install and configure vCenter Server and vSphere client on your Windows computer and be sure they are running correctly. See vSphere Installation and Setup. • Create a vFabric License Server database instance and create an ODBC data source that connects to the vCenter database system or to a separate database system. Make sure that only vFabric License Server uses this ODBC data source. vFabric License Server supports Microsoft SQL Server and Oracle databases.
Installing vFabric License Server and Activating Your License 25 3. Click the Add... button. 4. Select the SQL Server Native Client driver. Click Finish. 5. Enter a name and description of the data source, then select the SQL Server you want this data source to connect to from the drop-down list. Click Next. The SQL Server can be the one used by the vCenter Server or a different one, depending on which works best for your environment. 6.
26 vFabric Suite Procedure 1. On the same Windows computer on which you are running vCenter Server, invoke the ODBC Data Source Administrator window: Start > Programs > Administrative Tools > Data Source (ODBC). 2. Select the System DSN tab. 3. Click the Add... button. 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.
Installing vFabric License Server and Activating Your License 3. 27 Continue clicking Next to accept the license agreement and view where the installer will install vFabric License Server. You cannot change the location of vFabric License Server, which is a Web application and thus must be located in the webapps directory of the vCenter Tomcat instance. 4. Enter the credentials of the vCenter user who has the appropriate privileges to register the vFabric License Server as an extension.
28 vFabric Suite The vFabric License Server uses vFabric tc Server internally. If necessary, the installation of the vFabric License Server on RHEL will automatically install vFabric tc Server. Prerequisites • Be sure the RHEL computer on which you are going to install vFabric License Server has a JDK or JRE (Version 6 only) installed.
Installing vFabric License Server and Activating Your License 29 prompt# /opt/vmware/vfabric-license-server/server/create_vls_instance.sh The script outputs what it is doing; the initialization is successful if you see output similar to the following at the end: ...
30 vFabric Suite Starting and Stopping the Standalone vFabric License Server If you choose not to use chkconfig to configure standalone vFabric License Server to start at the same time you boot the RHEL computer, you must start and stop it manually. Prerequisites • Install standalone vFabric License Server. Procedure 1. Log on to the RHEL computer on which you installed the standalone vFabric License Server as the root user (or as an unprivileged user who has sudo privileges) and start a terminal. 2.
Installing vFabric License Server and Activating Your License 31 vfabric.licensing.server.address=https://host:port where: • host is the hostname of the vFabric License Server RHEL computer. • port is the secure port number that the License Serve listens to for HTTPS requests. For example, if your License Server is on host myhost, listening at the default HTTPS port 8443, the file would look like the following: vfabric.licensing.server.address=https://myhost:8443 Location of vflicense.
32 vFabric Suite Activate a vFabric Suite License in vCenter You activate vFabric licenses on vCenter Server using the vSphere Client. Prerequisites • Install vFabric License Server on your vCenter Server. • Decide how many vFabric Suite license units you need, purchase them, and then get your license key from the VMware license portal. See How Licensing Works with vFabric Suite Standard and Advanced. Procedure 1.
Installing vFabric License Server and Activating Your License 33 The vCenter Licensing page displays only the capacity of your vFabric Suite license; it does not actually keep track of the number of licenses currently assigned. See Monitoring vFabric License Usage for information on using the monitoring commands.
34 vFabric Suite Procedure 1. Log in as the root user on the RHEL computer on which you are going to install the OSS license agent and start a terminal. 2. 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.
Installing vFabric License Server and Activating Your License 35 */10 * * * * root /usr/sbin/vfdetect /opt/vmware/vfabric-agent/vfdetect-scripts The /opt/vmware/vfabric-agent directory will contain the state and log files of the OSS license agent. Upgrade vFabric License Server on vCenter Server Upgrade vFabric License Server to the latest version to get the latest features and bug fixes.
36 vFabric Suite Uninstall Standalone vFabric License Server Uninstalling the standalone version of vFabric License Server completely removes it from your RHEL computer, including the internal database that contains all usage data of vFabric components. Procedure 1. Log on to the RHEL computer on which you installed the standalone vFabric License Server as the root user (or as an unprivileged user who has sudo privileges) and start a terminal. 2.
Monitoring vFabric License Usage 37 6. Monitoring vFabric License Usage vFabric Suite provides command-line tools and a simple Web user interface to monitor vFabric license usage by the virtual and physical computers on which vFabric Suite components are installed. Note: If you installed the vFabric License Server in a vSphere environment (which means you installed the license server on the same computer on which vCenter Server is installed), you also activated vFabric licenses using the vSphere client.
38 vFabric Suite • RHEL standalone (that is, a non-vSphere environment): /opt/vmware/vfabric-license-server/bin For example, on the Windows VM on which vCenter Server is installed: prompt> cd c:\Program Files\VMware\Infrastructure\vFabric Platform\Reporting If you installed standalone vFabric License Server on a RHEL computer: prompt$ cd /opt/vmware/vfabric-license-server/bin 2. Run the desired monitoring command.
Monitoring vFabric License Usage 39 current-usage Displays the current vFabric license usage and capacity, organized by license key. When running in a vSphere environment and no relevant options are specified, the command displays information for the entire vCenter Server. Syntax current-usage [-group group | -cluster name | -datacenter name | -resourcePool name ] You can specify only one of these options: -group, -cluster, -datacenter, or -resourcePool. Table 6.1.
40 vFabric Suite When running in a vSphere environment and no relevant options are specified, the command displays information for the entire vCenter Server. Syntax current-versions [-group group | -cluster name | -datacenter name | -resourcePool name ] You can specify only one of these options: -group, -cluster, -datacenter, or -resourcePool. Table 6.2.
Monitoring vFabric License Usage 41 The following table lists the options for this command. Table 6.3. Options of usage-over-periods 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. You must specify either the -days option or the two options to specify a custom data range (-startDate and endDate), but not both.
42 vFabric Suite The output will look something like the following: 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.1 123AA-123BB-123CC-123DD-123EE,"Sep 8, 2012 - Sep 14, 2012",2,3,2,5 123AA-123BB-123CC-123DD-123EE,"Sep 15, 2012 - Sep 21, 2012",1,1,1 123AA-123BB-123CC-123DD-123EE,"Sep 22, 2012 - Sep 28, 2012",1,1,1 123AA-123BB-123CC-123DD-123EE,"Sep 29, 2012 - Sept 30, 2012",0,1,0.
Monitoring vFabric License Usage Option 43 Description • cluster • resourcePool • datacenter For example, to group by resource pool, specify -group resourcePool. You can specify only one of the following options: -group, -cluster, -datacenter, or -resourcePool. -cluster clustername (vSphere Environment Only) Displays periodic component version information for the specified cluster. You can specify only one of the following options: -group, -cluster, -datacenter, or -resourcePool.
44 vFabric Suite Monitor License Usage with the vFabric License Server Reporting UI The vFabric License Server Reporting web user interface provides a graphical representation of the vFabric license usage and capacity for a particular vCenter server or for a set of computers that the standalone vFabric License Server is tracking.
Monitoring vFabric License Usage 45 The output shows the minimum, maximum, and average usage of the two vFabric license keys that have been activated. The date range is the last 90 days from the current day (in this case October 3, 2012.) The middle table lists all the vFabric and open-source software (OSS) 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.
46 vFabric Suite Prerequisites • If necessary, install a JDK or JRE on the computer 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 47 prompt$ cd /opt/vfabric/utils/vfabric-vfchksn-1.2.0.6 prompt$ ./vfabric-licensetool printevents -f /var/opt/vmware/vfabric-tc-server-standard/myserver/logs/vf.tc-events.t In the preceding example, it is implied that you unzipped the ZIP file into the /opt/vfabric/utils directory. You should see output similar to the following: 2012-10-02T20:28:01 [INFO] The license client's event manager has started.
48 vFabric Suite 48 Monitoring vFabric License Usage
FAQ: vFabric Suite Integration and Off-Cycle Releases 49 7. FAQ: vFabric Suite Integration and Off-Cycle Releases VMware certifies the products listed in the vFabric Suite 5.3 Component table as an integrated suite of components. This certification ensures seamless integration when you use components together in development or production deployment environments.
50 vFabric Suite Can I mix and match component versions between vFabric Suite versions? If you are using two components in an integrated fashion and depending on them to work together seamlessly, you need to use component versions from the same vFabric Suite version to ensure component compatibility. However, if your use requires no integration between the components, you can mix and match to suit the upgrade and deployment needs of your application.
