JReport Enterprise Server Minimum Server Requirements OS: Microsoft Windows 2000, XP, 2003 Unix, Linux CPU: PIII 550 PIII 450 or sunSPARC 400 Memory: 128 MB 128 MB Disk: 200 MB free 200 MB free JDK: 1.3.0 or above JDK 1.3.0 or above Recommended Server Requirements OS: Microsoft Windows 2000, XP Solaris, Linux CPU: P4 2.0G P4 1.5G or sunSPARC 1G Memory: 512 MB 512 MB Disk: 200 MB free 200 MB free JDK: 1.4.1_02 or above 1.4.1_02 or above JReport Enterprise Server with JReport Clustered Server Option Minimum Server Requirements Admin/Backup Server Slave Server OS: Microsoft Windows 2000, XP, 2003 Unix, Linux Microsoft Windows 2000, XP, 2003 Unix, Linux CPU: PIII 800 PIII733 or sunSPARC 400 PIII 550 PIII 450 or sunSPARC 400 Memory: 256 MB 256 MB 128 MB 128 MB Disk: 200 MB free 200 MB free 200 MB free 200 MB free JDK: JDK 1.3.0 or above JDK 1.3.0 or above JDK 1.3.0 or above JDK 1.3.0 or above Recommended Server Requirements Admin/Backup Server Slave Server OS: Microsoft Windows 2000, XP, 2003 Solaris, Linux Microsoft Windows 2000, XP, 2003 Solaris, Linux CPU: P4 2.4G P42.0G or sunSPARC 1G CPU P4 2.0G P4 1.5G or sunSPARC 650 Memory: 1 GB 1 GB 512 MB 512 MB Disk: 200 MB free 200 MB free 200 MB free 200 MB free JDK: JDK 1.4.1_02 or above JDK 1.4.1_02 or above JDK 1.4.1_02 or above JDK 1.4.1_02 or above Client Requirements Minimum Client Requirements Internet Explorer 5.5 or above, Netscape 7.1, Mozilla 1.6 or above in windows platform Recommended Client Requirements Internet Explorer 6 or above, Netscape 7.1, Mozilla 1.7 or above in windows platform Note: Support for Java VMs other than Sun and IBM is not available, so the program's behavior will be unpredictable in other Java VMs. However, reports of any problems you find with another Java VM are welcome.
- Download JReport Enterprise Server installation file EntSvrSetup.exe from our Web site at http://www.jinfonet.com/ .
- Run EntSvrSetup.exe and follow the default prompts to install.
During installation, please note that:
- The InstallShield will first find a JVM to get started. If no JVM is found, the installer is failed to launch. To solve this issue, you can install JReport Enterprise Server from a DOS command by specifying
-is:javahomeoption for the InstallShield like below:
EntSvrSetup.exe -is:javahome c:\j2sdk1.4.1_06- The installer provides a chance for you to add additional classpath. Or after the installation, you can choose to manually add them into the setenv.bat under
%install_root%\bin.- If you select to install JReport Enterprise Server in a folder that contains a copy of JReport Enterprise Server, the installer will replace the packages and create new batch/script files. Meanwhile, a copy of the old batch/shell files is kept for your reference. You are recommended to use the batch/script files coming along with the installer to make sure all the new packages are added into the classpath.
JReport Enterprise Server officially supports Solaris, and is able to run on Linux, HP-Unix with GUI and AIX. Let us first learn to install JReport Enterprise Server on Unix with GUI. In the following process, suppose X server is running and Java 1.3.0 or above is available, otherwise ask your administrator for help.
- Download JReport Enterprise Server installation file for UNIX EntSvrSetup.sh (JReport also provides EntSvrSetup_linux.bin for the Linux users) from our web site at http://www.jinfonet.com . If you need to transfer the install file from your download machine to your Unix box, please transfer it with bin mode. Although the install file is named with .sh suffix, it is a binary file.
- Click the executable file EntSvrSetup.sh to launch the InstallShield Wizard. Or, open a console window. Change the directory to the location of the EntSvrSetup.sh file. Following are the examples of the commands that can be used:
$ cd thepath
To make EntSvrSetup.sh executable, type the command:
$ chmod +x EntSvrSetup.sh
Run EntSvrSetup.sh:
$ ./EntSvrSetup.sh
The InstallShield will first find a JVM to get started. If no JVM is found, the installer is failed to launch. To solve this issue you can specify a JVM for the InstallShield with the option-is:javahomelike below:
$ ./EntSvrSetup.sh -is:javahome /home/j2sdk1.4.1_06
For more methods about finding the JVM, please refer to the Trouble Shooting.
Note: The option-is:help (only for Unix) can be used to list all the InstallShield Command Line Options:
$ ./EntSvrSetup.sh -is:help- Once InstallShield Wizard is successfully loaded, you can follow the default prompts to install JReport Enterprise Server.
For those platforms that do not have GUI (like AIX 400, IBM 390), please follow the steps below to install JReport Enterprise Server silently:
- Download JReport Enterprise Server for UNIX EntSvrSetup.sh from our web site at http://www.jinfonet.com .
- Get the script file EntSvrSetup.script and edit it as you like. The file is used to create an option file (i.e., response file) for the Installation wizard. It predefines all the information that is needed in installing.
Or you can create a script file and save it by your own as follow:################################################################################
#
# License Agreement State
#
# The initial state of the License Agreement panel. Legal values are:
#
# 0 - Nothing will be selected
# 1 - "I &accept the terms of the license agreement." will be selected
# 2 - "I &do not accept the terms of the license agreement." will be
# selected
#
# For example, to configure the panel to initially display "I &do not accept the
# terms of the license agreement.", use
#
# -W bean3.selection=2
#
-W bean3.selection=1################################################################################
#
# JReport Enterprise Server Install Location
#
# The install location of the product. Specify a valid directory into which the
# product should be installed. If the directory contains spaces, enclose it in
# double-quotes. For example, to install the product to C:\Program Files\My
# Product, use
#
# -P installLocation="C:\Program Files\My Product"
#
-P installLocation=/usr/local/JREntServer################################################################################
#
# Specify Real Path for the Public Reports Node
#
# Specify a valid directory as the real path for the Public Reports node. JReport
# Enterprise Server will get dynamic resources from the real path without
# deploying the resources to the server.
# To specify the Real Path for Public Reports, use
#
# -W DestinationPanel.enableRealPath=true
# -W DestinationPanel.realPath="C:\RealPath"
#
#When -W DestinationPanel.enableRealPath=false, no real path is specified.
-W DestinationPanel.enableRealPath=true
-W DestinationPanel.realPath="C:\work"################################################################################
#
# License Input Panel
#
# License key for your JReport Enterprise Server. Input the UID and password provided by
# Jinfonet Software Inc. You must specify key here, otherwise installer can't
# proceed. In most cases, these are provided via email. Please cut and paste
# User ID and Install Key into the appropriate fields to avoid typing errors.
# If you are installing this product for evaluation purposes, please contact
# Jinfonet at 301-838-5560 to obtain an evaluation license.
#
# -W KeyCheckBean.uid=Paste your UID here
# -W KeyCheckBean.key=paste your password here
-W KeyCheckBean.uid=UID
-W KeyCheckBean.key=Password################################################################################
#
# Select JDK Home
#
# Home directory of JDK. Select the home directory of a JDK with which you want
# to load JReport Enterprise Server. Only home of JDK is acceptable, and tools.jar must
# reside under JDK_HOME\lib directory. For example, if you have a JDK well installed
# in C:\j2sdk1.4.2_05, you need to specify the value as:
#
# -W selectjdk.jdk="C:\j2sdk1.4.2_05"
-W selectjdk.jdk="C:\j2sdk1.4.2_05"
- Some built-in demo reports (\hsqlDemo\*.cls) with the HSQLDB as the data source (server\db\demo.script) are provided. At the end of the installation, the installer will go to configure the reports and catalog to the correct data path. This calls some AWT classes which require GUI support.
Therefore, if you have an X server installed, you can set the Display variable so that this step can be done successfully.
$ DISPLAY=hostname(or IP):0.0
$ export DISPLAY
Please note that if you do not have X server or, say, pure text environment, this step will be ignored. You may find the demo reports are not ready to go after you start the JREntServer due to the default wrong data source path. You can always use JReport Designer to deploy some working reports for testing purpose.- Run the following command, and the Server will be installed under the designated path.
$ sh EntSvrSetup.sh -options EntSvrSetup.script -silent
When you use this command to install JReport Enterprise Server silently, you will find that you cannot see the status and cannot anticipate what' s going on after pressing Enter. So we provide another command line to you (see below). By using this command, you can do silent installation more intuitively.
$ sh EntSvrSetup.sh -options EntSvrSetup.script -consoleNotes:
- Even if the X Server has been installed on your operation system, you can also install JReport Enterprise Server silently following above steps.
- When you install Update or Service Pack silently, please get the script file update.script and edit it to your own need. The file is used to create an option file (i.e., response file) for the Installation Wizard. It predefines all the information that is needed in installing.
Or you can create a script file and save it by your own as follow:
-W bean13.selection=1 -W spcheck.installdir="/usr/local/JREntServer" -W KeyCheckBean.uid=UID -W KeyCheckBean.key=Password
Please modify the above lines according to your own environment and configurations.
In rare case you may fail to install JReport Enterprise Server on Unix directly, please follow the steps below to install it manually:
- Install JREntServer on Windows as the above description first but don't start it.
- Modify javahome and reporthome in the following files to the directory of Unix to which you are going to copy:
report.ini
servlet.properties
setenv.sh
Note: Please modify them carefully one by one, because any incorrect one may cause incoming problems.- Pack all files under install root and transfer it to the Unix machine via binary mode.
- Extract the folder to the place in accordance with the REPORTHOME defined in setenv.sh.
- Use the dos2unix command convert all the .sh files under
/REPORTHOME/binto the format that can be recognized by Unix. You can execute the command like this:
$ dos2unix *.sh- Use the chmod command to make the converted files under
/REPORTHOME/bincan be read, written and executed. You can execute the command like this:
$ chmod 777 *.sh- Manually change the property REPORTHOME={REPORTHOME} in each .sh file to the real path, such as
/JREntServer.- Execute JREntServer.sh to start the server.
Use one of the following ways to uninstall JReport Enterprise Server:
- From the Start menu, select JReport Enterprise Server XXX (version number), and then click Uninstall JReport Enterprise Server.
- From the Control Panel, open Add/Remove Programs, and then select JReport Enterprise Server XXX to remove it.
- Run uninstaller.exe (uninstaller.sh) under
%install_root%\_uninst.Note: The uninstaller will remove all the files that generated by the installer, while the files that are created later by the program will be retained. You can remove them manually.
Below are some known problems during installation. When you encounter problems, please refer to this section first before seeking help.
To process the installation, JReport Enterprise Server installer must find and verify a suitable JVM from the corresponding computer. However, in rare case, installers cannot pass the JVM verification procedure, you will get an error like JVM not found although you have one JDK installed. Below steps will introduce some methods to bypass the JVM verification part during the installation. We will take JReport Enterprise Server for Unix as the example.
Method 1:
- Download JReport Enterprise Server installation file EntSvrSetup.sh into a specified directory from our Web site at http://www.jinfonet.com .
- Open a console and go to the directory where you saved your installation file, and then use the command
$ sh EntSvrSetup.sh -is:extract
to extract the installation file. This option will create a temporary folder (for example, it is named as istemp39400) under current directory and extract some files in the new directory.
Note: For Windows machine, no folder will be created. You will find extracted files under the current directory.
- Go to the new directory, run
$ java -jar EntSvrSetup.jar.
This will launch a GUI installer and follow the steps in the Installing JReport Enterprise Server from the Installer Wizard section to finish the installation.Method 2:
For the Linux users, though the
-is:javahomeoption is used,the InstallShield of EntSvrSetup.sh still cannot find the JVM, please do as below:
- Download JReport Enterprise Server installation file EntSvrSetup_linux.bin into a specified directory from our Web site at http://www.jinfonet.com .
- Run EntSvrSetup_linux.bin to install JReport Enterprise Server.
The InstallShield will generate temp files during installation. You can specify the temp directory with
-is:tempdiroption like below. Otherwise, system temp directory will be used. In this case, please make sure there is enough space for the temp directory; if not, a warning dialog will pop up. Temp files will be removed automatically once the installation is completed.
EntSvrSetup.exe -is:tempdir c:\tempor
$ sh EntSvrSetup.sh -is:tempdir /tmp
If you run into any problems when installing JReport Enterprise Server , we suggest that you can use this command to log the debug messages:
EntSvrSetup.exe -is:log c:\DebugMessage.txtor
$ sh EntSvrSetup.sh -is:log /usr/DebugMessage.txtPlease feel free to send your questions to support@jinfonet.com .