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.

    • Install vFabric License Server on an EC2 instance that is running RHEL or on a physical machine that is running RHEL. Because you do not install the License Server as an extension of the vCenter environment, this scenario is referred to henceforth as installing vFabric License Server Standalone . This version of vFabric License Server is known as the standalone License Server.

  2. Activate your vFabric licenses.

  3. Install individual vFabric Suite components (such as vFabric tc Server).

    • If you are installing vFabric Suite components on Red Hat Enterprise Linux (RHEL), you have two options: Use the yum command to install from an RPM file in the vFabric RPM repository, or install from a ZIP or TAR file from the standard VMware download Web site.

    • If you are installing on another supported operating system (such as Windows), you install the vFabric components from a package that you download from the VMware download Web site. If you install from a download page, the package might be in a *.zip, *.tar, or *.exe format, depending on the component.

This chapter provides installation-related procedures for vFabric License Server and describes how to activate your vFabric Suite license. For product installation instructions, see the documentation for a particular vFabric component.

Subtopics

Installing vFabric License Server on vCenter Server

RHEL Only: Install vFabric License Server Standalone

Activate vFabric Suite Licenses

Optionally Configure Computer to Track License Usage of OSS Components on RHEL

Upgrade vFabric License Server on vCenter Server

Uninstall vFabric License Server from vCenter Server

Uninstall Standalone vFabric License Server

Installing vFabric License Server on Your vCenter Server

If you are installing vFabric License Server into your existing vCenter environment, install it on the same Windows computer that is running vCenter.

vFabric License Server requires a database to store and organize its data. The 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 an Oracle database schema or a Microsoft database.) You can also use a completely separate database system. In either case, you must create an ODBC data source specifically for use by vFabric License Server, as described in the procedures that follow.

vFabric License Server supports Microsoft SQL Server and Oracle database systems. In general, the supported versions of each database system are the same as those supported by vCenter Server.

Prerequisites

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.)

Follow these general guidelines when creating the database instance:

  • Access permissions: In general, use the same database access permissions defined for the vCenter Server database.

  • Database size: Estimating the size of the vFabric License Server database is an inexact science that depends on a number of variables. Most important is the number of vFabric component installations across all the VMs on your vCenter Server. The more installations you have, the more data collected by vFabric License Server, and the bigger the database. However, the amount of data collected by the license server for a particular component installation is relatively small. In sum, 5 GB should be more than adequate for the vFabric License Server database instance.

For reference information about creating databases (Microsoft SQL Server) and schemas (Oracle) as well as users and their required permissions, see:

Create the Microsoft SQL Server ODBC Data Source

Before you install vFabric License Server in a vCenter Server environment, you must create an ODBC data source that connects to the database system associated with vCenter Server or to a separate database system. If you use the vCenter database system, VMware recommends that you create a separate SQL Server database instance 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 Microsoft SQL Server database system.

Prerequisites

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 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. Specify that you want SQL Server to verify the authenticity with 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 do not specify integrated Windows authentication.

  7. Continue clicking Next, accepting all default values, and then click Finish.

    You see a summary of the data source configuration.

  8. Test the data source to make sure you configured it correctly, then click OK.

Create the Oracle ODBC Data Source

Before you install vFabric License Server in a vCenter Server environment, you must create an ODBC data source that connects to either the database system associated with vCenter Server or to a separate database system. If you use the vCenter database system, VMware recommends 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.

    Warning: The following procedure provides only general guidelines for installing the Oracle ODBC driver. Contact your Oracle database administrator for the instructions for your particular environment.

    1. Download the following ZIP files from the Instant Client for Microsoft Windows (x64) Web site and unzip them into a directory:

      • Instant Client Package - Basic: All files required to run OCI, OCCI, and JDBC-OCI applications.

      • Instant Client Package - ODBC: Additional libraries for enabling ODBC applications.

      For the remainder of this procedure it is assumed you unzipped the files into the C:\instantclient_11_2 directory.

    2. Set the TNS_ADMIN environment variable to the C:\instantclient_11_2 directory and add the C:\instantclient_11_2 directory to the PATH environment variable.

    3. Open a command prompt and execute the following commands to install the ODBC driver:

      prompt> cd C:\instantclient_11_2
      prompt> odbc_install.exe

      You should see the message Oracle ODBC Driver is installed successfully.

    4. If necessary, create or update the C:\instantclient_11_2\tnsnames.ora file and define your Oracle database address so the ODBC driver can connect to it.

  • Create the database instance that will contain vFabric Suite license data. See Guidelines for Creating the vFabric License Server Database Instance.

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.

    From the TNS Service Name drop-down list, select the Oracle database system and database to which this data source will connect. The entries in the list come from the c:\instantclient_11_2\tnsnames.ora file.

    The Oracle database system can be the one used by the vCenter Server or another one, depending on which works best for your environment.

  6. Enter the Oracle database user name in the User ID field.

  7. Click Test Connection, enter the user's password, and ensure that you can connect to the Oracle database.

  8. Click OK.

Install vFabric License Server on the vCenter Server

  1. On the same Windows computer on which you are running vCenter Server, log in as the Administrator user (or user with administrator privileges) if you have User Account Control (UAC) enabled. If UAC is disabled, log in as any user.

  2. Double-click the vFabric License Server installer program from Windows Explorer to start the installation.

    The vFabric License Server welcome screen appears.

  3. 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. At a minimum, the user must have the following vCenter privileges:

    • Extension.Register

    • Extension.Update

    By default, vCenter users with the Administrator role have all these privileges. However, users and roles may have been customized for your particular environment, so check with your vCenter Server administrator. See Authentication and User Management for information on assigning vCenter privileges.

  1. Click Next to continue. The installer program performs the required validations and other tasks.

  2. 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.

  3. 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 program completes successfully when you see the message InstallShield Wizard Completed.

  4. To view details of the installation, click Show the Windows Installer Log. Click Finish to complete the installation.

  5. Restart your vCenter Server to enable the vFabric License Server changes.

  6. Optionally verify that the vFabric License Server is running by invoking the monitoring graphical UI. See Monitor License Usage with the vFabric License Server Reporting UI.

What to do next