Summary

The Nomad Dashboard is a collection of interactive tiles made available in the Configuration Manager console that provides you with a global view across your network of Nomad status and latest operation details. 

For the dashboard to function fully, it requires that Nomad returns status messages into the ConfigMgr site database. By default, the Nomad client agent does not return any ConfigMgr status messages. Use of the dashboard Operations panels requires the  following messages are set in the agent registry StatusMsgEvents value:

  • SNO_EVT_REQUEST_STARTED (0x0000000020)
  • SNO_EVT_REQUEST_COMPLETED (0x0000000040)
  • SNO_EVT_ERROR (0x0000000004)
  • SNO_EVT_FINALSTATS (0x1000000000)

These combine to the following value:

  • StatusMsgEvents = 0x1000000064

Use of the Client Health panel also requires that the following is set in the ClientHealth registry:

  • HKEY_LOCAL_MACHINE\SOFTWARE\1E\ClientHealth SendStatusMessages = true

Both the StatusMsgEvents and SendStatusMessages settings can be implemented using the The Nomad Baseline Wizard.


On this page

In this section

Nomad dashboard Status tiles

These tiles display information about the status of Nomad across your network.

Nomad dashboard Latest Operations tiles

The Nomad Dashboard tiles

The Nomad Dashboard is an HTML page in the Configuration Manager console that aggregates data from ActiveEfficiency which gets its content from the Configuration Manager database using the Nomad Synchronization service which is run every 30 minutes (set up when you run ActiveEfficiencyServer.msi). You can access the dashboard from the Configuration Manager console or from a browser.

You must be running ActiveEfficiency 1.9.800 or later to benefit from this feature.

We recommend running this on a host capable of displaying a 1920x1080 resolution. However, if the host you are running on has a lower resolution, use the CTRL and +/- keys to adjust the display to suite your personal preferences and avoid having to scroll to view the tiles.

The dashboard is made up of eight tiles:

The Nomad dashboard

The Nomad Status tiles

These tiles provide information about how Nomad is performing, including: the distribution of Nomad client versions across the network, client health status 

There are four Status tiles, as outlined in the following table:

Status tilesDescription

Client version distribution

This tile displays the distribution of Nomad client versions across your environment. The red bar indicates the number of clients that do not have Nomad agents installed (y-axis) and the turquoise bars identify the version (x-axis) and the number of clients for that version.

This tile currently has a dependency on hardware inventory, which is handled by the reports installer. We are working on removing this dependency in a future release.

Client health status

This tile displays the health status of your Nomad clients. There are three top-level status shown: Healthy, Warning and Failed. You can click on the Warning and Failed segments displayed to see a detailed breakdown of the warnings and failures that make up the overall status.

The tile additionally shows the health of CM client which is not gathered by Nomad agent, but directly queried from SCCM database.

This tile depends on Nomad status message reporting being enabled on each of the Nomad clients.

Content by type

This tile displays the distribution of the various types of Nomad content downloaded across your network split into those that are, and those that are not, enabled to use Nomad.

Overall WAN bandwidth usage

This tile shows a comparison between the available WAN bandwidth and that used by Nomad over a period of time. Hover your mouse over a date for a summary of the network usage over that period.

These tiles are described in greater detail on the Nomad Dashboard Status tiles page.

The Latest Operations tiles 

These tiles provide information on the progress of the latest Nomad Operations.

There are four Latest Operations tiles, as outlined in the following table:

Latest Operations tilesDescription

Download Progress:<Latest deployment>

This tile shows the download progress for the latest deployment.

 

Caching Metrics:<Latest deployment>

This tile shows the caching metrics (distribution point, peer and already cached and a combination of these) for the latest deployment.

Download progress: <Latest pre-cache job>

This tile shows the download progress for the latest pre-cached job.

This tile shows the proportion of clients downloading content for the last pre-cached job from the different pre-cached locations. The information is derived from the SNO_EVT_FINALSTATS status message.

Caching metrics: <Latest pre-cache job>

This tile displays the caching metrics for a particular package.

the ContentRegistration registry value must be set to 1 to enable precaching

These tiles are described in greater detail on the Nomad Dashboard Latest Operations tiles page.

If you enable the SECure feature, the Nomad Dashboard will not differentiate between secure and non-secure downloads in its reports for the Download Progress and Caching Metrics tiles.

Accessing the Nomad Dashboard

To access the dashboard:

  1. From the Configuration Manager console, open the Monitoring workspace.
  2. Expand the 1E Nomad folder and click Dashboard.
    Accessing the Dashboard from Configuration Manager
  3. From a browser, type http://<ActiveEfficiency Server Name>/ActiveEfficiency/NomadDashboard in the address bar (where <ActiveEfficiency Server Name> is the name of the server where you installed ActiveEfficiency). For example in the ACME.LOCAL domain there could be an AESERVER01 server where ActiveEfficiency has been installed. In this case the URL would be: pan> http://AESERVER01.ACME.LOCAL/ActiveEfficiency/NomadDashboard.

Restricting access to the Nomad dashboard

The Nomad Dashboard is implemented through ActiveEfficiency. When using the Nomad Dashboard with ActiveEfficiency 1.9, Configuration Manager Role-based Access Control is applied. Users will not be able to see data for deployments or content that they do not have read permissions on in CM security. From ActiveEfficiency 1.10 this has been replaced with a simpler AD group security model. This change was made due to performance issues with the dashboard when role-based access control was used, and feedback from customers that role-based access control was not as important as being able to view the data in a timely fashion.

By default, when ActiveEfficiency 1.10 is installed, the Domain Users group (in the ActiveEfficiency server's domain) is granted access to the Nomad Dashboard. To restrict the dashboard to a different AD user group:

  1. Navigate to C:\Program Files (x86)\1E\ActiveEfficiency\Web\WebService\
  2. Edit the web.config file.
  3. Locate the <appSettings> element, and update the value attribute for DashboardAccessGroup:

    <appSettings>
    	...
    	<add key="DashboardAccessGroup" value="Domain Users" />
    	...
    </appSettings>
  4. To specify a domain other than the ActiveEfficiency server's domain, you will need to add the following key to the web.config file (it is not in the default file - you can add it after the DashboardAccessGroup key) 

    <appSettings>
    	...
    	<add key="NomadDashboardDomain" value="MyDomain" />
    	...
    </appSettings>
  5. Save the file.

What each tile on the dashboard does

Nomad headline savingsThe Nomad Dashboard is split into two main sections; one reporting on statuses and the other on events taking place in your environment.  A summary at the top of the dashboard displays the headline savings for successful Nomad downloads and the WAN bandwidth savings.

To the top right of each tile there are icons to refresh the tile, to see a summary about the data or to get detailed information about the data. Hover your mouse over these icons to get a tool-tip. For example, if you click the Info icon, it displays a summary of the event for that tile and where appropriate, the date it was updated or the date range for the report.

Information about a tile

Nomad Dashboard Settings

The Nomad Dashboard stores data for the past 30 days only (by default).  Data older than this is automatically deleted from the ActiveEfficiency database when the Nomad Sync is executed.  This can be increased by modifying by the MaxNomadDashboardDataDays value in %ProgramFiles(x86)%\1E\ActiveEfficiency\Service\ServiceHost.exe.config.  Please note; this will increase the ActiveEfficiency database size.