Upgrading CA Business Intelligence JasperReports Server

Contents
cabi711
 
Contents
 
 
 
2
 
 
Prerequisites
  1. Back up your Jasperserver database:
    1. Create a folder where you can save your jasperserver database
      For example, C:\JS_BACKUP or /opt/JS_BACKUP
    2. Run the following commands for PostgreSQL:
      PostgreSQL:
      cd <path>/JS_BACKUP
      pg_dump --username=postgres jasperserver > js-db-dump.sql
       
  2. Back up your JasperReports server war file:
    1. Create a folder where you can save your jasperserver-pro folder.
      For example, C:\JS_BACKUP or /opt/JS_BACKUP
      Copy <tomcat>/webapps/jasperserver-pro to <path>/JS_BACKUP
       
  3. If you made modifications to the existing JasperReports Server application, you need to manually back up and restore configuration changes, like client-specific security classes or LDAP server configurations in your existing environment and integrate them with your upgraded environment.
  4. Ensure that Tomcat directory is closed before you upgrade CABI to avoid errors while upgrading.
  5. (Windows)
     Ensure that you review JasperReports known issues and update the timeout settings in 
    jasperreports.properties
     file as needed to avoid timeout issues and upgrade errors.
Upgrade CA Business Intelligence from 6.3 (ANT or silent installation), or 6.4.2, 6.4.3, 7.1.1 (GUI)
The following upgrade procedure is applicable when CABI release 6.3 was installed using properties-based file (ANT). 
  1. Download the CA Business Intelligence JasperReports Server 7.1.1 build.
  2. Unzip the CABI media and run 
    setup.bat
     (Windows) or 
    setup.sh
     (Linux) from the base directory by double-clicking the file or executing from a prompt. 
    The CA Business Intelligence installer screen appears.
  3. Select 
    English
     as preferred language and click 
    Next
    . (Currently, English is the only supported language for the installer).
    The Installation Prerequisites screen appears.
  4. The 
    Installation Type
     field shows 
    FRESH
    . Click 
    Next
    .
    The License Agreement screen appears. 
  5. Scroll to read the license agreement terms and conditions and select the 'I accept the terms of the License Agreement' option. Click 
    Next
    .
    The Installation Folder screen appears. 
  6. Specify the Installation Directory for CABI, then click 
    Next
    .
    The Server Installation Type screen appears. 
  7. Select 
    Custom Install
     and click 
    Next
    .
    The Application Server screen appears. 
  8. Select 
    I want to use an existing Tomcat 
     and click Next.
    The Existing Tomcat details screen appears. 
  9. Select the respective release Tomcat home directory (select 6.3 Tomcat directory for 6.3 release) by clicking 
    Choose
    . Review the default Web App Name and modify this value as preferred. Click 
    Next
    .
    The CABI already exists screen appears. 
  10. Click 
    Yes 
    to proceed with the upgrade.
    The Existing Database Details screen appears. 
  11. Enter password and click 
    Next
    .
    The Ready to Install screen appears. 
  12. Click 
    Install
     to continue.
    CABI is upgraded.
Upgrade CA Business Intelligence from 6.3 (GUI) or 6.4.2, 6.4.3 to 7.1.1 (GUI)
The following upgrade procedure is applicable when CABI release 6.3 and 6.4.2 or 6.4.3 was installed using GUI (IA). 
  1. Download the CA Business Intelligence JasperReports Server 7.1.1 build.
  2. Unzip the CABI media and run 
    setup.bat
     (Windows) or 
    setup.sh
     (Linux) from the base directory by double-clicking the file or executing from a prompt. 
    The CA Business Intelligence installer screen appears.
  3. Select 
    English
     as preferred language and click 
    Next
    . (Currently, English is the only supported language for the installer).
    The Installation Prerequisites screen appears.
  4. The 
    Installation Type
     field shows 
    UPGRADE
    . Click 
    Next 
    and follow the steps.
    The Existing Database Details screen appears. 
  5. Enter password and click 
    Next
    .
    If CABI 6.3 or 6.4.2 MSSQL Server is Windows authenticated, select the checkbox against the Port field to enable MSSQL Server Win authentication upgrade.
  6. Click 
    Next
     to continue.
    CABI is upgraded.
Verify Upgrade
  1. Ensure that you have 7.1.1 in the version.txt under tomcat/webapps/jasperserver-pro (jasperserver-pro is the webapp name that is given in the sample.properties file).
  2. Ensure that you receive 'CABI JasperReports Server 7.1.1 Upgrade Completed Successfully' message in the log file that is provided during the upgrade.
  3. After the upgrade, the server returns the Tomcat folder to its default state. Reconfigure LDAP. For more information, see Configuring LDAP Authentication.