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.
Verify that your system meets the installation requirements. See Meeting System Software Requirements for tc Server.
Review information about tc Server Developer edition and
its *.zip or
*.tar.gz distribution files.
See tc Server Editions.
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, putting the user in a separate group from regular users, and disabling its interactive login for security purposes. See Setting Up Unix Users for tc Server and Hyperic.
On Unix, never run tc Runtime instances as the root user.
For clarity, it is assumed in this topic that you will install and run tc Server as the
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.
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.
Open a terminal (Unix) or command window (Windows) and create
the main tc Server installation directory, such as
For example, on Unix:
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,
templates directory, the
tomcat- directory, and
templates directory contains a template called
insight that contains the Spring Insight
Create a tc Runtime instance that contains Spring Insight by
Unix: Change to the
/opt/vmware/vfabric-tc-server-developer directory and
tcruntime-instance.sh script to create an
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.
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
and execute the
tcruntime-instance.bat script to create
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
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
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
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 -
is a unique
combination of server name and servger directory.
After the tc Runtime instance starts, invoke Spring Insight in your browser:
where host refers to the computer on which
Spring Insight is running. If you are on the same computer, you can
For details about the directories you installed, see Overview of tc Server Directories, Variables, and Configuration Files.
For Spring Insight overview information and to create plug-ins that extend Spring Insight, see Spring Insight Developer.
Try out the tutorials. See Tutorial: Using Hyperic to Configure and Manage tc Runtime Instances and Tutorial: Very Simple Web Application Development.