Quick Start

This section provides quick start instructions for installing VMware vFabric tc Server Standard Edition, creating a tc Runtime instance, and starting the tc Runtime instance.


tc Runtime is the runtime component of tc Server.

If you are upgrading an existing tc Server installation, see the upgrade documentation. If you are installing tc Server Developer Edition, see Installing tc Server.

If you obtain tc Server as part of vFabric Platform, first complete the license activation and installation procedures in Getting Started with vFabric Cloud Application Platform. Then follow the procedures here to install tc Server and create and start a tc Runtime instance.

Install tc Server

  1. Download and install a JDK or JRE on the computer on which you are installing tc Server. See Required Software: JDK or JRE.

  2. 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 and disabling its interactive login for security purposes. On Unix, never run tc Runtime instances as the root user. See Setting Up Unix Users for tc Server and Hyperic.

    For clarity, it is assumed in this topic that you will install and run tc Server as the tcserver user.

  3. Login to the computer on which you are installing tc Server as the appropriate user, such as tcserver. If you have disabled interactive login, login as the root user and use su - tcserver to become the user.

  4. Open a terminal (Unix) or Command Prompt (Windows) and create a directory to contain the tc Runtime component (such as /opt/vmware) if it doesn't already exist.

    Unix example:

    prompt$ mkdir /opt/vmware

    Windows example:

    prompt> mkdir \opt\vmware
  5. From the VMware Download Center, download the most recent vfabric-tc-server-standard-version.zip file and unzip the contents into the directory you created in the preceding step. The version in the zip file name is the version number, for example 2.6.0.RELEASE.

    This is all that is required to install tc Runtime; there is no installer program.

    For example, in Unix, if you specified a directory called /opt/vmware in the preceding step and downloaded the Standard Edition file to your home directory:

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

    In Windows Explorer, double-click the ZIP file you downloaded to launch the Windows Extraction Wizard and extract the file into the directory you created in the preceding step.

    After you unzip the ZIP file you will have a directory called /opt/vmware/vfabric-tc-server-standard-version. This directory contains all the tc Runtime files and directories.

Create and start a tc Runtime instance

  1. From your terminal window or Command Prompt, change to the tc Runtime directory and execute the tcruntime-instance command to create a basic tc Runtime instance (called myserver in the examples).

    VMware recommends that you use the --instance-directory option to specify the full pathname of a directory in which the new instance will be created, and that this directory be different from the installation directory. Be sure the tcserver user can write to this directory and that the directory already exists.

    Unix example:

    prompt$ cd /opt/vmware/vfabric-tc-server-standard-2.6.0.RELEASE
    prompt$ ./tcruntime-instance.sh create --instance-directory /var/opt/vmware/vfabric-tc-server-standard myserver

    Windows example:

    prompt> cd \opt\vmware\vfabric-tc-server-standard-2.6.0.RELEASE
    prompt> tcruntime-instance.bat create --instance-directory \var\opt\vmware\vfabric-tc-server-standard myserver
  2. (Windows only) Use the tcruntime-ctl command to make the new runtime instance a Windows service; use the -n option to specify the directory in which the instance is located:

    prompt> tcruntime-ctl.bat myserver install -n \var\opt\vmware\vfabric-tc-server-standard 
  3. Execute the tcruntime-ctl command to start the new tc Runtime instance; use the -n option to specify the directory in which the instance is located.

    Unix example:

    prompt$ ./tcruntime-ctl.sh myserver start -n /var/opt/vmware/vfabric-tc-server-standard

    Windows example:

    prompt> tcruntime-ctl.bat myserver start -n \var\opt\vmware\vfabric-tc-server-standard

To confirm that the tc Runtime instance is running, invoke its welcome page in a browser. Use the URL http://host:8080, where host is the name or IP address of the computer on which the tc Runtime instance is running (localhost if local).

What to do next