Upgrading CA Business Intelligence JasperReports Server

Contents
cabi642
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.
For 6.1 or 6.2 to 6.4.2 Upgrade Scenarios
Below steps are applicable to 6.1 or 6.2 to 642 upgrade scenarios:
  1. Before upgrading to 6.4.2, back up jasper content (like organization, users, roles, reports, server attributes schedules, adhoc reports, JDBC data source, log settings, and so on) using Step 2. 
  2. In CABI 6.1 or 6.2 UI, export content by clicking
    Manage
    ,
    Server Settings
    , and click on
    Export
    tab, Check Export Options with Export Everything, and click
    Export
    .
  3. Export Data File Name, 
    (required):<xyz>.zip,
     that is saved in the Downloads folder.
Upgrade CA Business Intelligence from 6.1, 6.2, 6.3 (ANT or silent installation) to 6.4.2 (GUI)
The following upgrade procedure is applicable when CABI release 6.1, 6.2, or 6.3 was installed using properties-based file (ANT). 
  1. Download the CA Business Intelligence JasperReports Server 6.4.2 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 6.4.2 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.1 Tomcat directory for 6.1 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) to 6.4.2 (GUI)
The following upgrade procedure is applicable when CABI release 6.3 was installed using GUI (IA). 
  1. Download the CA Business Intelligence JasperReports Server 6.4.2 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 6.4.2 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 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.
Post Upgrade Steps from 6.1 or 6.2 to 6.4.2 (GUI or Silent Installation)
Import 
<xyz>.zip
 file into CABI 6.4.2 UI by clicking 
Manage
Server Settings
, and click on 
Import
 tab. Browse the path for Import data file:
<xyz>.zip
 (that is, 6.1 or 6.2 exported zip file) and click 
Import
.
Verify Upgrade
  1. Ensure that you have 6.4.2 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 6.4.2 Upgrade Completed Successfully' message in the log file that is provided during the upgrade.