Previous Page Next Page

Running as a Standalone Server

Starting using shortcuts

Starting using launch files

Starting using Java

Starting using shortcuts

After the installation finishes, some shortcuts are created with which you can conveniently launch JReport Server.

To start JReport Server using shortcut:

• Double-click the shortcut for JReport Server on your desktop.
• Click Start Server in the JReport folder on the Start menu.

Starting using launch files

After you have installed JReport Server, many batch files are automatically generated in <install_root>\bin. They are for assisting you with using and maintaining JReport Server. All of these batch files can be edited to suit different circumstances. However, make sure that you understand their functions when you want to edit them.

The following table lists the JReport Server launch files.

Examples of running rptconv.bat/rptconv.sh to convert reports

• To convert a single resource:

  rptconv "-source=C:\JReport\Server\jreports\Invoice Report.cls" "–target=C:\temp"

  This will convert C:\JReport\Server\jreports\Invoice Report.cls to C:\temp\Invoice Report.cls.

  rptconv "-source=C:\JReport\Server\jreports\Invoice Report.cls" "–target=C:\temp\1.cls.xml"

  This will convert C:\JReport\Server\jreports\Invoice Report.cls, save the converted report to C:\temp, and name it as "1.cls.xml" (if license allows).

  rptconv "-source=C:\JReport\Server\jreports\Invoice Report.cls"

  This will convert C:\JReport\Server\jreports\Invoice Report.cls, save the converted report in the same directory, and name it as "converted_Invoice Report.cls".

  rptconv "-source=C:\JReport\Server\jreports\Invoice Report.cls" -r

  This will overwrite C:\JReport\Server\jreports\Invoice Report.cls.

• To convert all resources (reports, visual analysis, library components, dashboards, catalogs etc.) in a directory:

  rptconv "-source=C:\JReport\Server\jreports" "–target=C:\temp"

  This will convert all the resources in C:\JReport\Server\jreports and save the converted resources to C:\temp. The converted resources use the same file names as source resources.

  rptconv "-source=C:\JReport\Server\jreports" "–target=C:\temp" -s

  This will convert all the resources in C:\JReport\Server\jreports and in the subdirectories and save the converted resources to C:\temp. The converted resources take the same file names and directory structure as source resources.

  rptconv "-source=C:\JReport\Server\jreports" "–target=C:\temp\*.cls" -s

  This will convert all the resources in C:\JReport\Server\jreports and in the subdirectories and save the converted resources to C:\temp. The converted resources take the same directory structure as source resources and the suffixes of their file names are all changed to ".cls".

  rptconv "-source=C:\JReport\Server\jreports" -r -s

  This will convert all the resources in C:\JReport\Server\jreports and in the subdirectories. The converted resources overwrite the source resources.

  rptconv "-source=C:\JReport\Server\jreports"

  This will convert all the resources in C:\JReport\Server\jreports. All the converted resources are saved in the same directory and named as "converted_SourceResourceName".

• To convert a type of resources with same suffixes in a directory:

  The usage is similar to converting a directory. You can specify the wildcard to filter resources, for example:

  rptconv "-source=C:\JReport\Server\jreports\*.cls" "–target=C:\temp"

  This will convert all the reports with the suffix ".cls" in C:\JReport\Server\jreports and save the converted reports to C:\temp.

Starting using Java

The class of the standalone server is jet.server.JREntServer. You can start JReport Server with the following command instead of using the generated batch files:

JAVA -classpath <classpath> -Djava.compiler=NONE -Dreporthome=<install_root> jet.server.JREntServer [options]

• -classpath
  The classpath must include the following packages originally in your <install_root>\lib: JRESServlets.jar; JREntServer.jar; JREngine.jar; javax.servlet-api-3.1.0.jar; log4j-core-2.7.jar; log4j-api-2.7.jar;
• -Djava.compiler=NONE
  This is without JIT. This is not a required option. However, if you encounter problems running the server and you think that they relate to the Java VM, you can try turning off the JIT compiler and then running again.
• -Djreport.url.encoding
  Specifies the encoding to encode/decode escape characters in URL strings. If not specified, the system default encoding will be used. For example: java ... -Djreport.url.encoding=8859-1...
• -Dreporthome
  This is where JReport Server is installed. It is the Destination Location you specified when you installed it. This option is required. When you set the reporthome, upon launching, JReport will try to find the jslc.dat and report.ini files in <install_root>\bin and check whether they are valid. Jslc.dat is the License control file. Open report.ini, and you will find the configuration information, including the temp, template and the help path. JReport will use the temp path to export the temporary files so you should make sure that the temp folder specified in report.ini exists and has space available.
• -Dfile.encoding
  Specifies the encoding to encode/decode escape characters in the server data. If not specified, the system default encoding will be used. For example: java ... -Dfile.encoding=8859-1...
• -Dresolution
  Sets the system resolution in DPI. If not specified, the system default resolution will be used, which is the resolution of your monitor, for example, -Dresolution=96.
• [options]

  Option	Description
  -?	Print brief help message.
  -p port	The port that this server listens on, default is 8888.
  -ap adminport	The port number that the remote administration uses, default is 8889.
  -l backlog	Maximum length of queue for incoming connection indications.
  -m max	Maximum number of connection handlers.
  -t timeout	Connection timeout in milliseconds.
  -s filename	Servlet property file name.
  -realm realmname	Active realm when the server starts up. The specified realm should exist, otherwise the server will use an existing realm as the active realm. The server will then record a warning message in the log file, and set the selected active realm by the server.realm.active property in the server.properties file.
  -web directory	Web application server root directory, default is <install_root>\public_html.
  -local	Administration on local host only.
  -vDebug	Enables the JReport Engine to output messages to a file and sets engine log file's log level to INFO.
  -vError	Enables the JReport Engine to output messages to a file and sets engine log file's log level to ERROR.
  -env	Print environment settings when the server starts up.
  -silent	Outputs nothing, not even the server start information.
  -log[:file Name] (deprecated)	Outputs the JReport Engine messages to the log file as specified and uses the -vDebug level.
  -logall	Sets all loggers' log level to INFO.
  -jrs.admin.server host:port	The admin server host and RMI port.
  -cleanup	Checks integrality of the server data and cleans up the invalid data.

Previous Page Next Page