UpgradeMINTInstructions

From IMSMA Wiki
Jump to navigation Jump to search

This page describes the technical process of upgrading MINT to the latest JasperReports Server (JRS) release.

Upgrading MINT

Backup of previous release

  1. Export the repository:
    1. Log in as superuser
    2. Go to Manage / Server Settings / Export
    3. Export everything as export.zip
  2. Backup the JasperReports Server War File:
    1. Create a folder where you can save your jasperserver-pro war file. For example, C:\JS_60_BACKUP
    2. Copy <tomcat>/webapps/jasperserver-pro  to  <path>/JS_60_BACKUP
  3. Backup the database:
    1. Take a backup of the jasperserver database (e.g. jasperserver6, jasperserver61 -- choose the latest one) using pgAdmin3

Install Tomcat

  1. Download the latest Tomcat release (check compatibility!)
  2. Stop the current service
  3. Uninstall the current Tomcat service
  4. Unzip Tomcat
  5. Adapt the server.xml
  6. Adapt the CATALINA_HOME variable
  7. Install the Tomcat service
  8. Adapt the Java properties
  9. Start the Tomcat service
  10. Test that the Tomcat is running

Download and prepare the JRS WAR archive

  1. Download the JRS WAR file from support.jaspersoft.com
  2. Copy it to the server and unzip it to C:\Jaspersoft
  3. Copy the postgresql_master.properties file from XX to YY
  4. Adapt the file:
    1. Path to the Tomcat
    2. Username and password of the database
    3. Name of the application
  5. Rename the file to default_master.properties

Install the latest JRS

  1. Stop the Tomcat service
  2. Open a command window, go the the buildomatic folder and type js-install.bat minimal
  3. Wait for the installation to finish. This takes several minutes.
  4. Start the Tomcat server

Import the repository

  1. Log in as superuser
  2. Go to Manage / Server Settings / Import
  3. Import the previously exported repository (export.zip)

Apply customisations

All customisations need to be re-applied, i.e. all the customised files need to replace the default ones. The list of customised files can be found here. VIE usually applies the customisation files one by one and restarts the Tomcat service after each change, so that a file causing a problem can be identified right away.

Test the new installation

Switch JRS version in production

Template:NavBox Hub