...
| Info |
|---|
We have several ways that you can get hold of the latest release - see our Download Options page for more details. Before upgrading, we always recommend that you review ALL release notes, from the version you are considering upgrading from and to. This is essential should there be a material change that could impact you or your customers. We always advise that you take a backup of your repository before beginning an upgrade , and recommend testing out the new software on a test environment first. |
...
Here is what is included in the release.
| Table of Contents |
|---|
...
Product Release
Added
...
Automatic removal of Tomcat log files based upon a new setting
...
#1883
...
25355 & 26671
...
Logging
Tomcat logs can now be set up to automatically be removed after a certain number of days. This behaviour is governed by a new setting available:
Under the Tomcat tab of the Configuration-Tool GUI under a new ‘Logging’ section (see picture below)
Under the Tomcat > Logging section of the dashboard.json file
Set via the PI_TOMCAT_LOGGING_MAX_AGE environment variable
...
This new setting also dictates the turnover of a new, daily rotating log file name out.{date}.log.
This new file is where log messages from the Dashboard are written. The default value for this setting is 0 which means that no logs will be removed.
...
...
‘Drill to top on full screen close' Chart Attributes option now supports 'Drill to Chart’ | #2054 | 28024 | Drill Down |
|---|
The ‘Drill to top on full screen close’ option added last month didn’t support ‘Drill to Chart’.
Now, once this option or the related ‘Full screen to display this level’ are set to True that drill level and any below it will reflect that behaviour - even if you have drilled to another chart.
The two fields are now independent of one another. When editing a chart, you will be able to tell when a drill level has one/both settings overridden by a higher drill level as they will be disabled, appear as checked, and a warning icon with a helpful, on-hover tooltip will be displayed next to them. Please note, the field appearing as checked when disabled does not relate to its value in the database it is a visualisation of the expected behaviour.
...
Setting drill Start and End levels when embedding a chart | #1892 | 26827 | Embedding |
|---|
It is now possible to set a start and end drill level that a user can see when looking at a chart when it is embedded. For instance example in a chart with 5 drill levels, it would be possible to have some users that can see levels 2-4. When skipping the top levels, no filter will be applied to the chart that is seen by the user.
You can set the values for drillStart and drill End as query parameters on the url URL that you are using to embed. When setting a drillStart you will also need to supply the identifiers for the chart and hierarchy levels of the drill levels above the start and the drill level you wish the user to see by manipulating the URL directly. These must be separated by the !$! delimiter when adding multiple levels. When drilling to the top, the user will return the the level defined as the drillStart parameter. It is possible to use the parameters individually or together.
...
The functionality will also work for dynamic drill conditions.
| Info |
|---|
The below url URL would allow the user to see drill levels 1, 2 and 3 (i.e the 2nd, 3rd and 4th hierarchy levels) of the chart: http://localhost:1234/pi/chart/?drillStart=1&drillEnd=3#chart-filter/251__1/d-f-p=251__0/!$!251__1 *Location and syntax of the query parameters. *Example of identifiers added to view level 1 (2nd hierarchy level) of the given chart. |
Further documentation on restricting drill levels when embedding charts can be foundon our Embedding pages.
Automatic removal of Tomcat log files based upon a new setting | #1883 | 25355 & 26671 | Logging |
|---|
Tomcat logs can now be set up to automatically be removed after a certain number of days. This behaviour is governed by a new setting available:
Under the Tomcat tab of the Configuration-Tool GUI under a new ‘Logging’ section (see picture below)
Under the Tomcat > Logging section of the dashboard.json file
Set via the PI_TOMCAT_LOGGING_MAX_AGE environment variable
...
This new setting also dictates the turnover of a new, daily rotating log file name out.{date}.log.
This new file is where log messages from the Dashboard are written. The default value for this setting is 0 which means that no logs will be removed.
| Info |
|---|
Removal of log files older than the currently set limit occurs either when the Dashboard is restarted or when that file is rotated due to being written to on a new day meaning that it is possible for ‘outdated’ files to still be present within the directory |
Redis support for session storage | #2003 | - | PlatformInfrastructure |
|---|
To enhance our scaling capabilities, we now have support for using Redis to store session data. This allows you to run multiple Dashboard instances in a load balanced environment with a single, fast store of session data.
...
‘Drill to top on full screen close' Chart Attributes option now supports 'Drill to Chart’
...
#2054
...
28024
...
Drill Down
The ‘Drill to top on full screen close’ option added last month didn’t support ‘Drill to Chart’. Now, once this option or the related ‘Full screen to display this level’ are set to True that drill level and any below it will reflect that behaviour - even if you have drilled to another chart.
The two fields are now independent of one another. When editing a chart, you will be able to tell when a drill level has one/both of these settings overridden by a higher drill level as they will be disabled, appear as checked, and a warning icon with a helpful, on-hover tooltip will be displayed next to them. Please note, the field appearing as checked when disabled does not relate to its value in the database it is a visualisation of the expected behaviour.
...
...
Changed
Container images rebased and updated to fully maintained versions | deployment#62 | - | Containers |
|---|
...
The Athena JDBC driver provided by Amazon has been upgrade upgraded to remove some reported vulnerabilities.
...
JDom, AWS Marketplace and Java SAML libraries have been upgraded to resolve reported vulnerabiltiesvulnerabilities
...
Fixed
Incorrect label for category panel unpin | #2022 | - | Category Panel |
|---|
...
Previously, when embedding 2 categories in 1 html page with 2 different category modes, the category modes would conflict, and you would get inconsistent behaviour where sometimes it would wrongly use the same category mode for both embedded categories. Now, each embedded category uses its defined mode correctly.
...
Previously when running the dashboard on Windows, the Scheduler was unable to pick up and use the correct time zone. This meant that the times in the monitoring screen were incorrect, and the scheduler logs would fill up with errors. This has now been fixed.
Resolved issue with encoding onurlURL feedback | #2065 | - | Embedding |
|---|
The wrong encoding format was being used on the url URL feedback snack bar when using single-chart mode. This has now been resolved improving both the security and display user experience.
...