Install tc Server Standard Edition and Hyperic Management Components

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.

Note

If you are installing tc Runtime instances on multiple computers you must install Hyperic Agent on each computer.

Prerequisites

Procedure

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

  2. 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 /opt/vmware/hyperic.)

    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
  3. 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, for example /home/Downloads:

    • vfabric-tc-server-standard-2.6.X.RELEASE.zip

    • vfabric-tc-server-standard-2.6.X.RELEASE.tar.gz

  4. Extract the tc Server distribution file into the /opt/vmware/tcserver directory.

    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 /home/Downloads directory:

    prompt$ cd /opt/vmware/tcserver
    prompt$ unzip /home/Downloads/vfabric-tc-server-standard-2.6.0.RELEASE.zip

    A directory called vfabric-tc-server-standard is created in the main tc Server installation directory that contains the tc Runtime utility scripts, the templates directory, the tomcat-version directory, and so on.

  5. From the VMware Download Center, navigate to the Hyperic download page.

  6. Download the Agent-only 4.6 Hyperic Hyperic EE distribution and unpack it into the /opt/vmware/hyperic directory.

    The Hyperic Agent is installed in the directory /opt/vmware/hyperic/agent-4.6.X.X-EE.

  7. On the computer on which you plan to install Hyperic Server, login as the appropriate user, such as hyperic.

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

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

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

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

  12. From your terminal window or command prompt, change to the temporary directory in which you unpacked the Hyperic distribution and execute the setup.sh (Unix) or setup.bat (Windows) script.

    For example, if you downloaded and unpacked the Hyperic distribution into the /home/Downloads directory, your subdirectory is hyperic-hq-installer:

    prompt$ cd /home/Downloads/hyperic-hq-installer
    prompt$ ./setup.sh
  13. 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 Hyperic, the 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.

    When the setup.sh script completes, Hyperic Server is installed in /opt/vmware/hyperic/server-4.6.X.X-EE.

What to do next