Install tc Server Developer Edition

When you install the Developer Edition of tc Server, you create a tc Runtime instance that contains Spring Insight Developer. The procedure covers Unix and Windows installation, although most instructions are specific to Unix. If you install on Windows, change the forward slashes (/) to back slashes (\); other differences in the installation are called out.

Prerequisites

Procedure

  1. On the VMware Download page, navigate to the tc Server download page and download the Developer Edition distribution in ZIP or compressed TAR file format.

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

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

  2. Login to the computer on which you are installing tc Server 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.

  3. Open a terminal (Unix) or command window (Windows) and create the main tc Server installation directory, such as /opt/vmware.

    For example, on Unix:

    prompt$ mkdir /opt/vmware
  4. Extract the tc Server distribution file into the new directory.

    This action creates a directory called vfabric-tc-server-developer in the main tc Server installation directory that contains the tc Runtime utility scripts, the templates directory, the tomcat-version directory, and so on.

    The templates directory contains a template called insight that contains the Spring Insight application.

  5. Create a tc Runtime instance that contains Spring Insight by specifying the insight template.

    Unix: Change to the /opt/vmware/vfabric-tc-server-developer directory and execute the tcruntime-instance.sh script to create an instance.

    VMware recommends that you use the -i 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.

    For example:

    prompt$ cd /opt/vmware/vfabric-tc-server-developer
    prompt$ ./tcruntime-instance.sh create -t insight \
            -i /var/opt/vmware/vfabric-tc-server-developer insight-instance

    Windows: Change to the \opt\vmware\vfabric-tc-server-developer directory and execute the tcruntime-instance.bat script to create an instance:

    prompt> cd \opt\vmware\vfabric-tc-server-developer
    prompt> tcruntime-instance.bat create insight-instance -t insight \
           -i \var\opt\vmware\vfabric-tc-server-developer
  6. Start the new tc Runtime instance.

    Unix: Execute the tcruntime-ctl.sh script to start the instance; use the -n option to specify the directory in which the instance is located. For example:

    prompt$ ./tcruntime-ctl.sh insight-instance start -n /var/opt/vmware/vfabric-tc-server-developer

    Windows: Execute the tcruntime-ctl.bat script to first install the tc Runtime instance as a Windows service and then start it; for both commands, use the -n option to specify the directory in which the instance is located:

    prompt> tcruntime-ctl.bat insight-instance install -n \var\opt\vmware\vfabric-tc-server-developer
    prompt> tcruntime-ctl.bat insight-instance start -n \var\opt\vmware\vfabric-tc-server-developer

    Note

    On Windows, VMware recommends that you subsequently start and stop the tc Runtime instance through the Windows Services console. The tc Runtime instance is displayed in the console with the name SpringSource tc Runtime - unique-name, where unique-name is a unique combination of server name and servger directory.

  7. After the tc Runtime instance starts, invoke Spring Insight in your browser:

    http://host:8080/insight

    where host refers to the computer on which Spring Insight is running. If you are on the same computer, you can use localhost:

    http://localhost:8080/insight

What to do next