Installing the WAR File Manually

You may need to install the WAR file manually when you cannot use the js-install scripts.

The manual buildomatic steps described in this procedure execute the same Ant targets as the js-install script (js-install.sh/.bat). The procedure shows which buildomatic targets to run manually if you are unable to use the js-install scripts.

To install the WAR file distribution using manual buildomatic steps

1. Start your database server.
2. Stop your application server.
3. Create and edit a default_master.properties file to add the settings in for your database and application server as described in Installing the WAR File Using js-install Scripts.
4. Open a Command Prompt as Administrator on Windows or open a terminal window on Linux or Mac. Run the following commands.

Buildomatic Targets to Execute to Install the WAR File

Commands

Description

cd <js-install>/buildomatic

Makes the buildomatic directory your current directory.

js-ant create-js-db

Creates the JasperReports Server repository database.

js-ant create-sugarcrm-db

js-ant create-foodmart-db

(Optional) Creates the sample databases.

js-ant load-sugarcrm-db

js-ant load-foodmart-db

(Optional) Loads sample data into the sample databases.

js-ant update-foodmart-db

(Optional) Initializes the sample databases

js-ant init-js-db-pro

js-ant import-minimal-pro

Initializes the jasperserver database, loads core application data. Running js-ant import-minimal-pro is mandatory. The server needs this data to function.

js-ant import-sample-data-pro

(Optional) Loads the demos that use the sample data.

js-ant deploy-webapp-pro

Configures and deploys the WAR file to Tomcat or JBoss.

js-ant deploy-jrws

Deploys only JasperReports Web Studio apps into the application server configured using the appServerDir, jrws.repo.url and jrws.jrio.url properties in the default_master.properties file.
js-ant create-audit-db (Optional) Creates the audit database. Required only for the Split installation.
js-ant init-audit-db-pro (Optional) Initializes the audit database. Required only for the Split installation.

On non-Linux Unix platforms, the js-ant commands may not be compatible with all shells. If you have errors, use the bash shell explicitly. For more information, see Bash Shell for Solaris, IBM AIX, HP UX and FreeBSD.

If you encounter an error when running create-sugarcrm-db, create-foodmart-db, or create-js-db, you can create the JasperReports Server database manually using the database administration tool for your particular database type. To create the JasperReports Server database manually for PostgreSQL, MySQL, Oracle, SQL Server, or DB2, refer to Manually Creating the JasperReports Server Database.

If you have previously installed the databases, you can drop the old versions and then recreate the databases. To do this, run the following drop commands before running the commands in Buildomatic Targets to Execute to Delete Sample Databases

Buildomatic Targets to Execute to Delete Sample Databases

Commands

Description

js-ant drop-sugarcrm-db

js-ant drop-foodmart-db

(Optional) Deletes the sample databases.

js-ant drop-js-db

(WARNING) Deletes the JasperReports Server repository database. Only run this command if you intend to recreate the jasperserver database
js-ant drop-audit-db

(Optional) Deletes the audit database.

Required only for the Split installation, or if the previous installation was Split, or for the database clean up after a Split installation.
5. Set Java JVM Options (required) as described in Setting JVM Options for Application Servers.
6. Set up the license (required) as described in Setting Up the JasperReports Server License.

Installing JasperReports Server automatically generates encryption keys that reside on the file system. These keys are stored in a dedicated Jaspersoft keystore. Make sure that this keystore is properly secured and backed up, as described in the JasperReports Server Security Guide.