On this page:
|Summary: this page explains how to reload the dashboard cache to display the most up-to-date snapshot data.|
The CAST dashboards feature a data cache to improve the speed at which data is displayed. This means that when requesting data, the dashboard may return data direct from the cache rather than fetching it from the Measurement or Dashboard Service. In turn, this means that data displayed in the dashboard may not be up-to-date. This is particularly true in the following situations:
To see the new data, you can manually force the cache to reload data from the Measurement or Dashboard Service, rather than waiting for it to do so automatically.
|Note that you must login with a user that has the ADMIN role in order to action this task.|
Browse to the following URL replacing server/port/dashboard with the details of your environment:
if you are already logged in, click the Test button to ensure you have an active session:
You will get a response as follows:
|Logged in||Not logged in|
If you are "logged in" you can proceed as below, otherwise, enter your user name and password and then click Login:
Once logged in, expand the Help section, you may click any of the following buttons:
The cache will then be reloaded with the most up-to-date data from the Dashboard or Measurement schemas.
The Reload server memory cache option (available in ≤ 1.23) has been replaced with the following options/buttons:
You can also reload the cache via a command line - this enables you to automate the process if you are using CAST's command line interface to automate an analysis, snapshot generation and upload of data to the Measurement Service. You can use a tool such as cURL to do so, for example, replacing "server:[port]/<dashboard>" with the details of your environment. Choose the appropriate option as shown below:
curl http://server:[port]/<dashboard>/rest/server/refresh -u admin:cast -H "Accept: application/json" curl http://server:[port]/<dashboard>/rest/server/reload -u admin:cast -H "Accept: application/json" curl http://server:[port]/<dashboard>/rest/server/reset -u admin:cast -H "Accept: application/json"
You can also specify a domain using the command line, for example:
Below table details the actions that you can perform using command line.
Add a new DataSource
Update context.xml and Restart Tomcat
Make a new application available in ED
Make a new application available in HD
Make a new snapshot available in HD/ED
Apply new authorizations
In ≥ 1.11.0 of the CAST Dashboard Package, an API Key feature has been introduced to allow connection without using standard login/password credentials or when SAML authentication is in operation. You can therefore use the API Key with curl as follows:
curl https://localhost:8080/RestAPI/rest/server/reload -H "X-API-KEY: G]MauT-9/*<dev8r" -H "X-API-USER: admin"
|If you are using ≤ 1.10.0 the API Key is not available, therefore then it is not possible to use the curl command line as described above. Some additional steps may be required (this third-party documentation may provide some hints about how to do this with a simple username/password, however, this is beyond the scope of CAST documentation).|
Server cache is refreshed, when a new snapshot is taken or when a new application is added to the existing central/measure (ED/HD) base.
Following user notification is displayed to the Dashboard users when a new application is added.
Following user notification is displayed when a new snapshot is taken.
The server reloads from cache, when a new application is added to central base (ED), and blocks the user activity on Dashboard until the server is reloaded.
Following pop-up message is displayed to the Dashboard users as shown in the below screen.
Server cache is reset, only when the authorization file is changed.
Following user notification is displayed to the Dashboard users when an authorization file/configuration is changed.