Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

On this page:

Table of Contents


Info
Summary: this page explains how to reload the dashboard cache to display the most up-to-date snapshot data.

...

  • if you have very recently generated a snapshot and were expecting to see this new data
  • if you have run a manual consolidation with GUI/CLI admin toolsif you have run a manual consolidation with GUI/CLI admin tools
  • if you have deleted an existing snapshot

...

Browse to the following URL replacing server/port/dashboard with the details of your environment:

Code Block
languagetext
WAR 1.x / 2.x
http://server[:port]/dashboard<server>:<port>/<dashboard>/static/default.html

ZIP ≥ 2.x
http://<server>:<port>/static/default.html

if you are already logged in, click the Test button to ensure you have an active session:

...

If you are "logged in" you can proceed as below, otherwise, enter your user name and password and then click Login:

Image Modified

Once logged in, expand the Help section and click the Reload server memory cache button:Image Removed, you may click any of the following buttons: 

  • Sync clients with new snapshots - Refresh of the server memory cache in the background with no interruption for Health Dashboard clients, and reduced interruption for Engineering Dashboard clients
  • Sync clients with new domains - Reload the domain properties configuration file and refresh the server memory cache
  • Sync clients after a license key change, or snapshot reconsolidation Reloads the license.key file, the license.xml file (used for authorization definition when using a restricted license.key) and invalidates the browser cache.

Image Added

The cache will then be reloaded with the most up-to-date data from the Measurement Service.Dashboard or Measurement schemas.

Info

The Reload server memory cache option (available in ≤ 1.23) has been replaced with the following options/buttons:

  • Sync clients with new snapshots
  • Sync clients with new domains
  • Sync clients after a license key change, or snapshot reconsolidation

Via a command line for automation

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 <dashboard>" with the details of your environment.   Optionally, this command line can then be added to a batch file containing the command lines required for generating a snapshot.Choose the appropriate option as shown below:

Code Block
languagetext
WAR 1.x / 2.x
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"

ZIP ≥ 2.x
curl http://server:[port]/rest/server/refresh -u admin:cast -H "Accept: application/json"
curl http://server:[port]/rest/server/reload -u admin:cast -H "Accept: application/json" 
curl http://server:[port]/rest/server/reset -u admin:cast -H "Accept: application/json"


Info

You can also specify a domain using the command line, for example:

WAR 1.x / ≥ 2.x

curl http://server:[port]/<dashboard>/rest/server/refresh?domain=AAD -u admin:cast -H "Accept: application/json"

ZIP ≥ 2.x

curl http://server:[port]/rest/server/refresh?domain=AAD -u admin:cast -H "Accept: application/json"

Actions using command line 

Below table details the actions that you can perform using command line.

Use Case

Action

User Impact 

Add a new DataSource

Update context.xml / application.properties / domain.properties and restart the web application.

If users are online, they will be interrupted.

Make a new application available in Engineering Dashboard

WAR 1.x / ≥ 2.x: http://server/:[port]/<dashboard>/rest/server/reload?domain=ED

http://server/:[port]/rest/server/reload?domain=ED

If users are online, they will be interrupted with a logout popup window.

Make a new application available in Health Dashboard

WAR 1.x / ≥ 2.x: http://server/:[port]/<dashboard>/rest/server/refresh?domain=AAD

http://server/:[port]/rest/server/refresh?domain=AAD

No interruption for online users

Make a new snapshot available in Health or Engineering Dashboard

WAR 1.x / ≥ 2.x: http://server:[port]/<dashboard>/rest/server/refresh?domain=AAD
WAR 1.x / ≥ 2.x: http://server:[port]/<dashboard>/rest/server/refresh?domain=ED

ZIP ≥ 2.x: http://server:[port]/rest/server/refresh?domain=AAD
ZIP ≥ 2.x: http://server:[port]/rest/server/refresh?domain=ED

No interruption for online users

Apply new license key, change license.xml file (used for authorization definition when using a restricted license.key) or reconsolidate a snapshot

WAR 1.x / ≥ 2.x: http://server/:[port]/<dashboard>/rest/server/reset

ZIP ≥ 2.x: http://server/:[port]/rest/server/reset

No interruption for online users

Anchor
apikey
apikey
Using an API Key

If you have enabled SAML authentication mode for your CAST Dashboard/RestAPI deployment, then in In ≥ 1.11.0 of the CAST Dashboard Package, an API Key feature has been introduced . You will need to to allow connection without using standard login/password credentials or when SAML authentication is in operation. You can therefore use the API Key instead of a password when using curl for automated actions. To do, so modify the command line  with curl as follows:

  • X-API-KEY: the API Key matching the key defined in the security.properties file
  • X-API-USER: a defined user name to obtain a CAST dashboard/RestAPI role and data authorization
Code Block
languagetext
WAR 1.x / ≥ 2.x
curl https://localhost:8080/RestAPI<dashboard>/rest/server/reload -H "X-API-KEY: G]MauT-9/*<dev8r" -H <some_key> -H" "X-API-USER: admin"

ZIP ≥ 2.x
curl https://localhost:8080/rest/server/reload -H "X-API-KEY: <some_key> -H" "X-API-USER: admin"


Info
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).

What to Expect 

When refresh service is executed 

The server cache

...

is refreshed when a new snapshot is taken or when a new application is added to the existing Dashboard/Measure schema. The following user notification is displayed to users when a new application is added:

Image Added

The following user notification is displayed when a new snapshot is taken:

Image Added

When reload service is executed

The server reloads from cache

...

Image Removed

If the user is already logged in, a pop-up message will appear, as shown in the below screen, and block the user activity on dashboard until the server is getting refreshed. 

...

when a new application is added to central base (Engineering Dashboard), and blocks user activity until the server is reloaded. The following pop-up message is displayed to users:

Image Added

When reset service is executed 

The web service reloads the license.key file, the license.xml file (used for authorization definition when using a restricted license.key) and invalidates the browser cache.  The following pop-up message is displayed to users:

Image Added