How to Upgrade Jaspersoft for AWS to a Newer Version

Updating your instance or Jaspersoft version for AWS requires three main tasks:

1. Export your repository.
2. Update the instance, to accommodate a different instance size and/or to move to a different version of JasperReports Server.
3. Import your repository into your new instance.

After the upgrade, you'll have to re-apply any customizations you made to the instance outside of the user interface.

To upgrade your instance for your particular version of JasperReport Server, refer to the appropriate section.

• Upgrading JasperReports Server 7.9.1 AWS BYOL Single Instance to 7.9.2
• Upgrading JasperReports Server 7.9.1 AWS Hourly Single Instance to 7.9.2
• Upgrading JasperReports Server 7.9.1 AWS BYOL Single Instance to 8.0.2
• Upgrading JasperReports Server 7.9.1 AWS Hourly Single Instance to 8.0.2
• Upgrading JasperReports Server 7.9.1 AWS Hourly Cluster Instance to 7.9.2
• Upgrading JasperReports Server 7.9.1 AWS BYOL Cluster instance to 8.0.2
• Upgrading JasperReports Server 7.9.1 AWS Hourly Cluster Instance to 8.0.2
• Upgrading JasperReports Server AWS Cloud Cluster Instance to Newer Version
• Upgrading AWS JasperReports Server 7.5.1, 7.5.2, or 7.8.1 (Single Instance or Cluster) to 8.0.2
• Migrating JasperReports Server 8.0.1 BYOL or Hourly single instance to 8.0.1 cluster

Upgrading JasperReports Server 7.9.1 AWS BYOL Single Instance to 7.9.2

You can upgrade the JasperReports Server AWS BYOL single instance from 7.9.1 HF1 to the secure version 7.9.2. You are required to export all resources into a zip using JasperReports Server UI or buildomatic scripts. Perform the following steps to upgrade JasperReports Server 7.9.1 AWS BYOL single instance to 7.9.2:

1.  Log in to the JasperReports Server 7.9.1 AWS BYOL single instance.
2.  Back up the jasperserver database.
3.  Navigate to Manage > Server Settings > Export.
4.  Name your export data file and select the items to export.
5.  Click Legacy Key under Import-Export Key.
6.  Select Export everything under Export Options.
7.  Click the Export button.
8.  (Optional) If you have a large repository, perform the following step:
      a. Backup any PostgreSQL databases that you want to restore in the JasperReports Server 7.9.2 AWS instance by running the following command.
         pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver.gz
9.  Create JasperReports Server 7.9.2 AWS instance. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
     a. Upload the PostgreSQL database dump files that you generated from the 7.9.1 instance.
b.  Restore the PostgreSQL database dumps by running the following command:
     gunzip -c psql_jasperserver.gz | psql jasperserver -U postgres -W
11. Log in to the JasperReports Server 7.9.2 AWS instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and then click the Import button.
16. When the import is completed, verify that the JasperReports Server 7.9.2 AWS instance contains everything that JasperReports Server 7.9.1 instance contained.
 

Upgrading JasperReports Server 7.9.1 AWS Hourly Single Instance to 7.9.2

Perform the following steps to upgrade JasperReports Server 7.9.1 AWS hourly single instance to 7.9.2.

1. Log in to the JasperReports Server 7.9.1 AWS hourly single instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the JasperReports Server 7.9.2 AWS instance by running the following command:
         pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver.gz
9. Create JasperReports Server 7.9.2 AWS instance. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
       a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server 7.9.1 instance.
       b. Restore the PostgreSQL database dumps by running the following command:
           gunzip -c psql_jasperserver.gz | psql jasperserver -U postgres -W
11. Log in to the JasperReports Server 7.9.2 AWS instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and then click the Import button.
16. When the import is completed, verify that JasperReports Server 7.9.2 AWS hourly single instance contains everything that the JasperReports Server 7.9.1 AWS instance contained.

Upgrading JasperReports Server 7.9.1 AWS BYOL Single Instance to 8.0.2

Perform the following steps to upgrade JasperReports Server 7.9.1 AWS BYOL single instance to 8.0.2.

1. Log in to the AWS JasperReports Server 7.9.1 instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the AWS JasperReports Server 8.0.2 instance by running the following command:
         pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver.gz
9. Create JasperReports Server 8.0.2 AWS instance. For instructions on creating an instance, see Launching Instances.
10. (Optional) In case of large repository, perform the following steps to upload and restore the repository:
       a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server7.9.1 instance.
b. Restore the PostgreSQL database dumps by running the following command:
    gunzip -c psql_jasperserver.gz | psql jasperserver -U postgres -W
11. Log in to the JasperReports Server 8.0.2 AWS instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and then click the Import button.
16. When the import is completed, verify that JasperReports Server 8.0.2 AWS BYOL single instance contains everything that the 7.9.1 instance contained.

Upgrading JasperReports Server 7.9.1 AWS Hourly Single Instance to 8.0.2

Perform the following steps to upgrade JasperReports Server 7.9.1 AWS hourly single instance to 8.0.2.

1. Log in to the JasperReports Server AWS 7.9.1 instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the AWS JasperReports Server 8.0.2 instance by running the following command:
         pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver.gz
9. Create JasperReports Server 8.0.2 AWS instance. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
       a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server7.9.1 instance.
       b. Restore the PostgreSQL database dumps by running the following command:
           gunzip -c psql_jasperserver.gz | psql jasperserver -U postgres -W
11. Log in to the JasperReports Server 8.0.2 AWS instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and then click the Import button.
16. When the import is completed, verify that JasperReports Server 8.0.2 instance contains everything that JasperReports Server 7.9.1 AWS instance contained.

Upgrading JasperReports Server 7.9.1 AWS Hourly Cluster Instance to 7.9.2

When you have out of box 7.9.1 CFT, perform the following steps (for any size of repository):

1. Download 7.9.2 template.
2. Go to cloudformation and select the 7.9.1 stack.
3. Select the Update option.
4. Select Replace current template option and then select upload a template file.
5. Upload the JasperReports Server 7.9.2 template and click Next.
6. Acknowledge and select Update the stack.
7. When update is completed, check the template in template tab and instances as well.

Upgrading JasperReports Server 7.9.1 AWS BYOL cluster instance to 8.0.2

Perform the following steps to upgrade JasperReports Server 7.9.1 AWS BYOL cluster instance to 8.0.2.

1. Log in to the JasperReports Server 7.9.1 AWS instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export using JasperReports Server UI.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the JasperReports Server 8.0.2 AWS instance by running the following command:
         pg_dump <7.9.1 database> -h <database endpoint> -U postgres -W | gzip > awsjrs791_sql_jasperserver.gz
9. Create JasperReports Server 8.0.2 AWS instance and make sure that you have specified a different database name. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
       a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server7.9.1 instance.
       b. Restore the PostgreSQL database dumps by running the following command:
           gunzip -c awsjrs791_psql_jasperserver.gz | psql <8.0.2 database name> -h<database endpoint> -U postgres -W
11. Log in to the JasperReports Server 8.0.2 AWS BYOL cluster instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and click the Import button.
16. When the import is completed, verify that JasperReports Server 8.0.2 AWS instance contains everything that JasperReports Server 7.9.1 AWS instance contained.

Note: Make sure that you have uploaded your BYOL jasperserver.license to the 8.0.2 system.

Upgrading JasperReports Server 7.9.1 AWS Hourly Cluster Instance to 8.0.2

1. Log in to the JasperReports Server 7.9.1 AWS instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export using JasperReports Server UI.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the JasperReports Server 8.0.2 AWS instance by running the following command:
         pg_dump <7.9.1 database> -h <database endpoint> -U postgres -W | gzip > awsjrs791_sql_jasperserver.gz
9. Create JasperReports Server 8.0.2 AWS instance and make sure that you have specified a different database name. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
       a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server7.9.1 instance.
       b. Restore the PostgreSQL database dumps by running the following command:
           gunzip -c awsjrs791_psql_jasperserver.gz | psql <8.0.2 database name> -h<database endpoint> -U postgres -W
11. Log in to the JasperReports Server 8.0.2 AWS hourly cluster instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and click the Import button.
16. When the import is completed, verify that JasperReports Server 8.0.2 AWS instance contains everything that JasperReports Server 7.9.1 AWS instance contained.

Upgrading JasperReports Server AWS Cloud Cluster Instance to Newer Version

You can upgrade JasperReports Server 7.9.1 AWS BYOL cluster instance to 7.9.2 for the following upgrade cases:

When you have out of box 7.9.1 CFT, perform the following steps (for any size of repository):
1. Download 7.9.2 template.
2. Go to cloudformation and select the 7.9.1 stack.
3. Select the Update option.
4. Select Replace current template option and then select upload a template file
5. Upload the JasperReports Server 7.9.2 template and click Next.
6. Acknowledge and select Update the stack.
7. When the update is completed, check the template in the template tab and instances as well.
 

When you use customized CFT and the size of repository is <15G, perform the following steps:
1. Export everything from 7.9.1.
2. Create JasperReports Server 7.9.2 AWS cluster with a new RDS.
3. Import everything into JasperReports Server 7.9.2 AWS instance.
 

When you use customized CFT (regardless of repository size), perform the following steps.
1. Log in to the JasperReports Server 7.9.1 AWS HF1 instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the AWS JasperReports Server 7.9.2 instance by running the following command:
         pg_dump <7.9.1 database> -h <database endpoint> -U postgres -W | gzip > awsjrs791_sql_jasperserver.gz
9. Create an JasperReports Server 7.9.2 AWS instance and make sure to use the database from the 7.9.1 HF1 instance. For instructions on creating an instance, see Launching Instances.
10. Log in to the JasperReports Server 7.9.2 AWS BYOL cluster instance.
11. Verify that the JasperReports Server 7.9.2 AWS BYOL cluster instance contains everything that the JasperReports Server 7.9.1 AWS instance contained. If JasperReports Server 7.9.2 BYOL cluster instance does not contain, perform the following steps to restore the data you backed up:
     a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server7.9.1 HF1 instance.
     b. Restore the PostgreSQL database dumps by running the following command:
         gunzip -c awsjrs791_psql_jasperserver.gz | psql <7.9.1HF1/7.9.2 database name> h <database endpoint> -U postgres -W
12. Log in to the JasperReports Server 7.9.2 AWS BYOL Cluster instance.
13. Navigate to Manage > Server Settings > Import.
14. Click the Choose File button, and select the file you exported.
15. Click Legacy Key under Import-Export Key.
16. Select your import options and click the Import button.
17. When the import is completed, verify that JasperReports Server 7.9.2 AWS BYOL Cluster instance contains everything that JasperReports Server 7.9.1 AWS instance contained.

Upgrading AWS JasperReports Server 7.5.1, 7.5.2, or 7.8.1 (Single Instance or Cluster) to 8.0.2

JasperReports Server 7.5.1, 7.5.2, or 7.8.1 can be upgraded to version 8.0.2. If the database dump is >=15G, then you need an incremental upgrade. Upgrading JasperReports Server 7.5.1 with a big repository to 8.0.2 required an incremental upgrade that is from 7.5.1 to 7.8.1 and then 7.8.1 to 8.0.2.

The following procedures show you how to upgrade 7.5.1, 7.5.2, or 7.8.1 (single instance or cluster) to 8.0.2.

To upgrade AWS JasperReports Server 7.5.2 or 7.8.1 to 8.0.2:
1. Log in to the AWS JasperReports Server 7.5.2 or 7.8.1 instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export.
4. Name your export data file and select the items to export.
5. Click Server Key for 7.5.2 or Legacy Key for 7.8.1 under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. Create an AWS JasperReports Server 8.0.2 instance. For instructions on creating an instance, see Launching Instances.
9. Log in to the AWS JasperReports Server 8.0.2 instance.
10. Navigate to Manage > Server Settings > Import.
11. Click the Choose File button, and select the file you exported.
12. Click Server Key for JasperReports Server 7.5.2 or Legacy Key for JasperReports Server 7.8.1 under Import-Export Key.
13. Select your import options and then click the Import button.
14. When the import is completed, verify that JasperReports Server 8.0.2 instance contains everything that JasperReports Server 7.5.2 or JasperReports Server 7.8.1 instance contained.
 

To upgrade JasperReports Server 7.5.1 (AWS single instance or cluster) to 8.0.2:
1. Log in to the JasperReports Server 7.5.1 AWS instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export using JasperReports Server UI.
4. Name your export data file and select the items to export.
5. Click Server Key under Import-Export Key.
6. Select Export everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the JasperReports Server 7.8.1 AWS instance by running the following command:
         pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver751.gz
9. Create JasperReports Server 7.8.1 AWS instance. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
      a. Upload the PostgreSQL database dump file that you generated from the 7.5.1 instance.
      b. Restore the PostgreSQL database dumps by running the following command:
          gunzip -c psql_jasperserver751.gz | psql jasperserver -U postgres -W
11. Log in to the JasperReports Server 7.8.1 AWS instance.
12. Navigate to Manage > Server Settings > Import to import the exported file.
13. Click the Choose File button, and select the file you exported.
14. Click Server Key under Import-Export Key.
15. Select your import options and then click the Import button.
16. Back up the jasperserver database.
17. Navigate to Manage > Server Settings > Export 19. Name your export data file and select the items to export.
18. Click Legacy Key under Import-Export Key.
19. Select Export everything to backup everything in the jasperserver database.
20. (Optional) Backup any PostgreSQL databases that you want to restore in the AWS JasperReports Server 7.8.1 instance by running the following command:
      pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver781.gz
21. Verify that JasperReports Server 7.8.1 AWS instance contains everything that JasperReports Server 7.5.1 instance contained.
23. Create JasperReports Server 8.0.2 AWS instance. For instructions on creating an instance, see Launching Instances.
24. (Optional) For a large repository, perform the following steps to upload and restore the repository:
      a. Upload the PostgreSQL database dump file that you generated from the 7.8.1 instance.
      b. Restore the PostgreSQL database dumps by running the following command:
          gunzip -c psql_jasperserver781.gz | psql jasperserver -U postgres -W
25. Log in to the JasperReports Server 8.0.2 AWS instance.
26. Navigate to Manage > Server Settings > Import.
27. Click the Choose File button, and select the file you exported.
28. Click Legacy Key under Import-Export Key.
29. When the import is completed, verify that JasperReports Server 8.0.2 AWS instance contains everything that JasperReports Server 7.8.1 AWS instance contained.

Migrating JasperReports Server 8.0.1 BYOL or Hourly Single Instance to 8.0.1 Cluster

Perform the following steps to migrate JasperReports Server 8.0.1 BYOL or Hourly single instance to 8.0.1 cluster.

1. Log in to the JasperReports Server 8.0.1 AWS BYOL or hourly VPC instance.
2. Back up the jasperserver database.
3. Navigate to Manage > Server Settings > Export using JasperReports Server UI.
4. Name your export data file and select the items to export.
5. Click Legacy Key under Import-Export Key.
6. Select Export Everything under Export Options.
7. Click the Export button.
8. (Optional) If you have a large repository, perform the following step:
     a. Backup any PostgreSQL databases that you want to restore in the JasperReports Server 8.0.1 AWS BYOL cluster instance by running the following command:
         pg_dump jasperserver -U postgres -W | gzip > psql_jasperserver_801byolvpc.gz
9. Create JasperReports Server 8.0.1 AWS BYOL or hourly cluster instance. For instructions on creating an instance, see Launching Instances.
10. (Optional) For a large repository, perform the following steps to upload and restore the repository:
       a. Upload the PostgreSQL database dump files that you generated from the JasperReports Server 8.0.1 AWS BYOL or hourly instance.
       b. Restore the PostgreSQL database dumps by running the following command:

           gunzip -c psql_jasperserver_801byolvpc.gz | psql jasperserver -U postgres -W
11. Log in to the JasperReports Server 8.0.1 AWS BYOL or hourly cluster instance.
12. Navigate to Manage > Server Settings > Import.
13. Click the Choose File button, and select the file you exported.
14. Click Legacy Key under Import-Export Key.
15. Select your import options and then click the Import button.
16. When the import is completed, verify that JasperReports Server 8.0.1 BYOL cluster instance contains everything that JasperReports Server 8.0.1 BYOL or hourly single instance contained.