Tomcat Configuration Application

From Connect
Jump to: navigation, search

Go Up to Overview of the Embarcadero Connect Tools

From Windows: Start > All Programs > Embarcadero Connect 3.0 > Configure Embarcadero Connect

You can use the Tomcat Configuration Application to start, stop and restart the Embarcadero Connect server, and to change configuration parameters such as the amount of memory assigned to the Embarcadero Connect server.

After you perform any change in this configuration application, click OK to apply the changes and close the dialog. You can click Apply to apply your changes immediately without closing the Tomcat Configuration Application, or Cancel to close the configuration application without saving any change that you did not apply yet.

The Tomcat Configuration Application provides the following tabs:

General Tab

On the General tab you can access the following items:

Item Description

Service Name

The name of the Embarcadero Connect system service. You cannot change this name.

Display Name

The display name of the Embarcadero Connect system service.

Description

A description of the Embarcadero Connect system service.

Path to executable

Path to the executable that starts the service.

Startup type

Use this combo box to choose how to start Embarcadero Connect up. You can select any of the following options:

  • Automatic. Windows starts the service automatically when the system starts.
  • Manual. Windows only starts the service when another service needs it, or if you start the service manually.
  • Disabled. Windows disables starting the service. You cannot start the service, not even manually.

Service Status

Indicates whether Embarcadero Connect is running ("Started") or not ("Stopped").

Start
(only when Embarcadero Connect is stopped)

Starts the Embarcadero Connect system service.

Stop
(only when Embarcadero Connect is running)

Stops the Embarcadero Connect system service.

Pause

Pauses the Embarcadero Connect system service.

Restart

Restarts the Embarcadero Connect system services.

Log On Tab

On the Log On tab you can choose which account you want to use when you start the Embarcadero Connect system service.

To use a local system account, check "Local System account" and optionally check "Allow service to interact with desktop" if you need to be able to interact with the Embarcadero Connect system service from a graphical application.

If you want to use a custom user account for the Embarcadero Connect system service, check "This account" instead, and enter a custom username and a password.

Logging Tab

On the Logging tab you can access the following items:

Item Description

Level

Embarcadero Connect only logs messages that have the level of severity specified here. By default, Embarcadero Connect logs only information messages.

Log path

Path to the folder where logs are saved.

Log prefix

Prefix of the Embarcadero Connect system service log files.

The name of the resulting log file is <prefix>.<year>-<month>-<day>.log. For example: mylog-2025-09-11.log.

Pid file

If you specify here the path to a file, Embarcadero Connect stores its process identifier in that file.

Redirect Stdout

Where to redirect the standard output.

Enter "auto" to use the default value, or click the ... button to select a file to write the output.

Redirect Stderror

Where to redirect the standard error output.

Enter "auto" to use the default value, or click the ... button to select a file to write the output.

Java Tab

On the Java tab you can access the following items:

Item Description

Use default

Check this option to use the default Java Virtual Machine.

Java Virtual Machine

Path to the Java Virtual Machine.

Java Classpath

List of locations to look for Java classes and packages.

Java Options

Additional startup options to use when Embarcadero Connect starts the Java Virtual Machine.

Initial memory pool

The initial amount of memory that Embarcadero Connect uses, in MB.

Maximum memory pool

The maximum amount of memory that you allow Embarcadero Connect to use, in MB.

Note: The Java Virtual Machine cannot use more than 1.5 GB of memory.

Thread stack size

Maximum size of the thread stack, in KB.

Startup Tab

On the Startup tab you can access the following items:

Item Description

Class

Main Java class to start Embarcadero Connect.

Image
(only in exe mode)

Image to start Embarcadero Connect.

Working Path

Working path to start Embarcadero Connect. Embarcadero Connect relative paths are relative to this path.

Method

Method to invoke on start.

Arguments

Arguments to include on the start command.

Timeout

Maximum startup time, in seconds. If the startup take more time, it automatically fails.

Mode

How to start Embarcadero Connect.

You can choose any of the following modes:

  • exe. Use a Windows executable to start Embarcadero Connect.
  • jvm. Use the Java Virtual Machine to start Embarcadero Connect.
  • Java. Use the Java executable to start Embarcadero Connect.

Shutdown Tab

On the Shutdown tab you can access the following items:

Item Description

Class

Main Java class to shutdown Embarcadero Connect.

Image
(only in exe mode)

Image to shutdown Embarcadero Connect.

Working Path

Working path to shutdown Embarcadero Connect. Embarcadero Connect relative paths are relative to this path.

Method

Method to invoke on shutdown.

Arguments

Arguments to include on the shutdown command.

Timeout

Maximum shutdown time, in seconds. If the shutdown take more time, it automatically fails.

Mode

How to shutdown Embarcadero Connect.

You can choose any of the following modes:

  • exe. Use a Windows executable to shutdown Embarcadero Connect.
  • jvm. Use the Java Virtual Machine to shutdown Embarcadero Connect.
  • Java. Use the Java executable to shutdown Embarcadero Connect.

See Also