Skip to main content

Running as an OS Service

  • Updated

BackPrevious Topic   Next TopicNext

Running as an OS Service

Logi JReport Server can be configured as an OS service. This section shows you how to run Logi JReport Server as a service of Windows, Unix and Linux.

Below is a list of the sections covered in this topic:

Running as a Windows Service

The tool JRservice.exe saved in <install_root>\bin is provided to assist you in installing Logi JReport Server as a Windows service.

You can get the following information if you run JRservice.exe without any options:

Usage:
JRService -install [-interactive] to install the service
JRService -remove                 to remove the service
    -interactive to enable Logi JReport Server service
                 to interact with the desktop
StartServiceCtrlDispatcher being called.
This may take several seconds. Please wait.
  • JRService -install
    Running JRservice.exe with the -install option will install Logi JReport Server as a Windows service. If you open the Services item in the Control Panel, you will find a service named Logi JReport Server in the list.
  • JRService -install -interactive
    If you use the -interactive option together with -install, the service installed will be run in interactive mode. That is, when you start the service, a Command Prompt window will pop up. However, if you don't specify this option when you install the service, the Command Prompt window will not be displayed when you start the service. After you have installed Logi JReport Server as a service, you will then be prompted to restart your computer for the service installation to take effect.
  • JRService -remove
    Running JRservice.exe with the -remove option removes the Windows service of Logi JReport Server from Windows. However, before you run this, you should stop the service.

Configuring the Service

The parameters for the Windows service of Logi JReport Server are read from the file NTService.ini in <install_root>\bin. In this file, you can find three parameters specified, as shown in the following example:

JavaVM="C:\Program Files\Java\jdk1.7.0_51\bin\java.exe"
StartArg= "-Dinstall.root=C:\Logi JReport\Server" -classpath "C:\Logi JReport\Server\derby\lib\*;C:\Logi JReport\Server\lib\JREngine.jar;
C:\Logi JReport\Server\lib\JRESServlets.jar;C:\Logi JReport\Server\lib\JRStructuredEngine.jar;C:\Logi JReport\Server\lib\JRStructuredClient.jar
;C:\Logi JReport\Server\lib\JREntServer.jar;C:\Logi JReport\Server\lib\maintain.jar;C:\Logi JReport\Server\lib\JRWebDesign.jar;
C:\Logi JReport\Server\lib\*;C:\Program Files\Java\jdk1.7.0_51\lib\tools.jar;" -Xms256m -Xmx1024m -XX:PermSize=64m -XX:MaxPermSize=128m
 -Xrs -Djava.net.preferIPv4Stack="true" "-DLogi JReport.url.encoding=UTF-8" -Dreporthome="C:\Logi JReport\Server" jet.server.JREntServer
ShutdownArg= "-Dinstall.root=C:\Logi JReport\Server" -classpath "C:\Logi JReport\Server\derby\lib\*;C:\Logi JReport\Server\lib\JREngine.jar;
C:\Logi JReport\Server\lib\JRESServlets.jar;C:\Logi JReport\Server\lib\JRStructuredEngine.jar;C:\Logi JReport\Server\lib\JRStructuredClient.jar;
C:\Logi JReport\Server\lib\JREntServer.jar;C:\Logi JReport\Server\lib\maintain.jar;C:\Logi JReport\Server\lib\JRWebDesign.jar;C:\Logi JReport\Server\lib\*;"
 -Xmx512m -Xrs -Dreporthome="C:\Logi JReport\Server" jet.server.CommandSender localshutdown
  • JavaVM
    The path of the Java VM.
  • StartArg
    The Java command line for launching Logi JReport Server as an independent web application server. This will be called when the service is started. In most cases you need to modify -Xms and -Xmx to specify the Java heap size. After you modify this file you need to stop and start the service again.
  • ShutdownArg
    The Java command line for shutting down Logi JReport Server. This is called when the service is stopped.

Starting the Service

There are two ways to start the Logi JReport Server service.

  • After the server has been installed as a service, it is by default configured to start automatically each time. In other words, without otherwise modifying the Control Panel, the service will start automatically each time Windows is started.
  • You can directly start the service through the Services item in the Control Panel. Open the Services list, find Logi JReport Server on the list, select it and select the Start button.

You can change the options in the file NTService.ini in <install_root>\bin before you start the service (for more information on the options available, see Starting Logi JReport Server Using Java). In the example above, there are no options specified in StartArg. If you would like to set all log level to INFO, you will need to append -logall at the end, as in the following example:

... 
StartArg= "-Dinstall.root=C:\Logi JReport\Server"
-classpath "C:\Logi JReport\Server\lib\JREntServer.jar;
C:\Logi JReport\Server\lib\JREngine.jar;C:\Logi JReport\Server\lib\javax.servlet-api-3.1.0.jar;
C:\Logi JReport\Server\lib\log4j-core-2.7.jar;C:\Logi JReport\Server\lib\log4j-api-2.7.jar;C:\TEMP" -Djava.compiler=NONE 
-Dreporthome=C:\Logi JReport\Server jet.server.JREntServer -logall
...

Stopping the Service

There are three ways for you to stop the Logi JReport Server service:

  • Open the Control Panel, go to Administrative Tools, double-click the Services item, select Logi JReport Server, and then select the Stop button if it is not disabled.
  • Run the batch file CmdSender.bat in <install_root>\bin with the localshutdown argument, for example: <install_root>\bin\CmdSender.bat localshutdown.
  • Use the Shut Down the Server button on the Logi JReport Administration page.

Notes:

  • When using NT service to start Logi JReport Server, the mapped disk in path cannot be accessed due to JVM limitation. You should use UNC path (for example, \\127.0.0.1\public_write) instead of the mapped disk it is mapped to (for example, Z).
  • When using the Local System account to run Logi JReport Server as a Windows service, under some circumstances writing to a UNC path (for example, \\127.0.0.1\public_write) is not allowed. To solve this problem, you need to start the service by using a normal Windows user.

Back to top

Running as a Service on Unix

Assume that Logi JReport Server has been installed to /user/report/jns,

  1. Write a script /etc/init.d/jrserver as follows, and make it executable. 
    #!/bin/sh
mode=$1
if [ ! -d /user/report/jns ]
then # Logi JReport not installed
exit 1
fi
case "$mode" in
'start')
if [ -d /user/report/jns ]
then
echo "Starting Logi JReport Server"
/user/report/jns/bin/NJRServer.sh &
fi
;;
'stop')
if [ -d /user/report/jns ]
then
echo "Stopping Logi JReport Server"
/user/report/jns/bin/CmdSender.sh localshutdown &
fi
;;
*)
echo " Usage: "
echo " $0 start (start Logi JReport Server)"
echo " $0 stop (stop Logi JReport Server)"
exit 1
;;
esac
exit 0
  2. Create a soft link to /etc/rc2.d/S99jrserver.

    ln -s /etc/init.d/jrserver /etc/rc2.d/S99jrserver

  3. Create a soft link to /etc/rc0.d/K99jrserver.

    ln -s /etc/init.d/jrserver /etc/rc0.d/K99jrserver

Back to top

Running as a Service on Linux

Running Logi JReport Server as an OS service on Linux is more or less the same as with running on Unix. Here it is assumed that your default start up rc is rc5.

Setting up XVFB

  1. Install XVFB.
  2. Write a script /etc/init.d/xvfb as follows, and make it executable. 
    #!/bin/sh
mode=$1
case "$mode" in
'start')
echo "start xvfb "
if [ -f /usr/X11R6/bin/Xvfb ]
then
/usr/X11R6/bin/Xvfb :1 -screen 0 1152x900x8 &
fi
;;
*)
echo " Usage: "
echo " $0 start (start XVFB)"
echo " $0 stop (stop XVFB not support)"
exit 1
esac
exit 0
  3. Create a soft link to /etc/rc5.d/S97xvfb.

    ln -s /etc/init.d/xvfb /etc/rc5.d/S97xvfb

Using rc to Run Logi JReport Server As a Service

Assume that Logi JReport Server has been installed to /Logi JReport/Server.

  1. Write a script /Logi JReport/Server/bin/JRServer as shown below, and make it executable. Here it is assumed that Logi JReport Server is running on a machine with IP address 127.0.0.1. 
    #!/bin/sh
DISPLAY=127.0.0.1:1.0
export DISPLAY
/Logi JReport/Server/bin/JRServer -silent "$@"
  2. Write a script /etc/init.d/jrserver as follows, and make it executable. 
    #!/bin/sh
mode=$1
if [ ! -d /Logi JReport/Server ]
then # Logi JReport not installed
exit 1
fi
case "$mode" in
'start')
if [ -d /Logi JReport/Server ]
then
echo "Starting Logi JReport Server"
cd /Logi JReport/Server/bin/;
JRServer -silent & 
fi
;;
'stop')
if [ -d /Logi JReport/Server ]
then
echo "Stopping Logi JReport Server" 
/Logi JReport/Server/bin/CmdSender localshutdown &
fi
;;
*)
echo " Usage: "
echo " $0 start (start Logi JReport Server)"
echo " $0 stop (stop Logi JReport Server)"
exit 1
;;
esac
    exit 0
  3. Create a soft link to /etc/rc5.d/S98jrserver.

    ln -s /etc/init.d/jrserver /etc/rc5.d/S98jrserver

  4. Create a soft link to /etc/rc5.d/K98jrserver.

    ln -s /etc/init.d/jrserver /etc/rc5.d/K98jrserver

If all has been carried out successfully, the installation of the service will now have finished. Logi JReport Server is now ready to run as a daemon process.

Back to top

BackPrevious Topic   Next TopicNext

Related articles