vFabric tc Server has several options for installation and setup. Installation options vary according to the tc Server edition you choose; whether you install tc Server standalone or as part of vFabric Platform installation; and whether your operating system is Linux or another supported platform. Installation also varies according to whether you are installing tc Server for the first time or are upgrading from a previous version.
If you have already installed a previous version of tc Server; have created one or more tc Runtime instances; and now want to upgrade all components to the latest version, see Upgrade and Migration Guide. The upgrade guide also describes how to upgrade an existing pre-4.5 Hyperic installation so that it can manage tc Runtime instances.
tc Server requires the Java Development Kit (JDK) or Java Runtime Environment (JRE). Depending on your installation, you might also need to install GNUtar and a database server.
Determine whether you must install these components:
GNUtar. If you install the compressed TAR file of tc Server in a Unix environment and your tar command does not support the -z option, you must install GNUtar.
Database server. If you install tc Server Standard Edition and the platform-neutral version of Hyperic Server and Agent, you must install a database server.
It is also recommended that you install a database server for production purposes, if you install the platform-neutral or platform-specific version of the Hyperic distribution. The platform-specific versions of the Hyperic distribution bundle a database to get you started, but this database is not recommended for production.
For Hyperic Server and Agent requirements, see "Installation Requirements" in vFabric Hyperic Installation Guide.
All tc Server editions require you to download a JDK or JRE. If you are installing the Hyperic components, the JDK or JRE requirement depends on whether you install a platform-specific version or the platform-neutral version. The platform-neutral version requires a JDK or JRE, and the platform-specific versions bundle one.
On each computer where you plan to install the tc Runtime component of tc Server, download and install a JDK or JRE.
If you plan to install the platform-neutral version of the Hyperic components, install a JDK or JRE on each computer on which you will install Hyperic Server or a Hyperic Agent.
Each computer requires one JDK or JRE. If you already installed a JDK or JRE on the computer in step 1, you do not need to install another one.
JAVA_HOME environment variable to point
to your installation and update your
variable to point to the
If you are installing the management components of tc Server
(Hyperic Server and Hyperic Agent) on a Windows platform, set
HQ_JAVA_HOME as a system environment variable that
points to the location of your JDK or JRE.
Make sure you set
HQ_JAVA_HOME as a
system environment variable. If you set it as a
user environment variable, the Hyperic Agent
aborts on startup.
The Hyperic Server uses a database to store its metadata. The platform-neutral version of Hyperic Server does not, however, bundle a database. If you install tc Server Standard edition and you want to install the platform-neutral version of the Hyperic Server and Agent components, you need to install a database server.
It is also recommended that you install a database server for production purposes, if you install the platform-neutral or platform-specific version of the Hyperic distribution. The platform-specific versions of the Hyperic distribution bundle a database for you to get started, but this database is not recommended for production.
Follow the procedure in "Set Up Hyperic Database" in vFabric Hyperic Installation Guide.
Hyperic Server supports Oracle 10g/11g, PostgreSQL, and MySQL 5.x.
If you are installing tc Server on Unix and have downloaded the
compressed TAR file format (
tar command on your computer must be
compatible with the tar command required by the tc
Server. If the commands are not, compatible, you must install
Open a terminal window and enter:
Search the help output for a
-z option, which filters the output
tar command on your
computer supports the -z option, then it is
compatible with the one required by tc Server and you can begin
installing tc Server.
tar command does
not support this option, then you must
install GNUtar (
gtar) from an external source.
Proceed to step 3.
Download GNUtar for free from Sunfreeware.com.
PATH environment variable (either of
the user installing tc Server or the system-wide environment
variable) to include the location of the
The location depends on the directory in which you installed GNUtar.
For any references to
the tc Server installation procedures, substitute the command