RHEL: Install vFabric tc Server Standard Edition from an RPM

VMware recommends that you install vFabric tc Server (Standard Edition) on a Red Hat Linux Enterprise (RHEL) computer by first installing the VMware RPM repository and then using yum to perform the actual installation. See Install vFabric tc Server from the VMware RPM Repository.

You can also download the RPM from the VMware Download page and install it on your RHEL computer using the rpm command, as described in Install vFabric tc Server from a Downloaded RPM. This installation option is necessary if you are installing a version of tc Server that is not yet certified for vFabric Suite, which means that it has not yet been added to the VMware RPM repository.

Install vFabric tc Server from the VMware RPM Repository

VMware recommends that you install tc Server on RHEL computers using the VMware RPM repository.

Prerequisites

Set the JAVA_HOME environment variable in the root user's environment. For example, you could add the following line to /etc/profile and then open a new terminal window:
export JAVA_HOME=/usr/java/latest
Replace/usr/java/latest with the base directory of your JVM installation.
Verify that your system meets the supported configurations and installation requirements. See Supported Configurations and System Requirements.
Install the vFabric repository RPM, which makes it easier for you to browse the vFabric RPMs, including the vFabric tc Server RPM. The vFabric repository contains all RPMs that are certified with this release of vFabric Suite. You install the vFabric repository RPM on each RHEL computer on which you want to install one or more vFabric components, such as vFabric tc Server.
1. On the RHEL computer, start a terminal either as the root user or as an unprivileged user who has sudo privileges.
2. Install the vFabric repository RPM using the following wget command, passing it the appropriate URL. The URL differs depending on the version of RHEL you are using.
  Important: You must run the entire wget command on a single line. Be sure you include the | sh at the end, or the RPM installation will not work.
  For RHEL 5:
```
prompt# wget -q -O - http://repo.vmware.com/pub/rhel5/vfabric/5.2/vfabric-5.2-suite-installer | sh
```
  For RHEL 6:
```
prompt# wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh
```
  If necessary, use sudo to run the preceding commands if you are not logged in as the root user. For example:
```
prompt$ sudo wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh
```
  The command performs the following tasks:
  - Imports the vFabric GNU Privacy Guard (GPG) key.
  - Installs the vFabric 5.2 repository RPM.
  - 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
...
======================================== Matched: vfabric ========================================
vfabric-rabbitmq-java-client-bin.noarch : The RabbitMQ Java Client Library
vfabric-rabbitmq-server.x86_64 : The RabbitMQ server
vfabric-tc-server-standard.noarch : VMware vFabric tc Server Standard
vfabric-web-server.x86_64 : VMware vFabric Web Server
...
```
  The vFabric tc Server RPM is called vfabric-tc-server-standard.

Procedure

From the RHEL computer on which you will install vFabric tc Server, log in as the root user (or as an unprivileged user who has sudo privileges) and start a terminal.
Execute the following yum command:
```
prompt# yum install vfabric-tc-server-standard
```
The yum command begins the install process, resolves dependencies, and displays the packages it will install.
If necessary, use sudo to run the preceding command if you are not logged in as the root user. For example:
```
prompt$ sudo yum install vfabric-tc-server-standard
```
Enter y at the prompt to begin the actual installation.
If the installation is successful, you see a Complete! message at the end.

What the yum install command does

The yum install command:

Installs vFabric tc Server into the /opt/vmware/vfabric-tc-server-standard directory and sets the owner of the directory, along with all child directories and files, to root:vfabric.
If the user does not already exist, adds a tcserver non-interactive user (in the group vfabric). VMware recommends that you create and run tc Server instances as this user.
You cannot log in directly as the tcserver user because interactive login is disabled. Rather, you must log in as the root user or as a privileged user using sudo , and then su - tcserver .
Creates an empty directory called /var/opt/vmware/vfabric-tc-server-standard and sets the owner to tcserver:vfabric.
VMware recommends that you create new tc Server instances in this directory rather than the installation directory. You do this by specifying the -i option of the tcruntime-instance command.

What to do next

If you installed tc Server standalone, activate a local tc Server license as described in Activate a vFabric tc Server Local License.
If you installed tc Server and Hyperic as part of vFabric Suite, you should have already activated licensing as described Getting Started with vFabric Suite.
For details about the directories you installed, see Overview of tc Server Directories, Variables, and Configuration Files.
For typical post-installation procedures such as creating tc Runtime instances, starting tc Server components, and getting started with the Hyperic user interface, see Creating and Managing tc Runtime Instances.
Try out the tutorials. See Tutorial: Using Hyperic to Configure and Manage tc Runtime Instances and Tutorial: Very Simple Web Application Development.

Install vFabric tc Server From a Downloaded RPM

You can install vFabric tc Server on RHEL by downloading the RPM from the VMware download center and executing the rpm command. This procedure is necessary if you want to install a version of tc Server that has not yet been certified for vFabric Suite.

Prerequisites

Verify that your system meets the supported configurations and installation requirements. See Supported Configurations and System Requirements.

Procedure

Log in to the RHEL computer on which you will install vFabric tc Server as the root user (or as an unprivileged user who has sudo privileges).
Browse to the VMware Download page and download the tc Server Standard Edition RPM file to a directory on your computer. The RPM file is called vfabric-tc-server-standard-version-RELEASE.noarch.rpm.
Start a terminal and change to the directory in which you downloaded the RPM.
Execute the following rpm command to install tc Server:
```
prompt# rpm -ivhf vfabric-tc-server-standard-version-RELEASE.noarch.rpm
```
If necessary, use sudo to run the preceding command if you are not logged in as the root user. For exampl:
```
prompt$ sudo rpm -ivhf vfabric-tc-server-standard-version-RELEASE.noarch.rpm
```
In the previous section, see What the yum install command does for post-installation information, such as the installation directory and the user that is automatically created by the RPM installation. (The yum install command corresponds to the rpm command in this procedure.)

See What to do next for the suggested next steps.