When you install tc Server Standard Edition, you have the option of also installing VMware vFabric Hyperic to monitor and manage tc Server. Hyperic 4.5 and later includes the tc Server Hyperic plug-in, which allows you to use the Hyperic interface to monitor and manage tc Runtime instances.
There are two Hyperic components to install. Hyperic Agent is installed on every computer running a tc Runtime instance. Hyperic Agent discovers tc Runtime processes, adds them to the inventory and manages them, through the tc Server plug-in. A computer with tc Server runtime instances and Hyperic Agent is called a "managed node." The other component, Hyperic Server, can be installed on any computer in the network and provides the central control point and user interface to use Hyperic to manage multiple deployments.
The procedure breaks the installation steps into those you do on managed node computer(s) and those you do on the Hyperic Server computer. If you are installing everything on the same computer, then simply execute all steps on the same computer.
If you are installing tc Runtime instances on multiple computers you must install Hyperic Agent on each computer.
Verify that your system meets the installation requirements for installing tc Server with Hyperic management components. See Meeting System Software Requirements for tc Server.
Review information about tc Server Standard edition and it's
*.tar.gz distribution files. See
tc Server Editions.
Determine the user that is going to create and run the tc Runtime instances, and create it if necessary. Consider creating a user dedicated to tc Server tasks, putting the user in a separate group from regular users, and disabling its interactive login for security purposes. See Setting Up Unix Users for tc Server and Hyperic for additional information about the Hyperic user.
On Unix, never run tc Runtime instances as the root user.
For clarity, it is assumed in this topic that you will install and run tc Server and Hyperic Agent as the
tcserver user and install and run the Hyperic Server as the
If you have an existing Hyperic installation, see Upgrade and Migration Guide for details about upgrading Hyperic with the tc Server Hyperic plug-in.
To understand the various installation scenarios for managed nodes and the Hyperic Server, read How tc Server and Hyperic Work Together. Then decide how you will install the components:
Install all components on the same computer.
Install Hyperic Server on one computer and install the managed node (Hyperic Agent and tc Runtime) on one or more different computers.
On the computer on which you plan to install the managed node (tc Runtime and Hyperic Agent), login as the appropriate user, such as
tcserver. On Unix, if you have disabled interactive login, login as the
root user and use
su - tcserver to become the user.
Open a terminal (Unix) or command prompt (Windows) and create two new directories: one to contain the tc Runtime component (such as
/opt/vmware/tcserver) and one to contain the Hyperic Agent (such as
You can install tc Runtime and Hyperic Agent in the same directory, but in this procedure it is assumed that you install them in different directories.
For example, on Unix:
prompt$ mkdir /opt/vmware/tcserver prompt$ mkdir /opt/vmware/hyperic
From the VMware
Download Center, navigate to the VMware vFabric tc Server
download page, and download the tc Server Standard edition ZIP or
compressed TAR file distribution into a directory on your computer,
Extract the tc Server distribution file into the
This action installs tc Runtime; there is no installer program.
For example, if you created a directory called
/opt/vmware/tcserver in the preceding step, and downloaded the
Standard Edition file to the
prompt$ cd /opt/vmware/tcserver prompt$ unzip /home/Downloads/vfabric-tc-server-standard-2.6.0.RELEASE.zip
A directory called
is created in the main tc Server installation directory that contains
the tc Runtime utility scripts, the templates directory, the
tomcat- directory, and
From the VMware Download Center, navigate to the Hyperic download page.
Download the Agent-only 4.6 Hyperic Hyperic EE distribution and
unpack it into the
The Hyperic Agent is installed in the directory
On the computer on which you plan to install Hyperic Server, login as the appropriate user, such as
Determine whether you need to download and install a JDK/JRE or database server.
You need to do this if you are installing the platform-neutral version of Hyperic Server or if you require a production-level installation at this time. The platform-specific version of Hyperic Server bundles a JDK/JRE and a non-production database server to get you started. See Meeting System Software Requirements for tc Server.
If you use your own database server, obtain the URL and username/password to connect to it.
The installation program for Hyperic Server will ask for database server credentials.
If you are installing the managed node (tc Server plus Hyperic Agent) on one or more computers and the Hyperic Server on another computer, open a terminal (Unix) or command prompt (Windows) and create the directory that will contain the Hyperic Server.
For example, on Unix:
prompt$ mkdir /opt/vmware/hyperic
If you are installing all components on the same computer, you
can install the Hyperic Server into the Hyperic Agent or tc Runtime
directory that you already created (such as
/opt/vmware/tcserver in this procedure.)
From the VMware Download Center, download the Hyperic EE (Enterprise Edition) distribution and unpack it into a temporary directory.
Be sure you download version 4.6 of Hyperic which automatically
includes the tc Server Hyperic plug-in. You can download a
distribution for your particular platform, such as Windows or Linux,
or you can download a platform-neutral distribution that does not
contain a JDK or database (labeled
From your terminal window or command prompt, change to the
temporary directory in which you unpacked the Hyperic distribution and
setup.sh (Unix) or
For example, if you downloaded and unpacked the Hyperic
distribution into the
/home/Downloads directory, your
prompt$ cd /home/Downloads/hyperic-hq-installer prompt$ ./setup.sh
After accepting the terms of agreement, enter
1 to install only the Hyperic Server
(you installed the Hyperic Agent in a preceding step.)
The script asks a few more questions, such as an encryption key
for encrypting the database-user password and the directory in which
you will install Hyperic Server (
/opt/vmware/hyperic in this
procedure.) If you are installing a platform-specific version of
setup.sh script might ask you to run another
script as the
root user. If you are installing the
platform-neutral version of Hyperic, the script asks for information
about your database, including the database URL, name and password of
the user that connects to the database.
setup.sh script completes, Hyperic Server
is installed in
If you installed tc Server and Hyperic standalone, activate a local tc Server license as described in Activate a Local vFabric tc Server License.
See the vFabric Hyperic Installation Guide for information on installing the local Hyperic license.
If you installed tc Server and Hyperic as part of vFabric Cloud Application Platform, then you should have already activated a network license using the vSphere client, as described in Installing tc Server as Part of vFabric Cloud Application Platform.
For additional details about the questions asked by the Hyperic
setup.sh script, see "Installing the Agent and
Server from a Tarball or Zip Archive" in vFabric Hyperic
For details about the tc Server 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 Post-Installation Tasks.
Try out the tutorials. See Tutorial: Using Hyperic to Configure and Manage tc Runtime Instances and Tutorial: Very Simple Web Application Development.