VQ Conference Manager - Device Management and Automation (DMA)

Welcome

VQ Conference Manager – DMA* (DMA) is designed as a replacement for Cisco TelePresence Management Server (TMS) deployed ‘on premise’ as part of a Cisco Meeting Server and Cisco videoconferencing devices eco-system.

This third and final phase in the delivery of the DMA suite into VQ Conference Manager adds the Device Maintenance functionality. It enables you to onboard, configure and manage all your Cisco collaboration devices.**

DMA can now be used to replace Cisco TM.S

DMA tooling is also provided for the ability to import all your current templates from your existing TMS environment.

* DMA is an extension to the existing Cisco recommended VQ Conference Manager platform

** DMA supports Cisco collaboration devices running the CE/RoomOS operating system

DMA Overview

Page Features & layout.

Administrators have full access to DMA. Users with restricted permissions will not have access to all menus and options.

Side Bar Menu

DMA functionality is grouped by main categories on the side bar menu:

Exit

The Exit button is always shown at the bottom of the side bar and will log you out of DMA and return you to the VQ Conference Manager login page.

Drop Down

Clicking on fields with a small triangle ‘twisty’ at the end will display a drop-down menu, as will clicking on the three dots shown in any ‘Action’ column.

Lists

You can re-sort most lists in DMA by clicking the title of the relevant column. A small arrow next to the column title will indicate whether the sorting is ascending or descending. Some lists may have hundreds or even thousands of entries. Rather than show them all in a single list, most lists in DMA are split into pages with < and > arrows at the bottom.

Filters

Clicking on the Filter icon above most Device lists will display a filter creation box that allows you to filter in or out devices to/from your selection. Devices can currently be filtered by Name, Location and Label.

Tabs

Many pages in DMA have multiple views available, shown as tabs across the top.

In the screenshot above, there are multiple pages available, including View, Assign, Remove, and Activity. The active tab is displayed with blue text and underline.

Add to List

Where it is possible or required that a list can be created or added to the, Add to List ‘+’ icon is displayed at the top of the list.

Edit a List Action

Where it is possible to execute an action on items in a list the three dots icon will be displayed. Clicking this icon will display a Drop-Down list of actions.

DMA components and application architecture

Whilst DMA does look quite different to the existing VQ Conference Manager – Meeting Scheduling & Management pages, the architecture of the VQCM platform is essentially unchanged. A new URL (https://servername.domain/dma/) has been added to the CM-Admin list to enable users to directly access DMA.

There are no additional servers to install or major configuration differences, other than the need to specify the user profiles and ACLs for access to the DMA functionality.

The End Point Agent (EPA) introduced in version 3.9.0 to deliver OBTP messages to Cisco video endpoints (Devices) has been expanded to ‘talk’ in more detail to devices using the Cisco Collaboration Endpoint Software API.

Setting up DMA

Profile and ACL use in DMA

As mentioned previously the access control features specifically for DMA functionality are not yet enabled. DMA is however an integrated ‘module’ of the VQ Conference Manger (VQCM) and as such requires a ‘non-personal’ user profile to access DMA using the ‘/dma’ URL.

System Service Account

DMA requires access to read from and write to Cisco devices (systems) at times during its operation and an account with ‘Admin’ level rights is required to do this. To align with security ‘good practice’ we recommend creating a dedicated account, the ‘Service Account’ to do this.

If you already have such an account in use in TMS (this is should not be the default ‘admin’ account with a changed password) we recommend using this same account to avoid having to make changes to your devices prior to migration.

Details of how to do this can be found in the sections of this guide.

System Certificate

DMA requests ‘feedback’ from devices during its operation to obtain the data required to log and show device status, warnings, and alerts. To do this all devices must have the Conference Manager Trust Chain Certificate Authority loaded.

To load the certificate, navigate to the Certificate menu item on the Main Menu side-bar under Device Configuration:

The Certificate page will appear and default to the ‘VIEW CERTIFICATE’ tab:

The ‘No certificate loaded’ warning will be displayed if no certificate has been uploaded to the system. To upload a certificate click on the ‘UPLOAD CERTIFICATE’ tab:

To upload the certificate (.pem) file drag and drop the file on to the highlighted box:

The upload screen will display details of the certificate and the UPLOAD CERFICATE will light up. Click to upload the certificate and the uploader will run and confirm success:

If the uploader fails, use the ‘Reset Uploader’ button to upload a new certificate. The certificate will be displayed in the View Certificate tab:

If the certificate is due to expire the menu will display an alert and the ‘View Certificate’ tab will also flag it:

DMA and the Tenant model

DMA has been designed to support the Tenant model of VQ Conference Manager. For each defined Tenant on a platform there is a separate DMA ‘container’; the devices of one Tenant cannot be seen or managed by the users (of any level) of another.

Users who require access to the devices of multiple Tenants can be permissioned to do so and must switch between Tenants using the link at the top of the DMA page to ‘Change Tenant’ and access the associated devices.

Importing data from TMS

Export/Import tooling and CSV importer

One of the greatest challenges faced when moving to a new management system of any kind is the migration of data in existing systems being replaced.

VQ has addressed this with DMA and is providing tooling where it is possible, to extract data from an existing TMS system*, transform it and load it into the DMA database.

In the inital releases of DMA, we are providing tools that can be run outside of the DMA platform to extract and load devices under management Phone Books and configuration templates from existing TMS systems.

* VQ recommends taking a copy/mirror of the TMS SQL database for migration use to avoid any risk of performance impact.

NOTE: A worked example of importing data from TMS is provided in the 'How to guide - TMS to DMA Migration '

Locations and Labels

Locations

To continue supporting the categorisation and organization of devices and contact lists (Address Books) in DMA as it has been in TMS, VQ has implemented a concept called ‘Locations’.

These Locations are intended to reflect the hierarchical ‘tree’ structure that TMS allows users to define in the Navigator function.

Labels

In addition to Locations DMA introduces a new concept not previously available in TMS, ‘Labels’.

The Labels feature allows permissioned users to create and assign free text tags (Labels) to devices in the database enabling an additional level of categorisation and grouping of devices.

Devices

DMA Devices vs. TMS Navigator

The primary method for navigation of devices managed by DMA is through the Devices section of the side bar main menu.

One major change that users of TMS will notice is that DMA does not have an equivalent tree view to the Navigator function found at the top of the Systems menu.

As described in the previous section, DMA does have a concept of hierarchical classification with the Locations feature. Locations are described as a path rather than a tree. DMA also has an extended classification feature with Labels.

Using filtering and sorting this device list, a user can narrow down to a focused list of relevant devices, or even a single device. At the same time, they can see other devices of relevance and perform actions, view, edit and switch between devices quickly and easily.

Role of the Devices area

Prior to this final phase of the creation of the DMA suite there was no facility for a user to perform actions on a device in the Devices list. With Phase 4, DMA1.2 (as part of VQCM 3.12 and 4.2), Devices becomes the hub of all activities relating to the monitoring and maintenance of your collaboration devices.

In the planned future releases of DMA, most new capabilities will be added to the Devices area.

Important: DMA requests ‘feedback’ from devices during its operation to obtain the data required to log and show device status, warnings, and alerts. To do this all devices must have the Conference Manager Devices Trust Chain Certificate Authority loaded. If the certificate is not loaded onboarding of device will fail with a warning.

See System Certificate for more information.

Devices basics

In the Devices area of DMA, the default view has six columns showing the most critical information about the devices under management. These are:

Device – The name of the device recorded in the ‘System Unit Name’ setting of the device’s configuration.

IP Address – The (IPV4) network IP address of the device assigned manually or via DHCP.

Status – The latest recorded status of the device reported to DMA by the device using the HttpFeedback feature of Cisco CE/RoomOS or determined due to no received feedback.

Status values are Online, Online with Issues, In Call, Offline and Unknown. Details of the conditions resulting in these status indicators can be found in – VQ Conference Manager DMA - Device Status Alert Conditions.

Location – The ‘location’ of the device in the user-defined DMA Locations hierarchy (see Device Configuration Basics - Locations).

Label – The assigned user-define label[s] for the device. A device can have multiple labels assigned to it.

Action – Clicking the ellipses displayed in this column displays the menu of ‘maintenance’ actions available to the user.

Device Onboarding

Following on from any migration of device data from TMS, or as a new user of device management software it will be necessary to add new devices to the system.

The device onboarding feature of DMA is designed to manage this ‘provisioning’ and adding to the DMA database of new devices.

NOTE: if your environment is built using CUCM as the SIP registrar for devices, you will continue to provision devices using CUCM and import/sync devices to/with DMA for advanced management.

Add New Device[s]

In the Devices area of DMA click on the Add new button Icon to open the Device Onboarding page:

In the Device Onboarding page, you must now provide the IP address, DNS names or IP address range of the device[s] that you want to onboard to DMA:

There are three ways that devices can be identified to DMA for onboarding.

  • as individual IP addresses (separated by a comma [,] for multiple devices)

  • by their DNS name if this has been assigned

  • as an IP range (i.e., where a new group of devices has been installed and allocated sequential addresses from a defined range)

Once the target devices have been identified you must provide Locations settings; Time Zone and location within the ‘Location Hierarchy’ defined in DMA:

Time Zones are in UTC format and written to the device during the onboarding process, therefore when onboarding multiple devices they must all be in the same time zone.

Next, select the devices’ location in the DMA ‘Location Hierarchy’:

Once these basic setting are provided the user must move to the Advanced Settings section:

In Advanced Settings you will also find options for Username and Password. These are only ever required if the device[s] that are being onboarded have not yet had the VQCM Service Account added to them. See ‘Setting up DMA’ for details of the Service Account creation and use.

Additionally, you will find options to set:

  • Persistent Template – a configuration template applied on a scheduled basis to the device[s]. It is possible to set this later, if the devices that you are onboarding will not all use the same template

  • Labels – user defined labels (‘tags’) that provide additional filtering and grouping options within DMA

  • Usage Type – basic usage types for devices that can used to further filter and group devices for operational or analytical reasons

NOTE: There is only one field that is mandatory in Advanced Settings, the Usage Type.

To select a persistent template, label or usage type simply click on the drop down ( ) arrow.

Multiple labels can be assigned to devices:

The Usage Type list is currently fixed in DMA. It is not editable :

Once all of the required fields have been set/selected and any additional settings populated the Start button will be turn from grey to blue indicating that the onboarding process can be run.

Select Start and the onboarding request will be sent to the server to be added to the queue:

The Device Onboarding page will now be switched to the ACTIVITY tab to display progress and success/failure messages for the request:

As the onboarding process progresses the activities for each device specified will be displayed. In addition, a summary message line will be displayed showing overall request status.

Successful:

Failed:

In the event of a failure to onboard the Activity tab will provide more information as to what went wrong (e.g., device not found, could not login to device etc.) to guide the user towards resolution.

Once onboarding is completed successfully the device will appear in the Devices list and show its status:

Device Location and Labels

From the main Devices page, it is possible to make DMA data configuration changes to a device or devices, i.e., the ‘Location’ and ‘Labels’ values stored against them.

Location

To set or change the Location (position in the ‘location hierarchy’ of DMA) of a device or devices select using the left-hand side check boxes:

The Location and Labels buttons in the page top menu bar will light up:

Click on the Location button to set/change the location of the device:

The location hierarchy can be expanded to find the new location to be set on the device:

Click ‘Save’ and the device records will be updated:

Labels

To set or change the Labels assigned to a device or devices, follow the process above but in this instance select the Labels button:

 

Select the required Label[s] and click Save to write these labels to the device[s]:

Click Save and Close and the device will now be update and the labels displayed in the Devices page:

Device Actions

To perform troubleshooting, testing, or fast settings changes to a device the DMA Devices page provides several different device actions or functions via the Action menu:

To access the available actions, click on the three dots ( ) in the ‘Action’ column for any device. The menu currently has seven options available.

Summary

This action opens a page displaying key information about the selected device such as, status detail, warning/alerts, system contact details and SIP registration.

You will notice that the page provides access to the other actions of the menu via tabs near the top of the page. It also provides a quick launch to access the web interface of the device in a new browser tab.

Settings

This page/tab displays more detailed configuration about the device and allows the user to edit various common settings that are useful when troubleshooting or re-configuring and device:

The Settings are grouped to enable faster locating of a setting and to allow the user to ‘declutter’ the view. Using the arrow on the far right of each section it is possible to expand or collapse the sections:

To edit a setting on the device the page/tab must be put into edit mode by clicking on the button.

The device is now in edit mode.

NOTE: any changes made here will be written to the device directly and immediately on ‘Save’.

The editable settings are now made ‘open’ to edit and can be changed via free text entry (items such as IP address formatting will be validated on save) or drop-down list selection. Once a change has been made the Save button will be lit:

If you do not wish to commit the changes to the device press Cancel and the changes will be ignored, and the device page will be taken out of edit mode and the displayed settings will revert to their pre-edit values.

NOTE: A new feature is available in DMA that allows users to store the geographical location of a device in its settings. This ‘geo-location’ is used by the DMA Dashboard in the Analytics module to display the device on a world map. Further information about how to obtain and use the geo-location data for a device is described in VQ Conference Manager DMA - Geolocation

For details of the settings and what effect they will have the device operation of performance please refer to the Cisco administrator, setup, or user guide for the device. DMA will not warn you of any detrimental effects to operation or performance that a change might have.

Address Books

This page/tab enables the user to assign to, or unassign address books from devices. No changes are made to devices by this feature, it simply manages device access to address books and whether they will be made searchable by the device:

Simply select the Address Book[s] that you want available to the device and click the ‘<<’ or ‘>>’ buttons to either assign or remove access:

Labels & Locations

This page/tab enables the user to assign to, or unassign labels from devices, or set the Location of the device in the DMA hierarchy. No changes are made to devices by this feature, it simply writes the selected labels to the DMA database entry for the device:

Select the labels to be assigned to/removed from the device and use the ‘<<’ or ‘>>’ buttons to assign or remove:

Location is set at the top of this page using a drop-down menu:

Activity

The Activity page/tab enables a user to view all of the device feedback activity received from the device. This is not the DMA activity on the device but what the device has been requested to provide to DMA via the HttpFeedback feature of the Cisco collaboration devices ‘xAPI’:

Log into Device

This menu option launches the web interface of the device in a new browser tab:

Delete

This menu option deletes the device from the DMA database and de-registers any status feedback requests made to it using HttpFeedback:

To complete the deletion, process the user must type the word ‘DELETE’ into the pop-up and click Continue.

NOTE: The process will immediately remove the device from the DMA database.

Directory Services

Directory Services (DS) basics

Data Sources

Data sources are basis of any Address Book that is to be created in and made available by DMA Directory Services to the video endpoint devices in your environment. The first and most important data source for DMA is its own list of devices under management, your organizations own devices. This source is predefined in DMA and named ‘Internal DMA’ by default.

Address Books (Phone Books)

DMA supports the creation of Address Books from the Internal DMA devices list, sub-sets (using filters) of the Internal DMA list or imported data from pre-formatted CSV files.

DMA Address Books are designed to replicate the TMS ‘Corporate Directory’ Phone Book. They are created primarily from the DMA managed device list and are made searchable to assigned video endpoints via the same SOAP XML API method used by TMS.

DMA Address Books can be accessed by endpoints that have been set to ‘TMS mode’ in Phone Books and have the URL set to point at the VQ Conference Manager server’s DMA Directory Service (https://servername.domain/api/v1/dma/tmsaddressbooks/PhoneBookService.asmx). The Address Books are secured to be accessed only by ‘Assigned’ (permissioned) groups of devices in the same way they are in TMS through the ‘Set on Systems’ command.

In addition to replicating the method of querying/searching the Address Books DMA supports the presentation of the results based upon the hierarchy defined using the Locations feature.

Creating an Address Book

To create an Address Book, you must first have a Data Source to connect it to. This will have been done in DMA either by importing the devices from TMS or importing from a CSV file using the CSV Import Tool available from VQ.

Step 1.

Select the Address Book feature from the side bar menu

Create a new Address Book by clicking the ‘Add New’ button at the top of the page

Select the Data Source that will be used to create this Address Book

Save the Address Book

The Address Book list will now show the address book.

Step 2.

While still in the Address Book, select the ‘Assign to Devices’ tab

Click the ‘Add Filter’ button to begin creating a list of target devices

Using the filter creation box build your list of devices to be assigned the Address Book

Once you’re happy with the list, check the boxes of the systems to be assigned the address book (the top box selects all devices shown on the current page) click the ‘Assign’ button to make the Address Book available to the selected endpoint devices

Assigning Address Books to endpoints

To provide access to an Address Book from a video endpoint device or group of devices use the ‘Assign’ action.

Select Address Books from the side bar menu

Locate the Address Book to be assigned to and click on the ‘Action’ button

Select ‘Assign to Devices’ from the drop-down menu to enter the Address Book assignment tab

Once in the Assign to Devices page click the ‘Add Filter’ button

Using the filter creation box build your list of devices to be assigned the Address Book

Once you’re happy with the list, check the boxes of the systems to be assigned the address book (the top box selects all devices shown on the current page) click the ‘Assign’ button to make the Address Book available to the selected endpoint devices|:

Working with Data Sources

If you want to use a sub-set of the DMA Internal Device list to create an address book to be used by specific devices, then you will need to create a new Data Source. This new source can be filtered to contain only the devices you wish to appear as contacts in it.

Select the Data Sources option on the side menu bar:

Select the ‘Add New’ button at the top of the page:

Give the new Data Source a name that describes the devices that you are going to filter into this new source, e.g., ‘UK Systems’:

Create a filter that selects only the devices that you want in the final Address Book, e.g., ‘Location - Equals - UK’:

Confirm that the endpoints you are expecting to see are now selected and Save the data source:

NOTE: In the initial releases of DMA there is only one Data Source available, the Internal DMA device database. This can be created from imported TMS device data or using a specially formatted CSV file.

Future releases will include Data Sources that have been created by connecting to external sources of data such as CUCM, Active Directory or LDAP.

Device Configuration

Device Configuration is where detailed configuration managment of Cisco collaboration devices can be performed using pre-defined Templates and Cisco xAPI commands. It is also where DMA can be provided with reference information that will be used to configure the details of devices in the DMA database.

In the initial releases of DMA the Locations of devices are extracted from the TMS database and are not directly editable in DMA. In a similar way Labels are also not currently editable in DMA and of course, will not have been extracted from TMS as it doesn’t support them. There are however ways of bringing devices into DMA with Locations and Labels assigned using our CSV import features. This might be worth experimenting with in your lab environment.

Device Configuration Basics

IMPORTANT: Device Templates was a new menu item in VQCM 3.11 (DMA 1.1) and we recommend that you read VQ Conference Manager DMA - Device Templates and Template Modules’ before using the features outlined below.

Device Templates in DMA are the equivalent of the ‘Configuration Templates’ function found in the ‘Systems’ section of TMS. The primary use case for Device Templates is to ensure that standard configurations are applied to all endpoints in the environment. This ensures that critical security, performance, and capability settings are maintained.

Before creating templates, you will need to create one or more Template Modules containing the commands or configuration settings that are to be sent to the collaboration device.

Template Modules

Template Modules are a new concept unique to DMA that we have introduced with the aim to reduce the amount of work required to create, manage, and change configurations in large environments.

To begin creating modules in DMA, select the Template Modules menu item on the side bar menu:

Step 1.

Create and new module by clicking the ‘Add New’ button at the top of the page

In the Settings tab, give the module a name and description:

Step 2.

Select the Commands tab to begin adding the required xAPI configurations and commands to the module

Add commands to the module one at a time either by typing directly into the field or by copying and pasting from the xAPI reference guide:

Click ADD to write the command to the module:

To add a multiline command, tick the Multiline Command check box to activate the multiline command entry box:

Type or paste the command text into the entry box.

NOTE: You must ensure that the last line is followed by a new line with a period (fullstop) followed by another new (blank) line.

Step 3.

Once all the required commands have been added to the module you can return to the Settings tab to ‘Enable’ the module ready for use in a template:

You must click to save the commands and settings to the module.

Alternatively, you can click to store the module and return directly to the Template Modules page.

Note that if you do this the module will be created but be in a disabled state until the ‘Enable’ switch is set:

NOTE: DMA provides a direct link to the online Cisco xAPI resource website . If you are not able to access this internet resource, then PDF versions of the guide can be downloaded from here: https://www.cisco.com/c/en/us/support/collaboration-endpoints/spark-room-kit-series/products-command-reference-list.html

Device Templates

Device Templates in DMA are constructed of; template modules (containing the required commands or configurations settings), a list of devices that the template must be applied to and, if ‘persistent’ (i.e., to be re-applied regularly to the devices), have details of when this should be done.

Step 1.

Create a new Template by clicking the ‘Add New’ button at the top of the page:

The Template must be given a name and at least one template module must be selected for the Template to save:

Select the module[s] to be included in the Template using the drop-down menu:

The selected modules will be displayed in the field showing their status:

A symbol indicates that the module is enabled, and its settings will be included in the Template at run/send time. A symbol indicates that the module is currently disabled and will not be included at run/send time.

NOTE: The Template can be sent to devices in this state, but disabled modules will be ignored until enabled in the Template Modules area.

Step 2. (optional)

If the Template is to be resent on a regular schedule to devices i.e., it is ‘Persistent’ then the Persistent check box must be ticked.

NOTE: Devices can only be assigned one persistent Template in DMA to avoid potential conflicting settings be sent at different times to aTtemplate. However, it is still possible to send ‘one time’ settings to a device using a non-persistentTemplate:

The page will automatically display the Apply Time selector to begin setting time, recurrence interval, and day of week:

Once the time, recurrence and day are set the template can be saved.

NOTE: Persistent templates can be identified by the ‘chip’ displayed on pages or in lists against the Template name.

Step 3.

Once saved you will be sent back to the Device Templates page ready to begin selecting the devices that the Template will be sent to:

Locate the Template that has just been created and click on the Action‘dots’ to display the Action menu:

Select Add To Group on the Template action page to add target devices which will be displayed:

NOTE: The Template action page will alert the user to any disabled modules that will be ignored at run/send time and provide a link to identify them:

To begin adding devices to the group a filter is required to identify the required endpoints from the DMA database of devices. Click the Filters icon and the filter builder dialogue will be displayed:

Build your filter using the options presented:

The in-scope devices will be displayed on the main page. Click outside of the filter builder to see them:

Select the devices to be included in the group by either clicking the All displayed items check box, or the devices individually if not all of them are required:

Once your selection is made click the ADD button to add the device to the Template group:

And confirm the action:

DMA will confirm that the group has been successfully created:

The devices will now be displayed in the VIEW GROUP tab:

NOTE: To remove devices, click the REMOVE FROM GROUP tab and repeat the above process of filtering and selecting devices:

Step 4. (optional)

Having created a Template and adding devices to the group you may want to send it to those devices rather than waiting for the scheduled time. Alternatively, if the Template is not persistent then it will need to be sent manually to devices using this process.

Select the SEND NOW tab:

Select the devices from the group that you want to send the Template to:

And click the SEND button to execute and confirm the send action:

You will be automatically taken to the ACTIVITY tab where the status of the send action will be displayed. On completion of the send a summary of the send action results will be displayed:

In this example one device was sent the Template successfully and one failed after three retries. The failure message will identify that device that failed and provide some explanation/possible reason for the failure.

The Template send routine of DMA doesn’t currently check if an endpoint is currently in a call when sending, this will be added in a future update.

Locations

Locations in DMA can be equated to the hierarchy that was previously created in TMS using the Navigator function. The primary use case for Locations is essentially as a categorisation and filing system for your devices.

Typically organizations use location hierarchies that describe the physical and geographic locations of devices, e.g., regions, countries, states, and cities. But they might also use an organisational design that allows for clear identification of who owns a device or what it is used for, possibly in an environment where devices are not stationary.

To begin building out or adding to your hierarchy select the Locations feature from the side bar menu:

Click on the ‘Add New’ button at the top of the page to create a new top level ‘node’.

If you want to add a new ‘child’ node to an existing branch, click on the ‘Action’ dots at end of the chosen ‘parent’ node. You will be presented with a drop-down list of available actions:

Click ‘Add Node’ and you will be given a box to name the new node:

Name the new and click 'Done' to save this new node in the hierarchy.

The same operation can be used to edit an existing node, or to delete a node that is no longer in use.

Please note that to delete a node it must first be empty of other nodes and devices.

Labels

In DMA we have introduced, and new concept not seen in TMS but often seen in more modern workflow applications, Labels.

Labels are additional free text ‘tags’ that can be added to devices enabling additional groupings and identification when filtering devices for actions. In our examples we show one of the most common use cases (there are plenty of others we’re sure) we have seen…tagging ‘VIP’ devices.

Applications

Switching and launching other VQCM modules

DMA runs as a separate ‘module’ on VQCM to Meeting Scheduling & Management and Analytics (Kibana) and in many cases we expect the users to be different from those using the other modules.

For users who do use the other modules DMA has side-bar menu options for the user to launch them:

Over time this menu may also list other applications that can be launched from within DMA.

Tenants

DMA is designed to work within the existing VQCM/CMS Tenant model, meaning that for every Tenant there is in effect a DMA ‘instance’.

What this means is that Devices, Data Sources and Address Books are created ‘per Tenant’, they can only be accessed by users with permissions on that tenant and the data cannot be seen/used within another tenant.

The Service Account mentioned earlier in this guide is also specific to the Tenant, again meaning that the security model is maintained at all levels.

To create the Service Account

Log in to DMA (make sure your user has access to the Tenant) and click on the “Tenants” menu item at the bottom of the main menu bar:

You will be presented with a page listing the Tenants on the VQCM server that you are permissioned to access. Select the Tenant that you want to set up the Service Account for:

The resulting page has only two fields, Username (for the Service Account) and Password. Enter the Service Account name that you want VQ to use to communicate with endpoints and the password it will have:

NOTE: Please ensure that you use a suitably ‘strong’ password that conforms to any organization security policies. If you rotate passwords on a defined schedule, then this is where it should be updated, REMEMBERING that endpoints must also be updated with the new password.

Additional DMA Tenant information

The main side-bar menu item allows a user to switch betweenTtenants that they have been permissioned for. This feature is designed to support environments where some users of DMA are responsible for the devices of more than one Tenant:

The current Tenant is displayed in the top left of the DMA page and can be used to switch between permissioned Tenants:

User Settings

The User Settings main side-bar menu give the user access to their personal configuration settings for DMA. These currently include Language selection and Dark Mode.

This area of DMA is where we will provide other accessibility features and settings over time.