This section provides quick-start instructions for installing Pivotal tc Server Standard Edition, creating a tc Runtime instance, and starting the tc Runtime instance.
- Download and install a JDK or JRE on the computer on which you are installing tc Server. See Supported Configurations and System Requirements.
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
rootuser. See Setting Up Unix Users for tc Server and VMware vCenter Hyperic.
For clarity, it is assumed in this topic that you will install and run tc Server as the
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
rootuser and use
su - tcserverto become the user.
Open a terminal (Unix) or Command Prompt (Windows) and create a directory to contain the tc Runtime component (such as
/opt/pivotal) if it doesn’t already exist.
prompt$ mkdir /opt/pivotal
prompt> mkdir \opt\pivotal
From Pivotal Network tc Server Download Page click “Pivotal tc Server Standard Edition <version>” (Where <version> is the latest version).
Click on the “Pivotal tc Server Standard Edition (zip)” link. Join or Sign in if prompted and after the file is downloaded unzip the contents into the directory you created in the preceding step.
This is all that is required to install tc Runtime.
For example, in Unix, if you specified a directory called
/opt/pivotalin the preceding step and downloaded the Standard Edition file to your home directory:
prompt$ cd /opt/pivotal prompt$ unzip ~/pivotal-tc-server-standard-3.2.6.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/pivotal/pivotal-tc-server-standard-version. This directory contains all the tc Runtime files and directories.
From your terminal window or Command Prompt, change to the tc Runtime directory and execute the
tcruntime-instancecommand to create a basic tc Runtime instance (called
myserverin the examples).
Pivotal recommends that you use the
--instance-directoryoption 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
tcserveruser can write to this directory and that the directory already exists.
prompt$ cd /opt/pivotal/pivotal-tc-server-standard-3.2.6.RELEASE prompt$ ./tcruntime-instance.sh create --instance-directory /var/opt/pivotal/pivotal-tc-server-standard myserver
prompt> cd \opt\pivotal\pivotal-tc-server-standard-3.2.6.RELEASE prompt> tcruntime-instance.bat create --instance-directory \var\opt\pivotal-tc-server-standard myserver
tcruntime-ctlcommand to start the new tc Runtime instance; use the
-ioption to specify the directory in which the instance is located.
prompt$ ./tcruntime-ctl.sh myserver start -i /var/opt/pivotal/pivotal-tc-server-standard
prompt> tcruntime-ctl.bat myserver start -i \var\opt\pivotal\pivotal-tc-server-standard
To confirm that the tc Runtime instance is running, invoke its welcome page in a browser. Use the URL
host is the name or IP address of the computer on which the tc Runtime instance is running (
localhost if local).