LATEST VERSION: 4.0 - CHANGELOG
Pivotal tc Server v4.0

tcserver.properties Configuration Reference

tc Server 4.0.0 introduces a new feature allowing users to configure default values for some command line options. This values are provided to the tcserver command via configuration properties files. The location of the files are shown in the following table

Processing Order File Location
1 ${TCSERVER_HOME}/conf/tcserver.properties
2 ${USER_HOME}/.tcserver.properties

If tc Server has been installed via the recommended location then `${TCSERVER_HOME} is either $/opt/pivotal/tcserver/standard-4.0.0.RELEASE (manual installation), $ (RPM only), or \opt\pivotal\tcserver\standard\standard-4.0.0.RELEASE (windows).

Properties loaded from ${USER_HOME}/.tcserver.properties will take priority over the properties read from ${TCSERVER_HOME}/conf/tcserver.properties

Most of the properties defined in these files provide values for various command line options, however, additional functionality is also available. The properties and their default values are shown in the following table

Property Name Default Value Description
java.home $JAVA_HOME environment variable Value for when the --java-home command line option is not used. This does not change the $JAVA_HOME used by the tcserver` command.
instances.directory ${TCSERVER_HOME}/../instances or /var/opt/pivotal/tcserver/instances when installed via RPM Value for when --instances-directory or -i is not used on the tcserver command line. Be sure the appropriate user (such as tcserver) can write to this directory.
runtimes.directory ${TCSERVER_HOME}/../runtimes or /opt/pivotal/tcserver/runtimes when installed via RPM Value for when --runtimes-directory or -r is not used on the tcserver command line
templates.directory ${TCSERVER_HOME}/templates or /var/opt/pivotal/tcserver/templates when installed via RPM Value for when --templates-directory or -e is used on the tcserver command line
create.runtime.major.version latest major version found in the runtime directory Species a default major runtime version. This is useful when there are multiple major runtime versions available and --version is not used on the command line. This property has no command line equivalent.
create.runtime.version The newest version found in the runtimes directory Value for when --version is not used on the tcserver create command line. Note: This property is only used by the tcserver create command.
get-template.url.username None Specifies the username to use with the get-template command. This option is equivalent to –username on the get-template command line.
get-template.url.password None Specifies the password to use with the get-template command. This option is equivalent to –password on the get-template command line.
tcserver.get-runtime.disable false This option is used to disable the functionality of tcserver get-runtime get-runtime`. The purpose is to avoid conflicts caused by package manager maintaining the available RPMs. This option may be set to false when tc Server and tc Runtimes are installed via RPM, however, package conflicts may arise.