Nav

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

  1. After a minute or two, open a Web browser to the following address: http://localhost:8080/console.

  2. Log in using "admin" for both username and password.

  3. The Tcat Server console appears, with the Servers tab selected by default.

Step Four: Register a Tcat Server with the Console

  1. In the left panel, click Unregistered.

  2. The local Tcat server instance appears to the right.

  3. Click the checkbox next to Server Name.

  4. Click Register.

  5. The local server instance now appears in the All group with a green status indicator.

Step Five: Manage the Tcat Server Instance

  1. Click the All list in the left panel.

  2. Click the Server Name.

  3. The Server Details panel appears.

  4. Click through the tabs to view the information and operations available.

Step Six: Add a New Web Application

  1. Click the Deployments tab.

  2. Click New Package at top right.

  3. Click Upload New Application.

  4. Browse to local file system to select a .war file.

  5. Click Add. Enter a Package Name:

    addDeployment1

  6. Click in the Space to the top right, and select the server name.

  7. Click Save and Deploy at bottom right.

  8. Select Deployed from left panel.

  9. The new package appears under Applications to the left, with the server to the right.

  10. Verify your application works by navigating to it in a browser.

    viewpebble1

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

  1. Run the installer again on the other machine(s), selecting Custom Installation.

  2. De-select the Administration Console.

    installTcatOnly

  3. Start the server. See Step Two: Start Tcat Server.

Step Three: Register the New Tcat Server with the Console

  1. In the Administration Console of the first server installed, click the Servers tab.

  2. The newly installed instance appears in the Unregistered group.

  3. Click the checkbox next to Server Name.

  4. Click Register.

    regnew1.png

  5. The local server instance now appears in the All group with a green status indicator.

Step Four: Add Servers to Group

  1. From the Servers tab in the Console, click New Group.

  2. Enter "Beta" and click OK.

  3. From the list of all servers which is displayed, select both server instances.

  4. Click Add to Group, and select the Beta group from the drop down menu.

    addtoBeta1

  5. Confirm your selection.

  6. Both instances appear in the Beta group.