Index

Installing and Launching JReport Enterprise Viewer

Installing JReport Enterprise Viewer

Installing on Windows

Please follow the steps listed below to install JReport Enterprise Viewer:

  1. Download the JReport Enterprise Viewer install program EntViewSetup.exe from the Jinfonet web site: http://www.jinfonet.com.
  2. Run EntViewSetup.exe. JReport Enterprise Viewer Installer program will search for a suitable JVM to load the InstallShield wizard. If no suitable JVM is found, the installation process will be terminated. You can run the setup again by using the option -is:javahome <JAVA HOME DIR>.
  3. Welcome Screen

    Once the InstallShield is successfully loaded, the Welcome screen will appear. Click Next to continue.

  4. EULA Screen

    Read the End User License Agreement carefully, click I accept the terms of the license agreement, and then click Next. The installation process will not continue unless you accept all the terms stated in the EULA.

  5. Select JDK Screen

    Select the JDK version with which JReport Enterprise Viewer will be installed. The selected JDK will be used to execute JReport Enterprise Viewer. The InstallShield collects and lists all the available JDK versions installed on your machine, you can highlight to select one of the JDK versions from the list. Click Next to continue.

    Note: The InstallShield doesn't list JRE versions found on your machine, and the lowest JDK version we support is 1.3, please use v1.3 or above.

  6. Specify Install Location

    Provide the absolute path where to install JReport Enterprise Viewer. Click Browse to navigate to the destination folder. Click Next to continue.

  7. Add Additional Classpaths

    A class path is necessary when using a JDBC driver or User Defined Object. A class path is composed of a file path plus a zip file, jar file, or directory path, for example, C:\jdk1.3\lib\tools.jar.

    If you want to add additional classpaths, check the Add additional classpaths to locate external system components option. Type the class path in the Select additional class paths field, you can also click the Select button to locate the class file. Click Add to add the selected class paths to the class path list. Click Delete to delete the selected class path from the class path list. Click Next, the InstallShield will start to install JReport Enterprise Viewer.

  8. Information Screen

    Read the information and click Finish to dismiss the InstallShield wizard.

Installing on UNIX

  1. Download JReport Enterprise Viewer installation file for UNIX EntViewSetup.sh from our Web site at http://www.jinfonet.com.
  2. Execute the installation of the executable file EntViewSetup.sh to launch the InstallShield wizard.

    Start it from a console. The dollar symbol($) in the following commands is supposed to be the prompt string and should not be copied. Open a console window. Change the current directory to the one where EntViewSetup.sh is located. Typically the command shown is similar to $ cd thepath. To make EntViewSetup.sh executable, type the command $ chmod +x EntViewSetup.sh. To run EntViewSetup.sh, use the command $ sh ./EntViewSetup.sh.

    After you execute the EntViewSetup.sh file, JReport Enterprise Viewer Installer program will search for a suitable JVM to load the InstallShield wizard. If no suitable JVM is found, the installation process will be terminated. You can run the setup again by using the option -is:javahome <JAVA HOME DIR>.

  3. Welcome Screen

    Once the InstallShield is successfully loaded, the Welcome screen will appear. Click Next to continue.

  4. EULA Screen

    Read the End User License Agreement carefully, select I accept the terms of the license agreement, and then click Next. The installation process will not continue unless you accept all the terms stated in the EULA.

  5. Specify Install Location

    Provide the absolute path where to install JReport Enterprise Viewer. Click Browse to navigate to the destination folder. Click Next to continue.

  6. Add Additional Classpaths

    A class path is necessary when using a JDBC driver or User Defined Object. A class path is composed of a file path plus a zip file, jar file, or directory path, for example, /usr/jdk1.3/lib/tools.jar.

    If you want to add additional classpaths, check the Add additional classpaths to locate external system components option. Type the class path in the Select additional class paths field, you can also click the Select button to locate the class file. Click Add to add the selected class paths to the class path list. Click Delete to delete the selected class path from the class path list. Click Next, the InstallShield will start to install JReport Enterprise Viewer.

  7. Information Screen

    Read the information and click Finish to dismiss the InstallShield wizard.

Launching JReport Enterprise Viewer

Launching on Windows

You can start JReport Enterprise Viewer on Windows with either command line or batch files.  

Starting JReport Enterprise Viewer from the Command Line

jet.client.ui.JRViewer is the class to start JReport Enterprise Viewer. Use the following command:

java -classpath <classpath> -Dreporthome=<reporthome> jet.client.ui.JRViewer [options]

Where

Examples:

Assume that you installed JReport Enterprise Viewer at C:\JREntViewer.

  1. java -classpath C:\JREntViewer\lib\JREntViewer.zip -Dreporthome=c:\jrentviewer jet.client.ui.JRViewer -vDebug -vError
    -reporthttp://222.222.222.109:8888/hsqlDemo/Tutorial.cat/phaseorder.cls "-paramsSTARTDATE=5/10/1998,ENDDATE=7/10/1998" -useradmin -passwordadmin

    With this command line, you will view the result of report phaseorder.cls which belongs to catalog /hsqlDemol/tutorial.cat on JReport Enterprise Server that is located at http://222.222.222.109:8888.  The user name and password are both admin, and the parameter values for report phaseorder.cls are startdate,5/10/1998,and enddate, 7/10/1998.

  2. java -classpath C:\JREntViewer\lib\JREntViewer.zip -Dreporthome=c:\jrentviewer jet.client.ui.JRViewer -vDebug -vError
    -reporthttp://222.222.222.109:8888/hsqlDemo/Tutorial.cat/phaseorder.cls "-paramsSTARTDATE=5/10/1998,ENDDATE=7/10/1998" -useradmin -passwordadmin   -showBrowser

    With this command line, in addition to viewing the results of the specified report, the main frame of the JReport Enterprise Viewer will be loaded as well.

  3. java -classpath C:\JREntViewer\lib\JREntViewer.zip -Dreporthome=c:\jrentviewer jet.client.ui.JRViewer -vDebug -vError
    -serverhttp://222.222.222.109:8888/hsqlDemo -useradmin -passwordadmin

    With this command line, connect with JReport Enterprise Server located at http://222.222.222.209:8888 using the initial path /hsqlDemo, and then loading the main frame of JReport Enterprise Viewer.

  4. java -classpath C:\JREntViewer\lib\JREntViewer.zip -Dreporthome=c:\jrviewer jet.client.ui.JRViewer -vDebug -vError

    Load the main frame of JReport Enterprise Viewer directly.

Starting JReport Enterprise Viewer with Launcher

After you install JReport Enterprise Viewer, a set of utilities are generated automatically under %installroot%\bin.  All of these batch files have their own functions and can be edited or tailored to certain circumstances.

Launching on Unix

Starting JReport Enterprise Viewer from the Command Line

java -classpath <classpath> -Dreporthome=<reporthome> jet.client.ui.JRViewer [options]

Where

-help:Print out this message.
-vDebug: Enable output debug message.
-vError: Enable output error message.
-log[:<file>]: Output message to ./JRViewer.log or ./<file>.
-server<server URL >: Indicate JReport Server URL address.
-report<report URL >: Indicate the report URL to view new result from the command line.
-params<parameters>: Indicate parameters of the reports to view result from the command line.
-showBrowser: Indicate whether to display the browser of JReport Enterprise Viewer while running and viewing new report results of a from the command line.
-user<user name>: Indicate user name.
-password<password>: Indicate password.
-proxyhost<proxy host>: Indicate proxy host.
-proxyport<proxy port>: Indicate proxy port.
-proxyuser<proxy user name> Indicate proxy user name.
-proxypassword<proxy password> Indicate proxy password.

Examples:

Assume that you installed JReport Enterprise Viewer at /JREntViewer.

  1. java -classpath /JREntViewer/lib/JREntViewer.zip -Dreporthome=/JREntViewer jet.client.ui.JRViewer -vDebug -vError
    -reporthttp://222.222.222.109:8888/hsqlDemo/Tutorial.cat/phaseorder.cls "-paramsSTARTDATE=5/10/1998,ENDDATE=7/10/1998" -useradmin -passwordadmin

    With this command line, you will view the result of report phaseorder.cls which belongs to catalog /hsqlDemo/tutorial.cat on JReport Enterprise Server that is located at http://222.222.222.109:8888. The user name and password are both admin, and the parameter values for report phaseorder.cls are startdate,5/10/1998,and enddate, 7/10/1998.

    Java -classpath /JREntViewer/lib/JREntViewer.zip -Dreporthome=/JREntViewer jet.client.ui.JRViewer -vDebug -vError
    -reporthttp://222.222.222.109:8888/hsqlDemo/Tutorial.cat/phaseorder.cls "-paramsSTARTDATE=5/10/1998,ENDDATE=7/10/1998" -useradmin -passwordadmin -showBrowser

  2. With this command line, in addition to viewing the results of the specified report, the main frame of the JReport Enterprise Viewer will be loaded as well.
  3. java -classpath /JREntViewer/lib/JREntViewer.zip -Dreporthome=/JREntViewer jet.client.ui.JRViewer -vDebug -vError
    -serverhttp://222.222.222.109:8888/hsqlDemo -useradmin -passwordadmin

    With this command line, connect with JReport Enterprise Server located at http://222.222.222.209:8888 using the initial path /hsqlDemos, and then loading the main frame of JReport Enterprise Viewer.

  4. java -classpath /JREntViewer/lib/JREntViewer.zip -Dreporthome=/JREntViewer jet.client.ui.JRViewer -vDebug -vError

    Load the main frame of JReport Enterprise Viewer directly.

Starting JReport Enterprise Viewer with Launcher

After you install JReport Enterprise Viewer, a set of utilities are generated automatically under %installroot%/bin. All of these batch files have their own functions and can be edited or tailored to certain circumstances.

To make these files executable, first type the command such as: $ chmod a+x JREntViewer.sh

Run viewer with options.
Usage: $ sh ./JREntViewer.sh [options]
[options] is the same as what we described above.
Use -? for more detailed information.

Run viewer with debug and log information. The output log file is JReport.log under the current directory. In case of problems, you may run this batch to reproduce the problem.
Usage: $ sh ./DJEntViewer.sh [option]
Use -? for more detailed information

Run Viewer without JIT option. If your viewer often crashes with JIT option, try this batch file instead of JREntViewer.bat.
Usage $ sh ./NJREntViewer.sh [options]
Use -? for more detailed information.

 

Index