Installing vFabric tc Server

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.

Note

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.

Subtopics

Meeting Software System Requirements for tc Server

Installing tc Server as Part of vFabric Cloud Application Platform

Install tc Server Developer Edition

Install tc Server Standard Edition (tc Runtime Only)

Install tc Server Standard Edition with Hyperic Management Components

Activate a Local vFabric tc Server License

Overview of tc Server Directories, Variables, and Configuration

Enabling Bash Completion for tc Server Scripts

Setting Up Unix Users for tc Server and Hyperic

Meeting System Software Requirements for tc Server

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.

    Note

    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.

Subtopics

Required: Install JDK or JRE

Possibly Required: Install a Database Server

Possibly Required: Install GNUtar

Required: Install JDK or JRE

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.

Prerequisites

Procedure

  1. On each computer where you plan to install the tc Runtime component of tc Server, download and install a JDK or JRE.

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

  3. Set your JAVA_HOME environment variable to point to your installation and update your PATH environment variable to point to the JAVA_HOME/bin directory.

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

Possibly Required: Install a Database Server

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.

Note

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.

Procedure

  • Follow the procedure in "Set Up Hyperic Database" in vFabric Hyperic Installation Guide.

    Hyperic Server supports Oracle 10g/11g, PostgreSQL, and MySQL 5.x.

Possibly Required: Install GNUtar

If you are installing tc Server on Unix and have downloaded the compressed TAR file format (*.tar.gz), the 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 GNUtar.

Procedure

  1. Open a terminal window and enter:

    prompt$ tar --help

  2. Search the help output for a -z option, which filters the output through gzip.

    • If the 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.

    • If your tar command does not support this option, then you must install GNUtar (gtar) from an external source. Proceed to step 3.

  3. Download GNUtar for free from Sunfreeware.com.

  4. Update the PATH environment variable (either of the user installing tc Server or the system-wide environment variable) to include the location of the gtar command.

    The location depends on the directory in which you installed GNUtar.

  5. For any references to tar in the tc Server installation procedures, substitute the command gtar.