DeviceLive platform is designed for the industrial IoT field to quickly build intelligent edge networks paired with InHand edge intelligent hardware. It has four major capabilities: device management, remote monitoring, edge computing app management, and remote access to on-site machines. Collaborating with edge hardware, DeviceLive helps you deploy and upgrade edge APPs, implement edge data collection and pre-processing, and enable status visual monitoring.
Type https://device.inhandcloud.com/ in the web browser to go to the DeviceLive registration and login page. (Google Chrome is recommended.)
After registration and verification, click Access under "DeviceLive" in the Console to enter DeviceLive.You can also enter https://device.inhandcloud.com/ login directly to DeviceLive.
After login, go to the Security settings page to bind a mobile number. This allows you to log in to DeviceLive by typing the mobile number.
Click "Users" to enter InHand Cloud Service, and you can manage your accounts in the system.
Describe account management, user operate permissions controlled by role, user data permissions controlled by organization, and external accounts in the system.
Click Users at the top of DeviceLive to manage the organization and user information of the system.
1.Add Users
In the user list, click "Add," and enter the user information as follows:
Field Name | Description |
User Name | The name of the current user. |
Login Email | The user's email information is used for logging into the platform and receiving messages from the platform. |
Organization | Belongs to the organization associated with the current account. Users can view resources such as devices within the current organization and its subordinate organizations. |
Applications | All applications provided by InHand Networks Cloud Services, including DeviceLive, InCloud Manger, and more. |
User Roles | The roles available in DeviceLive may vary depending on the selected application. |
Login Password | The password is used for logging in. For the security of your account, please set a login password according to the system requirements. Please keep your account password secure and change it regularly. |
2.Invite
Click on "Invite", enter organization and role information, copy the link to the user. The user can register an account using that link, and after registration, the user's account will be automatically added to the list.
The system provides four roles: system administrator, organization manager, device full access, and device read only . The functional permissions of each role are as follows:
Role | Functionality Permission |
system administrator | Have all the functions and data permissions of current registered account. |
organization manager |
|
device full access |
|
device read only |
|
Admin can assign roles to other users.Each user can only have one role in an application.A new role assignment will overwrite the current role.
If you assign a user the role of system administrator, the user has the highest permission in all applications of the InHand Cloud Service.
Select the target user and click Delete. Confirm the delete operation to delete the user.
Admin accounts can lock other accounts to prevent accounts from logging into the platform.
On the Accounts page, click the "Lock" button in the "Operation" column to lock the account. If you need to unlock the account, click "Unlock" and the account can resume login.
After logging into DeviceLive, click on the application switch icon in the top left corner to access the InHand Cloud Service. From there, you can navigate to the "My Profile" page to change your account login password, link your mobile phone number, and set up two-factor authentication. Alternatively, you can click on the account icon in the top right corner, then scroll down and select "Security Settings".
Passwords with high security can make your account more secure. We recommend that you change your password regularly.
Click Change, enter the current password of your account to verify your identity. Enter the new password and confirm it.
After binding the mobile phone number, you can use the mobile phone number and SMS verification code to log on to DeviceLive. Or you can use this phone number to receive alert messages when configuring alerts.
To enhance account security, you can set up two-factor authentication (2FA) using multiple methods. This allows you to have a backup authentication method in case you lose your device or cannot access the app for verification.
1.SMS Verification
1. Click on "Settings" and follow the prompts to bind your mobile phone number. After successfully binding your phone number, you will receive a verification code on your bound phone number during subsequent logins for two-factor authentication.
2. If you no longer wish to use SMS verification, you can click on "Disable" to turn off SMS verification.
2.APP Verification
1. Click on "Settings" and follow the prompts to download and install the Google Authenticator or Microsoft Authenticator app on your mobile phone.
2. Open the app and scan the QR code on the screen to set up your account.
3. After scanning the code, enter the 6-digit code displayed in the app to verify your identity. Once verified, the app authentication is successfully bound to your account. You will need to enter the 6-digit code from the app for two-factor authentication during login.
4. If you no longer wish to use app authentication, you can click on "Disable" to turn off app authentication.
3.Recovery Code Verification
When setting up two-factor authentication for the first time, you will also receive a backup code. This backup code can be used in case you are unable to receive SMS codes or use the authenticator app. You can use this backup code to bypass two-factor authentication during login by selecting "Use Backup Code.
Set the default number of items displayed per page in the current account list.
Administrators can go to the System Settings page to set login timeouts and Force MFA for the entire organization.
1.Idle Timeout
After setting, if the idle timeout of the account in the whole organization exceeds the setting time, you will need to log in again to access it.
2.Force MFA
After opening,this will require Two Factor Authentication for all users in the account.
DeviceLive supports multi-level organizations. Users, devices, and other resources belong to a specific organization; users of one organization can view the devices and other data of this organization and its subordinate organizations. You can use this function to realize the data access control of different users. The isolated management of multiple sub-customers can make the data management more organized and the privacy security of the account more secure.
On the "Users" page, click "Create" to add a new organization, you need to select the parent organization of the organization. By default, the organization where the account is registered is the root organization.
On the Devices page, adding and importing devices will assign the devices to the operator's organization by default. You can modify the device's organization.
1. Select the device, click "Move", then select the organization or the group you want to move in
2. After selection, save the changes. Then the device is moved to the new organization, and only users within the same organization can view the device on the "Devices" page.
On the Groups page, click add and then select the organization the group is in. Only users within the same organization can view these groups on the Groups page, and the devices within these groups can also be seen by these users on the Devices page.
On the Networks page, click add and then select the organization the network is in. Only users within the same organization can view these networks on the "Networks" page. They can operate the devices, endpoints, and accounts in the network. When a user has the permission of a network but does not have permission for the devices that are within the network, the user can only operate the devices from the network dimension and cannot view the device on the "Devices" page or operate the devices through DeviceLive.
On the Users page, click add and then select the organization the group is in. The data resources an account can view (including devices, groups, networks, and users) are the data within the same organization that the user is in and its subordinate organizations. Particularly, users within the root organization can view all the data in the current registered account, which includes all devices, groups, networks, and users.
If an external user with a registered email account in DeviceLive needs to join your organization to provide external support, you can invite them by adding them as an "External User" to your current organization.
1. Go to the "Users" page and click on "Add" above the user list.
2. Select the user type as "External User".
3. Set the external user's login email, organization, application, and role information, then click "Save".
4. The external user will receive an email invitation. After accepting the invitation, the user will be able to switch to your organization to provide technical support.
External users switching organizations should follow these steps:
(1) Local Device Configuration for Cloud Management.
(2) Adding Devices to the Platform.
Method 1: Ethernet connection
Environment: Connect the PC to ETH1 (default 192.168.3.100) interface of EC942 using an Ethernet cable, and connect ETH2 (default 192.168.4.100) interface to the Internet.
Method 2: Cellular Connectivity
Method 3: Wi-Fi (STA) Connectivity
Once the device is connected to the network, you can add it to the platform. After successful addition, the device will automatically synchronize with the platform, allowing for cloud-based management of the device. Here are the steps for adding a device:
(1) In the "Devices" menu, click on "Add."
(2) In the window, enter the device name and serial number, then click "Save."
DeviceLive offers an overview feature that allows you to easily monitor real-time information such as device status, data usage, uplink, and device distribution under your account.
The overview page displays essential information including the number of devices, their online status, and upgrade status under the current account.
Function Modules | Description |
The number of devices |
|
Recent Alerts | To view the latest alert information for all devices/networks under the platform, click 'View More' to navigate to the alert details. |
Configuration Status | Device Configuration Synchronization Status Ratio Information, including the following configuration states:
|
Firmware Status | Firmware Upgrade Status Ratio Information for Devices, including the following firmware upgrade states:
|
Networking Method | Device networking method include:
|
Device Distribution | Distribution of device models across the account. |
Offline Times TOP 10 | View detailed connection information for the top 10 devices with the highest number of offline occurrences on the platform. |
Alerts TOP 10 |
|
The Data Usage page allows you to view the total data usage of all devices under the account and supports viewing by network connectivity type. Basic information includes:
Function Modules | Description |
Summary | Total data usage, cellular data usage, wired data usage, and wireless data usage information for all devices. |
Usage Trend | Data usage trends over time for all devices. |
Usage TOP 10 | The top 10 devices ranked by data usage and their corresponding data usage information. |
Uplink for all devices, with specific details as follows:
Field Name | Description |
Status | The device's uplink status include:
┃Note: Due to the device reporting the latest link information every 30 minutes, there may be a delay in this status. |
Uplink | Types of uplink include:
|
Working Mode |
|
Uptime | The connection duration of the current link. |
Public IP | Public IP information for the current link. |
Interface IP/Mask | Interface IP/Mask information for the current link. |
Throughput | Throughput information for the current link. |
Latency | Latency for the current link. |
Jitter | ┃Note: This metric is not available for cellular and Wi-Fi links. |
Loss | ┃Note: This metric is not available for cellular and Wi-Fi links. |
You can view the actual locations of all devices and their distribution on the Map page.
The device page allows you to view the basic information of all devices and supports operations such as remote configuration, firmware upgrades, remote access, commands, add, delete, move, import, export, and filter.
The information displayed in the device list is as follows:
Field Name | Description |
Status | The device online/offline status, where green represents online and gray represents offline. |
Device Name | The name that you set for the device when adding the device. |
Serial Number | Indicates the unique ID of a device. |
Organization | The name of the organization where the device is currently located. |
Product | Indicates the device model. |
Firmware Version | Indicates the current firmware version of a device. |
Cellular Module Version | The current cellular module version of a device. |
Cellular Signal | The signal strength of a cellular card. |
Group | The group to which a device belongs. |
IP Address | The public address that a device uses to connect to the Internet. |
MAC Address | The physical MAC address of a device. |
ICCID | The unique ID of a SIM card. |
Config Status |
|
Firmware Status | Firmware upgrade status for devices include:
|
Networking Method | Networking method for devices include:
|
Location | Displays the geographic location of a device. |
Description | Description information when adding a device. |
Actions |
|
Click 'Add' on the 'Devices' menu page. In the 'Add Device' popup, enter the device name, serial number, and MAC address, then click 'Confirm'.
Click 'Import' on the 'Devices' menu page to bulk add devices to the cloud platform.
1. Click 'Import' at the top right of the device list.
2. Download the import template and fill in device information according to the template.
3. Click 'Upload File',select the file, and then click 'Import'.
┃Note: When there are errors in the imported file, the page will provide notifications of successful and failed imports, along with the row numbers where the failures occurred.
Click the 'Export' button to export the existing device asset information from the platform in table format.
Click 'Move' on the 'Devices' menu page to move devices to a specific organization or a subgroup within an organization.
1. Select the devices you want to move in the device list.
2. Click 'Move' at the top right of the device list.
3. Choose the target organization or group and click 'Save'.
┃Note: Only devices from the same product can be added to a group. When the device's firmware version does not match that of the group, the configuration changes made on the platform will not synchronize with the device.
Function | Description |
Performances | The device's usage status of CPU, memory, disk, and so on. |
Connection History | Recording the historical connection instances between the device and the platform. |
Users can select the target device in the 'Devices' menu, click 'Remote Access', and achieve remote access to the device's local interface.
┃Note:
Users can select the target device in the 'Devices' menu, click 'Reboot', and after a secondary confirmation, the device will execute the restart operation.
┃Note: The device cannot be rebooted remotely when it is offline.
Users can select the target device in the 'Devices' menu, click 'Restore to Factory', and after a secondary confirmation, the device will execute the factory reset operation.
┃Note:
In the device details, you can perform remote configuration operations on individual devices, including editing configuration, viewing configuration, clearing configuration,copying configuration, and more.
The device details supports editing device configurations. After editing and submitting the configuration, the new configuration will be pushed to the device. The configuration edited here is the device's personalized configuration.
1. Click on the device name to access the device details.
2. Click 'Configuration' and choose the 'Edit' operation.
3. Change the configuration in the editing configuration popup, and after making changes, click 'Commit Charges'.
In the editing configuration popup, the following operations are supported:
┃Note:
① Devices must be online on the platform, and the current firmware version must support remote configuration.
The device details allows you to view the configuration information of the target device, including: Running Configuration, Individual Configuration, Group Configuration, Target Configuration, and Pending Configuration.
1. Click on the device name to access the device details.
2. Click 'Remote Configuration' at the top of the device list and choose 'Configuration Details'.
3. In the configuration details popup, you can view all the configuration information for the current device. Configuration information includes:
Click the 'Clear' button, and after a secondary confirmation, the clear operation will be executed.
┃Note: The copy-to-devices operation copies the target configurations of a device to the individual configurations of the selected device.
The 'Copy to Device' operation allows you to copy the target configuration from the source device to the target device, and the copied configuration will be treated as the personalized configuration for the target device.
1. Click on the device name to access the device details.
2. Click 'Configuration' at the top of the device list and choose 'Copy to Device'.
3. In the popup, select the target device(s), you can select multiple, and then click 'Save'.
The 'Copy to Groups' operation allows you to copy the target configuration from the source device to a group, and the copied configuration will become the group configuration for the selected group(s).
1. Click on the device name to access the device details.
2. Click 'Configuration' at the top of the device list and choose 'Copy to Groups'.
3. In the popup, select the target device group(s), you can select multiple, and then click 'Save'.
The device details supports individual device firmware upgrades or batch upgrades for devices of the same model.
1. Click on the device name to access the device details.
2. Click 'Firmware' at the top of the device details.
3. In the firmware upgrade popup, select the target firmware version. If the selected device models are not consistent, you will need to select the product model for the upgrade first.
4. Choose the current firmware version that you want to upgrade.
5. Select the upgrade time and click 'Save':
The EC series products allow pinning a project version in the device details. Once a device's project version is pinned, it won't be affected by project version updates within its grouping. Upon unpinning, the device will synchronize with the group project version.
┃Note: Devices not included in any group cannot be pinned to a project version.
A Connector network has three types of resources: devices, endpoints, and accounts. The respective functions are as follows:
resource | Description |
devices | Networking devices such as routers and gateways. |
endpoints | The business terminal connected to the router or gateway, such as PLC and IP telephone. |
accounts | The account used by the engineer or administrator to establish VPN tunnels. |
To access the 'Connector' page, click on 'Add', enter network information such as the network name, and click 'Save' to create a new cloud connection network.
To add devices to the connector network, follow these steps:
1. Click on the 'Add' action in the upper right corner of the device list.
2. In the 'Add Devices' popup, select the devices you want to add to the current connector network.
3. Configure the device's subnet address to establish a VPN communication tunnel. There are two ways to assign subnet addresses:
After devices are added, the system automatically assigns a virtual IP to each device and establishes a VPN connection tunnel. When the VPN channel for device cloud connectivity is online, users can use this virtual IP to remotely access the local web management interface of the router device.
┃Note: A maximum of 4,000 devices and accounts can be added to a connector network.
To add endpoint resources to the connector network, follow these steps:
1. Click on the 'Add' action in the upper right corner of the endpoint list.
2. In the 'Add' popup, enter the endpoint name and LAN IP.
3. Select the device to which the endpoint belongs.
4. Configure the endpoint's virtual IP to enable remote communication through the router's VPN communication tunnel. There are two ways to assign virtual IP to endpoint:
┃Note: A maximum of 243 endpoints can be added to a connector device.
1、Add an account
When accessing the Connector network details, go to the 'Accounts' page to add accounts to the Connector network.
1. Click on the 'Add' action in the upper right corner of the Accounts list.
2. In the 'Add Account' popup, enter the account name.
3. Configure the virtual IP for the account to establish a VPN communication tunnel through the virtual IP and DeviceLive. There are two types of virtual IP assignment:
┃Note: A maximum of 4,000 devices and accounts can be added to a connector network.
2、Connect the account to the client
After the account is added, you must use the connector client to establish a VPN tunnel. The platform supports MacOS, Windows, iOS, and Android clients.Below is an example of Windows operation:
1. Download the Windows client: Access the Connector Network details, go to the 'Accounts' tab, and click on the Connector Client to download the Windows version.
2. Download the client configuration file: On the 'Accounts' tab, select an account, and download the corresponding client configuration.
3. After the client has installed well, open the client software, import the client configuration file, and then click "CONNECT" to establish the VPN tunnel between the account and DeviceLive. Next, you can use this VPN tunnel to remotely access your endpoints under the device or download and upload data.
Both devices and accounts can view the history of connector, which can assist in analyzing business trends or identifying abnormal nodes. The recorded information includes historical connection status, duration of individual connections, total VPN traffic, and uplink and downlink traffic of a single connection.
To access the connector history, go to the connector network details and click on the 'Connection History' option in the device list and account list operations column.
You can add or remove groups to configure devices in bulk. If there's a conflict between group settings and individual preferences, the device follows individual preferences. If the group is for EC series products, it enables project management based on the group.
┃Note: If a device has a different firmware version than the group, it's marked as "suspended," meaning you can't configurate it remotely. Click the unusual icon in "Firmware Distribution" on the "Overview" page to upgrade devices with mismatched firmware.
Users can go to the group details, and click the "Edit" button to edit the group‘s firmware configuration’.
In the configuration editing popup, the following operations are supported:
┃Note:
The group details allows you to view the configuration information for the current group.
1. Click on "Configuration" at the top of the group list, then choose "Config Details".
2. In the configuration details popup, you can view the current configuration information for the selected group.
Click on "Clear" in the configuration section. After confirming the action, the group configuration will be cleared.
┃Note: This operation only clears the group configuration, and the individual configurations of devices within the group will still be retained.
Click on "Copy to Groups" in the configuration section, to copy the group configuration and perform batch configurations for devices within the target group.
The group details supports firmware upgrade operations for individual groups.
1. Click on "Firmware" at the top of the group details.
2. In the firmware upgrade pop-up window, choose the target firmware version.
3. Select the current firmware version that needs to be upgraded.
┃Note:
①Online devices within the group will immediately execute the upgrade task.
②Devices that are offline will perform the upgrade operation upon their next online status.
In the configuration editing popup, the following operations are supported:
Click "Reboot" to perform a batch restart of devices within the group.
┃Note:The restart command will only affect devices within the group that are currently online. Devices within the group that are offline will not execute this command (even when they come online later, they will not restart automatically).
In the "Groups" menu, select the target group, click on "Restore to Factory",and you can perform a batch factory reset for the devices within that group.
┃Note:
①The factory reset command will only affect the devices within the group that are currently online. Offline devices within the group will not execute this command, even when they come online later.
②After a device is restored to factory settings, all historical data will be cleared. When the device comes online again, it will reapply both its individualized configuration and the group configuration.
You can move devices running the same business application into a group according to business needs, managing applications and their required runtime environments in bulk through "Groups >> Project" This facilitates the efficient deployment, upgrade, and environment deployment of applications.
When you need to deploy or update applications for devices within a group, you can achieve this by creating and deploying a project version. A project version includes the applications you need to deploy along with the corresponding runtime environment configuration.
Navigate to the "Projects" tab in the group details, click the "Add" button, and enter the "Add Version" page. Here, you can configure container applications, native applications, and application dependency settings as needed.
Container applications support two configuration modes: Compose mode and WEB mode.
The method for creating services and data volumes in WEB mode is as follows:
You can use standard systemd commands to configure native applications.
Application dependencies consist of two parts: application dependency files and env incremental.
You can perform various operations on created project versions, including release, edit, deploy to a group, copy, and delete.
If you need to pull images from a private Docker Registry, you must configure information about the private Docker Registry. Navigate to the "Project" tab in the group details, click the "Registry Management" button, and enter the "Registry Management" page.
Click the "Add" button, configure the Registry URL, username, and password, then click "OK." Once configured, the Docker Registry will be distributed to all devices under the group.
If the application running on your device has environmental requirements for the host machine (For example, to run the application properly, the host machine must have Python 3.7 runtime environment and related Python dependencies such as pymysql and paho-mqtt), you can first complete the application's debugging and running on a test device. Afterward, remove files unrelated to the runtime environment, such as logs and application programs. Next, upload the runtime environment of the test device to the platform for subsequent deployment to other devices.
Go to the group details 'Env Incremental' tab, click the 'Upload Env Incremental' button, and configure the name, device, and description in the popup window. After configuration, click 'OK' and wait for the completion of the env incremental upload. Once uploaded, you can associate this env incremental in the 'Application Dependency Configuration' of the project version.
Env incrementals not associated with any project version can be deleted. Env incrementals associated with a project version need to have their association with the project version removed before deletion.
The platform supports multiple types of alarms, allowing you to customize the specific alert types you wish to receive and the groups for which alerts should be reported. Additionally, you can choose the notification recipients and methods for these alerts.
1. Go to the Alerts menu and click "Alert Settings" in the upper left corner of the alert list.
2. Click "Add Rule" in the upper right corner of the alert rule list.
3. Select the group to be monitored, alert type, notification users, and notification method, then
click "Save". If no notification users are set, the generated alarms will only be displayed on the platform. The platform supports two notification methods:
The explanation for alarm types is as follows:
Alert Type | Description |
Connect to the Platform | Devices can be online on the platform for more than N minutes.Configurable time range: 5 -120 minutes. |
Disconnect from Platform | Devices can be disconnected (offline) from the platform for more than N minutes. Configurable time range: 5 -120 minutes. |
Configuration Sync Failed | The device failed to synchronize its configuration with the cloud platform due to network or other issues. |
Configuration Modified Locally | The device configuration was modified by the user via the local interface or CLI. |
Reboot | The device's system has been rebooted. |
Firmware Changed | The device's local firmware has been upgraded or downgraded, including: local device execution of upgrades, platform upgrades to the device firmware version. |
License Expiring Soon | The license applied to the device on the platform will expire in N days. Configurable time range: 1-30 days. |
License Expired | The license applied to the device has expired, rendering the device unable to utilize the platform's functionalities. |
Client Online | A client connected under the device has connected. |
Client Offline | A client connected under the device has disconnected. |
Primary Uplink Type Switch | The upstream link type of the device has changed, either due to manual intervention or backup link switching. |
SIM Switch | The device with dual SIM cards has undergone a primary-secondary SIM card switch, such as the cellular link transitioning from SIM1 to SIM2. |
Wired Wan Connected | The current upstream link for the device is wired, and it's connected. |
Wired Wan Disconnected | The current upstream link for the device is wired, and it's disconnected. |
Cellular Wan Connected | The current upstream link for the device is cellular, and it's connected. |
Cellular Wan Disconnected | The current upstream link for the device is cellular, and it's disconnected. |
Wi-Fi(STA) Wan connected | The current upstream link for the device is Wi-Fi(STA), and it's connected. |
Wi-Fi(STA) Wan Disconnected | The current upstream link for the device is Wi-Fi(STA), and it's disconnected. |
Under the "Alerts" menu, you can view the alert information for all devices on the platform. This information includes the time when the alert was generated, its type, device name, group, description, and more.
The report page displays historical generated report information and supports adding new reports and managing report information.
Click "Create New" to create a new report by selecting report information based on your business requirements.
1. In the "Reports" menu, click "Create New" to enter the report content selection page.
2. Choose the type of report: Select the report content you want to include in the report.
3. Select Devices/Groups: Choose whether you want to include all devices, organizations, or specific groups in the report.
4. Set the reporting period: Define the time range for the report data, with a maximum selection of up to the last 30 days.
5. Configure report details: Specify whether you want to generate the report in PDF or Excel format and provide an email address for receiving the report. If you want to schedule regular report generation, you can set the time for daily, weekly, or monthly reports.
6. After submission, the platform will generate the report according to the selected configuration at the specified time. If you have set an email address to receive the report, you will receive an email notification when the report is ready.
Clicking "Manage Now" allows you to view all the newly added reports with scheduled tasks.
You can view the generated reports on DeviceLive from the Report menu. You can perform the following operations:
Click the Messages menu to receive messages from DeviceLive, including product messages, firmware messages, and service messages.
On the page Logs, you can view Activity Logs, Login Logs.
Click the Activity Logs tab to view the operations performed by all users on DeviceLive.
Click the Login Logs tab to view the login records of all users on DeviceLive. Upgrade Logs, Activity Logs, Login Logs.
DeviceLive subscribes to each device based on licenses and charges accordingly. You can choose different types of licenses for devices based on your needs, and the service scope of each type of license is as shown on the purchase page. The platform supports online purchase of service licenses, eliminating the need for cumbersome offline communication. Upon successful online purchase and application to the device, the service is immediately activated.
On the "Subscriptions>> Overview" page, you can view statistical information about the licenses under your account.
Function Modules | Description |
Device Overview | View the number of devices in different service statuses, click to apply filter conditions, and navigate to the "Devices" page:
|
License Overview | To view the total number of licenses and statistics for different license statuses, click to apply filter conditions and navigate to the "Licenses" page:
|
Recent License Alerts | View license alarm information for all devices, and click "View More" to jump to the alarm menu. |
License Distribution | View the percentage of different types of licenses in the account. |
On the "Subscriptions>> Licenses" page, you can view the purchased licenses, and the license information includes the following:
Field Name | Description |
License Key | The unique ID of a license. |
Type | The plan type of a license. |
Status | The working status of a license:
|
Order ID | The order from which the license was generated. |
Added At | The time when the license was added to this account. |
Duration | The subscription duration of a license is measured in days. |
Activation Date | The time when the license is activated. |
Expiration Date | The time when the license expires. |
Time Remaining | The remaining usable duration of a license is the time left until the license expires. Once the duration is consumed, the license status changes to "expired." |
Associated Device | The device to which the license is currently applied. |
①Once a license is applied to a device for the first time, it becomes activated.
②An activated license will continue to consume its remaining valid duration, whether or not it is applied to a device.
③After a license has expired, it cannot be applied to any more devices. Any devices that had the license applied will lose access to the features covered by that license once it expires.
On the "Subscriptions>> Devices" page, you can manage the application of licenses to devices, which includes the following functions:
1、License status of devices
In the "Subscriptions>> Devices" section, you can view the current service status for each device. The service status can have the following states:
Status | Description |
Available | Devices capable of connecting to the platform and using its functionalities (determined by applied device licenses). |
Unavailable | Devices unable to connect to the platform due to expired or unapplied licenses. Licensing required for these devices. |
Anomaly | After a device license expires, the device might retain partial platform functionality, but it may lack expected features. |
2、Assign a license to one device
On the "Subscriptions>> Devices" page, you can apply a license to an individual device using the following steps:
1. Click on "Assign License" in the operations column of the device list (The device that have not yet applied a license).
2. In the "Assign License" pop-up window, select the license type and the specific license you want to use, then click "Assign".
3、Extend device license duration
For a licensed device, you can extend the license period before the license expires to prevent service termination and avoid affecting service operation. InCloud Manager support extending the duration of a license by merging the duration of multiple licenses. You can only superimpose licenses of the same type to a licensed device.
1. On the "Subscriptions>> Devices" page, click on the "Assign License" option in the operations column (These devices that have already applied a license).
2. In the "Extend License" pop-up window, select the desired license, and then click the "Assign" button.
┃Note:
4、Assign licenses to multiple devices
When dealing with a large number of devices, the platform supports the quick batch application of licenses to multiple devices:
1. In the "Subscriptions>> Devices" page, click on "Assign Licenses" above the device list.
2. Select the license types you want to apply and the devices you want to apply them to. Click "Assign Licenses", and the platform will automatically allocate the licenses.
3. Confirm the license results and click "Assign" to make the batch licenses effective.
To maximize the utilization of licenses under your account, the platform will prioritize the allocation of activated licenses. Other types of licenses will be randomly allocated without considering the duration.
5、Remove license
When a device's business use case changes, and you need to switch to a different type of license, or if the device experiences a malfunction and needs to be replaced with another device, you can revoke the license from the original device. After revoking it, the canceled license can be applied to another device, and the original device will become "unlicensed," causing the services within the license scope to immediately terminate.
1. On the "Subscriptions>> Devices" page, click the "Remove License" option in the action column for the target device.
2. After confirming the action in a second dialog, the license will be removed from the device.
6、Remove licenses in batches
The platform supports quickly revoking the licenses of multiple devices. After revocation, the revoked licenses can still be applied to other devices. The original devices will become "Unlicensed," and services within the license scope will be terminated immediately.
1. On the "Subscriptions>> Devices" page, select the devices from which you want to remove licenses.
2. Click on "Remove License" at the top of the device list and confirm the action when prompted.
When the functionality of a device with a lower version of the license does not meet your business requirements, you can upgrade the license for that device.
1. On the "Subscriptions>> Devices" page, click "Upgrade License" at the top of the device list.
2. Select the type of license you want to upgrade. Once selected, the platform will automatically filter devices bound to this license type.
3. Choose the devices you want to upgrade the license for.
4. Select the license type to which you want to upgrade, then click "Submit".
5. Confirm the results of the license upgrade. After clicking "Confirm", the license upgrade will take effect, and the device's license will change to the advanced version. If you choose to cancel the license upgrade, it will not take effect.
┃Note: You can batch upgrade already activated licenses of the same type. After the upgrade, the remaining duration of the license will be adjusted proportionally based on the price ratio between the two license types before and after the upgrade.
The platform supports users in transferring licenses to other accounts. After the transfer, the license will be removed from the original account. However, licenses that have already been applied to devices cannot be transferred.
The other account needs to bind your InCloud Manager email account:
1. The system administrator should click on "Company" in the page header to access the Enterprise Management page.
2. In the "Associate an MSP Account" section, enter your InCloud Manager email account and click "Update". You will see that account in the customer list.
3. In the "Subscriptions>> Licenses" page, select the license you want to transfer.
4. In the "Transfer Licenses" popup, confirm the license you want to transfer, select the customer, and click "Transfer" to complete the transfer successfully.
┃Note:
When you need to align the expiration time of equipment licensing services, you can better manage your business and unify financial reconciliation and settlement. You can do the following:
1. On the "Subscriptions>> Licenses" or "Subscriptions>> Devices" page.
2. Select the license that needs to be aligned with expiration time.
3. Click "Co-Termination".
4. Confirm the result information after unification, click "OK", and the system will automatically unify the expiration time of the selected license to the same time.
The license purchase process is as follows:
1. Go to the "Subscriptions >> Purchase" page.
2. Select the type of product to purchase the license.
3. Go to the license purchase page, select the required license type, subscription duration and quantity, and click "Buy Now".
4. Confirm the order, select the payment method, and click to pay.
5. After the payment is completed, the platform will automatically generate the license.
The device cannot go online after it is added to the platform. Please check:
1. Whether the network of the device is normal.
3. Confirm whether the current firmware version of the device supports connecting to the cloud platform.
4. If the device is connected to the Internet via cellular, please check whether the whitellisted address of the iot card includes: *.inhandcloud.com, *.amazonaws.com.
5. Whether the device is bound with a license? If not, you can enter "InHand Cloud Service >> Subscriptions" to bind the license.