Thank you for using the Grandstream Device Management System Mobile Application!
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.
GDMS provides a centralized management interface for configuring, managing, monitoring, and troubleshooting by site, group, and model, including device management, account management, device configuration, firmware upgrades, device monitoring, intelligent alarm, and statistical analysis, for an individual device or a batch of devices. This powerful cloud management platform adds powerful security features, including bank-level client-to-client, two-way certificate TLS encryption, authentication, and encryption for all device information. By providing centralized, secure, and zero-operations management to Grandstream end users, GDMS is ideal for enterprises, service providers, and multi-site enterprises because it allows them to easily deploy and manage Grandstream products.
This document introduces the GDMS platform mobile application and how to use it to manage various Grandstream products such as the GXV series, GRP series, DP series, WP series, etc.
To learn more information about the GDMS platform, please visit the link www.grandstream.com to get more information.
FEATURE HIGHLIGHTS
GDMS mobile application provides users the ability to manage Grandstream audio and video clients with centralized, secure, and zero-operation management methods.
The administrator can manage the devices remotely, such as scanning the code to add a device, configure an account, or upgrade a device’s firmware quickly, and receive alert messages with the mobile application.
Add devices by scanning codes: Support to add a batch of devices quickly by scanning the bar codes of the devices.
Easy to manage devices: Configure accounts, upgrade device firmware, and start devices remotely.
Monitor devices in real-time: Push the account registration status, device exception message, and alert message to the GDMS mobile application.
GETTING STARTED
System Requirements
Android™ OS: Android™ 4.1 or later version.
iOS™: iOS™ 9.0 or later version.
Download GDMS Mobile Application
Android users can download the GDMS mobile application Android version from the Google Play Store, and iOS users can download the application from the Apple Store.
Account Registration
On the GDMS mobile application home page, the user can click on “Sign Up” to create an account. Fill in the required fields, then click on the Sign-Up button. Once the registration has been done, a 6-digit verification code is sent to the email of the user, the user should enter the code in the respective prompt to activate the account.
Create a GDMS Account
Nickname
Enter the nickname. This will be displayed in GDMS platform, however, it cannot be used to authenticate.
Username
Enter the username. This username can be used to authenticate into GDMS platform.
Email
Enter the email address. An email with verification code will be sent to this address.
Password
Enter the password. The password must consist of at least 8 character, and 64 at most. It should contain letters, numbers, and special characters.
Confirm Password
Re-enter the password.
User Type
Select the user type.
Enterprise
Service Provider
Channel Reseller
System Integrator
Personal User
Login
Users can log in to the GDMS Cloud platform through the GDMS mobile application.
Log in using username and password
Start the GDMS mobile application.
GDMS Mobile Application Home Page
GDMS Application Login Page
Select the server region. If the user is using the GDMS Local Deployment platform, the user needs to select “Custom”, and enter the server address.
Enter the login account username and password to log in.
Important Notes
If the failed logging attempts exceed 5 attempts, the account will be frozen for 30 minutes. The user has to wait until the cooldown time has elapsed before attempting to log in again. If the user wishes to log in before the cooldown timer elapses, they will need to reset their password by clicking on “Forgot Password?”, and log in using the new password.
Accounts that remain inactive for over one year will be automatically locked, and users will be unable to sign in. To regain access, users must reset their password.
Log in using single sign-on
The user can log in by providing the SSO identifier in the application to be able to access their accounts.
Click on “Sign in with SSO”.
GDMS Mobile Application Login Page
Enter the SSO code, then click “Sign In”.
SSO Sign-in
Log in using Google Account
The user can sign into GDMS using a Google Account.
Sign in with Google
SELECT A SYSTEM
Using the GDMS mobile application the user can switch between two systems: UC System and Networking System. By switching to a certain system, the user can choose to manage either the unified communication devices or the networking devices. In this user manual, we are focusing on the Unified Communications System.
GDMS Systems
OVERVIEW
On the Overview page, the user can view statistics regarding the devices added, the statistics of the calls, and the status of the PBX. The information displayed is specific to the organization chosen. To jump to another organization, please click on the name of the current organization, then choose the organization you wish to navigate to. Please refer to the screenshot below.
Overview Page
Add a Device
Using the GDMS mobile application, the user can add devices in two different ways, either by scanning the information sticker on the device using the smartphone’s camera or by entering the information manually. In the sections below, the user can view the steps to follow to add devices by scanning or by entering the information manually.
Scan Device Information
Users can scan the barcode of the device to add the device to the GDMS platform or configure SIP accounts for the device quickly.
On the Overview or Device page of the application, click on the scanning icon in the top right corner to access to scanning interface:
Scan Device
Scan the bar code of the device. If the light is dim, it is recommended to turn on the phone flashlight by clicking button.
After scanning the barcode successfully, the application will direct the user to add the device. The user can enter the device name and location of the device to add the device.
Add Device
Click on the “Add device” button to add the device to the specific site.
If the device has been added to the user’s account, the user can obtain the device information, configure the SIP account, and upgrade the device firmware through the GDMS platform.
One device can only be added by one single GDMS account.
After adding the device successfully, the user can search the device by device name, MAC address, or site name. Information
Add Device Manually
For the remote device, or the device which does not have a bar code, the user can add the device manually.
Click the scan icon at the right upper corner of the application, and click on the “Manual Add” button to add the device manually:
Add Device
Enter the information about the device.
Add Device Manually
Device name
(Optional) Set a note name that identifies the device, up to 64 characters.
MAC address
(Required) Enter the MAC address of the device. (Locate the MAC address on the MAC tag of the unit, which is on the underside of the device, or on the package)
S/N
(Required) Enter the serial number of the device. (Locate the serial number on the MAC address sticker on the underside of the device or the package)
.
Site
(Required) Set which site the device belongs to, and the default setting is “Default” site.
Add Device Manually Parameters
Tap “Add Device” to finalize adding the device.
One device can only be added by one single GDMS account.
After adding the device successfully, the user can search the device by device name, MAC address, or site name.
Device Statistics
On the Overview page of the application, users can see the details of the device status under the current organization, including account amount, device amount, site amount, account status, device status, and device type distribution.
GDMS Overview
Total Extensions
Display the total number of all SIP accounts in the current system.
Total Devices
Display the total number of devices in the current system.
Total Sites
Display the total number of all sites in the current system.
Extension status
Summarize the number of accounts for each status, including:
Normal: All devices using the account are registered successfully.
Abnormal: The account is not registered on the device.
Unassigned: The account is not assigned to any device.
Devices Type
Summarize the number of audio devices, On-Premise PBX devices, and Cloud UCM plans
Summarize the number of devices online and offline respectively.
Online: The network connection between the device and GDMS platform is normal.
Offline: The network connection between the device and GDMS platform is lost.
Abnormal: The network connection between the device and GDMS platform is abnormal.
Plan Status
Summarize the active and expired plans for:
UCMRC – UCM RemoteConnect
CloudUCM
SecureAccess
PBX Upgrades
Firewall Service
SoftwareUCM
GDMS Overview Parameters
Call Statistics
In Call Statistics, the user can view statistical graphs about the number of local and remote calls that have been established, as well as statistics of the concurrent remote calls, and the number of extensions over a period of time of 7 days or 30 days.
UCMRC
UCMRC Call Statistics
CloudUCM
CloudUCM Call Statistics
PBX Status
In the PBX status tab, the user can view the PBXs added to the organization and their related information.
PBX Status
DEVICE
Search Device
This button is used to search for a specific device using either the device’s name or the address MAC.
Use this button to filter the displayed devices by model, status, or site.
VoIP
The current version does not support PBX device management.
On the Device page, the user can view all associated devices.
View Device
Click on the device to view the details of the device, including the account information of the device.
If the user has permission for multiple organizations, the user can click on the organization’s name to switch the organizations to view the devices list for different organizations.
Click the button on the right side of the device to view various operations for the device, such as account configuration, editing device information, deleting the device, upgrading firmware, restarting the device, etc.
Device Action Button
Device Actions
Account Configuration (Non-DP Series)
Click button on the devices list and select the “Account Configuration” option to access the account configuration page.
Account Configuration
Click the account that needs to be configured, and then select the SIP account under the current organization. If the SIP account status is “Assigned”, it indicates the account has been assigned to other devices; if the SIP account status is “Unassigned”, it indicates the account has not been assigned to any device.
Users can also re-select the existing SIP account or delete it.
Click the “Save and Apply” button, and the account will be assigned to the device immediately.
If the device is not connected to GDMS platform at this time, the configuration cannot be synchronized to the device immediately. The account configuration will be synchronized to the device once the device is online.
If the SIP account is configured on the device locally, the SIP account will not be synchronized to GDMS platform (configure a SIP account through device’s Web UI).
Configure SIP Account and Line (DP series)
Users can configure the SIP accounts and lines for the DP devices through the GDMS platform, and the existing SIP accounts of the current DP device can be viewed/edited/deleted.
Click button on the devices list and select the “Account Configuration” option to access the account configuration page.
Click “Account Configuration” to configure SIP accounts.
AccountLine Configuration
Select SIP account
Assigned: The SIP account has been assigned to another device.
Unassigned: The SIP account has not been assigned to any device.
Template
Different SIP servers cannot be set with the same DP template.
Handset
If this option is not filled, the default setting is “Circular” mode.
Account Configuration Parameters
Click the “Line” tab to enter the Line configuration page:
a. Set the line account for each handset and select the existing SIP accounts in the device.
Support to re-select the existing SIP account or line or delete the SIP account or line configuration.
Click the “Save and Apply” button to assign the configuration to the device immediately.
If the device is not connected to GDMS platform at this time, the configuration cannot be synchronized to the device immediately. The account configuration will be synchronized to the device once the device is online.
The SIP account or line configuration in the device will not be synchronized to the GDMS platform.
Please refer the user manual of DP device for the specific configuration rules of the device.
On-Premise PBX
On this page, the user can view the UCM6300 Series, SoftwareUCM, and GCC6000 Series PBX module information. The information displayed includes the name, the network status, the IP address assigned to the device, the site, and the model. The user can also use this page to edit the device information and reboot it.
On Premise PBX UCM63xx
On Premise PBX GCC6010
On Premise PBX SoftwareUCM
On premise PBX Menu
CloudUCM
On this page, the user can view the instances of the CloudUCM created in the organization.
CloudUCM
Reset CloudUCM Password
If you have forgotten about the CloudUCM password, it can be reset through GDMS. To do that please follow the steps below.
Navigate to the Device category, then tap the “CloudUCM” tab.
Tap the three dots button on the CloudUCM device for which password you want to reset.
Then press “Reset Super Administrator Password”.
CloudUCM Menu
Confirm that you want to reset the password of the CloudUCM by pressing “OK”.
CloudUCM Password Reset Confirmation
A code will be displayed; please write down the code or copy it, since it is required for password reset.
Password Reset Verification Code
A link has been sent to your GDMS account email. Please access your email inbox and find the email with the reset link.
CloudUCM Password Reset Link Email
Click the link then find, then paste the code, enter the new password on the second field, and retype it on the second field.
CloudUCM Password Reset Window
Press “Reset Password” then the page shown below will appear. After a few seconds, you will be redirected to the login page of the CloudUCM.
Password Reset Successfully
Stop CloudUCM Services
To suspend the CloudUCM services temporarily, all the data and configuration will be preserved and the user can resume the service at any time.
Open the three-dot menu of the CloudUCM and press “Stop Service”.
CloudUCM Instance Menu
A confirmation message will appear to confirm whether the suspension of the service is an intentional action, acknowledge the warnings displayed on the prompt, and then press “OK”.
Service Stopping Confirmation Message
Edit Device
Users can edit the note name and the site of the device.
Click button on the devices list and select the “Edit Device” option to access the device editing page.
Click the “Save” button, and it will take effect immediately.
Upgrade Firmware
The GDMS mobile application allows users to upgrade a specific device.
Click button on the devices list and select the “Upgrade Firmware” option to access to device upgrading page.
Upgrade Firmware
Select the target version to upgrade the device, and the firmware marked with “Official Firmware” is the firmware issued by Grandstream official technical support.
Click the “Upgrade Now” button, and the task of upgrading the firmware will be assigned to the device immediately.
Reboot Device
The GDMS mobile application allows users to reboot a specific device. In the example below, we are using a CloudUCM, but the steps are similar for all the devices, except that the menu might look slightly different.
Click button on the devices list and select the “Reboot Device” option to restart the device.
Reboot Device
After clicking the “OK” button, the task of restarting the device will be assigned to the device immediately.
Delete Device
The GDMS mobile application allows users to delete a specific device. In the example below, we are using a CloudUCM, but the steps are similar for all the devices, except that the menu might look slightly different.
Click button on the devices list and select the “Delete” option to delete the device from the GDMS platform.
Delete Device
After clicking the “OK” button, the task of deleting the device will be assigned to the device immediately. The device will be removed from the current GDMS account.
ALERT
View/Search Alert Message
Access to the “Alert” page.
Users can view all alert messages through the GDMS mobile application:
Alert Page
You can filter the alerts by the types or levels, below are the lists of the types and levels of the alert messages.
Alert Filter Types:
Account registration failed
PBX cloud storage space is insufficient or full
CPU traffic control
Local disk usage
Memory usage
Abnormal system reboot
System crash
Fail2ban blocking
Alert Levels:
Emergency
Warning
Notice
The user can tap the alerts to view more information about them.
SETTINGS
Personal Information
Basic Info
Click the “Me” tab and click “Personal Information” to view the user’s personal information.
Personal Information
Note
The user cannot change personal data on GDMS mobile application.
More Sign-in Methods
The user can bind Google and Apple accounts to use to log in to the GDMS account. By clicking on the account type, as shown in the figure below, the user can bind their Google/Apple account with a GDMS account. To learn how to log in using a Google/Apple account, please refer to the [Login] section.
Bind Google Account
Note
Google accounts can be only be used for Android devices, and Apple accounts can only be used for Apple devices.
Multi-Factor Authentication
From the Personal Information page, users can check whether Multi-Factor Authentication is enabled on their GDMS account.
Note
The method enabled by default for multi-factor authentication is Email Verification.
The user can enable one or more multi-factor authentication methods.
MFA Information
Note:
The MFA feature cannot be enabled directly from the app; users can only view which multi-factor authentication method is enabled. To configure Multi-Factor Authentication, users must log in to their account settings via the web interface.
GMDS Account Security Settings
The supported MFA options for GDMS are:
Email Verification: A verification code is sent to the user’s registered email address during the login process. The user must retrieve the code from their email and enter it into the GDMS login prompt.
Authentication App: this method involves using a time-based one-time password (TOTP) generated by an authenticator app, such as Google Authenticator, Microsoft Authenticator.
TOTP Hardware Token: similar to an authentication app, a TOTP hardware token is a physical device (like a key fob) that generates time-based one-time passwords.
FIDO Security Key: FIDO (Fast IDentity Online) Security Keys are physical devices (typically USB, NFC, or Bluetooth-based) that comply with the FIDO2/WebAuthn standards.
Note:
For more information on how to configure each authentication method, please refer to the MFA guide linked here: GDMS MFA Device – User Guide
Selecting the Authentication Method for GDMS
The screenshot below shows an example of a login prompt in the GDMS app for an account with Email-based MFA configured.
GDMS App MFA Login Prompt
Logout
Click the “Me” tab and click “Personal Information” to access the user’s personal information page.
Click on the “Sign out” button at the bottom of the page, and the GDMS account will be logged out once clicking the “OK” button. The user will be directed to the login page.
About Version
Users can view the current application version number by clicking the “Me” tab.
The application will detect whether there is a new version automatically. If there is a new version, users can click the “Upgrade Now” button to upgrade the application.
The system starts to download the latest application version and install it.
If it is the latest application version, the user will be prompted not to upgrade the application.
Feedback
If users encounter problems in the process of usage or have any suggestions, users can send feedback to us for evaluation.
Click the “Me” tab and click the “Feedback” button to access the feedback page.
Describe the problem and suggestion. If there is a screenshot of the problem or suggestion, users can click the “Upload” button to upload the screenshot as an attachment.
Click the “Submit” button to submit the feedback/suggestion to us. Our technical support will respond to the feedback/suggestion soon.
Supported Models
Users can view the supported models list for the GDMS mobile application.
Click the “Me” tab and click “Supported Models” to view which device models are supported in the GDMS mobile application.
GDSM Overview
CHANGE LOG
Version 1.0.11.8 for Android® / Version 1.11.7 for iOS®
Added SecureAccess plan status section in the Overview page. [Device Statistics]
on the right side of the device to view various operations for the device, such as account configuration, editing device information, deleting the device, upgrading firmware, restarting the device, etc.
