Nav

QuickStart

Use these instructions to install Tcat Server on one or more machines to get started managing, monitoring, and deploying your applications.

For additional information and more detailed installation documentation, see:

You can send comments or questions to: tcat-install@mulesoft.com

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

To run Tcat Server, you need a working installation of the correct version of Java. You have two ways to arrive at this – either use a pre-existing installation of Java, or you may select a Tcat Server installer download that contains a bundled Java Runtime Environment (JRE). This second option is only available for some operating systems.

In either of these cases, you need to read this section to determine system requirements.

Obtain Installer

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 Solaris OS X

installer.exe

installer.sh

installer.sh

installer.dmg

Step Two: Start Tcat server

Use the commands listed below to start Tcat Server.

Windows Linux Solaris OS X

tcat6.bat OR start menu

./tcat6.sh

svcadm enable tcat6

./startup.sh

Step Three: Log on to 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 the 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 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 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, and 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.

    viewpebble2

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, you should disconnect before you continue. Otherwise, the Tcat Server instances may not be automatically detected.

Step One: Install Tcat Server on a Machine

Use the instructions in the previous Install Tcat Server on One Machine.

Step Two: Install Tcat Server without Console

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

  2. De-select Administration Console.

    selcomps1

  3. #Start the server

Step Three: Pair the New Tcat Server with the Administration 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

  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 Administration 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.

    tobeta

  5. Confirm your selection.

  6. Both instances appear in the Beta group.