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}/.pivotal/tcserver.properties |
If tc Server has been installed via the recommended location then `${TCSERVER_HOME} is either $/opt/pivotal/tcserver/standard-4.1.0.RELEASE (manual installation), $ (RPM only), or \opt\pivotal\tcserver\standard\standard-4.1.0.RELEASE (windows).
Properties loaded from ${USER_HOME}/.pivotal/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. |