Workspace selection

Overview Copied

The Active Console configuration is stored in a binary workspace file in AWX format. It contains the following:

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 formerActive Console workspace 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.


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.

Beginning Geneos 6.4.x, it is now possible to run the Active Console in State Only mode, and its configuration is stored in a binary workspace file in SWX format. For more information, see Quickstart guide.

Workspace directory Copied

Beginning Geneos 5.6.x, Active Console sets the new workspace default directory to the following paths:

The Active Console

Note the following behaviours with the new workspace directory:

Select workspace Copied

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:

These are the additional options available in the workspace selection dialog:

In Active Console, the workspace also allows you to:

Load workspaces from URL Copied

Active Console allows you to open workspaces from a URL so that you can use the latest standard workspace.

When you successfully load a workspace from URL, Active Console saves a copy of this workspace locally. If a cached workspace file already exists, then it will be replaced by the newly saved workspace file.

If loading a workspace from URL is unsuccessful, then Active Console displays the Active Console failed to load the workspace. Load the cached file from <date:time>? error message. You can select whether you want or not to load the cached version of the workspace.

When you load the cached workspace, these behaviours persist:

If you do not want to use the cached version of the workspace, you can use a different URL when selecting a new workspace.

Workspace connection issues Copied

Due to an upgrade in Active Console’s JDK version, you may encounter the following conditions:

To resolve the workspace connection issues:

  1. Close all your running Active Console instances.
  2. Open ActiveConsole.gci in your installation directory.
  3. Under -jvmargs section, add this line:

Another option for jdk.http.ntlm.transparentAuth is trustedHosts, but you must add the URL as a Windows trusted site.

Error types in the workspace Copied

The workspace displays the following if it encounters any errors:

When you encounter an error while loading a workspace, the Active Console prompts the following options:

When you encounter an error while saving a workspace, the Active Console prompts the following options:

Use authentication to load the workspace Copied

When you load an HTTPS URL using authentication for -wsurl or selected AWS file, Active Console gets the workspace from the specified path. To access the workspace:

  1. Open Select Workspace.
  2. Click Open From URL.
  3. Enter the link for the selected AWS file in the URL field. For example, https://website/document/path/filename.awx. When you open a valid workspace with an HTTPS URL, this opens the URL needs authentication screen.

  1. Provide your username and password.
  2. Click OK.


Beginning Geneos 5.14.x, you can enable certificate validation for HTTPS connection by setting the enableCertificateValidation flag to true. For more information on how to set this flag up, see ActiveConsole.exe flags.

If an invalid URL is provided, the workspace displays the The specified URL is not accessible error message. If the error still occurs, you may not have permission to access the resource site. Check your credentials with your Geneos administrator.

Auto saving and recovery Copied

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.

Import into the workspace Copied

There are a number of files types that can be imported into the open workspace.

The following files types are supported:

["Geneos"] ["Geneos > Active Console"] ["User Guide"]

Was this topic helpful?