Follow this procedure to install JasperReports Server using the WAR file distribution. The js-install shell scripts, supported on Windows, Linux, and Mac, do most of the work for you.
Prerequisites for installing the WAR file:
1. | Install the Oracle/Sun Java JDK 1.6, 1.7, or OpenJDK 1.6. |
2. | Create and set the JAVA_HOME system environment variable to point to the Java JDK location. |
3. | Locate or install one of the following application servers: |
• | Apache Tomcat 6 or 7 |
• | JBoss 5.1 or 7.1 |
• | Glassfish 2.1, 3.0, or 3.1.2 using the default domain (domain1) |
If you use GlassFish 3.1.0 or a custom domain, see GlassFish Modifications.
4. | Locate or install the PostgreSQL or MySQL database. |
The target database can be on a remote server. The application server should reside on the local machine. |
For an optional pre-install validation test, run js-install-ce.bat/sh test. See js-install Script Test Mode for more information.
To install the WAR file using js-install scripts:
The scripts are intended for the bash shell.
If installing to non-linux Unix platforms such as HP-UX, IBM AIX, FreeBSD, or Solaris, the bash shell is required for using the js-install scripts. |
1. | Extract all files from jasperreports-server-cp-6.1-bin.zip. Choose a destination, such as C:Jaspersoft on Windows, /home/<user> on Linux, or /Users/<user> on Mac. |
The directory, jasperreports-server-cp-6.1-bin, appears in the file location you choose.
2. | Copy the <database>_master.properties file for your database from sample_conf and paste it to buildomatic: |
• | Copy from — <js-install>/buildomatic/sample_conf/ |
• | Paste to — <js-install>/buildomatic |
For example, if your database is PostgreSQL, copy postgresql_master.properties to <js-install>/buildomatic.
3. | Rename the file you copied to default_master.properties. |
4. | “Sample Values for the default_master.properties File” lists sample property values for each supported database. |
Sample Values for the default_master.properties File
Database
Sample Property Values
PostgreSQL
appServerType=tomcat7 [tomcat6, jboss, jboss-eap-6, jboss-as-7, glassfish2, glassfish3, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 7dbHost=localhostdbUsername=postgresdbPassword=postgres[/code]
MySQL
appServerType=tomcat7 [tomcat6, jboss, jboss-eap-6, jboss-as-7, glassfish2, glassfish3, skipAppServerCheck]appServerDir=c:Program FilesApache Software FoundationTomcat 7dbUsername=rootdbPassword=passworddbHost=localhost[/code]
On Linux, if Tomcat is installed using apt-get, yum, or rpm, see Tomcat 6 Installed Using apt-get. |
5. | Password encryption |
The default_master.properties file has a property setting to enable encryption of passwords that reside on the file system. This applies to all files found under the buildomatic folder, as well as the connection pooling file used by Apache Tomcat (context.xml). Currently, password encryption for connection pooling supports only the Tomcat application server.
To enable encryption on the file system, uncomment the encrypt property so it looks like this:
encrypt=true
For more information about the encryption functionality, refer to the JasperReports Server Security Guide. |
6. | Run the js-install scripts: |
a. | Start your database server. |
b. | Stop your application server. |
c. | Open Command Prompt as Administrator on Windows or open a terminal window on Linux and Mac OSX. |
d. | Run the js-install script: |
Commands | Description |
cd <js-install>/buildomatic |
|
js-install-ce.bat (Windows) ./js-install-ce.sh (Linux and Mac OSX) | Installs JasperReports Server, sample data, and sample databases (foodmart and sugarcrm) |
js-install-ce.bat minimal (Windows) ./js-install-ce.sh minimal (Linux and Mac OSX) | Installs JasperReports Server, but not the sample data and sample databases |
If you encounter errors during the js-install script execution, see Error Running js-install Scripts (js-install-ce.bat/sh).
7. | Set Java JVM Options (required), as described in Setting JVM Options for Application Servers. |
To view the output log, look in: <js-install>/buildomatic/logs/js-install-ce-<date>.log |
Recommended Comments
There are no comments to display.