GDMS Platform – User Guide

Thank you for using Grandstream Device Management System! GDMS is a cloud-based solution that provides the ability to easily manage Grandstream products before, during, and after deployment. GDMS separates subsystems independently based on different product lines: VoIP phone systems, PBX systems, network systems, and gateway systems.

PRODUCT OVERVIEW

Feature Highlights

• Intuitive deployment and management: GDMS’s easy-to-navigate web portal and batch operation support allow users to easily deploy and manage Grandstream devices located on several sites.
• All-in-one solution: GDMS offers a complete package that offers convenient management of devices and SIP server accounts on multiple sites, real-time monitoring and alerts, task scheduling and tracking, and device diagnostics.
• Supports presetting offline devices.
• One-click debugging: Easily collect system logs, network captures, and traceroutes with a click of a button.
• Supports UCM devices’ remote management and synchronizes SIP accounts to the GDMS platform in real time. All devices/SIP account one-stop management.
• Supports value-added services – UCM Remote Management Plan in GDMS platform. Supports remote external network communication for UCM clients.
• Supports value-added services – Cloud Storage Space in GDMS platform. UCM users can store more data and do not need to worry about storage space.
• Channel customer support: Allows automatic association of Grandstream ERP devices, allowing for the establishment of channel relationships and quick device allocation.
• Powerful API integration features: GDMS is compatible with ERP/CRM/OA platforms to improve workflow efficiency.

GDMS Technical Specifications

GDMS Technical Specifications

GETTING STARTED

GDMS Overview

Main Functions Overview

For different models, users can select to use different systems in the GDMS platform.

Users can select to access the different sub-systems depending on the different managed devices models by clicking the system selection options in the left upper corner. As the screenshot shows below:

• VoIP System: Users can remotely manage IP phones such as GRP, GXP, GXV, WP, and DP models, and the system provides unified configuration, real-time monitoring, scheduling/executing tasks functions, etc.
• UCMRC System: Users can remotely manage UCM63xx devices and corresponding extensions, and the system provides remote access, monitoring, upgrade functions, etc. The UCMRC system provides a large cloud storage space, and it allows remote calls through external networks.
• GWN.Cloud: The user can remotely manage the GWN products, this includes the GWN access points, GWN routers, and GWN switches. The user can perform a wide range of tasks fully remotely such as changing the device configuration, running diagnostic tools, rebooting the devices, upgrading the firmware, backing up and restoring the configuration, etc…

Import Devices and Management

Users need to import the devices into the GDMS platform first to view the status and configuration of the devices and monitor the devices on the GDMS platform.

Channel vendors could acquire devices directly through ERP, and the channel vendors need to submit relevant certificates to Grandstream customer support.

Import SIP Accounts and Allocate to Devices

Users could import a batch of SIP accounts with Excel files, and allocate the batch of SIP accounts to devices. Users could complete all accounts configuration for all devices by importing a batch of SIP accounts to a batch of devices.

Configure Devices

• Configure devices by model: Once the device is associated with the GDMS platform, the device will be allocated with the configuration parameters according to the device model and located site.
• Configure devices by group: Manage the devices by certain rules and groups, and the GDMS supports pushing configuration files to all devices under a group.
• Configure a single device: Modify a specific device configuration in the Device list directly.
• Configure devices by configuration file: Users could upload the configuration file of the device into the GDMS platform directly.

Firmware Upgrade

GDMS platform supports upgrading a batch of devices’ firmware by device model, site, firmware version range, and other conditions. It also supports upgrading the devices’ firmware by a batch of MAC addresses of the devices.

Schedule Tasks

Users could schedule certain tasks for a certain period of time. For example, users could schedule firmware upgrade tasks and execute the task in the early morning, so that the task will not affect the device owners.

Alarm message and diagnostic

In case of malfunction or dangerous operation of the devices, the administrator will be alerted. The GDMS platform supports to allow administrators to diagnose faults of some devices to locate and resolve problems quickly.

Prerequisites

• TR-069 feature needs to be enabled on the endpoints.
• Working Internet connection to access the GDMS platform.
• Endpoint devices are in the supported device list of the GDMS platform.

GDMS Account Registration

If using GDMS for the first time, an administrator will need to register for a GDMS account using the following steps:

1. Open the GDMS platform URL on the browser: https://www.gdms.cloud

2. Click on the Sign Up option to enter the registration page, and then fill in the following information:

Register GDMS Account

3. Once registration is complete, an account activation email will be sent to the configured email address. Follow the instructions in the email to activate the account and complete registration.

Supported Devices and Requirements

The current GDMS platform version supports the following device models.

Supported Devices

Connect with GDMS

The devices must be upgraded to firmware versions that are compatible with the GDMS platform. Otherwise, the devices will not be able to connect to GDMS. When the devices connect to the Internet, and the user has added this device to the GDMS account, the device will connect to GDMS automatically.

VOIP SYSTEM

Overview

Device Statistics

The Dashboard page provides an overview of the following information:

• Total Accounts
• Total Devices
• Total Sites
• Accounts Status
• Device status
• Device Type
• Site Statistics
• Model statistics

Module	Description
Total Accounts	Displays the total number of SIP accounts configured on GDMS.
Total Devices	Displays the total number of devices configured on GDMS.
Total Sites	Displays the total number of sites configured on GDMS.
Account Status	Displays the total number of accounts currently registered, unregistered, and unallocated. Normal: All devices which use this account are registered successfully. Abnormal: The account is unregistered on a device. Unallocated: This account is not allocated to any device.
Devices Status	Displays the total number of devices currently online and offline. Online: Device and GDMS platform network connection is normal. Offline: Device and GDMS platform lose network connection.
Device type	Displays the total number of devices in each category: audio, video, and conferencing. Audio devices: GRP series, DP series, GXP series, and WP series Video devices: GXV series Conference devices: GVC series
Site Statistics	Displays the total number of devices assigned to each site and the allocation of devices per site.
Model Statistics	Displays the total number of each device model, the percentage of total devices that each model makes up, and the distribution of different firmware per model.

Device Distribution

This menu will show the distribution map of the devices which have been associated with the enterprise.

• The dark blue area on the map shows that area has more associated devices, and the light blue area shows the area has fewer devices.
• Users could leave the cursor on the area to check the number of devices in that area.
• If a certain city has the devices, it will be marked with a green dot , and users could leave the cursor on the city to check the number of devices in that city. The user can click on the dot to see the devices list in this city.

Overview

The Overview page displays all VoIP devices statistics information in the current organization.

Account Management

Overview

On the SIP Account page, users can manage SIP accounts across all configured SIP servers in GDMS, import a list of accounts for quick setup, and export a list of all accounts configured on GDMS.

Account Status Description

Operation	Description
Sorting	Click on the buttons to sort the list in ascending/descending order based on a specific column.
Custom Display Option	Users could customize the displaying options on the list by clicking on option on the right side of the list to select the displayed/hidden options.
Filter and Search	Filter accounts by status, site, and search for specific accounts by entering their user IDs, account names, or display names.

Add SIP Server

The SIP Server page shows all of the SIP servers added to GDMS.

Server Name	Specifies an identity name for the SIP server. (Required)
SIP Server	This is a necessary option. Specifies the URL or IP address, and port of the SIP server. This should be provided by the VoIP service provider (ITSP).
Outbound Proxy	Configures the IP address or the domain name of the primary outbound proxy, media gateway, or session border controller. It is used by the phone for firewall or NAT penetration in different network environments. If a symmetric NAT is detected, STUN will not work and only an outbound proxy can provide a solution.
Secondary Outbound Proxy	Sets the IP address or domain name of the secondary outbound proxy, media gateway, or session border controller. The phone system will try to connect the Secondary outbound proxy only if the primary outbound proxy fails.
Voice Mail Access Number	Sets if the phone system allows users to access the voice messages by pressing the MESSAGE key on the phone. This ID is usually the VM portal access number. For example, in UCM6xxx IPPBX, *97 could be used.
DNS Mode	Defines which DNS service will be used to look up the IP address for the SIP server’s hostname. There are three modes: A Record SRV NATPTR/SRV To locate the server by DNS SRV set this option to “SRV” or “NATPTR/SRV”.
NAT Traversal	Specifies which NAT traversal mechanism will be enabled on the phone system. It can be selected from the dropdown list: NAT NO STUN Keep-alive UPnP Auto VPN If the outbound proxy is configured and used, it can be set to “NAT NO”. If set to “STUN” and the STUN server is configured, the phone system will periodically send a STUN message to the STUN server to get the public IP address of its NAT environment and keep the NAT port open. STUN will not work if the NAT is a symmetric type. If set to “Keep-alive”, the phone system will send the STUN packets to maintain the connection that is first established during the registration of the phone. The “Keep-alive” packets will fool the NAT device into keeping the connection open and this allows the host server to send SIP requests directly to the registered phone. If it needs to use OpenVPN to connect to the host server, it needs to set it to “VPN”. If the firewall and the SIP device behind the firewall are both able to use UPnP, it can be set to “UPnP”. Both parties will negotiate to use of which port to allow SIP through.
Proxy-Require	Adds the Proxy-Required header in the SIP message. It is used to indicate proxy-sensitive features that must be supported by the proxy. Do not configure this parameter unless this feature is supported on the SIP server.
Additional Settings	Users could add the custom fields below. Some custom fields are only available for certain device models: Secondary SIP Server Failover SIP Server Prefer Primary SIP Server Primary IP Backup IP 1 Backup IP 2 DNS SRV Failover Mode Use NAT IP SIP Diff-Serv RTP Diff-Serv Tel URI For detailed filling rules, please refer to the User Guide of the devices.

Upon adding the SIP server, it will appear in the SIP Server list. Entries in the list can be edited or deleted.

Add SIP Account

The SIP Account page shows all of the SIP accounts added to GDMS.

Allocate to Devices:

To associate devices currently in GDMS with the new SIP account, click on the Add button at the bottom of the screen and enter the following information:

Batch Import SIP Account

GDMS platform supports to allow users to import a batch of SIP accounts and SIP servers to the system and allocates them to the devices via Excel files.

1. On the SIP Account page, click on the Import Account button. The following window will appear:

2. Click on either the Download General Device Template button, Download DP Device Template, or Download HT Device Template button to get a template that will be used to import account and server information.

Account Name	This is an optional option. Users need to set the identity name for the SIP account.
SIP Server	This is a necessary option. Users need to input the SIP server address. If the SIP server does not exist in the GDMS platform, the GDMS platform will create the SIP server in the system.
SIP User ID	This is a necessary option. Configures user account information provided by your VoIP service provider (ITSP). It is usually in the form of digits similar to a phone number or actually a phone number.
SIP Authentication ID	This is a necessary option. Configures the SIP service subscriber’s Authenticate ID used for authentication. It can be identical to or different from the SIP User ID.
SIP Authentication Password	This is a necessary option. Configures the account password required for the phone to authenticate with the ITSP (SIP) server before the account can be registered. After saving, it will appear as hidden for security purposes.
Display Name	Configure the display name of the SIP account. This option will be used for Caller ID display. The configured content will be included in the From, Contact, and P-Preferred-Identity headers of the SIP INVITE message.
Device MAC Address	Input the device MAC address: e.g. 00-15-65-1A-2B-3C; 00:15:65:1a:2b:3c; 0015651a2B3c
Account Index	Users need to select the account index to which the account will be allocated (e.g. Account 1 – Account 16). If the current account location has a configured account, the configured account will be replaced with the new account information.
Profile	For DP devices and HT devices only. Enter the profile that the account will use (e.g. Profile1, Profile2, etc.). If multiple different SIP servers use the same profile, the import will fail.
HS Mode	For DP devices only. Enter the HS mode for the account. Available options are “Circular”, “Linear”, “Parallel”, and “HSx”, where x can be 1 to 5.
HS1-HS5	For DP devices only. Users could configure the Line for each handset from Line 1 to Line 10. Each SIP account can be allocated to different handsets.
Port Type (FXS/FXO)	This option is valid only for HT devices. Input the port type which will be assigned to the device. Users could select FXO port type or FXS port type.
Port Serial Number	This option is valid only for HT devices. Input the port serial number which will be assigned to the device. Users could input the port serial number from Port 1 to Port 10.
Search Group	This option is valid only for HT devices. Users could select the search group between None (default), Active, and other port serial numbers beside their own.

3. Once the template is filled out, drag, and drop the file to the upload window or select the file from your PC. Click on the Import button to confirm the import.
4. When the Excel file is imported into the GDMS platform successfully, the GDMS platform will prompt the execution result. If there is data that failed to be imported, the user could export the failed data and re-edit the Excel file.

Examples:

1. If the user wants to allocate 1 SIP account to multiple devices, the 1^st SIP account information will be the correct information to allocate to the devices. Please see the example below, the SIP account display name “Sqhuang” will be allocated to the involved devices:

2. For the existing SIP account, if the user wants to allocate this SIP account to another device, here is the example: Account 100 has been allocated to Device 1, and the user wants to allocate the SIP account 100 to Device 2 (00:0b:82:cc:dd:ee).

3. If the user wants to allocate multiple SIP accounts to a single device, here is an example:

4. If the user wants to allocate multiple SIP accounts to a single DP device, here is an example:

Incorrect examples:

1. If the user wants to allocate multiple SIP accounts to a single device, the account index cannot be the same.

2. Different SIP server addresses cannot be allocated to the same Profile in the same DP device.

3. If the user wants to allocate the SIP accounts to the same DP device, the different SIP accounts cannot be allocated to the same HS Line.

Allocate Device

Users could allocate the SIP accounts to the devices during adding SIP accounts, editing SIP accounts, or importing a batch of SIP accounts to the GDMS platform. Each SIP account can be allocated to multiple devices.

Edit Account

Users could edit the SIP account information and allocated devices on the Edit Account configuration page.

1. Click on the button for the SIP account you want to modify.

2. Click on the Save button to finalize changes. All associated devices will receive the updated account information.
3. Click on the button to unallocated devices from the account. The SIP account will be removed from unassigned devices.

Batch Modify SIP Server of SIP Accounts

Users can batch modify the SIP server of the SIP accounts, e.g. Modify the SIP protocol of the SIP server from UDP to TCP.

1. On the “SIP Account” interface, select the SIP accounts that need to be modified.

2. Click on the “Modify SIP Server” button at the top of the interface.
3. Select the target SIP server, which can be searched by the server name.

4. After clicking the “OK” button, the SIP server corresponding to the SIP accounts will be modified immediately. Then, the updated account information will be assigned to the corresponding VOIP devices.

Delete Account

To delete SIP accounts on GDMS, click on the button for a single account or the Delete button in the top-left corner for multiple accounts. Associated devices will automatically remove deleted SIP account information.

Users could delete 1 single SIP account or a batch of SIP accounts on the GDMS platform:

Export Account

Users can export all existing SIP accounts in GDMS to a file by clicking on the Export Account button in the top-right corner of the SIP Account page.

Edit SIP Server

Users can edit SIP server information by clicking on the button for the desired SIP server. Changes to the server will affect all associated SIP accounts.

Delete SIP Server

Users can delete selected SIP servers by selecting them in the SIP server list and clicking on the Delete button in the top left corner of the SIP Server page.

VoIP Device Management

The Device page shows all the associated VOIP devices. Users can view the information and status of the devices, the allocated account information, etc. GDMS platform supports to allow users to configure parameters, upgrade firmware, reboot/factory reset devices, view device details, device diagnostics, and other operations.

Status	Description
Status Indicator	The device is offline. The current account status is the last reported status before the device is offline. The device is online. The device network penetration (NAT) is abnormal, the GDMS server cannot connect to the device, but the device can periodically obtain the configuration.
Account Status	Normal: The allocated accounts from the GDMS platform to the devices are registered successfully, and all accounts can be used normally. When an account is registered normally, the extension number will be displayed. Abnormal: Some of the device’s allocated accounts are unregistered. This may be due to the following reasons: The account is not activated. The account registration credentials are incorrect. The account was modified on the device. No Account: GDMS platform does not allocate any account to the device.
Last Config Time	Synchronizing: If the account and device parameters were modified, the changes will immediately be pushed to the device. This status will be shown while this is happening. Date/Time: The date and time of the last successful provisioning.
Call Status	Idle: The SIP account is in an idle state. Busy: The SIP account is on a call.
HS Status	The SIP account is configured on the handset. The SIP account is not configured on the handset.

Operation	Description
Sorting	Click on the sorting buttons to sort the list by various columns in ascending/descending order.
Custom Display Option	Click on the button on the top right corner of the list to select the columns to show and/or hide.
Search	In addition to being able to search for devices with the search bar near the top-right corner of the page, users can further refine search results by clicking on the Filter button by specifying account status, device status, site, city, and firmware version.

Add VoIP Device

To add a new device to GDMS, click on the Add Device button. The following window will appear:

Add VoIP Device

Batch Import VoIP Devices

Users can import multiple devices by uploading a file. Click on the Import Devices button on the Device page to get started. The following window will appear:

1. Click on the button to download the template. Users must follow the instructions to enter the required information.

2. The template will have the following fields:

Import VoIP Device Template

3. Users can drag the file to the pop-up window, or they can click the upload button to select a file from their PC to import.
4. Once the file is imported into GDMS, the result window will appear. If any data failed to import successfully, users can export the problematic data, re-edit, and attempt to import them into GDMS again.
5. The user can choose to sync the devices’ configuration by enabling “Sync Configuration”. Once that is enabled, the local configuration and SIP accounts will be synchronized to the GDMS.

Configure SIP Account (Non-DP Devices)

Users can configure SIP accounts for each device from the Device page.

1. In the devices list, click on the icon corresponding to the account to access the Account configuration page.
2. After clicking the button, users will see the Account configuration page as the figure shows below:

3. On this Account Configuration page, users can select the SIP accounts created on the SIP Account page to assign to the device.
4. Users could also select to replace the existing SIP account with a specific account or delete the existing accounts.
5. Click on the Save and Apply button. The accounts will then be assigned to the device.

Configure SIP Account/Line (DP Devices)

Users could configure SIP accounts and lines for DP devices. GDMS platform supports to allow users to view the existing SIP accounts for current devices and edit/delete the accounts.

1. In the devices list, click on the icon corresponding to the account to access the Account configuration page.
2. After clicking the button, users will see the figure as shown below:

User ID	Allocated: This SIP account has already been allocated to other devices; Unallocated: This SIP account has not been allocated to any device.
Profile	Different SIP servers cannot be set to the same profile.
HS Mode	If this field is not filled, the default setting is “Circular” mode.

3. To configure the lines for each HS mode, click on the Line Configuration tab.

4. Select the desired SIP accounts to use for each line and handset.
5. Click on the button Save and Apply to allocate the SIP accounts or lines to the devices.

Device Parameters Configuration

Users can modify the configuration parameters for a single device.

1. In the device list, click on the button to go to the Device Parameters Configuration page, as shown in the figure below:

• Clicking on the Select All button will select every option on the current page. Clicking on it again will deselect all the options.

• Clicking on the Reset Settings button will restore all settings on the current page to default values.

• Clicking on the button following the account, users can copy and paste the current account configuration to other accounts.

• When users try to configure the device wallpaper or screensaver image, users can select a picture from the resources list, or upload the local picture to GDMS and configure it to the device.

2. Modify the desired settings on the page or click on the Switch to GUI Editor to configure device settings via text editing (i.e. p-values).

• The format requirement is key=value. The key can be either a P-value or an alias.
• Users can enter the latest parameters and values of a device in the text editor even if the GDMS configuration page does not display the configuration options.

3. Click on the Save and Apply button to finalize changes. Only settings that are checked will be pushed to the device.

MPK Stickers Printing

Certian Grandstream IP phones have a MPK sticker placement (GRP2604, GRP2634, GRP2636, GXP2130, GXP2160) to label the MPKs as the user desires. GDMS offers a way to print the stickers when configuring the devices.

You can select whether to pring the background color, whether to display the border, or whether to print repeatedly on the A4 paper.

When the user prints MPK sticker repeatedly on an A4 paper, it will be displayed as following.

If you want to print on the native sticker provided with the IP phone unit. Please refer to the following video: https://v.youku.com/v_show/id_XNDc3MDczOTIwOA==.html

Upgrade The Firmware

You can select the firmware path from the existing firmware resource list or directly upload your firmware file by clicking the “Upload” button following the option. Please refer to the screenshot below.

Configure Resource Files

Users can configure custom ringtones and languages for devices (Supported models: GXP/DP series).

1. On the Device list, click on the button to go to the Device Parameters Configuration 🡪 Resource Configuration page, as shown in the figure below:

2. On the “Custom Ringtone” page, for Ringtone 1 to Ringtone N, select a ringtone file from the resources for each ringtone index.
3. On the “Language Configuration” page, select a language pack from the resources for the device.
4. Click on the “Save and Apply” button, the device will download the selected resources from the firmware path.

Synchronize Device Local Configuration

Before the device is configured, the user can synchronize the device’s local configuration to the GDMS server.

1. Select a specific device, click icon and select the option “Synchronize Device Local Configuration”.
2. Click “OK” to confirm synchronization on the pop-up window. Then, the GDMS server will synchronize all the account configurations and parameters of the current device to the GDMS server.
3. Enable Sync SIP Account if you wish to have your SIP accounts synchronized to the GDMS.

Disable Push Configuration

If the user does not want to push any configuration to the device through the GDMS server, please follow the steps below:

1. Select a specific device, click icon and select the option “Disable Push Configuration”.
2. Click “OK” to confirm the operation, the account configuration or parameters will not be pushed to the device through the GDMS server anymore, including the scheduled tasks. The configuration that has not been pushed to the device will not be pushed to the device anymore.

View VoIP Device Details

Click on the button to view a specific device’s system information and account status.

System Information

The device details include System information, Network information, Account status, etc.

Account Status

Energy Saving Inform (GRP Series Only)

If you are viewing the detail of a GRP series IP phone, an additional tab will appear Energy Saving Inform. This tab contains information about your GRP device power usage. It provides information about which Energy Saving Mode has been configured on your device, the percentage of the energy saved, whether Deep Energy Saving has been enabled, and information about when the Energy Saving has been enabled with all the related information of how much energy has been saved and how long the phone has been operational under energy saving mode.

Edit VoIP Device

Users could edit the Device name and which site the device belongs to.

1. In the device list, click on the button which is following the device, and select Edit Device to access the device editing page.

2. Users will see the device editing page as the figure shows below:

3. Click on the Save button to apply the changes on the GDMS platform.

View VoIP Device Operation Logs

Users could view all operation logs for a specific device on the GDMS platform.

1. On the Device List, select the menu button following the specific device, and click on the “Operation Log” button.
2. Access to the Operation Log menu of the device, the menu includes the operation logs of device SIP account configuration, updating configuration parameters, device rebooting, device upgrading/downgrading, device factory reset, device diagnostics, etc.

Note:

Users could only view the device operation logs for the last 30 days.

View VoIP Device Task History

Users could view all task histories in the sub-system for a specific device on the GDMS platform, including immediate tasks and timed tasks.

1. On the Device List, select the menu button following the specific device, and click on the “Task History” button.
2. Access the Task management page, and search for all tasks of the specific device.

Firmware Upgrade

Users could upgrade firmware for a batch of devices to a specific firmware version.

1. In the device list, check multiple devices, and then click on the button Upgrade Firmware on the top of the Device page.

2. Users need to select the firmware version to upgrade to.
3. Task Time: Select when to start the firmware upgrade. Users can choose to upgrade immediately or to schedule the firmware upgrade for a specific time.
4. Click on the Save button to create the task. Users can check the status of the upgrade by navigating to the Task Management page.

Site Assignment

Users could edit the site of a batch of devices on the GDMS platform. The default site is “default”.

1. Select the desired devices and click on the Site Assignment button.

2. Select the site to assign the selected devices.
3. Click on the Save button, and all selected devices will be transferred to the selected site.

Move Device

Users can move devices to other organizations.

1. Select the desired devices and click on More 🡪 Move Device.

2. Select the target organization where to transfer the device.
3. The user needs to select whether to clone the SIP account and server which have been configured in the devices. If the user selects “No”, only the device data are transferred to the new organization, and the configured SIP accounts become empty after moving the devices.

Assign RPS

To assign an RPS to the devices, please click on and pick an RPS from the list, then select the devices to configure with the selected RPS.

If no RPS has been created, please refer to RPS Management section.

Remote Access to Device Web UI

On the GDMS platform interface, even though the VoIP device is under the internal network, the user can remote access the VOIP device Web UI through the external network for viewing data and configuration.

1. Go to the VoIP Device interface, click the “More” settings for a VoIP device 🡪 Remote access to Device Web UI, as the screenshot shows below:

2. Go to the Web UI, and log in to the VoIP device through the username and password. As the screenshot shows below:

Remote Access to Device Interface

The user can remote access Grandstream devices using the GDMS. This can be performed even if the device is behind a NAT router, and the user will be able to view the screen of the device.

1. Go to VoIP Device interface, click the “More” settings for a VoIP device 🡪 Remote access to Device Interface, as the screenshot shows below:

2. Enter the virtual device interface, the user can control the virtual buttons on the device and the LCD screen, as the screenshot shows below:

Reboot VoIP Device

Users could reboot one device or a batch of devices on the GDMS platform.

1. Select the desired devices and click on More 🡪 Reboot Device.

2. Task Time: Select when to start the device reboot. Users can choose to reboot immediately or schedule the reboot for a specific time.
3. Click on the Save button to create the task. Users can check the status of the reboot by navigating to the Task Management page.

Factory Reset

Users could factory reset one device or a batch of devices on the GDMS platform.

1. Select the desired devices and click on More 🡪 Factory Reset.

2. Task Time: Select when to factory reset the device. Users can choose to factory reset the device immediately or to schedule the factory reset for a specific time.
3. Click on the Save button to create the task. Users can check the status of the reboot by navigating to the Task Management page.

Delete VoIP Device

Users could delete one device or a batch of devices on the GDMS platform.

1. Select the desired devices and click on More 🡪 Delete.

2. Click on the OK button on the pop-up window to confirm deleting the devices, and the selected devices will be deleted immediately from the GDMS platform. The scheduled tasks involving the deleted devices will be canceled too.

Export VoIP Device

To export the entire device list, click on the button in the top-right corner of the device list page. The exported list includes all device and account information.

Manage Device via GDMS Support

If the user’s device is abnormal and wants Grandstream Support to troubleshoot the problem, the user can enable to manage the device through GDMS Support.

After the authorization is assigned, Grandstream Support can diagnose the device and assign parameters to the device.

1. On the VoIP Device list, click the “More” button following the device and select to access the “Authorization Management” interface, as the screenshot shows below:

2. Enter the authorization duration, which can be set between 1 to 9999 minutes, according to the time required for problem troubleshooting.
3. Tick “Grant SSH Access” box to grant access using SSH, then enter the username and password of the VoIP endpoint device SSH information.
4. Once the user clicks the “Authorization” button, Grandstream Support can only manage the device within the authorization period. Once the authorization period ends, Grandstream Support cannot manage the device.

Stop Authorizing Manually

1. When the problem is confirmed, the user can end authorization manually. The user can click the “More” button following the device, and select to access the “Authorization Management” interface, as the screenshot shows below:

2. The user can click the “Stop Authorizing” button to stop managing the device immediately, and then Grandstream Support cannot manage the device.

UCMRC SYSTEM

Dashboard

Device Statistics

The Device Statistics page provides an overview of the following information:

• Total Devices
• Alert Management
• VoIP Device Status
• VoIP Device Type
• UCM Real-time Status

Module	Description
Total	UCM Device: Display the number of all UCM devices in the enterprise. VOIP Device: Display the number of VoIP devices that use the UCM extensions in the enterprise. Total Extensions: Display the number of extensions reported by all UCM devices in the enterprise.
Alert	Display the latest 5 high and medium-level alert messages of the UCM devices in the GDMS platform.
VoIP Device Status	Display the number of devices that are currently online, offline, and network restricted: Online: The network connection between the device and the GDMS platform is normal. Offline: The device is disconnected from the GDMS platform. Network Restricted: The network connection between the device and the GDMS platform is abnormal.
VoIP Device Type	Display the number of devices in each category: audio and video. Audio devices: GRP series, DP series, GXP series, and WP series Video devices: GXV series
UCM Real-time Status	Display the real-time status of all UCM devices in the current GDMS platform: Device: Display the MAC address of the device. Resource Usage: Display the usage of CPU and memory. Current Calls: Display the number of current calls and the remote calls. Current Meetings: Display the number of ongoing meetings. SIP Extension Status: Display the number of the extensions which have been registered and unregistered. Connected Interface: Display the names of the connected interfaces. Trunk: Display the number of total trunks, the number of trunks in idle/busy/abnormal state, and the number of trunks that are unmonitored. UCMRC Plan: Display the status of the UCMRC plans which are valid, almost expired, and expired. Storage Space: Display the storage space details of UCM local and cloud space usage. Note: Only UCM devices firmware version 1.0.11.X or higher version support displaying the real-time status.

UCM Device Statistics

When clicking one of the UCM devices added to the GDMS platform, the user will see an overview of the following information, Extension Status, VoIP Device Status, Sever Address, Call Statistics, Alerts, UCM Device Status, and Number of Registered Users.

Call Statistics

The Call Statistics module displays all UCM devices’ call statistics information in the current system.

The user can select up to 3 UCM devices at one time to view the call statistics information in the latest 7/30 days.

The call statistics information contents include the number of total calls, the number of total remote calls, and the number of maximum concurrent remote calls.

Device List

The Device List module displays all devices listed in the UCMRC system of the current enterprise account, including the VoIP devices and PBX devices. Users can search devices by the MAC addresses of the devices.

Overview

The Overview module displays the overview information of each organization, including the Device Statistics and Call Statistics.

Device Statistics

This module displays the same information in the UCMRC system 🡪 Dashboard 🡪 Device Statistics.

Call Statistics

This module displays the same information in the UCMRC system 🡪 Dashboard 🡪 Call Statistics.

Extension

The module displays the extension information of all UCM devices in the selected organization.

If the extensions in the UCM device have not been synchronized to the GDMS platform yet, the user can click to view the UCM devices which have not synchronized the extensions and the corresponding reasons on the GDMS platform. Please see the screenshot below:

Edit Extension in UCM Web UI

The user can click button to access the UCM device Web UI to edit the extensions. As the screenshot shows below:

Assign Account

The user can click button to assign accounts to the VoIP devices in the current system.

Delete Account

Users can delete one or multiple extensions in this module.

1. Select an extension to delete, click button or button to delete the extension. The user can select to delete one extension or select multiple extensions to batch delete the extensions.
2. Click on the “OK” button, the deleted extensions will be disassociated from the corresponding UCM devices.

Modify SIP Server

Users can modify the SIP server of one or multiple extensions in this module.

1. Select the extension that the user wants to modify the SIP server.
2. Click on button and select the new preferred SIP server.
3. Click on the “OK” button to apply the changes. Once the SIP server is modified, the new SIP server settings will be assigned to the associated device.

Export Extension

Users can click the “Export Extension” button on the right upper corner of the Extension module to export the extensions in the current enterprise in the GDMS platform.

UCM Device Management

The UCM Device menu shows all associated UCM devices. Users can view the firmware version numbers, IP addresses, plans, and other information of the UCM devices. It also allows users to access the device, upgrade firmware, reboot the devices remotely, etc.

Status	Description
Status indicator	The device is offline. The device is online. The device network penetration (NAT) is abnormal, the GDMS server cannot connect to the device, but the device can periodically execute
Firmware version too low	This icon indicates device firmware version too low and the device cannot be used normally with GDMS.
Plan expiring	This indicator means the plan is expiring soon or already expired.

Operation	Description
Sorting	Click on the sorting buttons to sort the list by various columns in ascending/descending order.
Custom Display Option	Click on the button on the top right corner of the list to select the columns to show and/or hide.
Search	In addition to being able to search for devices with the search bar near the top-right corner of the page, users can further refine search results by clicking on the Filter button by specifying device status, site, city, and firmware version.

Add UCM Device

To add a new UCM device to the GDMS platform, users can click on the Add Device button. Please see the screenshot below:

Add UCM Device

After clicking the “Save” button, the device will be added to the GDMS platform successfully, and the user can apply for a UCMRC advanced plan free trial for this device

Batch Import UCM Devices

Users can import multiple devices by uploading a file. Click on the Import Devices button on the Device page to get started. The following window will appear:

• Click on the button to download the template. Users must follow the instructions to enter the required information.
• The template will have the following fields:

Import UCM Device Template

• Users can drag the file to the pop-up window, or they can click the upload button to select a file from their PC to import.
• Once the file is imported into GDMS, the result window will appear. If any data failed to import successfully, users can export the problematic data, re-edit, and attempt to import them into GDMS again.

View UCM Device Details

Click on the button to view a specific device’s system information.

In the UCMRC system, the user can quickly view all SIP server addresses in the Device List. For a certain SIP server address, the user can quickly view the advanced settings of the SIP server, including all advanced settings of the SIP server in the VoIP system.

The device details include System information, Network information, etc.

The device details include System information, Network information, etc.

View Device Plan

Select the plan for a specific UCM device to view the plan of the device, expiration date, currently used cloud storage space, and total cloud storage space.

Access Server	This is used to configure Wave phones so that Wave users can connect to the UCM server and make calls at any time, anywhere on any network. If the user wants to configure the remote service address on the terminals for remote calls, the user can enable the button and obtain the remote service address.
Storage Space	Refer to the current storage space used by the UCM device, and the total storage space of the UCM device. If there is not enough space, the backup files cannot be stored. The used storage space contains: – l  Used storage space by cloud storage (excluding the space allocated to the Cloud IM service) – The maximum storage space allocated to the Cloud IM service
Device Plan	Refer to the current plan and add-on plan of the device. If the plan has expired, the user can only use the Basic plan as the current plan.

After adding the device to the GDMS platform, the user can apply for a UCMRC advanced plan free trial for 3 months by clicking the button.

1. After the paid plan expires, it will be downgraded to the “Basic” plan and the UCM630x device will permanently stay on the Basic plan until the user decides to upgrade it.

On the UCM Device -> Plan -> Expand the drop-down menu, users can view the information of “Device Original Plan” displayed on the interface. Please see the screenshot below:

2. After the paid plan expires, the user can go to the “My Plans” menu and move the cursor to the corresponding tip, the user will see the notification “After the previous plan expires, your UCM device can always use the Basic plan for free.”

We also updated the option “Order History” on the right upper corner to “My Plans”.

3. If the user cannot contact the dealer in the process of purchasing the plan, the user can click the “Help” button and fill in the relevant information. Then, we will send an email to the authorized distributor and the authorized distributor will contact the user as soon as possible.

4. Then, a form will appear for the user to fill in the necessary information.

Remote Access to UCM Web UI

On the GDMS platform interface, even though the UCM is under the internal network, the user can remotely access the UCM Web UI through the external network for viewing data and configuration.

Prerequisite: UCM device firmware version must be later than 1.0.15.1

1. Go to Device Management 🡪 UCM Device interface, click on the button of the specific UCM device, as the screenshot shows below:

2. Go to the UCM Web UI, and log in to the UCM device through the username and password, as the screenshot shows below:

3. After logging in, the user can operate this UCM remotely by accessing the UCM device under the local network, as the screenshot shows below:

Notes:

• Users do not need to configure the external network for UCM devices and access the UCM devices with encryption through the GDMS platform. However, the network environment of the UCM devices is allowed access through external networks.
• Users can assign permission that remote access to UCM Web UI without entering a password. Once the permission is assigned, the user can remotely access the UCM Web UI through the GDMS platform without entering the UCM password.

UCM Device Diagnosis

On the UCM Device list, users can click the Diagnosis button following the UCM device to diagnose the UCM device, including UCMRC Connection, Ping/Traceroute, Syslog, Capture Trace, Network Diagnostics, and System Status.

If the UCM device which is using the UCMRC services has any problems, the user can diagnose the UCM device and troubleshoot the problems remotely. The user can try to fix the problems based on the suggestions and click on the “Feedback” button to send the logs and descriptions to our technical support.

View Statistics

Daily Report

Prerequisite: The UCM plan contains permission for this function.

The UCM device collects the data report of the day and sends it to the GDMS user or the configured email box.

Please refer to the screenshot below for the daily report email:

View Statistics Report (Last 30 days)

Prerequisite: The UCM plan contains permission for this function.

1. Go to the Device Management 🡪 UCM Device interface, click on the button of the specific UCM device, and select the “Statistics Report” menu.
2. Users can only view the statistics report for the last 30 days. The reports will be sorted by the local time zone of the UCM devices, as the screenshot shows below:

3. Click on the button to view the type and amount of the connected device on the current day to the UCM device:

4. Click on button to view the call type statistics of the current day:

5. Click on button to view chart statistics of the number/type of calls in the last 7 days or last 30 days, as the screenshot shows below:

Set Daily Report Receiving Mailbox

Prerequisite: The UCM plan contains permission for this function.

GDMS platform will send a daily report email of the UCM device every day. Click on the button on the UCM Device 🡪 Statistics Report interface to configure the email-receiving mailbox, as the screenshot shows below:

Daily Email Notification	This is used to configure whether the user wants to send the daily report to the mailbox every day. If not, no mail notification will be sent, and users can view the statistics report on the GDMS platform.
Time Zone	This is used to set the time zone of the daily report.
Send Time	This is used to set the sending time of the daily report.
Repeating	This is used to set the repeating sending time of the statistical report. Once this configuration is set, the statistical report will be sent to the configured email box periodically.
Receiving Email Address	Supports entering any email address. Users can click “Add Email Address” to add multiple email addresses to receive the daily report.

View Operation Logs

Prerequisite: The UCM plan contains permission for this function.

Users can view all operation logs on the GDMS platform for the UCM devices.

1. On the UCM Device List, select the menu button following the specific device, and click on the “Operation Log” button.
2. Operation logs include Remote accessing UCM Web UI logs, restarting logs, and firmware upgrading logs.

Custom Remote Access Domain Name

Remote Access Domain Name is used to configure the Wave application so that Wave application can connect to the UCM server and make calls at any time, anywhere under any network environment.

Prerequisite: The UCM plan contains permission for this function.

You can also customize your domain to access Wave Web RTC page/ UCM portal.

1. Go to Device Management 🡪 UCM Device interface, click the Edit Device option for the specific UCM device, and access to the “Device Edit” menu.
2. If the user wants to configure this address on the soft terminals for remote calls, the user can click the button  and customize the remote domain address. Please see the screenshot below:

3. Click on the “Personal URL” field, and enter the preferred URL, such as {yourdomain}.zoneb.gdms.cloud

4. If the plan has a custom domain name function, the user can click on the “Custom Domain” option and enter the server address with the private domain name, and the user also needs to enter the custom certificate of the domain name.

5. If the user needs to modify the information, the user can click on the button to add a new custom server address.

6. Click on the “Save” button to apply the settings. Then, both the default server address and the new custom server address can be used.

Synchronize UCM Device Alert to GDMS

Only the advanced UCM Remote Control plans support synchronizing UCM device alerts to the GDMS platform. For UCM Remote Control plans details, please refer to our official website.

1. Users need to enable UCM alert notifications on the management platform of the UCM device. For details, please refer to the UCM User Guide on the UCM product page.
2. The alerts generated in the UCM device will be synchronized to the GDMS platform.
3. Users can view all UCM alert notifications in the GDMS platform, and set the alert notification methods: Email Notification, Message Notification, or SMS Notification.

Reboot Device

Users can reboot UCM devices from GDMS instantly or set up a schedule to reboot the UCM devices.

1. Select a UCM device from the GDMS 🡪 Device 🡪 UCM Device page, and click on “Reboot Device”. Or select multiple UCM devices by clicking More 🡪 Reboot Device.
2. The users can select to reboot the device immediately or set up a schedule to reboot the device. For a scheduled reboot, please select the start and end times of the task. Reboot will be performed during this period.

3. After saving the reboot configuration, users can view the status of this task from the GDMS 🡪 Task page.

Upgrade Firmware

Prerequisite: The UCM plan contains permission for this function.

Upgrading UCM firmware via GDMS is supported. Please note there must have UCM official firmware or customized firmware available on the GDMS platform first.

1. Select a UCM device from GDMS 🡪 Device 🡪 UCM Device and click on “Upgrade Firmware” as shown in the below picture. Users can also select multiple UCM devices and then click on “Upgrade Firmware” to perform a batch upgrade for all selected UCMs.

2. Select upgrade immediately or set up a schedule to perform the upgrade. For scheduled upgrades, please select the start and end times of the task. Upgrade will be performed during this period.

3. Save the configuration. Then the users can view the task status under the GDMS Task page.

Edit Device

Users could edit the UCM Device name and which site the device belongs to.

1. In the device list, click on the button to Edit Device to access the device editing page.

2. Users will see the device editing page as the figure shows below:

3. If the plan has the custom server address function, the user can click “Personal URL”; If the plan has permission to custom private domain name function, the user can click on the “Custom Domain” option to configure it.
4. Click on the “Save” button to apply the changes on the GDMS platform.

UCMRC Settings

Prerequisite: The user has the corresponding UCMRC plan including this function.

The user can remotely access the PBX device to set the plan of the UCMRC service.

1. In the UCM Device list, the user can select the UCM device which the user prefers to access and click button to set the UCM device.

2. After clicking the UCMRC Settings button, the user will be directed to the UCM Web UI remotely.
3. The user will be directed to the UCM Web UI 🡪 UCM RemoteConnect 🡪 Plan Settings interface. As the screenshot shows below:

Custom Enterprise Logo

Prerequisite: The user has the corresponding UCMRC plan including this function.

The user can remotely access the UCM device Web UI to customize the enterprise logo.

1. In the UCM Device list, the user can select the UCM device which the user prefers to customize the logo and click button to access the UCM Web UI.

2. After clicking the custom logo button, the user will be directed to the UCM device Web UI.
3. The user will be directed to the UCM Web UI 🡪 UCM RemoteConnect 🡪 Custom Logo to customize the enterprise logo. As the screenshot shows below:

Back up UCM Data

Prerequisite: The user has the corresponding UCMRC plan including this function.

The user can remotely access the UCM device to enable the UCM data backup function.

1. On the UCM Devices list, the user can select the UCM device, click the button  to access the UCM Web UI, and set the UCM data backup function for the GDMS platform account.

2. After clicking the UCM data backup button, the user will be directed to the UCM device Web UI.

3. The user will be directed to the UCM Web UI, RemoteConnect → Plan Settings → Storage & Backup interface and set to back up the UCM data to the GDMS platform account. Please see the screenshot below:

Batch Modify Sites

Users could edit the site of a batch of UCM devices on the GDMS platform. The default site is “default”.

1. Select the desired devices and click on the ”Site Assignment” button.

2. Select the site to assign the selected devices.
3. Click on the” Save“ button, and all selected devices will be transferred to the selected site.

View/Disassociate Host/Spare UCM Device

Prerequisite: The user has the corresponding UCMRC plan including this function.

Users can view Host/Spare UCM devices in the UCM devices list, the Host/Spare icon will be marked following the MAC address, and users can view the corresponding MAC address of the Host/Spare devices.

When the Host/Spare association is established, and once the Host UCM server is down, the Spare UCM device can still get connected through the Host UCM device’s UCMRC domain name.

The user can click “Remove Relationship” to remove the UCMRC Host/Spare relationship. However, the local Host/Spare relationship configuration in the UCM devices is still retained. If the user also wants to remove this relationship, the user needs to go to the UCM management platform to disassociate the relationship.

Delete Device

Users could delete one UCM device or a batch of UCM devices on the GDMS platform.

1. Select the desired devices and click on More 🡪 Delete.
2. Select a UCM device from GDMS 🡪 Device 🡪 UCM Device and click on “Delete Device”. Users can also select multiple UCM devices and then click on More 🡪 Delete to perform a batch delete for all selected UCMs.
3. Click on the” OK“ button on the pop-up window to confirm deleting the devices, and the selected devices will be deleted immediately from the GDMS platform. The timing tasks involving the deleted devices will be canceled either.

Export Device

To export the entire device list, click on the button in the top-right corner of the device list page. The exported list includes all device information.

Configure Parameter For Device

GDMS platform administrator can configure the parameters of UCM RemoteConnect for the device remotely. Once the device has been configured following the methods below, the device can use the UCM RemoteConnect functions.

Method 1:

1. GDMS platform administrator can go to VoIP Account 🡪 SIP Account interface, select the SIP accounts which will be assigned to the device, and click on the edit button to access the account editing interface:

2. Click Add Server option and select the external network server address reported by the UCM RemoteConnect.
3. Assign the SIP server to the device and enter the device MAC address and Account index, then select the SIP server of the UCM RemoteConnect.
4. Click to save and apply the changes for UCM RemoteConnect for the device.

Method 2:

Users can select multiple SIP accounts, click the “Modify SIP Server” option on the top of the interface, and then select the server address of UCM RemoteConnect to modify the SIP server address (internal network) to the server address of UCM RemoteConnect for a batch of devices.

Storage

View Backup File

For backup files generated from UCM manually or automatically, they can be stored in GDMS cloud storage. On the GDMS platform, users can view all backup files.

1. Go to the UCM Backup page, all backup files available for connected UCM devices will be displayed. The file type includes CDR files, config files, etc.

2. Click the searching box at the top of the interface to search the backup files by device MAC address, backup file type, and device model.

Upload Backup File

Users can upload the backup file and recover the backup file on UCM.

1. Go to the UCM Backup page, and click on the “Upload File” button in the right upper corner to access the interface:

File	Click to select the backup file from the local PC or drag the backup file to this field to upload the backup file. The backup file can be the configuration file of the device.
MAC Address	Enter the MAC address of the UCM device for uploading this backup file. Note: The UCM device must be in the current organization, otherwise, the backup file cannot be uploaded.
File Name	Enter the name of the backup file.
File Type	Enter the file type of the backup file so that the UCM device can obtain the backup file accordingly by the file type.

2. Click the OK button to upload the backup file.

Download Backup File

1. On the ”UCM Backup“ page, click the button following the backup file to download the file.
2. Download the files locally.

Restore UCM Backup File Remotely

Users can restore backup files for UCM devices remotely through the GDMS platform.

1. On the “UCM Backup” interface, select a UCM backup file and click the “Restore” button to restore the UCM device.

2. Once the user clicks the “OK” button, the UCM backup file will be assigned to the UCM device to restore the UCM device.
3. It may take several minutes to restore the backup file for the UCM device. The user can refresh the interface to view the results next to the MAC address of the UCM device on the interface. As the screenshot shows below:

: Restored successfully. The user can leave the cursor on the icon to view the last restoring time.

: Restored failed. The user can leave the cursor on the icon to view the last restoring operation time.

Delete Backup File

If the user wants to clean up the storage space of the UCM device, the user can delete the backup files in the UCM device.

1. On the” UCM Backup“ page, click the button following the resource file to delete the backup file. Users can also select multiple backup files and click the Delete button on the top of the page to batch delete the backup files.
2. When the user confirms to delete, the selected files will be deleted from the GDMS platform.

Convert Configuration File

If the user has upgraded the UCM device model, the user can use this function to convert the configuration file of UCM62xx/UCM65xx to the configuration file of UCM63xx.

1. Go to the UCMRC System 🡪 Storage interface, the user can click the “Convert Config File” button to access the conversion interface, as the screenshot shows below:

2. The user can click to upload or drag the configuration file of UCM62xx/UCM65xx to the uploading area.
3. Select the target model to be converted, which means the model of your new UCM device.
4. Select the converted configuration file and save it to the cloud storage space of the new UCM device.
5. The converting duration will last for several minutes. When the conversion is done, the user can download the converted configuration file on the UCM Backup interface. Or the user can click to download the converted configuration file directly to the local PC. The user can also restore the configuration file in the new UCM device directly.

VoIP Device

This module displays all VoIP devices in the current organization.

For more details, please refer to the VoIP System -> VoIP Device module.

Call Quality

Statistics Overview

The interface below displays the call quality reported by the device on the GDMS platform.

Prerequisites: The device must use the SIP account in the UCM server which has the UCM RemoteConnect service so that the device can report the call quality to the GDMS platform. This function is only supported for certain UCM RemoteConnect plans. To check which plans support this feature please refer to the RemoteConnect website: https://ucmrc.gdms.cloud/home

Module	Description
Total VoIP Devices	Display the number of VoIP devices reported by the current organization (only display the statistics report for the current filter time)
Total Calls	Display the number of calls reported by the current organization (only display the statistics report for the current filter time)
Call Quality	Display the call quality ratio and average values for the reported call history by the current organization (only display the statistics report for the current filter time)
Call Type	Display the call types for the reported call history by the current organization (only display the statistics report for the current filter time)

Call Quality Record

GDMS platform displays all reported call quality records on the Call Quality interface.

Please see the screenshot below:

1. GDMS platform supports filtering call quality records by date.

2. GDMS platform supports search call quality records by site, device model, call quality, and call type.
3. GDMS platform supports to search of call quality records by device MAC address, device name, and SIP Account.
4. Click the Call Statistics button to view the statistical report of the filtered call quality records.

Enable/Disable Call Quality Reporting

Users can enable/disable reporting call quality on the GDMS platform. If the user does not want to view the call quality report, the user can disable this function on the GDMS platform.

On the Call Quality interface, the user can click Phone reports the call quality button to disable reporting call quality. When this function is disabled, the devices under the current organization will no longer report the call quality to the GDMS platform.

CLOUDUCM SYSTEM

CloudUCM System integration in the GDMS allows the creation of CloudUCM devices and other features for managing the device like starting and stopping the CloudUCM, rebooting, upgrading the firmware, running diagnostic for the device, checking the task history and operation log, and resetting the device’s default password.

Switching to CloudUCM System

To switch to the GDMS system, please click on the systems menu in the top left corner of the web UI, as shown in the figure below, and then choose CloudUCM System.

The system will be then switched to CloudUCM-related features.

Dashboard

On the Dashboard, the user can view general information about the CloudUCM devices. The dashboard is split into 4 tabs: Device Statistics, Call Statistics, CloudUCM, and VoIP Device.

Device Statistics

The Device Statistics tab displays the following:

Call Statistics

You can select multiple CloudUCM devices to view the latest 7-days or 30-days call status chart.

• Total Calls: Chart of the total number of calls per day

• Max Concurrent Calls: Chart of the number of concurrent calls per day

• Number of Registered Extensions: Chart of the number of registered extensions per day

CloudUCM

Displays the real-time status of all CloudUCM devices in the current GDMS platform:

• Device: Displays the MAC address of the device.
• Device Status: Displays the status of the device. The value can be “To be Activated”, “Running”, “Stopped”, “Starting”, or “Pending activation”.
• CloudUCM Plans: Displays the current plan information and status.
• Storage Space: Displays the storage space details of UCM local and cloud space usage.
• Current Call: Displays the current number of calls/the maximum number of concurrent calls of the plan.
• Extensions: Displays the number of currently registered extensions/the number of created extensions/the maximum number of extensions of the plan.
• Trunk: Displays the number of total trunks, the number of trunks in idle/busy/abnormal state, and the number of trunks that are unmonitored.
• Alerts: Displays the number of unread notifications and IP addresses blocked by Fail2ban.
• Organization: Displays the organization where the device resides.

VoIP Device

Displays all the VoIP Devices in the current GDMS platform:

Overview

On the Overview screen, the user can view general information about the CloudUCM devices. The information displayed is related to the number of CloudUCM devices created in the organization, the number of VoIP devices that are registered to the CloudUCM device, and the total number of extensions created on the CloudUCM devices.

Device Statistics

The Device Statistics tab displays the following:

Call Statistics

You can select multiple CloudUCM devices to view the latest 7-days or 30-days call status chart.

• Total Calls: Chart of the total number of calls per day.

• Max Concurrent Calls: Chart of the number of concurrent calls per day.

• Number of Registered Extensions: Chart of the number of registered extensions per day.

Extension

The module displays the extension information of all UCM devices in the selected organization.

Edit Extension in UCM Web UI

The user can click button to access the UCM device Web UI to edit the extensions. As the screenshot shows below:

Assign Account

The user can click button to assign accounts to the VoIP devices in the current system.

Delete Account

Users can delete one or multiple extensions in this module.

1. Click on to delete individual extensions.
2. When the confirmation prompt appears, click “OK”.

To delete multiple extensions at once, please select the extensions by ticking the box next to each extension, then click . When the confirmation message appears, click “OK”.

Export Extension List

Users can click the “Export Extension” button on the right upper corner of the Extension module to export the extensions in the current enterprise in the GDMS platform.

CloudUCM Device

In the CloudUCM Device List, all CloudUCM devices in the current organization are displayed, along with device status, plan information, storage space, CloudUCM server address, the number of calls in real-time, extension number (the number of currently registered extensions/the number of created extensions/the maximum number of extensions in the plan), and Trunk status.

Status Descriptions:

Status	Description
Device Status	Indicates that the CloudUCM device is running properly. Indicates that the CloudUCM device is not running. (It is possible that the plan has expired, or it has been stopped manually by the administrator.) Indicates that the CloudUCM device has not been activated yet and it needs to be activated before it can be used. Indicates that the CloudUCM device is being started and cannot be accessed in this state. Indicates that the current CloudUCM device is in the process of deploying services, such as upgrading firmware, upgrading plan services, or restoring configuration, etc. In this state, the CloudUCM device cannot be accessed.
The firmware version is too low	This icon indicates device firmware version too low, and the device cannot be used normally with GDMS.
The Plan is about to expire	This indicator means the plan is expiring soon or already expired.
Trunk Abnormal	Indicates that the abnormal trunk exists in the CloudUCM. You can click to view the status of all trunks.
Unread Notification	Indicates that the CloudUCM device has some unread notifications. You can click to access the Web UI of the CloudUCM device.
Fail2ban	Indicates that the CloudUCM device has 2 IP addresses that are blocked by Fail2ban. You can click to access the Fail2ban page on the Web UI of the CloudUCM device.

Server Address Descriptions:

Admin Portal: This specifies the CloudUCM device Web UI access address. The username and password of the device are required. CloudUCM User Manual

Wave Server: This specifies the server address of the Wave client. Wave User Manual

SIP Server: This specifies the SIP server address used for registering extensions. IP Phone Configuration User Manual

Filter Device:

Apply for CloudUCM Free Trial

Users can apply for the CloudUCM free trial. If you need more free trials, you can contact your superior channel or Grandstream Support for help. Learn more about CloudUCM Free Trial.

1. Apply in the CloudUCM Device List:

2. After applying for the free trial, click the option “Activate Now” in the pop-up window or click the button in the CloudUCM Device List to activate the device. After activating the device, the free trial will be started.

3. If you have entered the customer’s email address, an activation email is automatically sent to that configured email address. (Individual and company users do not have the “Customer Email Address” option.)

Activate CloudUCM Device

For a newly created CloudUCM device, you need to activate the device before you can start using it.

1. You can activate the CloudUCM device by clicking the icon in the activation email or in the CloudUCM Device module of the GDMS platform.

2. Before activating the CloudUCM device, you need to fill in the following information:

Zone	Select the nearest data center for quick access.
CloudUCM Server Address	Enter your custom service address for easy memorization. Note: Only advanced plans support this function.
Device Administrator Email	Enter the administrator email of your CloudUCM device so that you can use it to retrieve the password, receive plan notifications, storage space alerts, etc.

The device information will be displayed after filling the information:

MAC Address	It indicates the virtual MAC address of the CloudUCM device, as a unique identifier for this device.
Initial Password	It indicates the initial password of the CloudUCM device, and it is also the initial password of the super administrator for logging in to the CloudUCM Web UI.
Plan Information	It indicates the plan name for this CloudUCM device.
Valid Duration	It indicates the validity period of this CloudUCM device’s plan.

3. The activation may take several minutes. After activating the CloudUCM device, you can quickly access the CloudUCM admin portal to configure the CloudUCM service or add it to the GDMS platform for management.

Please refer to the CloudUCM User Manual to learn more details.

Add CloudUCM Device

You will need to enter the MAC address and initial password of your CloudUCM device to add it. The rules are the same as adding UCM devices in the UCMRC System.

Import CloudUCM Devices in Batches

The rules are the same as importing UCM devices in batches to the UCMRC System.

Start/Stop CloudUCM Device

Start Device: When the CloudUCM device stops running or needs to be activated, you can manually start the device. If the current plan has expired, it cannot be started.

Stop Device: When the CloudUCM device is running, you can click the option to stop the device. After stopping the device, the device is no longer accessible.

Remotely Access CloudUCM Device Web UI

Click the option to remotely access the Web UI of the CloudUCM device on the device list.

• You can access the CloudUCM device Web UI without entering a password. Once the permission is assigned, the user can remotely access the UCM Web UI through the GDMS platform without entering the UCM password.

You can also set the CloudUCM device Web UI to be accessible only through the GDMS platform:

View Device Details

In the CloudUCM Device List, you can click the option to view the device details, including the current extension registration status, VoIP device status registered with the extension, storage space usage status, the number of terminals connected to the server address, alert statistics, call statistics, and extension registration statistics.

You can view the CloudUCM device daily statistical reports, basic device information, plan information, etc.

Server Address Descriptions:

• Admin Portal: This specifies the CloudUCM device’s Web UI access address. The username and password of the device are required. CloudUCM User Manual
• Wave Server: This specifies the server address of the Wave client. Wave User Manual
• SIP Server: This specifies the SIP server address used for registering extensions. CloudUCM Endpoint Configuration Guide

View Statistics

Daily Report

The CloudUCM device collects the data report of the day and sends it to the GDMS user or the configured email box.

Please refer to the screenshot below for the daily report email:

View Statistics Report (Last 30 days)

Except for the fields below, all other rules are the same as UCM devices in the UCMRC System.

View CloudUCM Device Plan

It displays the storage space (currently used) of the plan, the maximum number of extensions in the plan, the maximum number of concurrent calls, the plan name, and the expiration time.

Edit CloudUCM Device

You can click the option in the CloudUCM Device List to edit the device:

Customer Email: Enter the email address of the customer who uses this device.

Customer Remarks: Enter the remarks of the customer who uses this device.

Device Remarks: Enter the remarks of the device. The device remarks of the CloudUCM device will be synchronized to the GDMS platform.

Server Address: Enter the server address of the CloudUCM device. The advanced plan allows you to customize the domain name for this server address.

Custom Server Domain Name

Prerequisite: The CloudUCM advanced plans support custom server domain names.

1. On the CloudUCM device editing page, users can customize the server domain name.
2. You can enter the preferred URL, such as {yourdomain}.a.myucm.cloud.

3. If the plan has a custom domain name function, the user can click on the “Custom Server Domain Name” option and enter the server address with the private domain name, and the user also needs to enter the custom certificate of the domain name.

Reboot Device

After the device is restarted, its status changes to ”Starting”. After a few minutes, its status changes to “Running”. Other rules are the same as those for UCM devices in the UCMRC System.

Upgrade Firmware

It only supports upgrading to the official CloudUCM firmware version.

Downgrading the firmware version is not currently supported. Please contact Grandstream Support if needed.

Other rules are the same as those for UCM devices in the UCMRC System.

CloudUCM Device Diagnostics

CloudUCM devices only support Ping/Traceroute and Syslog, which are the same as those in the UCMRC System.

View Device Operation Logs

In the CloudUCM Device List, you can click to view the operation logs of devices. The rules are the same as those for UCM devices in the UCMRC System.

Factory Reset

You can factory reset a single CloudUCM device. After resetting the device, the firmware version is still used the same one before restoration.

Reset CloudUCM Super Administrator Password

1. In the CloudUCM device list, you can click the option and click the option “Reset Super Administrator Password”.

2. After confirming the reset, an email will be sent to the email address of the device administrator:

3. The device administrator can click the link in the reset password email and enter the 6-digit verification code, then after the verification passes, the device administrator can enter a new password.

Modify Sites in Batches

Users could edit the site of a batch of CloudUCM devices on the GDMS platform. The default site is “default”.

1. Select the desired devices and click on the “Site Management” button.

2. Select the site to assign the selected devices.
3. Click on the “Save” button, and all the selected devices will be transferred to the selected site.

Delete CloudUCM Device

To delete a CloudUCM Device, the user can go click on then click “Delete Device” as shown in the screenshot below.

Or, to delete multiple CloudUCM devices at once, please select the device by ticking the box nex to the device’s MAC address then go to “More”, then select “Delete”.

Export CloudUCM Device

To export the list of CloudUCM devices, click on button. The list created will be in .xls format, and it will include all the CloudUCM devices which are added to the organization. If the user wishes to select the devices to be exported, he/she can tick the box next to the CloudUCM MAC address, then click on “Export Device” to export only those selected devices.

Synchronize CloudUCM Device Alerts to GDMS

1. Users need to enable CloudUCM alert notifications on the management platform of the CloudUCM device. For details, please refer to the CloudUCM User Guide on the CloudUCM product page.
2. The alerts generated in the CloudUCM device will be synchronized to the GDMS platform.
3. Users can view all CloudUCM alert notifications in the GDMS platform and set the alert notification methods: Email Notification, Message Notification, or SMS Notification.

DEVICE TEMPLATE

The Device Template page allows users to create templates that can be used to provision devices of the same model or in the same group. Additionally, users can upload configuration files for individual devices and manage them individually.

By Model

Users could customize the configuration template and classify the templates by device model and site. Users could also configure a batch of devices on the GDMS platform, which means users could create a configuration template for all the same models of devices or create multiple templates for different sites.

Automatic Configuration Push

When a device is added to GDMS for the first time, it will automatically obtain and use the configuration template for its model.

Manual Configuration Push

To manually push the configuration to specific device models, click on the button of the desired models.

Example:

For GXV3370 devices, all sites are using the same configuration template and all the devices under site A – D will acquire the same configuration template – GXV3370 Config Template.xml.

For DP720 devices, different sites have different configuration templates. The DP720 in site A will acquire the DP720 configuration file – Config Template -1.xml; the DP720 in site B will acquire the DP720 configuration file – Config Template -2.xml.

Add Template

To add a configuration template for a specific device model, click on the Add Template button on the By Model page and enter the following information:

Add Template

Once complete, users will be redirected to the Set Parameters page to modify the device settings of the template.

Set Parameters

Users can configure model-specific settings when editing model templates.

1. To configure these model-specific settings, click on the of the desired template.

2. Clicking on the Select All button will select every option on the current page. Clicking on it again will deselect all the options.
3. Clicking on the Reset Settings button will restore all settings on the current page to default values.
4. Clicking on the button following the account, users can copy and paste the current account configuration to other accounts.
5. When users try to configure the device wallpaper or screensaver image, users can select a picture from the resources list, or upload the local picture to GDMS and configure it to the device.

6. Modify the desired settings on the page or click on the Switch to Text Editor to configure device settings via text editing (e.g. p-values). The key can be either a P-value or an alias.
7. After setting the parameters, the user can click the “Save” button to save the changes. The user can select to apply the template configuration to all the same model devices on the corresponding site. The user can click the option “Provision to Selected Devices” to select the devices to which the user wants to push the parameters. The user can also click the button “Apply All” to push the parameters to all devices.

Configure Resource Files

Users can configure custom ringtones and language for devices (Supported models: GXP/DP series).

1. To configure these model-specific settings, click on the button of the desired template to go to the Parameters Configuration 🡪 Resource Configuration page, as shown in the figure below:

2. On the “Custom Ringtone” page, for Ringtone 1 to Ringtone N, select a ringtone file from the resources for each ringtone index.
3. On the “Language Configuration” page, select a language pack from the resources for the device.
4. After clicking the “Save” button, the device of this model will download the resource file from the firmware path once the device is connected to the GDMS platform for the first time.
5. Or, users can click the “Push” button to push the template of the model to the device. Then, the device will download the resource file from the firmware path.

Push Update

Users could push the configuration template to the device manually.

1. Select a specific configuration template, and click on the button following the template.

2. Users could select any device in this device model to push the configuration template, and the device will be updated with the configuration template.
3. Users can either push the configuration template immediately or schedule the configuration push for a specified time. If the latter is selected, users will need to enter a name and time for the scheduled push.

4. Click on the Save button to finalize the task. Users can check the task status on the Task Management page.

Edit Template

To edit the configuration template’s name, site, and description, click on the button for the desired template.

Download Model Template Configuration

To download the configuration template of a device model, click on the button for the desired template.

Copy Model Template

On the main page of the Model Template, the user can copy one or multiple templates and apply them to a different organization, this allows the user to copy the configuration easily across many organizations.

To copy a template, please tick the box on the left side of the template name, then select .

• Target Organization: Select the organization to which you want to copy the template to.
• Auto Provision to Devices in: You can select “All Sites”, “Select Sites”, or “None”. The rules are the same as those for creating model template.

After the templates have been copied successfully, the templates will be added to the “By Model” page of the selected organization, and the template’s name will be “Original Template Name_Copy”.

Delete Model Template

To delete configuration templates from GDMS, select the desired templates and click on the Delete button in the top left corner of the By Model page.

By Site

Users can customize device templates based on sites. The users will be able to configure devices based on the sites to which they have been assigned.

Add Site Template

To add a template, please click

• Name: Enter the name of the template.
• Auto Provision to Devices in: Choose the site on which the template will be applied to.
• Description: Enter a description for the template.

: Use this button to edit the information related to the template.
: Use this button to change the configuration of the template.

By Group

Users could customize the configuration template by group. Users could configure a group and update the configuration template by group. For example, users could classify a batch of devices into a group and configure/manage the devices in the group. Users could push the configuration template to the group members on the GDMS platform.

Users could view the group configuration template and the devices list in each group.

Users could modify the configuration parameters, push the configuration to the devices, edit the group and members, and download the configuration template by group.

Add Group

Users can add a group at any time on the GDMS platform.

1. Click on the Add Group button at the top right of the By Group page.

Group Name	Enter the name of the group to identify it easily. Names must be unique and have a maximum character limit of 64.
Type	Users need to select the type: Audio phone series: This is used to configure the common configuration parameters of the GXP and GRP series. DP series: Use the configuration template for the DP7xx series. HT series: Use the configuration template for the HT8xx series. GRP series: Use the configuration template for the GRP series. GXP series: Use the configuration template for the GXP21xx series. GXV series: Use the configuration template for the GXV33xx series. GVC series: Use the configuration template for GVC3210.
Description	Enter the detailed description and purpose of the configuration template.

2. Once complete, users will be redirected to the device selection page to add devices to the group. Users can either select devices from the list or manually enter the MAC addresses of the devices. Selected devices will be moved to the Selected Device list on the right of the page.

3. Users could click on the “Prev” button to go back to the group configuration page to re-edit the group information.
4. Click on the Save button to complete the group member selection. Users will then be redirected to the Set Parameters page.

Set Parameters

Users could set the unique parameters of the devices in the group in the configuration template to push the unique parameters to the devices in the group.

Select a specific group, and click on the button to access the group member parameters configuration page.

• Clicking on the Select All button will select every option on the current page. Clicking on it again will deselect all the options.
• Clicking on the Reset Settings button will restore all settings on the current page to default values.
• Clicking on the button following the account, users can copy and paste the current account configuration to other accounts.
• When users try to configure the device wallpaper or screensaver image, users can select a picture from the resources list, or upload the local picture to GDMS and configure it to the device.

• Modify the desired settings on the page or click on the Edit Configuration File to configure device settings via text editing (i.e. p-values). The key can be either a P-value or an alias.

Configure Resource Files

Users can configure custom ringtones and language for devices (Supported models: GXP/DP series).

1. Select a specific group, and click on the button to access the group member parameters configuration page.

2. On the “Custom Ringtone” page, for Ringtone 1 to Ringtone N, select a ringtone file from the resources for each ringtone index.
3. On the “Language Configuration” page, select a language pack from the resources for the device.
4. After clicking the “Save” button, the configured parameters and resources will be saved in the system. When the user clicks the “Push” button to push the template to the device, the device will download the resource file from the firmware path.

Push Update

Users could push the group configuration template to the device manually.

1. Click on the button for the desired group.

2. In addition to being able to push the configuration template to all or select members of the group, users can also push it to non-members.
3. Users can either push the configuration template immediately or schedule the configuration push for a specified time. If the latter is selected, users will need to enter a name and time for the scheduled push.
4. Click on the Save button to finalize the task. Users can check the task status on the Task Management page.

Edit Group Template

Users could edit the group name, descriptions, and group members.

1. Click on the button for the desired group.

2. Modify the desired settings and click on the Save button to finalize changes.

Download Group Template Configuration

Users can download the group configuration template by clicking on the button for the desired group.

Copy Group Template

On the main page of the Group Template, the user can copy one or multiple templates and apply them to a different organization, this allows the user to copy the configuration easily across many organizations.

To copy a template, please tick the box on the left side of the template name, then select .

Select the organization to which you want to copy the template to by selecting the organization name from the “Target Organization” list.

Delete Group Template

Users can delete groups by selecting the desired groups and clicking on the Delete button in the top-left corner of the By Group page.

By CFG

Users can import configuration files for specific devices. Settings in these uploaded files will be used for their specified device.

Upload CFG File

Users could upload the custom configuration file to the GDMS platform and push the custom configuration file to the device.

1. Click on the Import Configuration File button at the top-right corner of the By CFG page. The following window will appear:

2. Drag and drop the file to the window or click on the upload icon to select a file from your PC.

3. Click on the OK button to finalize the import.
4. The following window will appear asking the user to either push the configuration to the specified device immediately or to cancel the configuration push.

Push Update

Click on the button for the desired device to manually push the configuration to it.

Download Configuration File

Click on the button for the desired device to get its configuration file.

Delete CFG File

To delete uploaded configuration files from GDMS, select the desired devices in the list and click on the Delete button at the top left of the By CFG page.

RPS MANAGEMENT

RPS (Redirection & Provision Server) allows creating and pushing configuration to many Grandstream devices, this reduces the time and effort spent on configuring the devices manually, which improves the deployment process greatly and lessens the frequency of mistakes that occur when configuring the device manually.

The user can create instances of RPS (Redirection and Provisioning Server).

To configure this option, the user needs to create an RPS server by providing the IP address or FQDN domain of the server, and then select the protocol used for upgrading.

To assign a specific RPS to an organization, click on the three dots and add an organization as indicated in the figure below.

When an RPS is edited, the new RPS will be automatically delivered to the associated devices. If an RPS has been deleted, it only deletes the association between the RPS and the device. The RPS configuration will not be deleted from the device.

SITE MANAGEMENT

Site Management allows users to organize their devices by sites and categories.

Add Site

Users can add a site at any time on the GDMS platform.

1. Click on the Add Site button at the top right of the Site Management page. To quickly add a sub-site under a specific site, click on the button next to the desired site. Users can create a total of 7 different levels of sites.

Site Name	Enter a name for the site to identify it easily. Sites on the same level cannot have the same name.
Superior Site	The parent level of the site. This field can be left blank if the created site is a top-level site.
Site Description	Enter the descriptions of the site.

2. Once the site is created, users can then assign devices to it.

Batch Import Sites

Users could import a batch of sites into the GDMS platform.

1. Click on the Import Site button at the top right corner of the Site Management page. The following window will appear:

2. Click on the Download button to get a template that will be used to import site information.

Site Name	Enter the name of the site. If the site is the child of another site, users must enter the entire path (e.g. top-level site/second-level site/third-level site/…new site name).
Description	Enter the descriptions of the site.

3. Once the template is filled out, drag, and drop the file to the upload window or select the file from your PC. Click on the Import button to confirm the import.
4. When the Excel file is imported into the GDMS platform successfully, the GDMS platform will prompt the execution result. If there is data that failed to be imported, the user could export the failed data and re-edit the Excel file.

Edit Site

Users could edit the information of the site on the GDMS platform.

1. Click on the button next to the desired site.

2. Edit the desired fields and click on the Save button to finalize changes.

Delete Site

To remove a site from GDMS, click on the button next to the desired site.

View Devices

To view all the devices under a specific site, click on the desired site in the Site Management list.

Transfer Site

Users can select devices on a site and move them to another site by clicking on the Move button.

Clicking on the Save button will finalize the move to the specified site.

TASK MANAGEMENT

The Task Management page displays all queued and completed tasks in GDMS such as configuration pushes, firmware upgrades, reboots, and factory resets. Users can add, edit, and delete tasks from this page.

Add Task

To add a task to GDMS, click on the Add Task button.

Add Task

Click on the Save button to finalize the task creation. Users can view this task in the Task Management list.

View Task Status

Users can see the status of all completed and pending tasks by looking at the Status column.

Pending	The task has not been executed yet.
Executing	The task is currently in progress.
Success	The task has been completed successfully.
Failed	The task has failed.
Canceled	The task was canceled.
Timeout	The task was not executed when it arrived at the ending time.
Ended	The task was ended before it could be completed. Some of the involved devices may not have run the task before it ended.

To view more details about a task, click on the button for the desired task. Users can view the task status of each device involved.

Pending Executed	The task has not been run yet.
Executing	The task is currently ongoing.
Success	The task has been completed successfully.
Failed	The task has failed. A failure reason will be shown.
Timeout	The task has been sent to the device, but the device has not responded yet.
Success (Timeout)	The task has been completed successfully for this device, but it was completed later than the specified time.
Canceled	The task has been canceled before the starting time.
Ended	The task was ended before it could be completed. Some of the involved devices may not have run the task before it ended.

Users could re-create tasks for the executed failed devices or all devices. If the user re-creates tasks for certain devices, all attributes of the task and all executed devices information will be logged on the “Re-create Task” page.

Start Scheduled Tasks

Users can start pending scheduled tasks immediately by clicking on the button.

Cancel Pending Tasks

To cancel a pending task, click on the button for the desired task. The task status will be changed to Cancelled. To run the task again after it is completed, click on Task Details 🡪 Run Again for the desired task.

If the task is recurring, users could select whether to cancel the entire recurring task or just cancel the single task.

End Task

To stop a running task, click on the button to immediately end it.

If the device has already executed the task (e.g. Reboot Device), the device will finish the task; if the device does not start to execute the task, the device will not execute the task anymore.

Search Task

Users can search for specific tasks by using the search bar and filters at the top-right of the top right corner of the Task Management page.

Delete Task

Users can delete tasks at any time. Select one or more tasks and click on the Delete button at the top of the page to delete them.

DEVICE DIAGNOSTICS

Device Diagnostics allows users to check devices on GDMS for issues, view device information, obtain network captures and Syslog, and conduct traceroutes.

The user can view the diagnosis status of the device in the current organization of the current system. If the user does not have the relevant permissions, the user cannot diagnose the corresponding device.

Start Diagnostics

To start diagnosing a device, users can do one of the following:

1. Enter the device’s MAC address and click on the Start Diagnostics button.
2. Click on the button for the desired device in the list to diagnose the device.

To view the diagnostic details of a device, click on the button for the desired device.

View Device Details

Click on the button on the right of the Device Diagnostics page to view information about the device.

On the Diagnostics Details page, users can quickly perform operations on the devices, including restarting the devices, factory reset the devices, updating the configuration, and upgrading the devices. Users can also view the detailed information of the device, including device name, MAC address, public/private IP address, device model, and device type on this page.

Click on the button  next to the diagnosis record to view the specific diagnosis result of the device.

UCMRC Connection

Users can diagnose the current UCMRC connection status in the GDMS platform.

Click on the button “Start Diagnosis” and wait for the GDMS platform to diagnose the device. The GDMS platform will display the diagnosis result of the UCMRC connection.

If the UCM device which is using the UCMRC services has any problems, the user can diagnose the UCM device and troubleshoot the problems remotely. The user can try to fix the problems based on the suggestions and click on the “Feedback” button to send the logs and descriptions to our technical support.

Ping/Traceroute

Clicking on the Ping/Traceroute tab in the Device Diagnostics page will show the following:

Operation Method	Ping: Checks the connection status and speed between the device and the target host. Results include packet loss information, maximum/minimum data packets size, and the round-trip time of the packets. Traceroute: Displays the route and transit delays of packets from the device to the target host. Up to 30 hops can be monitored.
Target Host	Enter the IP address or hostname of the target host.

Users could click on the “Start” button, wait for the GDMS system to diagnose the device, and the GDMS platform will print out the results of the diagnostics.

Each operation prints the diagnostics result once, and users could operate the diagnostics multiple times.

Syslog

The Syslog tool allows users to capture logs from a device.

1. To start a capture, click on the Start button on the Syslog page. At any time during the capture, users can click on the button to download the Syslog.

2. Clicking on the End button will stop the capture, and the Syslog will be saved to GDMS.

3. Users can access these saved logs at any time.

Capture Trace

The Capture Trace tool allows users to get a network packet capture of a device.

1. Click on the Start button to start the packet capture.

2. Click on the Stop button to end the packet capture.

3. Click on the button to download the capture file.

Network Diagnostics

Users can perform network diagnostics on a specific device, including local network status, network packets loss rate and latency, uplink/downlink network rates, etc.

1. Click the “Start Diagnostic” button to start network diagnosis.

SSH Remote Capture

One of the diagnostic tools that the GDMS provides is the ability to perform a capture trace through SSH remotely.

To access the SSH Remote Capture feature please navigate to Diagnostics tab, then click on the corresponding device on which you would like to enable SSH Remote Capture. Then select “SSH Remote Access” tab.

After enabling Remote SSH Capture, a Remote Access Address will be displayed, the user can use the Remote Access Address to capture the ethernet packets using a packet analyzer like Wireshark. For more information, refer to the following chapter: https://documentation.grandstream.com/knowledge-base/grp260x-series-administration-guide/#remote-ssh-capture

System Status

Users can view the system status of a specific device through the GDMS platform to diagnose the device problems, including storage space, CPU, memory information, etc.

1. Click the “Start to Get” button to get the system status from the device in real-time.

End Diagnostics

Click on the End Capture button on the Device Diagnostics page to end diagnostics for the device. All diagnostic processes will stop.

Diagnostics Records

Users can view the entire diagnostic history of all devices associated with the current account.

1. If a device is currently being diagnosed, click on the button to continue diagnosing or the button to end it.
2. If a device has been diagnosed already, click on the button to start another round of diagnosis or the button to view the results.
3. View the diagnostic history of a specific device by using the search bar on the top right of the Diagnostic Records page.
4. Users can delete records by selecting one or more items and clicking on the Delete button.

ALERT MANAGEMENT

GDMS has an alert system that will trigger when certain conditions are fulfilled. There are 3 alert levels: High, Medium, and Low.

Alert Notification Settings

Users can view and receive alert notifications in two ways: Message Notification and Email Notification.

Message Notification Settings

This displays the alert as a notification under the icon in the top right corner of the GDMS page.

1. To manage message alert notifications, click on the Message Notification Settings button on the top-right corner of the Alert Management page.

Message Notification Settings

2. When there are unread alerts, and a user subscribed to alerts logs in, the icon will shake. Hovering over the icon will show the unread messages. Clicking on these messages will show more details about the alerts.

Email Notification Settings

Alerts will be sent as emails to subscribers.

1. To manage email alert notifications, click on the button on the top-right corner of the Alert Management page.

Email Notification Settings

2. When the subscriber receives the alarm notification, the GDMS platform will send an email to inform the subscriber. To avoid the alarm notification emails disturbing the subscriber, the GDMS platform only can send one alarm notification email to the subscriber’s email box per hour.

App Notification Settings

The alerts can be pushed to the subscribers through the App notifications.

1. The user can click the button  to access the App notification settings interface.

App Notification Settings

SMS Notification Settings

UCM devices that have UCM RemoteConnect service plan can use the SMS Notification function. This function is only supported by some of the UCM RemoteConnect plans.

1. To manage email alert notifications, click on the button on the top-right corner of the Alert Management page.

Notification Settings

2. Click the Save button to apply the changes.

View Alert Notification

The Alert Management page shows all alerts that have been generated by GDMS.

• Search: Users can find specific alerts by using the filter and search features in the top right corner of the Alert Management page.
• Latest alarm notification: If the alarm notification includes a red dot at the beginning of the item, it means the alarm notification is an unread notification. Users could click on the button to mark all unread notifications as “Read.”
• View Details: Users could click on the button following the alert notification to view the alert notification details, and the red dot will disappear if the user has viewed the alert notification details.
  Note: When you click on , the following information will appear.

• Device Diagnostics: For the device which has a fault, the user could click on the option to access the Device Diagnostics page to diagnose the device.
• Delete Alerts: Users can delete notifications by selecting one or more items and clicking on the Delete button.
• To display the device that has generated the event, the user can click on the hyperlinked MAC address to view more information about the device.

REGION MANAGEMENT

The user can switch between the available regions which are available on the GDMS platform. Currently, we support the US region and the EU region. The user can enable both regions at the same time if they wish to, to do that please access the region configuration window by clicking your region name on the upper right corner of the GDMS web UI.

Select the region you would like to switch to. Or, to configure a new region, please click on “Region Settings”

You can either delete or add a region.

Enter the password of the administrator to be able to add or delete a region.

RESOURCE MANAGEMENT

Firmware Management

Custom Firmware

Users could upload the firmware of the devices to upgrade the associated devices on the GDMS platform.

1. On the Custom Firmware page, click on the Upload Firmware button.
2. Either drag and drop the firmware file to the upload area or enter the firmware file path.

Upgrade Path	Upload File: Upload the firmware file directly. Users could drag the firmware file to the uploading area or click on the uploading area to select the uploading firmware. Enter File Path: File path of the firmware. Please make sure that this file path can be accessed by your devices.
Firmware Name	This is used to identify the firmware file name. The limit is 1 – 64 characters.
Version Number	Fill in the actual version number of the uploaded firmware.
Supported Model	Select the supported device models of the firmware.
Description	Description of the firmware. The maximum character limit is 256.

3. Once the firmware is uploaded successfully, it will appear in the custom firmware list. Devices will be able to select the firmware when upgrading via GDMS.

Official Firmware

The official firmware page lists the latest official firmware for every supported device. This list is maintained and updated by Grandstream.

Firmware Update Notification Settings

Users can subscribe to firmware update email notifications to keep up to date with the latest firmware releases.

1. Click on the New Version Notification Settings button at the top of the Firmware page. The following window will appear:

2. Users can select the device models they want firmware update notifications for.
3. Click on the Save button to finalize changes.

Push Firmware Update

Using this feature, the user can push firmware updates to the devices directly; this can be performed for devices with various firmware version number, or the if the user wants to upgrade devices which have a specific firmware version number, the user will be able to specify that version number or specify a range of firmware versions to be upgraded.

1. Click on the button for the desired firmware. The following window will appear:

2. Select the devices to push the firmware to. Users can search for specific devices by entering in a MAC address or name or filter devices by specific sites.
3. Click on Update Now to immediately push the firmware upgrade to devices or Schedule Config Update.
4. Click on the Save button to create the task. Users can check the status of the firmware upgrade on the Task Management page.

Edit Custom Firmware File Info

Users could edit the custom firmware file name, firmware version, and other information on the GDMS platform. Click on the button to access the firmware editing page.

Download Firmware

Users can download firmware on GDMS by clicking on the button.

Delete Custom Firmware

Users can delete custom firmware by selecting them in the firmware list and clicking on the Delete button in the top-left corner of the list.

Other Resources Management

Users can upload the resource files (such as ringtone files, wallpapers, language packs, etc.) to the GDMS platform so that users can configure or assign the resource files to devices at any time.

Upload Resource

1. On Resource Management 🡪 Other Resources page, click on the resource files uploading button.
2. Users can drag or click to upload ringtone files, pictures, language packs, and other files, as the figure shows below:

File	Users could drag the file to the uploading area or click on the uploading area to select the file. Supported file format: gsrt/flac/gsm/ogg/wav/mp3/jpg/png/txt. If the user selects the file type as “Other,” the GDMS platform will not restrict the file format. File size limit: Bin file/Ringtone – 128KB; Picture/Language pack – 500KB; Other – 5MB.
File Name	This is used to identify the file name. The limit is 1 – 64 characters.
File Type	This is used to identify the file type, such as ringtone, picture, language pack, and Others.

3. Click the “OK” button to save the file to the GDMS server.

The user can also choose to edit a file, this basically allows the user to upload a file and overwriting the existing one.

View Resource List

Users can view all resources on Resource List under the enterprise, including the uploaded resources.

1. Users can go to Resources 🡪 Other Resources to view the resources list.
2. Users can also search the resources by resource type or file name on the resources list.

Copy File URL

1. On Resource Management 🡪 Other Resources page, click the button following the resource file to copy the resource URL.
2. Copy the file URL and paste it to another file download path.

Download Resource

1. On Resource Management 🡪 Other Resources page, click the button following the resource file to download the resource.
2. Download the resource file locally.

Modify Resource

1. On Resource Management 🡪 Other Resources page, click the button following the resource file to modify the resource.
2. Users can modify the file and file name.

Delete Resource

1. On Resource Management 🡪 Other Resources page, click the button following the resource file to delete the resource. Users can also select multiple resource files and click the Delete button on the top of the page to batch delete the resource files.
2. When the user confirms to delete the resource file, the selected file will be deleted from the GDMS platform.

GUI Config File

The user can use the GUI Config tool o create a configuration file for a specific model device and store the configuration file on the GDMS storage space.

• On Other Resources, please click “Create GUI Config File”

• Choose the model of which you want to create the configuration file.

• Once the configuration has been customized, click on “Save to GDMS”.

View Storage Space

All resource files are stored in the enterprise’s storage space. This interface shows the storage space occupied and the total storage space:

1. On the” Resource Management“ 🡪 ”Storage Space“ interface, go to the Storage Space statistics page. This interface shows the storage space taken up by the custom firmware and the other resource files.

RESELLER CHANNEL

Channel customers and service providers can obtain a list of purchased devices from Grandstream ERP. This list will allow the channel customer or service provider to:

1. Quickly assign devices to sub-channel customers. These customers will then be able to log into GDMS to manage the devices.

2. Manage devices directly for customers.

Track Device

View Device

To view all devices assigned to the account, click on the Track Device tab.

Users can search for specific devices by using the filter and search options in the top-right of the Channel Management page.

Device Assignment Notification

When devices are assigned to an account, the icon will show a notification. Clicking on the notification will show the list of assigned devices.

Device Assignment

For the devices which have been sold to the associated company customer, the user could allocate the devices to them. The associated company customer could log in to the GDMS platform to view and manage the devices.

Assign Devices:

1. Click on the Device Operation button at the top-right of the Reseller Channel page.
2. Click on Assign to Associate Company on the Track Device page. The user will be redirected to the batch device assignment page.

3. The user will be directed to the batch devices allocating page:

Select Associate Company	Select the associated company to add the device to.
Device	Select the devices to assign to the associated company from the list or enter the MAC addresses of the devices.

4. Click the Save button to finalize changes and the assignment. The sub-channel will then be notified of the device assignment.

Assign to Organization

To assign devices to different organizations, please navigate to Reseller Channel > Track Device then click on “Assing to Organization”.

Reclaim Device

Reclaim Device allows the user to reclaim devices which are assigned to an associated company. This can be done to forcibly reclaim the device by the superior channel. Once a device has been reclaimed, it will no longer appear in the account of the user in the associated company.

To reclaim a device, please navigate to System > Reseller Channel, then click on “More”, then “Reclaim Device”.

Choose the device(s) to reclaim then click “Save”.

Return Device

The user can use return a device to return it to the superior channel once it’s no longer needed. Once the device is returned, it will be deleted from the list of the devices on the user’s account.

To return a device, please navigate to System > Reseller Channel, then click on “More”, then “Return Device”.

Choose the device(s) to return then click “Save”.

Upgrade Task

Users can perform an upgrade task to devices which belong to a specific channel. The upgrading can be triggered to many devices at once or it can be performed subsequently.

On the main page of scheduled tasks, please click on “Add Upgrade Task” on the top right corner of the page.

Fill in the fields according to the description in the table below.

USER MANAGEMENT

The User Management page allows users to view, add, and edit users and manage role privileges. By default, GDMS has one administrator, which has all available privileges. Roles are sets of privileges that admins can assign sub-users.

User Settings

The user can customize his/her settings when logged into the account. To access the settings of the account, the user must click on the name of the account on the top right corner, then select User Settings.

User Settings

Sign Out

Log out of the account by clicking on the username on the top-right corner of the GDMS portal and clicking Sign Out.

Delete GDMS Account

If the user does not want to use the GDMS platform to manage devices anymore, the user can delete the GDMS account and all sub-accounts of the enterprise.

1. Click the “Personal Information” option on the name menu at the upper right corner of the main page to enter the personal information configuration page.
2. Click the “Delete business account” button at the top of the page to delete the current GDMS account. If the enterprise GDMS administration account is deleted, all sub-accounts under the main GDMS account will also be deleted.

Multi-factor Authentication

The administrator can enable the multi-factor authentication for the associated user. To do that please navigate to Users section under System, then check the box next to the user for which you want to enable multi-factor authentication then click on “Enable Multi-Factor Authentication”.

After the multi-factor authentication has been enabled, the users will receive an email to activate multi-factor authentication.

The user can click on “Authenticate Now” button to access the multi-factor authentication page. The sub-user can only log into his/her account after setting multi-factor authentication. Otherwise, the user will not be able to log in.

Account Security Settings

Under this tab, the administrator can control security settings related to the sub-user accounts. The administrator can set the security requirement for the sub-user accounts which he/she has created. This is to ensure that the sub-user accounts security is reinforced and lower the chances of getting the login credentials of the account from being compromised.

ASSOCIATED COMPANY MANAGEMENT

Users can add associated companies for management in the GDMS platform. After establishing the association relationship, users can select the associated companies and share the organizations with the associated companies for management. The associated companies are a way to centralize the management of the devices of many entities.

Add Associated Company

After adding the associated enterprise, the user can select the associated company and share the organization with the company

The user can obtain the binding address from the enterprise with which the user wants to establish the association relationship.

1. The user can access Users > Associate Company page, and click the “Add Associated Company” button to add the associated company. Please see the screenshot below:

2. Enter the binding address of the associated company in the field “My Company Associating Address”.

3. Fill in the remarks of the associated company.

4. The user can click the “Save” button to add the associated company. Once done, the user can view the associated company name, remarks, and association time on the “Associated Companies” list. Please see the screenshot below:

Edit Associated Company

On the “Associated Company” list, the user can click the button  to access the “Edit Associated Company” interface to modify the remarks of the associated company.

Disassociate Company

If the user wants to disassociate the relationship with the associated company, the user can select the enterprise and click the button  to disassociate the association relationship.

ORGANIZATION MANAGEMENT

If users want to manage devices in multiple associated companies, users could create multiple organizations (such as customer enterprises, sub-companies), and assign the devices to multiple users to manage separately. The devices, SIP accounts, and other parameters are separated between different organizations. The data in a specific organization can only be viewed and managed by the administrator who has permission.

All devices and data are in the “Default” organization by default.

Multiple organizations and administrators:

Switch Organization

If the user has permissions for multiple organizations, the user could switch to manage different organizations.

1. Click the drop-down box of the Organizations menu at the upper left corner of the page to select the organization the user wants to manage.
2. After switching the organization, the user only could view/edit the Device, SIP Account, Template, and other data under the organization.

Add Organization

The user could create an organization if the user has permission.

1. On the menu at the right side of the page, select System Management 🡪 User Management, and select the “Organization” tab, click the “Add Organization” button at the upper right corner.
2. Fill in the information of the organization as shown in the following figure:

Add Organization

3. Click the Save button to save the organization in the GDMS platform.
4. The system will switch to the newly created organization by default, and the user could add devices to the newly created organization for management.

Edit Organization

Users could edit the organization’s information at any time.

1. On the menu at the right side of the page, select System management 🡪 User Management, and select the “Organization” tab to view all organizations under the account.
2. Click on the button following the organization name to access the editing page. The user could edit the organization name, the administrator of the organization, and descriptions, as the figure shows below:

Delete Organization

1. On the menu at the right side of the page, select System management 🡪 User Management, and select the “Organization” tab to view all organizations under the account.
2. Click on the Delete button following the organization name, the organization will be deleted completely after confirmation, including the SIP accounts, templates, tasks, diagnostics histories, and other data under the organization.

Share Organization

The user can select to share the organizations with the associated enterprises. There are 2 methods of sharing permissions: Co-management and Authorized Management.

1. On the “Organization” management interface, the user can select the organization that the user wants to share with another enterprise for management and click the button  to access the “Share” organization interface. Please see the screenshot below:

Share Organization

2. The user can select the “Share Permission”: “Co-management” or “Authorized Management”.

3. Select the associated enterprise to which the user wants to share the organization.

4. After clicking the “Save” button, the selected organization will be shared with the selected associated enterprise.

5. After the operation steps above, the user can view the organizations which were shared with other associated enterprises and shared with other associated enterprises on the “Organization” list. Please see the screenshot below:

: The label indicates the organization has been shared with another associated enterprise for management together.

: The label indicates the organization is shared with another associated enterprise for management together.

Cancel Sharing Organization

The user can cancel sharing the organization with the associated enterprise.

1. On the “Organization” list, the user can select the organization with which the user wants to cancel sharing with the associated enterprise and click the button  to cancel sharing with the organization. Please see the screenshot below:

2. After canceling sharing the organization, the user will get the organization management permission back, and the associated enterprise cannot manage this organization anymore.

Return Organization

After receiving the shared organization, the associated enterprise can return the management permission to the user.

On the “Organization” list, the user can view the received shared organizations and select the organization to which the user wants to return it by clicking the button  as the screenshot shows below:

2. After returning the organization, the organization will be removed from the “Organization” list of the associated enterprise, and the associated enterprise will lose the management permission the organization.

SYSTEM LOG

Users could view all operation logs of the system, including the login/logout logs of the user, adding new devices, deleting devices, adding SIP accounts, deleting SIP accounts, firmware upgrading/downgrading logs, updating configuration files for devices, devices factory reset logs, devices diagnostics logs, creating model template logs, etc.

On the menu at the right side of the page, select System management 🡪 System Log, and users could view all operation logs of the system. Users could also search the operation logs by level, operation contents, operators, and time.

PLAN & SERVICES

Users can click on the button in the top right corner to view UCM RemoteConnect plans and the services offered with each plan. When the user clicks on he/she will be able to view general information about the types of purchased plans.

• To view the history of all purchases, the user should click on .
• To ask for help to purchase a RemoteConnect plan, the user should click on .
• To edit Cloud IM settings, the user should click on .

By hovering over with the mouse pointer and clicking on you will access the UCM RemoteConnect website, on which the user can find all the details of the services provided by RemoteConnect.

UCM RemoteConnect Plan

• Supports only UCM63xx. When the user adds the UCM63xx device to the GDMS platform, the user can apply for a UCMRC advanced plan for a free trial.
• Complete NAT penetration mechanism. Users can use it directly without complicated configuration, so it can ensure the remote communication requirements through external networks (including Wave application in mobile phones/desktop clients for registration/communication through external networks).
• UCM Remote Management: There are 3 levels according to the plans, including View device information (e.g. Firmware version), SIP accounts synchronization, remote restarting UCM device, upgrading UCM, and remote access to the UCM Web UI.
• GDMS Cloud Storage service is provided with bonus cloud storage space. This is used for backup configuration files and user data for UCM.
• UCM data statistics report is provided and sent to the administrator through email.
• UCM Cloud IM Plan provides cloud IM communication services for UCM devices. After purchasing this plan, Wave users can use the cloud IM system, and the chat data will be stored in the cloud system.

UCM Cloud IM Service

UCM CloudIM Plan provides cloud IM communication services for UCM devices. After purchasing this plan, Wave users can use the cloud IM system, and the chat data will be stored in the cloud system.UCM Cloud IM service is an add-on service of the UCM RemoteConnect plan, and it provides cloud IM communication services for UCM devices. After purchasing a UCMRC plan that contains the Cloud IM service, the Wave user can use the cloud IM system, and the chat data will be stored in the cloud system.UCM CloudIM Plan provides cloud IM communication services for UCM devices. After purchasing this plan, Wave users can use the cloud IM system, and the chat data will be stored in the cloud system.

• Supports unified communication across multiple UCM devices in different regions.
• Provides cloud communication service with high performance, large storage, and multi-function.
• Starts to use UCM CloudIM service, which is not limited by the performance and storage space of UCM devices. Phone calls and messages are not affected by each other.

Enable Service

Prerequisite: The UCM plan contains the permission for this function.

1. The user can click the button  to access the “My Plans” list, select a UCM RemoteConnect plan which contains the Cloud IM service, and enable the Cloud IM service on the GDMS platform.

2. The user can click the button  to access the “Edit Cloud IM” interface. Please see the screenshot below:

Edit Cloud IM

3. Click the “Save” button to get the UCM Cloud IM Service, and the user can view the Cloud IM service domain name, service ID, and Key.

4. The user can quickly bind the UCM device for the Cloud IM service so that the UCM device can start to apply the Cloud IM service quickly.

• The bound UCM device also needs the UCMRC plan which contains the Cloud IM service.
• For the Cloud IM service in the UCMRC plan free trial, when the free trial expires, the user cannot use the Cloud IM service on the GDMS platform, and if the user wants to use the UCM device data in the Cloud IM service in the UCMRC plan free trial, the user needs to transfer the data to the newly purchased Cloud IM service.

View UCM CloudIM Plan Service ID and Key

In “My Plan” interface, find the UCM CloudIM plan, click the icon to view the service domain name, service ID, and Key of this plan.

Manage Bound UCM Device

1. In My Plan interface, find the UCM CloudIM plan, click the icon .

2. View the UCM devices which are bound to the UCM CloudIM plan. It allows users to add/delete devices. Please see the screenshot below:

Edit Enterprise Name

1. In My Plan interface, find the UCM CloudIM plan, click the icon .

2. The user can modify the name of the enterprise, and the new name will be applied immediately.

Cloud IM Maximum Storage Space

1. In the “My Plans” interface, find the UCM Cloud IM Service, and click the icon .

2. The user can modify the maximum storage space of the Cloud IM service. The configured Cloud IM service usage storage space must be smaller than the currently available storage space and larger than the currently used storage space.

IM File Limit

The user can set the maximum limit size of the file that the user can send at one time. To set the limit, please refer to the screenshot below.

• Chat File Limit (MB): The single file size limit in the Wave instant chat. The size limt is between 10MB and 100MB.
  It also cannot be greater than the total size of Cloud IM Maximum Storage Space.

Synchronize UCM Data in Cloud IM Service Free Trial

For the Cloud IM service in the UCMRC plan free trial, when the free trial expires, the user cannot use the Cloud IM service on the GDMS platform, and if the user wants to use the UCM device data in the Cloud IM service in the UCMRC plan free trial, the user needs to transfer the data to the newly purchased Cloud IM service.

1. The user can hover the mouse pointer on click the button  to access the “My Plans” interface, select the previous Cloud IM service on the list of the plans, click the button  and select the newly purchased Cloud IM service so that the UCM device data in the previous Cloud IM service will be transferred to the newly purchased Cloud IM service.

2. The user needs to select the main plan which contains the Cloud IM service, click the button  to access the Cloud IM service editing interface, and the user can customize the enterprise name, and allocate the maximum storage space for the Cloud IM service.

3. After clicking the “Save” button, the UCM device data in the previous Cloud IM service will be transferred to the newly purchased Cloud IM service of the UCMRC plan.

Purchase Service

Users can purchase one or more UCM RemoteConnect plans and assign them to the corresponding UCM63xx devices. If the user wants to purchase a UCM RemoteConnect plan, the user needs to contact the device distributor to learn more details about the plan and purchase the plan. The GDMS platform does not provide the purchasing service online. Users can purchase one or more UCM RemoteConnect plans and assign them to the corresponding UCM63xx devices.

Note:

If the user cannot contact the device distributor, the user can access the “UCM Devices” list -> Plans or by hovering on the clicking on  to view the “My Plans” list and click the button  to access purchasing interface. Then, the user can click the “Help” button so that the GDMS platform will inform the device distributor to contact the user as soon as possible.

View My Plans

Click on the Plan and Services on the upper right corner, the click on . This page displays all purchased plans by the current enterprise.

View all plans on the Plans menu:

• Active
• Expired
• About to expire (Less than 15 days from expiration date)
• Invalid (The plan has been revoked or has not been approved)
• In trial (The plan is a free trial plan)

Notes:

1. If the user can see icon , it means the Add-on Plan will expire soon.

2. If the user can see the icon , it indicates that the plan will expire soon. Please renew or upgrade the plan as soon as possible.

View Plan Details

On My Plans interface, select a specific plan and click on the button to view all order history of this device.

• Users could check the ID, Plan, Transaction, Type (upgrade/renew/purchase), Subscription Time, and Expiration Time.
• The user can view all the additional plans under the current plan, as well as the record of orders of the additional plans.
• The plan details contain the main plan and the add-on plan.

Export Receipt

The user can download the receipt for a specific plan renewal or upgrade from the plan details page.

1. View all plans for My Plans menu.
2. Select of the plan of which you want to export the receipt

The receipt will be downloaded as a PDF file and below is an example of a receipt

Renew/Upgrade Plan

If the user wants to renew the current UCM RemoteConnect plan or upgrade it, the user needs to contact the device distributor to learn more details about the plan and renew or upgrade the plan.

1. Please click on the name of your plan, then select

2. This window will appear, please select “I want to purchase a UCM RemoteConnect plan, but I cannot contact the dealer.

3. Fill in the form with the corresponding information:

Plan Expiration Notice

If the plan in the account will be expired after 15 days or already expired, the user will receive a notification through registered email.

An example of plan expired email notification:

MULTI-FACTOR AUTHENTICATION

GDMS Multi-Factor Authentication (MFA) is the simple and best security practice method that adds extra protection to account username and password. When MFA is enabled, the user will be required to enter the login username and password (the first security method) and an authentication code (the second security method) from the MFA device when they log on to the GDMS platform. These multiple methods will improve the security of the settings and resources of your GDMS account.

Users can purchase supported physical devices or virtual MFA devices to enable MFA for GDMS accounts.

• Virtual MFA Device

Virtual MFA Device is an application that runs and simulates physical devices on mobile phones or other devices. Virtual MFA device will generate a six-digit code based on a one-time time-synchronized cryptographic algorithm.

When logging into the GDMS platform, the user must type in a valid code from the specific device. Each virtual MFA device assigned to the user must be unique. The user cannot type in the code with another user’s virtual MFA device code for authentication. Since the virtual MFA device may be executed on an unsafe mobile device, it may not provide the same level of security as a physical MFA device.

• Physical MFA Device

A physical MFA Device is a device that can generate a six-digit code based on a one-time time-synchronized cryptographic algorithm.

When logging into the GDMS platform, the user must type in a valid code from the specific device. Each physical MFA device assigned to the user must be unique. The user cannot type in the code with another user’s physical MFA device code for authentication.

MFA Device Standards

	Virtual MFA Device	Physical MFA Device
MFA Device	Refer to table 2	Purchase physical MFA device
Cost	Free	Price by supplier
Physical Device Standard	Use your smartphone/tablet/PC which can execute applications that support open TOTP standards to install virtual MFA device	The physical device supports open TOTP standards. It is recommended to use the devices from Microcosm manufacturer.
Function	Support multiple tokens on a single device	The financial service institutions and IT enterprises use the same model of the device.

Download Virtual MFA Application

Install virtual MFA application for your smartphone/tablet/PC from your device’s app store. The following table lists some applications that are suitable for multiple kinds of smartphones.

Android	Google Authenticator; Authy 2-Factor Authentication
iPhone	Google Authenticator; Authy
Windows Phone	Authenticator

Enable MFA Device

To enhance security, it is recommended that users can configure Multi-Factor Authentication (MFA) to help protect GDMS resources. Users can enable MFA for GDMS accounts.

Authenticator App

Prerequisite: Users need to install a virtual MFA application on the smartphone/tablet/PC before enabling a virtual MFA device.

1. Log in to the GDMS platform with your account number, click on the name at the upper right corner, and access the personal information page:

2. Click to enable the “Multi-Factor Safety Authentication” option and select to use “Virtual MFA Device” on the pop-up window, then click the “Next” option to continue.
3. Then, it will generate and display the configuration information of the virtual MFA device, including QR code graphics. This figure represents the configuration of the virtual MFA device as a secret key, users can scan the QR code to finish setting the virtual MFA device. Users can also input the secret key manually into the smartphone/tablet/PC to finish setting virtual MFA devices if your smartphone/tablet/PC does not support scanning QR codes.

4. Open virtual MFA application in your smartphone/tablet/PC, ensure that the application in your smartphone/tablet/PC supports scanning QR code, and then perform one of the following actions below:
   • If the MFA application in the smartphone/tablet/PC supports scanning QR code, the user can use the application to scan QR code to finish setting virtual MFA device. For example, the user can select the camera icon or scanning QR code option to use the device’s camera to scan the QR code.
   • If the smartphone/tablet/PC does not support scanning QR codes, the user can click on the “Show secret key” option and input the private secret key manually in the MFA application.

5. When the operations above are completed, users can use the virtual MFA device to generate one-time passwords.

In the MFA secret code box Code 1, the user enters the one-time password which is displayed in the virtual MFA device currently. Then, wait for 30 seconds so that the virtual MFA device will generate a new one-time password, the user enters the second one-time password in the MFA secret code box Code 2.

6. Click on the “Start Verification” option to start to verify the password. When the verification is passed, the GDMS account and the virtual MFA device have been bound successfully. When the user tries to log in to the GDMS platform, the user must input the MFA device code.

Hardware TOTP Token

Prerequisite: The user needs to purchase the physical MFA device before using this verification function.

1. Log in to the GDMS platform with your account number, click on the name at the upper right corner, and access the personal information page.
2. Click to enable the “Multi-Factor Safety Authentication” option and select to use “Physical MFA Device” on the pop-up window, then click the “Next” option to continue.
3. Enter the interface below to bind the physical MFA device with the GDMS account:

4. Input the secret key of the device. Please contact the manufacturer for the secret key.

5. In the MFA secret code box Code1, the user enters the six-digit one-time password which is displayed in the physical MFA device currently. The user needs to press the button on the front of the physical MFA device to display the secret code. Then, wait for 30 seconds and press the display button on the front of the physical MFA device again, so that the MFA device will generate the second six-digit one-time password. The user needs to enter the second one-time password in the MFA secret code box Code 2.

6. Click on the “Start Verification” option to start to verify the password. When the verification is passed, the GDMS account and the physical MFA device have been bound successfully. When the user tries to log in to the GDMS platform, the user must input the MFA device code.

Enable FIDO Security Key

FIDO security keys are an authentication hardware which are provided by third-party companies, e.g., Yubico. These devices use complex encryption algorithms to ensure a safe authentication into your GDMS accout.

The user can select “FIDO Security Key” as a method of multi-factor authentication. When this method is selected, the user needs to connect the FIDO hardware to the computer and configure the hardware as prompted for authentication.

Remove MFA Device

If the user does not need to proceed with MFA verification, the user can remove the MFA device and restore the normal login authentication method.

1. Log in to the GDMS platform with your account number, click on the name at the upper right corner, and access the personal information page.
2. Click the “Remove” button to remove the MFA Authentication function for the current GDMS account.

Lost MFA Device/Invalid MFA Device

If your MFA device is lost or does not work properly, you can remove the MFA device first and then re-enable the new MFA device.

Method 1: If your GDMS account is a sub-account, you can contact the main GDMS account to remove your multi-factor authentication from the User management page. After removal, you can log in to the GDMS platform with the password, and then re-enable the new MFA device.

Method 2: If your GDMS account is the main GDMS account and you cannot log in to the GDMS platform, you can contact our Technical Support, provide your relevant information to our Technical Support, and they will help you remove the multi-factor authentication (Our Technical Support will send the removal email to the user and the user needs to input account password and check removal).

API DEVELOPER

GDMS platform opens API interfaces for public users. Users can apply for API Developer to use the services. Users can click to view the details about API interfaces.

API document access address: https://doc.grandstream.dev/GDMS-API/

1. Click on “API Developer” on the menu on the left side and click to apply for API Developer.

2. Click on “Apply for API Developer”, the GDMS platform will assign the API Client ID and secret key to the GDMS account, and the GDMS account can use the API Client ID and secret key to invoke the API interfaces.

3. If the user wants to disable the API Developer feature, the user can click on “Disable API Developer” to stop invoking the API interfaces.

Notes:

1. Call API Address:

The API Address is https://{gdms_domain}/oapi/xxx

• If your GDMS account is in the US region, the {gdms_domain} can be filled with www.gdms.cloud
• If your GDMS account is in the EU region, the {gdms_domain} can be filled with eu.gdms.cloud

2. When the API Developer is disabled, the previous API secret key will be invalid, the user cannot invoke the GDMS interfaces. If the user tries to re-apply for the API Developer feature, the system will assign another secret key to the GDMS account.

ABOUT GDMS

Users can view GDMS “System Version”, “Server information”, and “Supported Models and Firmware” by clicking on System 🡪 About GDMS.

• “System Version” includes:
  • GDMS Version: The current version of the GDMS platform and the “Release Notes” link.
  • App Version: iOS and Android application version and QR codes to scan to download the app.

• “Server Information” includes links to:
  • GDMS & UCMRC Server Information
  • GDMS Security Whitepaper
  • Privacy Statement

• “Supported Models and Firmware” includes the supported products and the minimum/recommended firmware version.

The GDMS platform supports the following languages:

• English, Chinese, Spanish (Spain), Spanish (Latin America), French, Greek, and Arabic.

CHANGELOG

Version 1.0.16.9

• Added CloudUCM System. [CloudUCM System]

Version 1.0.15.15

• No major changes.

Version 1.0.14.14

• GDMS and GWN.Cloud can now be merged into one account to manage all Grandstream devices using one account. [Main Functions Overview]
• The user can now quickly switch between VoIP System, UCMRC System, and GWN.Cloud System. [Main Functions Overview]
• Added “Account Security” module which includes password security settings, login timeout, and multi-factor authentication for all the users. [Account Security Settings]
• Improved requirements for password rules. [GDMS Account Registration]
• Added “Return Device” and “Reclaim Device” features on the Reseller Channel page. [Return Device] [Reclaim Device]
• Moved the “Reseller Channel > Subchannel” module to “Users > Associated Company” for management. [Associated Company Management]
• Added the “Region Settings” module to open or close certain regions. [REGION MANAGEMENT]
• Optimized the login page, User management page, Personal Settings page and Reseller Channel, etc.

Version 1.0.13.21

• Added DP755 model on the support list of the GDMS platform. [About GDMS]
• Added “Account Active” option on the “Add Account” page and “Edit Account” page under the “SIP Account” module. [Add SIP Account] [Edit Account]

Version 1.0.13.15

• Add FIDO U2F multi-factor authentication method. (GDMS platform mobile apps do not support this feature) [Enable FIDO Security Key]
• Added ability for the administrator to forcibly enable multi-factor authentication for sub-users, and remove multi-factor authentication for sub-users in batches. [Enable Multifactor Authentication For a User]
• Integrated GUI Config Tools. Users can quickly create GUI Config files on the Resource Management page and parameters configuration page. [GUI Config File]
• Added new features for VoIP devices on the parameters configuration page: Print MPK Sticker, select firmware path or upload firmware from the firmware list, and move up and down the tables. [Device Parameters Configuration]
• Supported copying model templates and group templates to another organization. [Copy Model Template]
• Supported creating permanent firmware upgrade task and it can take effect on newly added devices [Add Task]
• Added ability to edit the custom firmware files. [Edit Custom Firmware File Info]
• Added the SSH remote diagnosis switch in Diagnostics module for devices (Currently only supported by GRP260x). [SSH Remote Capture]
• Added the following updates in the UCM device details statistics report: Device status statistics chart and remote user registration statistics chart. The alert list is also added to the PDF report file. [UCM Device Statistics]
• Added the device model info to the alert emails and alert details. [View Alert Notification]
• Added the alert for restoring the online status of the VoIP devices.
• Added ability to set chat file size limit after enabling Cloud IM service. [IM File Limit]
• Added the following APIs: View template list and push the configuration template with a specific ID to some devices. [API Developer]

Version 1.0.12.18

• Added “RPS Management” module. Users can manage multiple RPS (Redirection & Provision Server) in a unified manner and configure RPS for device organizations. [RPS Management]

• Added ability to quickly configure RPS for the current organization on the “VoIP Device” menu. [Assign RPS]

• Added SSH access authorization to the UCM device or VoIP device for remote support to troubleshoot problems. [Manage Device via GDMS Support]

• Added ability to select whether to enable/disable GDMS cloud storage space when adding UCM device or importing UCM device to the GDMS platform. This feature is only for the UCMRC paid plan users. [UCM Device Management]

• Added ability to batch download files on the UCM cloud storage space interface. [Storage]

• Added ability to select to upgrade firmware for “All devices in this model” when creating the upgrade tasks on the “Task” module. [Add Task]

• Added ability to edit the “Alert” settings for multiple organizations in batches. [Alert Notification Settings]

• Added ability to directly upgrade firmware for the devices in the “Reseller Channel” module. [Upgrade Task]

• Added “GDMS Security Whitepaper” document and “Privacy Statement” in the “About” module. [About GDMS]

Version 1.0.12.6

• Added “By Site” option under “Device Template” module. It allows users to configure the template for a specific site and provision the devices in that site. [By Site]
• Added the “Energy Saving Inform” tab under the VoIP Device Details module. Users can configure the energy saving settings through the device configuration template. [View Device Details]

Version 1.0.11.19

• Added an add-on plan for UCM RemoteConnect service: Extra 100 Concurrent Calls. If the user purchases this add-on plan, the corresponding UCM63xx device can add the capacity of 100 concurrent calls. [Plan & Service]
• Added an option to export order receipts. Users can export the order receipts after placing the orders. [Export Receipt]
• Added an option to ask the user whether to synchronize the local configurations of the device when adding/importing VoIP devices to the GDMS platform. [Add VoIP Device]
• Added an option to ask the user whether to import the local SIP account configuration of the device when synchronizing the VoIP device’s local configuration to the GDMS platform. [Batch Import SIP Account]
• Added a new alert type for the UCM63xx device “Outbound trunk call duration usage”, and combined “Network Disk Status” and “External Disk Status” alert types to “External Disk Usage”. [Alert Notification Settings]
• Added the time range settings for “Message notification settings”, “App notification settings”, and “Email notification settings”. If the user sets the time range for alerts, the user can only receive the alert notifications during that specific period. The user can select the whole day, or a specific time period, or multiple different time periods during a day. [Alert Notification Settings]
• Supported editing resource files. The user can upload the resource file again, and leave the URL unchanged. [Other Resources Management]
• Added an entrance to view UCM RemoteConnect plan specifications on the GDMS main page. [Plan & Services]
• Added “Outbound Proxy” field for SIP accounts importing the template. [Batch Import SIP Accounts]
• Supported adding OEM devices to the GDMS platform account for management. [UCM Device Management]
• Improved the user experience on the GDMS platform.

Version 1.0.10.41

• No major changes

Version 1.0.10.23

• Added to share organizations between enterprises. Organizations can be managed by the other associated enterprises. [Share Organization]
• Added UCM-related alert types and App notification setting module. [Alert Notification Settings]
• Added an option to apply the changes to all devices when editing the “By Model” template. Added an option to remember the current setting for option “Auto Provision to Devices in”, and the option will be set following the setting for the previous model template when the user creates a new one. [Add Template]
• Optimized the “UCM Devices” interface and added the feature to apply for the free trial plan. [Add SIP Server]
• Optimized the “My Plans” interface and added the feature to apply for the Cloud IM service. [Enable Service]
• Optimized interface according to the specifications of the UCM RemoteConnect plans.

Version 1.0.9.13

• Unified the account login center. Users do not need to select US regional server or EU server for login. [GDMS Account Registration]
• VoIP System is classified by supporting VoIP device and GXW45XX Device. [Supported Device Model]
• Added search function in Set Parameters module. [Set Parameters]
• Improved the function performances in Diagnostics module. [Device Diagnostics]

Version 1.0.8.16

• Assigned permissions to separate the different sub systems in the GDMS platform.
• Added UCMRC system module and the navigation structure has been updated. Added Dashboard module and Overview module and added displaying more UCM device status information.[UCMRC SYSTEM]
• Optimized the UCM device list. Added Overview module and Plan Details information module in Device Details module. [Figure 72: UCM Device Details]
• Added new default site when adding a new UCM device to the GDMS platform.[Add SIP Server]
• Added supporting remote access to the UCMRC, UCM permissions settings, and supporting accessing the UCM Web UI without entering a password through the GDMS platform. [UCMRC SYSTEM]
• Added managing SIP server address for UCM devices, and support configuring the advanced settings of SIP servers. [Add SIP Server]
• Added to support Spanish, Latin Spanish, French, Greek, and Arabic languages in the GDMS platform. [About GDMS]
• Added to support UCMRC and VoIP sub systems in GDMS mobile application.
• Added alert messages pushing function in GDMS mobile application.

Version 1.0.7.11

• Supported Host/Spare functionality for UCMRC services. Users can view the Host/Spare associations in the GDMS platform and disassociate the relationship. [View/Disassociate Host/Spare UCM Device]
• Supported to allow users to diagnose UCMRC services availability. [UCM Device Diagnosis]
• Supported access to the Web UI of the VoIP devices remotely. [Remote Access to Device Web UI]
• Added time and date format settings in Personal Settings. [User Settings]
• Added the ability to convert configuration files. Supported converting the configuration file of UCM62xx to the configuration file of UCM63xx. [Convert Configuration File]
• Added to display VPN IP address in VoIP Device Details interface. [View Device Details]

Version 1.0.6.10

• Added UCM CloudIM Service. [UCM Cloud IM Service]
• Added support to modify the UCM region. [Add SIP Server]

Version 1.0.5.5

• Added support to synchronize UCM devices’ alert notifications to the GDMS platform. [Synchronize UCM Device Alert to GDMS]
• Added support to restore UCM backup files remotely through the GDMS platform. [Restore UCM Backup File Remotely]
• Added to support to diagnose UCM devices through the GDMS platform. [UCM Device Diagnosis]
• Added to authorize Grandstream Support to manage devices. [Manage Device via GDMS Support]

Version 1.0.4.9

• Added Call Statistics module for VoIP devices. The SIP accounts in the devices which are using the UCM RemoteConnect service plan will report the call quality and statistical report. [Call Statistics]
• Added support to upload UCM device backup file to GDMS platform. [Upload Backup File]
• Added SMS Notification function in the GDMS platform. [SMS Notification Settings]
• Added to allow users to add UCM devices to the GDMS platform with the original password. [Add SIP Server]
• Added to support to configure multiple SIP servers for a single SIP account. [Add SIP Account]
• Added to allow users to set sending time for UCM daily statistical report. [View Statistics]

Version 1.0.3.4

• Added to support network diagnosis and system diagnosis functions in the device diagnosis module. [DEVICE DIAGNOSTICS]
• Added to support to configure the concurrent upgrading devices amount for concurrent upgrade tasks. [Supported Devices and Requirements]
• Added WP810 to supported devices. [Add Task]

Version 1.0.2.8

• Supported adding UCM63xx to the GDMS platform. Added PBX Device module: Remote access to UCM63xx, restart UCM63xx, upgrade UCM63xx, view UCM63xx device details, data statistics report, synchronize SIP accounts in the UCM63xx to GDMS platform, etc. [UCM Device Management]
• Added Value-added services module in GDMS platform. Supported to purchase/renew/upgrade UCM RemoteConnect Plan and UCM/User Cloud Storage Space Plan and view the order history.
• Supported to view statistics report of UCM63xx device. The system can send the daily report to the configured mailbox. [UCM Device Diagnosis]
• Supported to view the enterprise/UCM cloud storage space usage. Users can receive alert messages through a configured mailbox. [View Storage Space]
• Supported to notify users when the plan will expire soon or has already expired. The alert notification can be sent to the user through a configured mailbox. [View My Plans]
• Supported creating tasks to reboot/upgrade PBX devices. [TASK MANAGEMENT]

Version 1.0.1.16

• Added device local configuration synchronization function. Users can synchronize the SIP accounts and parameters to the GDMS platform. [Synchronize Device Local Configuration]
• Added “Disable Push Configuration” function. Users can disable pushing the configuration to the device through the GDMS platform. [Disable Push Configuration]
• Added file type “Others” in Resources Management module. There is no file type limit if the user selects the file type as “Others”. [Other Resources Management]
• Added to allow users to manage devices with GDMS mobile application. Users can use the application to scan the bar code of the device to add the device to the GDMS platform, configure SIP accounts and view alert messages, etc.
• Added GDMS account deletion function. [Delete GDMS Account]

Version 1.0.1.3

• Added Resource Management module in GDMS platform. [RESOURCE MANAGEMENT]
• Added Custom Ringtone configuration and involved settings. [VoIP Device Management]
• Added the function to support copy configuration. [Device Parameters Configuration]

Version 1.0.0.65

• New independent region: EU region (for GDRP rules)
• Support GRP26XX, DP7XX, GXP21XX, GXV3380/3370/3350, HT80X, HT81X, GVC3210, GRP2616. [Supported Devices and Requirements]
• Add Sub-level organization feature.
• User’s dashboard support statistic by sites. [Device Statistics]
• User’s dashboard adds devices distribution Map. [Device Statistics]
• Added operation logs for different users and record the operation logs for each device. [SYSTEM LOG]
• Support repeating tasks. [Add Task]
• ACS server support load-balance.
• Supported Multi-Factor Authentication function in GDMS platform to provide higher security protection for GDMS account. [MULTI-FACTOR AUTHENTICATION]
• Supported to copy and paste the data from other organizations when users try to create a new organization. [Add Organization]
• Supported to transfer the devices to other organizations. [Move Device]
• Supported to divide group templates into multiple series templates, which is easier for users to configure devices in different groups. [By Group]
• Supported to delete organizations. [Delete Organization]
• Supported to filter the devices in the specific city on Device Geo Map. [Device List]
• API Interfaces. [API DEVELOPER]

Version 1.0.0.42

• This is the initial version.