Milesight DeviceHub Software User Guide

June 1, 2024
Milesight

Mile sight Device Hub Software

Milesight DeviceHub Software

INTRODUCTION

Mile sight Device Hub provides a high-efficiency, low maintenance On-Premises solution to allow easily deployment of Mile sight IoT devices across multiple locations, reducing complexity and increasing productivity. This guide will describe how to install Device Hub program.

CONNECTIONS

(*Mile sight routers and gateways compatibility are under development.)
Connections

System Requirements

Hardware

It is suggested to use a server that fits the following requirements:

For 500 devices and 2000 LoRaWAN end devices

  • CPU: 4 Cores, 3.2 GHz
  • RAM: 8 GB
  • Disk: 512 GB
  • Bandwidth: ≥100MBps

For 1000 devices and 2000 LoRaWAN end devices

  • CPU: 8 Cores, 3.2 GHz
  • RAM: 16 GB
  • Disk: 1 TB
  • Bandwidth: ≥100MBps

Note: the RAM should be more than 4GB, otherwise the Device Hub will not work well.

Software

  • Operating System: Ubuntu Server 22.04
  • Recommended Browser: Chrome

Operation Guide

Requirements

  • Ubuntu Server
  • Device Hub Installation Package: downloaded from Mile sight Website
  • WinSCP
  • Putty (or other SSH tool)

Device Hub Installation

Note: Take “Devicehubv2_ubuntu22.04-1.0.1.tar.gz” as an example in providing the the commands below, please use the commands according to real installation package name.

  1. Download the Device Hub and install package in your computer.
    Device Hub Installation

  2. Open WinSCP and set up a session between WinSCP and server.
    Device Hub Installation

  3. Select the Device Hub installation package and click “Upload”, select the server path and click “OK” to upload.
    Device Hub Installation

  4. Log in the server via Putty or other SSH tools.
    Device Hub Installation

  5. Ensure the network tool is installed in the server. You can type ipconfig to double check. If not found, execute apt install net-tools to install it.
    Device Hub Installation

  6. Navigate to the path including Device Hub installation package to unzip it:
    Device Hub Installation
    Device Hub Installation

  7. Navigate to the Device Hub folder, execute the deploy script:
    Device Hub Installation
    Select option 7 to install docker. If the server has already installed docker, skip this step. After installing, the following message will show.
    Device Hub Installation

  8. Execute the deploy script again, select option 1 to install Device Hub.
    Device Hub Installation
    After installing, the following message will appear.
    Device Hub Installation
    Users can also use command below to check if the DeviceHub is installed well.
    Device Hub Installation

  9. After installing, log in the Device Hub with IP address http://xx.xx.xx.xx. The default login info:
    Username: admin
    Password: password
    Device Hub Installation

Device Hub Uninstallation

  1. Navigate to the Device Hub folder, execute the deploy script:
    Device Hub Uninstallation
    Select option 6 to uninstall the Device Hub. After uninstalling, the following message will appear.
    Device Hub Installation
    Type “yes” to continue uninstalling docker or “no” to complete the device hub uninstallation.
    Device Hub Installation
    Users can also use below command to check if the Device Hub is removed.
    Device Hub Installation

Backup and Restore

When transferring the Device Hub program from one server to another, please refer below steps to backup the data from old server and restore it to the new server.

  1. Navigate to the Device Hub folder of old server, execute the deploy script:
    Backup and Restore
    Select option 4 to backup the data. After backing up, the following message will appear.
    Backup and Restore

  2. Export the backup data file from old server via WinSCP or other tool:
    Backup and Restore

  3. Install Device Hub program to the new server according to Device Hub Installation.

  4. Import the backup data file to the new server via WinSCP or other tool:
    Backup and Restore

  5. Navigate to the Device Hub folder of new server, execute the deploy script:
    Backup and Restore
    Select option 5 to restore the data, type the path of backup data file, then click Enter to restore the data.
    Backup and Restore

Export Log

Device Hub program supports exporting logs for troubleshooting.

  1. Navigate to the Device Hub folder of old server, execute the deploy script:
    Export Log
    Select option 3 to export the log files. After exporting, the following message will appear.
    Export Log

  2. Export the log files via WinSCP or other tool:
    Export Log

Services and Ports

In order to ensure the secured communication, here are some ports for the services:

Port Protocol Description
80 TCP HTTP Service
443 TCP HTTPS Service
1883 TCP MQTT Service
8883 TCP MQTTS Service
50000-50100 TCP Remote Access Service

Preface

This guide teaches you how to install Mile sight on-premises Device Hub platform.

Readers

This guide is intended for the following users:

  • Distributors
  • Network Planners
  • On-site technical support and maintenance personnel
  • Network administrators responsible for network configuration and maintenance

Copyright © 2011-2024 Mile sight. All rights reserved.
All information in this guide is protected by copyright law. Whereby, no organization or individual shall copy or reproduce the whole or part of this user guide by any means without written authorization from Xiamen Mile sight IoT Co., Ltd.

Revision History

Date Doc Version Description
Jan. 15, 2014 V 3.0 Device Hub V2 Initial version

 CUSTOMER SUPPORT

For assistance, please contact Mile sight technical support:
Email: iot.support@milesight.com
Tel: 86-592-5085280
Fax: 86-592-5023065
Address: Building C09, Software Park III, Xiamen 361024, China
Logo

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals