Skip to main content
Version: 2.8

Starting the Tomcat server

Once the installation has finished, it is time to start the application. You can do this either from the command line or as a Linux service.

To start and stop the server from the command line

  1. Open the installation directory, and run the ll command. The result should be similar to the following:

    _update/
    conf/
    modules/
    plugins/
    runtime/
    storage/
  2. Run cd runtime/host/bin. This directory contains the tribefire-console-start.sh and tribefire-console-stop.sh scripts.

  3. Complete one of the following tasks:

    TaskLinux commandWindows commandResult
    Start the service./tribefire-console-start.sh./tribefire-console-start.bat

    You should get Tomcat started response and the service should be available shortly (less than in a minute) - when all components are deployed.

    If the service is not available, check the catalina.log available in installation_directory/../logs (unless configured otherwise).

    Stop the service./tribefire-console-stop.sh./tribefire-console-stop.bat

    You should get Tomcat stopped response.

    It can take several minutes to stop the service. In this case, you will get the following warning.

    Tomcat did not stop in time. PID file was not removed. To aid diagnostics a thread dump has been written to standard out Tribefire Host stopped.

To start and stop the server as a Linux service

After installation, you can find a Linux tribefire-service.sh script file in the runtime/host/bin/ folder.

It can be used to install the Tomcat server as a Linux service. At the moment we support the following Init systems: sysvinit and Upstart.

  1. Run sudo ./tribefire-service.sh install as a root user.

  2. When prompted, enter the root password.

    This will create a symbolic link to this script in /etc/init.d and register it as a service:

    sudo ./tribefire-service.sh install
    Assigning execution rights to start/stop script
    Creating a reference to the start/stop script in /etc/init.d
    Registering conversion as a service
    Registering conversion using /usr/sbin/update-rc.d
    Done with registering service conversion

    To uninstall the service, run sudo ./tribefire-service.sh uninstall.

  3. Once it is installed, the service can be used to start and stop the server:

    TaskCommand
    Start the service/etc/init.d/service_name start*
    Stop the service/etc/init.d/service_name stop*

    *Replace the service_name with the name provided in projectDescriptor property inside the configuration file (defaults are conversion for the Conversion Service package and agile-documents-platform for the D1 package).

    Note

    Alternatively, you can start Tomcat as a background service. For more information, see Tomcat documentation.