The Active Console configuration is stored in a binary workspace file in AWX format. It contains the following:
- Gateway connections
- Position, size, and placement of all the dockable components.
- Active charts and their data.
- Configured custom views, their content, and any filters you have defined .
- Configuration and layout of the dataviews, including which columns are displayed, their widths, and their position (relative to other columns).
The Active Console introduces the AWX extension file name starting GA3.0 versions to allow you to save the workspace in an XML format. However, the former Active Console Work Space or AWS extension has been introduced for GA2.1 and lower versions, but is still supported.
The workspace you are currently using is displayed in the status bar at the bottom of the application.
Note: It is possible to force the Active Console to read and write in the old .aws format using a flag in the gci file. For more information, see Start Up Settings.
When you start up the Active Console, you can select the workspace that you want to use:
The Select Workspace dialog presents some standard workspace options, and a list of the recent workspace files that you have used.
The general workspace options are:
- Last known good workspace — loads the last known good workspace, if it exists and is accessible.
Create a new workspace— opens a new workspace.
- Browse for a workspace — selects an existing workspace file to load.
- Open workspace from url — opens a workspace from a URL.
These are the additional options available in the workspace selection dialog:
- Always use the last known good workspace — directs the Active Console to use the last known good workspace.
- Show unavailable items — displays the historical workspaces that are now inaccessible.
- Cleanup — deletes workspace entries that are inaccessible.
In Active Console, the workspace also allows you to:
- Auto-load the last good workspace by configuring the Active Console Settings > General > Persistence > Autoload last good workspace.
- Auto-save workspaces by configuring the Active Console Settings > General > Persistence > Autosave period.
- Revert a workspace to undo and discard your changes that you have made. To do this in, click File > Workspace > Revert.
- Set the workspace to read-only which means that no configurations or settings can be made. To do this, go to the Active Console Settings > General > Persistence > Workspace is read only. The auto-save function does not work when a workspace is set to read-only mode.
The workspace displays the following if it encounters any errors:
Critical (red exclamation mark)— critical or serious issues which normally result in to a significant loss of configuration information in the workspace.
Warning (yellow exclamation mark)— issues which result in the lost of some configuration information in the workspace.
Information (blue information symbol)— minor losses of configuration that are unlikely to have a serious impact in the workspace.
When you encounter an error while loading a workspace, the Active Console prompts the following options:
- Load Anyway — loads the workspace normally and ignores the errors.
- Save As a different workspace — provides a new location to save the affected workspace.
When you encounter an error while saving a workspace, the Active Console prompts the following options:
- Revert to the last known good workspace — stops the saving process, and restores the last known good workspace.
- Save anyway — saves the workspaces regardless of the errors.
- Save it to a different location — provides a new location to save the affected workspace.
- Do not save the workspace — does not save the workspace, and continues to shut down or load a newly selected workspace.
- Abandon Save and return to the application — stops the save operation and returns to the application.
The Active Console has an auto save feature that can write out temporary AWES files periodically, such that it can recover after unexpected behaviour or allows you to restore an older version of your workspace in the event that it becomes corrupt.
These temp files have a name equal to:
~<day of the month>.<hour>.<minute>.<sec>~~<workspace file name>.aws
Here's an example:
These files are written to the same directory as the workspace file is located in. You can configure how often these are written out and how many temp files to keep in the Active Console settings > General settings ( once the upper limit of temp files has been reached, it starts replacing the older files.)
If the Active Console fails to shut down correctly, then the last auto save will be available in the workspace selection dialog as a recovered file on the next start up.
There are a number of files types that can be imported into the open workspace.
The following files types are supported:
- Active Console Dockables (.ado) — dockables that have been exported from the Dockable Manager can be imported as new dockables.
- Metric views (.msv) — individual metrics tab are added to the metrics view.
- Active Dashboards (.adb) — a single active dashboard that can be imported into the selected dashboard dockable.
- Dashboard Tools (.adt) — contains one or more user defined tools for the Active dashboard.
- Active Dashboard components (.dbi) — a dashboard component, such as an active chart or gauge.
- Other workspaces (.aws) — merges the contents of the specified workspace with your current workspace. Currently, only the metric views and dashboards can be imported.