Changes in 7.5 That May Affect Your Upgrade

Driver Updates

In the 7.5 release, the Simba JDBC drivers for Spark and Impala have been updated. By default, the new release supports the new JDBC drivers, and the old drivers cannot be used. You should update your data sources to use the new driver. For more information, see the JasperReports Server Administrator Guide.

 The drivers have been replaced due to vulnerabilities from third-party libraries. Update your data sources to use the new drivers.

Using the Old Impala Driver

If you want to continue using the Impala driver that was previously available from the community website, modify the install as described below.

Add the following files to the <js-install>/WEB-INF/lib directory:

  • Curator-client-2.6.0.jar
  • Curator-framework-2.6.0.jar
  • Curator-recipes-2.6.0.jar
  • Hive-metastore-1.2.2.jar
  • Hive-service-1.2.2.jar
  • Impala-jdbc4-1.0.44.1055.jar
  • Libfb303-0.9.3.jar

If you do not add the files listed, data sources that use the old Impala driver causes errors when running reports that rely on them.

Using the Old Spark Driver

If you want to continue using the Spark driver that was previously available from the community website, modify the install as described below.

Add the following files to the <js-install>/WEB-INF/lib directory:

  • Curator-client-2.6.0.jar
  • Curator-framework-2.6.0.jar
  • Curator-recipes-2.6.0.jar
  • Hive-metastore-1.2.2.jar
  • Hive-service-1.2.2.jar
  • Spark-jdbc4-1.1.1.1001.jar
  • Libfb303-0.9.3.jar

If you do not add the files listed, data sources that use the old Spark driver causes errors when running reports that rely on them.

Changes to the Jaspersoft MongoDB Query Language

The Jaspersoft MongoDB Query Language has been updated to reflect changes in the MongoDB driver:

• All aggregate commands must be updated to the new API-driven query syntax.
• All other command-driven queries (queries that use runCommand) are deprecated. If you want to use your queries in a future release, you should update them to the new syntax.

See the language reference for more information.

Encryption Keys

JasperReports Server 7.5 streamlines how it manages the encryption keys it uses to protect sensitive data inside and outside of the server. There is no more any need to configure the encryption keys because all keys are generated automatically during the installation and stored in a central keystore. The keys are used transparently whenever the server stores passwords internally or exports sensitive data. And as long as the same user performs the upgrade, the upgrade scripts have access to the same keys in the keystore.

The new keys are backward compatible with the default keys from previous servers. However, there are possible cases when you need to manage keys during an upgrade. For example, if you do not have access to the user who installed the 7.5 instance, you may not be able to access the keystore anymore.

If you are in this situation, you should plan your upgrade as follows:

1. Before starting, back up your original 7.5 server.
2. Then export everything from your running 7.5 server with the following command: 
cd <js-install-7.5>/buildomatic
js-export.sh --everything --output-zip js-7.5-export.zip --genkey

This encrypts the export with the key that is displayed on the console output:

Secret Key: 0xb1 0x44 0x72 0x0a 0xe9 0x5b 0x39 0xf5 0x87 0x5c 0xa9 0x1b 0x99 0x9d 0x14 0x4c
Key Alias (UUID): 9e41cd54-31da-43aa-84c2-638a7d0b47b8
3. Proceed with the upgrade and installation of the new server, but without migrating your data.
4. Import the key into your upgraded server with the following command. 
./js-import.sh --input-key "0xb1 0x44 0x72 0x0a 0xe9 0x5b 0x39
                 0xf5 0x87 0x5c 0xa9 0x1b 0x99 0x9d 0x14 0x4c"
               --keyalias 9e41cd54-31da-43aa-84c2-638a7d0b47b8
               --keyalg AES --keypass NewKeyPassword
5. Proceed with the migration of your data to the upgraded server, or manually import your catalog to the upgraded server. As the data is imported, it is decrypted with the given key, and re-encrypted with the server's new keys.
6. Once the server is ready for production, back up your data and the new keystore once again.

For more information and procedures for importing keys, see the JasperReports Server Security Guide.

Theme Changes

The look and feel of the JasperReports Server web interface has been redesigned to modernize the application's appearance. To accomplish this, markup and styles have been modified. As a result of these modifications, custom themes developed for the previous interface need to be updated for the new interface. The main changes are in the banner, body, and home page.

The following table lists the changes made to the user interface, except for the changes to the home page. The changes to the home page are extensive. Instead of attempting to update an existing home page, you should reimplement the home page in the new default theme.

If you have not customized the user interface, these changes do not affect you.

Banner

Element Classname and Modifications File Notes
Banner

.banner

Changed background-color, font-family and height.

 containers.css

Default value:

background-color: #062e79
font-family: source_sans_proregular
height: 40px

Body

#frame

Changed the top value to fit the body of the application between the banner and footer without overlap.

 containers.css

Default value:

top: 40px

Banner Logo

#logo

Changed width and height.

Responsive behavior was added to the banner. There is now a breakpoint at which the logo shrinks in size (1100 px) and a breakpoint at which it becomes hidden (980 px).

 theme.css

Default values:

height: 23px
width: 200px

Breakpoint from 981-1100 px:

width: 150px

980 px and below:

display: none

Banner Main Navigation home icon

.menu.primaryNav #main_home .wrap > .icon

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays.

containers.css

Default value:

background-image: url(images/banner_icons_sprite@1x.png)

High-resolution value:

background-image: url(images/banner_icons_sprite@2x.png)

Banner Main Navigation Item text

.menu.primaryNav .wrap

Enlarged font-size. Changed height and line-height to be 1 px shorter than .banner.

 containers.css

Default values:

font-size: 14px
height: 39px
line-height: 39px

Banner Main Navigation Item arrow icon

.menu.primaryNav .node > .wrap > .icon

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Changed height of icon container.

containers.css

Default values:

background-image: url(images/disclosure_icons_sprite@1x.png)
height: 16 px

High-resolution value:

background-image: url(images/disclosure_icons_sprite@2x.png)
Banner Metadata container

#metalinks

Changed height to be 1 px shorter than .banner. Increased margin-right to accommodate search box.

With the addition of responsive behavior, the margin-right value changes at certain breakpoints to accommodate a smaller search box.

theme.css

Default values:

height: 39px
margin-right: 270 px

Breakpoint from 821-1100 px:

margin-right: 200px

Breakpoint from 751-820 px:

margin-right: 140px

Banner Metadata text

#metalinks li

Enlarged font-size. Increased line-height to vertically center text in the banner.

theme.css

Default values:

font-size: 14 px
line-height: 39 px
Banner Search container

#globalSearch.control.searchLockup

Increased width of container.

Responsive behavior was added to the banner. There are now breakpoints at which the search container shrinks in width and a breakpoint at which it becomes hidden.

controls.css

Default value:

width: 250px

Breakpoint from 821-1100 px:

width: 180px

Breakpoint from 751-820 px:

width: 100px

750 px and below:

display: none

Banner Search input wrapper

#globalSearch.control.searchLockup > .wrap

Increased height of input wrapper.

 controls.css

Default values:

height: 28 px
Banner Search input

#globalSearch.control.searchLockup > .wrap > input[type=text]

Responsive behavior was added to the banner. There are now breakpoints at which the search input shrinks in width and a breakpoint at which it becomes hidden.

controls.css

Default value:

width: 200px

Breakpoint from 821-1100 px:

width: 130px

Breakpoint from 751-820 px:

width: 80px

750 px and below:

display: none

Banner Search button icon

#globalSearch .button.search

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays.

controls.css

Default value:

background-image: url(images/search_icons_sprite@1x.png)

High-resolution value:

background-image: url(images/search_icons_sprite@2x.png)

Ad Hoc Designer

Extensive changes have been made to the look and feel of the Ad Hoc Designer. Although there are too many changes to document fully, the following table lists the basic elements that have changed.

Element Classname and Modifications File Notes
Page Title

#display > .column.decorated > .content > .header

This element has been removed and replaced with the new .pageHeader element.

 pages.css
Data and Filters Panel Headers

#designer .column.decorated > .content > .header

Removed bottom border, changed background-color, and increased height.

pageSpecific.css

Default values:

background-color: #d6d5d5
border-bottom: 0
height: 32px

Data and Filters Panel Headers Title Text

#designer .column.decorated > .content > .header > .title

Changed color and font-family. Increased font-size and line-height.

 pageSpecific.css

Default values:

color: #333333

font-family: source_sans_proregular
font-size: 15px
line-height: 32px
Panel Minimize Button

#designer .button.minimize

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Changed height and width. Added a background-color.

 pageSpecific.css

Default values:

background-color: #999999
background-image: url(images/disclosure_indicators_icons_sprite@1x.png)
height: 32px
width: 14px

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)

Panel Options Button

Panel Section Options Button

.header > .button.mutton,
#filter-container .title .button.mutton

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Changed height and width.

pageSpecific.css

Default values:

background-image: url(images/disclosure_indicators_icons_sprite@1x.png)
height: 32px
width: 22px

.

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)

Panel Section Headers

#designer #availableFields .dimension .header,
#designer #availableFields .measure .header,
#level-container .pod-header,
#filter-container .header,
#expression-container .header

Changed background-color and font-family, increased height, and removed the bottom border.

 pageSpecific.css

Default values:

background-color: #ebebeb
border-bottom: none
font-family: source_sans_proregular
height: 32px

Toolbar

#designer .toolbar

Increased height.

 pageSpecific.css

Default values:

height: 32px

Toolbar Buttons

button.capsule

Increased width.

 buttons.css

Default value:

width: 32px

Toolbar Buttons with down arrow

button.capsule.mutton

Increased width.

 buttons.css

Default value:

width: 36px

Toolbar Button Icons

.button.capsule .indicator

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays.

pageSpecific.css

Default values:

background-image: url(images/disclosure_indicators_icons_sprite@1x.png)

.

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)

Report Viewer

Changes have been made to the general look and feel of the Report Viewer. The following table lists the basic elements that have changed.

Element Classname and Modifications File Notes
Page Title

#reportViewer #reportViewFrame > .content > .header

This element has been removed and replaced with the new .pageHeader element.

 pages.css
Toolbar

#reportViewer .toolbar

Increased height.

 pageSpecific.css

Default value:

height: 32px

Toolbar Buttons Container

#reportViewer .toolbar > .buttonSet

Increased height.

pageSpecific.css

Default value:

height: 31px

Toolbar Button Icons

#designer .toolbar .button .icon

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays.

pageSpecific.css

Default values:

background-image: url(images/button_action_icons_sprite@1x.png)

.

High-resolution value:

background-image: url(images/button_action_icons_sprite@2x.png)

Options Panel Header

#reportViewer #inputControlsForm > .content > .header

Removed bottom border, changed background-color, and increased height.

pageSpecific.css

Default values:

background-color: #d6d5d5
border-bottom: 0
height: 32px

Options Panel Header Title Text

#reportViewer #inputControlsForm > .content > .header > .title

Changed color and font-family. Increased font-size and line-height.

 pageSpecific.css

Default values:

color: #333333

font-family: source_sans_proregular
font-size: 15px
line-height: 32px
Options Panel Minimize Button

#reportViewer #inputControlsForm .button.minimize

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Changed height and width. Added a background-color.

 pageSpecific.css

Default values:

background-color: #999999
background-image: url(images/disclosure_indicators_icons_sprite@1x.png)
height: 32px
width: 14px

.

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)


Dashboard Designer

Extensive changes have been made to the look and feel of the Dashboard Designer. Although there are too many changes to document fully, the following table lists the basic elements that have changed.

Element Classname and Modifications File Notes
Page Title

.column.decorated > .content > .header

This element has been removed and replaced with the new .pageHeader element.

 pages.css
Available Content Panel Header

.dashboardDesigner .column.decorated > .content > .header

Removed bottom border, changed background-color, and increased height.

 designer.css

Default values:

background-color: #d6d5d5
border-bottom: 0
height: 32px

Available Content Panel Header Title

#display.dashboardDesigner .column.decorated > .content > .header > .title

Changed color and font-family. Increased font-size and line-height.

designer.css

Default values:

color: #333333
font-family: source_sans_proregular
font-size: 15px
line-height: 32px

Available Content Panel Minimize Button

.dashboardDesigner .button.minimize

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Changed height and width. Added a background-color.

 designer.css

Default values:

background-color: #999999
background-image: url(images/disclosure_indicators_icons_sprite@1x.png)
height: 32px
width: 14px

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)

Available Content Panel Section Headers

.dashboardDesigner .dashboardSidebar .panel.collapsiblePanel > .header

Removed bottom border and increased height. Changed background-color and font-family.

 designer.css

Default values:

background-color: #ebebeb
border-bottom: none
font-family: source_sans_proregular
height: 32px

Available Content Panel Section Headers Title

.dashboardDesigner .dashboardSidebar .panel.collapsiblePanel > .header > .title

Changed color. Increased font-size, height, and line-height.

designer.css

Default values:

color: #333333
font-size: 13px
height: 32px
line-height: 33px

Available Content Panel Section Headers Toggle Button

.dashboardDesigner .collapsiblePanel > .header > .buttonIconToggle

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Increased height and width.

 designer.css

Default values:

background-image: url(images/disclosure_indicators_icons_sprite@1x.png)
height: 32px
width: 22px

.

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)
Available Content Panel Section Options Button

.header > .button.mutton

New sprites for background-image: one for standard-resolution displays and one for high-resolution displays. Increased height and width.

containers.css

Default values:

background-image: url(images/disclosure_indicators_icons_sprite@1x.png)
height: 32px
width: 22px

.

High-resolution value:

background-image: url(images/disclosure_indicators_icons_sprite@2x.png)
Dashboard Canvas

.dashboardCanvas > .content > .body

Changed background-color.

 canvas

Default values:

background-color: #ffffff