Starting and Stopping the Server

Start/Stop Menu — Windows
Start/Stop Scripts — Linux
Start/Stop Apps — Mac OSX

Start/Stop Menu — Windows

This section describes start and stop procedures that vary depending on whether you installed the bundled Tomcat and PostgreSQL or used your own Tomcat and PostgreSQL.

Start/Stop Menus — Bundled Tomcat and PostgreSQL

If you installed the bundled Tomcat and PostgreSQL, use the Windows Start menu to start and stop JasperReports Server.

Click Start > JasperReports Server > Start Service.
Click Start > JasperReports Server > Stop Service.

Additional Information about the Bundled Tomcat and PostgreSQL

The Windows installer installs PostgreSQL and Tomcat as Windows Services. You can manage these Services in the Windows Control Panel:

Control Panel > System and Security > Administrative Tools > Services

You can also start JasperReports Server from the Windows Start menu or by using the Desktop icon. You can shut down using the Desktop icon.

JasperReports Server Windows Service Names

PostgreSQL and Tomcat, installed as Windows Services, are listed in the Windows Services Panel as:

jasperreportsPostgreSQL
jasperreportsTomcat
Preventing JasperReports Server from starting up automatically

By default, the bundled services start automatically on a reboot, which also starts JasperReports Server. To change the startup mode for the services from automatic to manual:

In the Windows Services Panel, select jasperreportsTomcat.
Right-click the jasperreportsTomcat service, and select Properties.
Change the Startup type drop-down setting from Automatic to Manual.
Follow the same steps for jasperreportsPostgreSQL service.

To start JasperReports Server from the Windows Services Panel

  1. Open the Windows Services Panel.
  2. Select jasperreportsPostgreSQL, click Start.
  3. Select jasperreportsTomcat, click Start.

To start JasperReports Server from the CMD Shell

  1. Open a Windows CMD Shell.
  2. Navigate to the root of the <js-install> folder (for example, C:\Jaspersoft\jasperreports-server-9.0.0)
    1. To start JasperReports Server, run the following command:

      servicerun START

    2. To shutdown JasperReports Server, run the following command:

      servicerun STOP

Running Processes

When JasperReports Server is running, the Windows Task Manager lists information about the processes running under the SYSTEM user name, for example:

postgres.exe
tomcat9.exe

Start/Stop Scripts — No Bundled Applications

During installation, if you chose to install one bundled and one existing Tomcat or PostgreSQL, you can use the Windows start/stop scripts to start and stop only the bundled one.

For example, if you have an existing Tomcat and you install the bundled PostgreSQL, the scripts and menus specified in the previous section would start and stop the PostgreSQL application. To start and stop the existing Tomcat, you would use the management scripts provided by the Tomcat application.

JasperReports Server requires database and application servers to be started in this order:

1. Database server.
2. Application server.

Start/Stop Scripts — Linux

This section describes start and stop procedures that vary depending on whether you installed the bundled Tomcat and PostgreSQL or used your own Tomcat and PostgreSQL.

Manual Start/Stop

You typically start and stop JasperReports Server at the Linux command line. Run the following commands in a Linux shell.

  • To start JasperReports Server, enter:

    cd <js-install>

    ./ctlscript.sh start

  • To stop JasperReports Server, enter:

    cd <js-install>

    ./ctlscript.sh stop

To start and stop individual components:

cd <js-install>
./ctlscript.sh start|stop   postgresql
./ctlscript.sh start|stop   tomcat 

If you enter just the ./ctlscript.sh command, then you get the following:

./ctlscript.sh
usage: ./ctlscript.sh help
./ctlscript.sh (start|stop|restart|status)
./ctlscript.sh (start|stop|restart|status) postgresql
./ctlscript.sh (start|stop|restart|status) tomcat
help - this screen
start - start the service(s)
stop - stop the service(s)
restart - restart or start the service(s)
status - show the status of the service(s)

Auto Start/Stop with Bundled Tomcat and PostgreSQL

If you want JasperReports Server to start automatically when you reboot your Linux server, you need to install the JasperReports Server database and application server as services. If you have installed JasperReports Server using the binary installer with the bundled Tomcat and bundled PostgreSQL options, you'll find an example jasperserver service script in the following location:

<js-install>/scripts/linux/jasperserver

Edit this script and set permissions as described in the <js-install>/scripts/linux/readme file in the same location.

Once installed, these services start automatically when you reboot, which also starts JasperReports Server.

Start/Stop Apps — Mac OSX

After you complete the Mac OSX installation, you typically find JasperReports Server installed in the following location:

/Applications/jasperreports-server-9.0.0

When JasperReports Server is running, you can see the names of the Java and PostgreSQL processes in the Activity Monitor.

  • To start JasperReports Server, locate this folder in Finder and double-click the following app:

jasperServerStart.app

  • To stop JasperReports Server, locate this folder in Finder and double-click the following app:

jasperServerStop.app

The Mac lists the following information in the Activity Monitor:

java

or

org.apache.catalina.startup.Bootstrap

postgres

Start/Stop Apps — Mac Dock

Using Finder, move the following apps into the Mac Dock to start, stop, and login to JasperReports Server:

jasperServerStart.app
jasperServerStop.app
jasperServerLogin.app

Start/Stop JasperReports Server — Mac Terminal Shell

To start and stop JasperReports Server using the Mac terminal shell

1. Open a Terminal shell (Finder > Go > Utilities > Terminal Icon).
2. Navigate to the <js-install> folder. For instance: /Applications/jasperreports-server-9.0.0
3. To start PostgreSQL, Tomcat, and JasperReports Server, enter:

./ctlscript.sh start

4. To shutdown PostgreSQL, Tomcat, and JasperReports Server, enter:

./ctlscript.sh stop

5. To start and stop individual components:
cd <js-install>
./ctlscript.sh start|stop   postgresql
./ctlscript.sh start|stop   tomcat

If you enter just the ./ctlscript.sh command you will get the following:

./ctlscript.sh
usage: ./ctlscript.sh help
./ctlscript.sh (start|stop|restart|status)
./ctlscript.sh (start|stop|restart|status) postgresql
./ctlscript.sh (start|stop|restart|status) tomcat
help - this screen
start - start the service(s)
stop - stop the service(s)
restart - restart or start the service(s)
status - show the status of the service(s)