Pivotal tc Server 4.x Documentation
This documentation describes product concepts and provides complete setup instructions for VMware tc Server enterprise application server. tc Server is completely compatible with Apache Tomcat. Read this documentation to configure and manage tc Runtime instances, and deploy Web applications.
tc Server Demonstration
VMware tc Server provides tooling to easily create a tc Runtime (Tomcat) instance, deploy your application, and start the instance.
Creating a new tc Runtime (Tomcat) instance is as easy as running a single command.
tcserver create demo-instance
By default VMware tc Server creates a new instance with a separate
CATALINA_BASE it is highly recommended to keep this default. This layout makes it easier to upgrade and keep your application specifics separate from the tc Runtime (Tomcat).
VMware tc Server offers a feature we call
instance descriptor file which contains the properties used to create an instance such as name, templates, application, and any changes to default properties. By using an
instance descriptor file it is easy to recreate an instance. In a containerized environment one can easily create, deploy, and start an instance with a single command. Please see the tc Server Kubernetes How-to for more details.
The above screenshot shows how to use an
instance descriptor file to create an instance, deploy the Tomcat sample application, and start the instance as a foreground process. It can be reached via
instance descriptor file used above looks like the following:
instance: name: tcserver-demo templates: - nio applications: - https://tomcat.apache.org/tomcat-9.0-doc/appdev/sample/sample.war=ROOT.war
This file defines the name of the instance as
tcserver-demo, the name is used to identify the tc Runtime (Tomcat) instance when issuing
tcserver commands. It should be meaningful to you. This instance uses the
nio template, which is the default is provided only for illustration purposes in the example. It also deploys the Tomcat sample application to the tc Runtime (Tomcat) instance’s
webapps folder as a file named
The command used by the above screenshot is
tcserver create-from-file tcserver-demo.yaml --run
--run command line option is new to VMware tc Server version 4.1.0. It instructions VMware tc Server to run the instance after it is created. This is the same as if two commands had been entered.
tcserver create-from-file tcserver-demo.yaml tcserver run tcserver-demo.yaml
By combining into a single command a
Dockerfile may use a single
RUN command which will tell VMware tc Server create the instance, pull down a remote
.war file, deploy it, and run the instance all in the foreground.