Starting and Stopping JasperReports Server

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 > All Programs >JasperReports Server> Start or Stop Services then select Start Service or Stop Service.

Additional Information about the Bundled Tomcat and PostgreSQL

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
Do the same for the jasperreportsPostgreSQL service

To Start JasperReports Server from the Windows Services Panel:

Open the Windows Services Panel
Select jasperreportsPostgreSQL, click Start
Select jasperreportsTomcat, click Start

To Start JasperReports Server from the CMD Shell:

Open a Windows CMD Shell
Navigate to the root of the <js-install> folder (C:\Jaspersoft\jasperreports-server-)
servicerun START
servicerun STOP (to shutdown JasperReports Server)

Running Processes:

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

postgres.exe
tomcat7.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.

Start JasperReports Server:

cd <js-install>

./ctlscript.sh start

Stop JasperReports Server:

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 

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-

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

Feedback