QuickStart
Use these instructions to install Tcat Server on #one or #more machines, and to get started managing, monitoring, and deploying your applications.
Install Tcat Server on One Machine
This process explains how to install the Tcat Server and the Tcat Administration Console on one machine, then use the Console to manage the Server and deploy a new application.
Before You Begin
Ensure that you have JRE 1.6 or newer installed and that your JAVA_HOME (or its alias JRE_HOME) environment variable is set.
Download the Tcat Server installer for Windows (.exe), Linux (.sh), and MacOS (.dmg) from https://www.mulesoft.com/tcat/download.
Step One: Run the Installer
Select Standard Install, and accept all defaults
| Windows | Linux and Solaris | Mac OS X |
|---|---|---|
installer.exe |
installer.sh |
installer.dmg |
Step Two: Start Tcat Server
Use the commands listed below to start Tcat Server.
| Windows | Linux | Mac OS X and Solaris |
|---|---|---|
bin\tcat6.bat OR start menu |
service tcat6 start OR bin/tcat6 start |
bin/startup.sh |
Step Three: Log into the Tcat Server Console
-
After a minute or two, open a Web browser to the following address:
http://localhost:8080/console. -
Log in using "admin" for both username and password.
-
The Tcat Server console appears, with the Servers tab selected by default.
Step Four: Register a Tcat Server with the Console
-
In the left panel, click Unregistered.
-
The local Tcat server instance appears to the right.
-
Click the checkbox next to Server Name.
-
Click Register.
-
The local server instance now appears in the All group with a green status indicator.
Step Five: Manage the Tcat Server Instance
-
Click the All list in the left panel.
-
Click the Server Name.
-
The Server Details panel appears.
-
Click through the tabs to view the information and operations available.
Step Six: Add a New Web Application
-
Click the Deployments tab.
-
Click New Package at top right.
-
Click Upload New Application.
-
Browse to local file system to select a .war file.
-
Click Add. Enter a Package Name:
-
Click in the Space to the top right, and select the server name.
-
Click Save and Deploy at bottom right.
-
Select Deployed from left panel.
-
The new package appears under Applications to the left, with the server to the right.
-
Verify your application works by navigating to it in a browser.
Install Tcat Server on Multiple Machines
This process explains how to install the Tcat Server and the Tcat Administration Console on one machine, to install only the Tcat Server on another machine, and then use the Administration Console to manage servers and applications on both Tcat Server instances.
| If you are connected to your network via VPN, disconnect before you continue. Otherwise, the Tcat Server instances may not be automatically detected. |
Step One: Install Tcat Server on One machine
Use the previous instructions in Install Tcat Server on One Machine.
Step Two: Install Tcat Server Without a Console
-
Run the installer again on the other machine(s), selecting Custom Installation.
-
De-select the Administration Console.
-
Start the server. See Step Two: Start Tcat Server.
Step Three: Register the New Tcat Server with the Console
-
In the Administration Console of the first server installed, click the Servers tab.
-
The newly installed instance appears in the Unregistered group.
-
Click the checkbox next to Server Name.
-
Click Register.
-
The local server instance now appears in the All group with a green status indicator.
Step Four: Add Servers to Group
-
From the Servers tab in the Console, click New Group.
-
Enter "Beta" and click OK.
-
From the list of all servers which is displayed, select both server instances.
-
Click Add to Group, and select the Beta group from the drop down menu.
-
Confirm your selection.
-
Both instances appear in the Beta group.