Jump to content
  • This documentation is an older version of JasperReports Server Upgrade Guide. View the latest documentation.

    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 TIBCO JasperReports Server Administrator Guide.

    warning-icon-ns_28x28.png.4e17613257dcfc915dccdf73b43fa0c5.png

    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.

    1. 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 will cause 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.

    1. 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 will cause errors when running reports that rely on them.

    Changes to the TIBCO MongoDB Query Language

    The TIBCO 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:

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

    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.
    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 new keystore once again.

    For more information and procedures for importing keys, see the TIBCO 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 will 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 re-implement the home page in the new default theme.

    If you have not customized the user interface, these changes will 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 (1100px) and a breakpoint at which it becomes hidden (980px).

    theme.css

    Default values:

    height: 23px
    width: 200px

    Breakpoint from 981-1100px:

    width: 150px

    980px 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 1px 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: 16px

    High resolution value:

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

    Banner Metadata container

    #metalinks

    Changed heightto be 1px 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: 270px

    Breakpoint from 821-1100px:

    margin-right: 200px

    Breakpoint from 751-820px:

    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: 14px
    line-height: 39px

    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-1100px:

    width: 180px

    Breakpoint from 751-820px:

    width: 100px

    750px and below:

    display: none

    Banner Search input wrapper

    #globalSearch.control.searchLockup > .wrap

    Increased height of input wrapper.

    controls.css

    Default values:

    height: 28px

    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-1100px:

    width: 130px

    Breakpoint from 751-820px:

    width: 80px

    750px 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 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 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 forbackground-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 forbackground-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 forbackground-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 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


    User Feedback

    Recommended Comments

    There are no comments to display.



    Guest
    This is now closed for further comments

×
×
  • Create New...