DSA Server Installation

Contents

• Downloads Page
• Requirements
  • Dart VM
  • Java VM
  • Node.JS
  • Hardware
    • Small Installation (Edge Broker)
    • Standard Installation
    • Large Installation
• Linux
  • Install as Linux Service
• Windows
  • Install as Windows Service
• macOS
  • Install as macOS Service
• RaspberryPi

Downloads Page

Use this page to download DSA Server: http://get.iot-dsa.org

You can also pre-install DSLinks with the server.

Requirements

Dart VM

DSA Server requires Dart VM to run broker and Dart DSLinks. When you download the server using the downloads page above, the Dart VM will be packaged with the server and doesn't require any additional installation steps. If you need to manually download Dart VM distribution follow the steps on this page. Supported Dart VM versions are 1.19.1 - 1.24.1.

Java VM

All the Java DSlinks require Java Virtual Machine to run. Please follow the installation steps for your platform:

• Oracle Java
• Open JDK
• Amazon Corretto

Java 8 is the required version to run DSLinks and Java SDK.

Node.JS

When using JavaScript DSLinks developed with JavaScript SDK, you might need to install Node.js. Use this page to download and install the version for your platform.

Hardware

DSA Server can work on various devices, starting with Raspberry Pi and going up to multi-core dedicated servers. Server performance will have a great impact on how many dslinks you'll be able to run simultaneously and even more on how many points and subscriptions broker can handle. Additional aspects, like having multiple downstream brokers require faster hardware and more memory. Here are several recommended configurations to keep in mind when choosing a server for DSA installation.

Points - number of individual data points available in your Data tree. Depending on how many users work with the system at the same time and what points they subscribe to, the number of actual subscriptions that the server can handle could be between X and X / 10, where X is a number of points in the table below.

Small Installation (Edge Broker)

This configuration is recommended for small installation, like a single building with several systems.

CPU	RAM	HDD	Points
1-2	2GB	2GB	≤ 2000

Standard Installation

This option is a good start for pretty much any project working with data from different sources.

CPU	RAM	HDD	Points
2-4	4-8GB	10GB	≤ 20000

Large Installation

If you're planning to aggregate data from tens or hundreds of sources, like 3-rd party databases, services, multiple buildings, and downstream connections, it's better to go with a high-performance server.

CPU	RAM	HDD	Points
16+	32-64GB	2TB	≤ 500000

* If you're going to store historical data on the same server in an external database or in ETSDB DSLink, please multiply HDD by 10.

Linux

Installation steps:

1. Open http://get.iot-dsa.org
2. Select x32/x64 Linux platform and download package.
3. Extract the ZIP file provided by the Get DSA Packager. The installation is self-contained, so feel free to move it anywhere on the hard drive.
4. Open a Terminal and change to the dglux-server directory in the extracted ZIP location.
5. Run the following commands:

chmod 777 bin/*.sh
./bin/daemon.sh start

You will be able to access DGLux at http://localhost:8080. Default credentials are: dgSuper / dg1234

Install as Linux Service

Follow these steps to install DSA Server as a service on Linux.

Windows

Installation steps:

1. Open http://get.iot-dsa.org
2. Select x32/x64 Windows platform and download package.
3. Extract the ZIP file provided by the Get DSA Packager. The installation is self-contained, so feel free to move it anywhere on the hard drive.
4. Navigate to the dglux-server folder in the extracted ZIP location.
5. Open a new Command Prompt here.
6. Run the following command:

bin\daemon.bat start

You will be able to access DGLux at http://localhost:8080. Default credentials are: dgSuper / dg1234

Install as Windows Service

1. Open a new Command Prompt as an Administrator in the dglux-server folder.
2. Run bin\daemon.bat install-service.
3. Now, you should see the server installed as a "DGLux Service" on your system, launched, and ready to work.

macOS

Installation steps:

1. Open http://get.iot-dsa.org
2. Select x32/x64 macOS platform and download package.
3. Extract the ZIP file provided by the Get DSA Packager. The installation is self-contained, so feel free to move it anywhere on the hard drive.
4. Open a Terminal and change to the dglux-server directory in the extracted ZIP location.
5. Run the following commands:

chmod 777 bin/*.sh
./bin/daemon.sh start

You will be able to access DGLux at http://localhost:8080. Default credentials are: dgSuper / dg1234

Install as macOS Service

Follow these steps to install DSA Server as a service on macOS.

RaspberryPi