Milesight DeviceHub Software User Guide

Mile sight Device Hub 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.)

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.
   

2. Open WinSCP and set up a session between WinSCP and server.
   

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

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

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.
   

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

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

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

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 Uninstallation

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

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:
   
   Select option 4 to backup the data. After backing up, the following message will appear.
   

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

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:
   

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

Export Log

Device Hub program supports exporting logs for troubleshooting.

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

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

Services and Ports

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

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

 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

References

• deploy.sh

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>