DeviceOn
  • Get Started
    • ⬇️Resources Download
    • 💡About DeviceOn
      • Feature Highlight
      • Cloud Versions
      • Agent Versions
      • Security Architecture
    • 🛠️Installation and Deployment
      • Server (Standard)
        • Windows
        • Ubuntu
        • Azure Marketplace
        • AWS Marketplace
      • Server (Enterprise)
        • Azure Kubernetes
      • Agent
        • Windows
        • Ubuntu
    • ⏲️Version History
      • Version 5.3.12
      • Version 5.2.4
      • Version 5.1.2
      • Version 5.0.3
      • Version 4.7.2
      • Version 4.6.3
      • Version 4.5.5
      • Version 4.4.2
      • Version 4.3.10
      • Version 4.3.3
      • Version 4.2.3
    • ❓FAQ
      • General
      • Technical
  • SECURITY STANDARD
    • ISA/IEC 62443
    • Compliance
  • User Interface & Functions
    • 💻Server (Standalone)
      • Server Management Tools
      • Background Service
  • 🖥️Agent
    • User Interface
    • Background Services
  • 🏠Web User Interface
    • Overview
    • Device Management
      • Device List
      • Real-time Monitoring & Rule Engine
      • Remote Control & Diagnostic
      • Device Data
      • Device Group
      • Task Management (Batch Control)
      • Provision & Configuration
      • Anomaly Detection
    • App Management (OTA)
    • Container Management
    • System Setting
    • Dashboard
    • Event Logs
    • Account Management
  • LAB
    • 📦Application (OTA)
      • Package and Deploy your Application
      • Security Update for Windows
      • Upgrade DeviceOn Agent in On-premises DeviceOn Server
  • 🔧Out-of-Band
    • Intel AMT
      • Local Management (iAMT)
      • Cross-Network Integration (Open AMT)
    • IPMI
    • AMD DASH
    • Advantech iBMC
    • Advantech EdgeBMC
  • 🌐System
    • Update DeviceOn Server to the Latest Version
    • Enabling Automated Backups and Restores from Backup Archives
    • Enable Passive Mode on FTP Server
    • Enable HTTPs for DeviceOn Web Service
    • License Management
  • ⚒️Managed Devices
    • Set up Device Thresholds and Enable Trigger Notifications
    • Set up the Application Watchdog and Enable Trigger Notifications
    • Visualize Device Data through Grafana Dashboards
    • Onboard Multiple Devices at Once
    • Securely Connect to DeviceOn using x.509 Certificates
    • Enable Windows Lockdown Features
Powered by GitBook
On this page
  • Start Menu
  • Service Management
  • Reset to Default
  • Server Advanced Configuration
  • Server Diagnostic
  • Server Migration

Was this helpful?

  1. User Interface & Functions
  2. Server (Standalone)

Server Management Tools

PreviousServer (Standalone)NextBackground Service

Last updated 12 months ago

Was this helpful?

Start Menu

DeviceOn provides various widgets to assist server management, which can be found in Windows Start Menu.

Or can be found in installation path

C:\Program Files\Advantech\DeviceOn Server\Tools

Service Management

After the DeviceOn standalone version has been installed, a “Server Control” icon should show up in the system tray.

If it does not show up for some reason, please go to installation path and launch the program (ServerControl.exe) manually as shown here:

C:\Program Files\Advantech\DeviceOn Server\Tools\Server Management

Right-click the tray icon to open the status overview. A green light indicates the component is running normally. A red light means the corresponding service has stopped.

  • Management Service The “Management” service includes the DeviceOn backend core function and consists of two Java processes (DeviceOn and Provisioning Worker) that handle messages and process OTA traffic between the client and server.

  • Tomcat Service The DeviceOn web service uses Apache Tomcat to provide the user interface, APIs and WebSockets. For advanced configuration (SSL, connection pool, etc.), you may modify “server.xml” located in the installation folder.

  • PostgreSQL Service The relational database (PostgreSQL) is used to store account, device, map, permission data etc. A GUI tool called “omnidb-server” providing access to the PostgreSQL database comes with the PostgreSQL installation and is located in the installation folder as shown below. The default account is “postgres” and the password is the one you defined during the installation. We recommend you do not delete/edit any schema, table or data, since DeviceOn might stop to work if data is corrupt or missing.

    The defaut port of omnidb-server is 8000, and user/pwd is admin/admin.

  • MongoDB Service To process sensor data from client devices, DeviceOn leverages MongoDB to provide better performance and compression rates than relational databases. Click “Stop” to stop the MongoDB service.

  • RabbitMQ Service RabbitMQ is one of the most popular open-source message brokers and is used as “IoT Hub” to exchange messages between the server and client devices.

  • Grafana Service Grafana is a popular framework that allows you to query, visualize and alert on data from various data sources. DeviceOn supports a simple JSON API that as can be used as data source in Grafana, effectively making all DeviceOn data available to Grafana.

  • FTP Service To remote deploy the application to edge device via OTA, DeviceOn build-in a FTP service (Apache FTP) as a default storage. The Apache FtpServer is a 100% pure Java FTP server. It’s designed to be a complete and portable FTP server engine solution based on currently available open protocols. FtpServer can be run standalone as a Windows service or Unix/Linux daemon or embedded into a Java application.

Reset to Default

The DeviceOn server package includes a built-in restoration tool to revert your settings. You may need to use this if device configurations, data, apps, or system settings get changed without your knowledge. The tool will restore your server to its original post-installation state while retaining your current installation settings. All customizations made since installation will be overwritten.

C:\Program Files\Advantech\DeviceOn Server\Tools\Reset to Default

Server Advanced Configuration

The DeviceOn Server IP Adjustment tool allows quick modifications when needed, without reinstalling the server. Some cases where you may need to update the IP:

  • The IT network configuration changed the server IP

  • The SSL certificate was updated

This tool can change the IP entered during initial installation to a new fixed IP or domain name. This allows edge devices to connect after network changes.

Additionally, the tool can:

  • Modify the root account username suffix

  • Enable automatic MongoDB data recycling to clear old data from capped collections

C:\Program Files\Advantech\DeviceOn Server\Tools\Server Configuration
  • Web Server: Modify your IP/DNS Address. For Linux Server:

    sudo sed -i "s/CURRENT_IP/NEW_IP/g" /opt/advantech/deviceon/etc/deviceon/Server_Config.xml
    sudo systemctl restart deviceon-portal.service

    Example:

  • Login Account: Modify a suffix to the Root account username

  • MongoDB: Enable data recycling mechanism.

  • WebRTC: Update STUN server for WebRTC, default adopt Google’s WebRTC.

Server Diagnostic

The DeviceOn diagnostic tool helps technical staff troubleshoot server issues in the field. It checks the health of all services and collects relevant logs. After running the tool, a log.zip file is generated. Please send this to your DeviceOn support representative to assist with debugging any problems.

C:\Program Files\Advantech\DeviceOn Server\Tools\Server Diagnostic

Server Migration

The DeviceOn Server Migration tool, included in v4.4.2+, allows seamless transfer of your existing server installation to new hardware or cloud VMs (AWS/Azure). It migrates all device data, account information, configurations, etc.

💻