Skip to main content

Linux

This guide covers the installation and configuration of Aladdin SDS on Linux systems. You'll learn how to install the application as a Linux service and configure it to communicate with your IoT Edge server.

Run as a Linux Service​

Be sure to have Administrator permissions.

Follow these steps to install and run Aladdin SDS as a Linux service:

  1. Download the .deb installer from the Aladdin SDS Release page.
  2. Copy the file into a preferred folder, for example /home/Documents/AladdinSDS.
  3. Change to that folder and install the package:
sudo apt install ./aladdin-sds_X.Y.Z_amd64.deb
  1. Aladdin SDS is installed by default into:
/usr/lib/AladdinSDS

Configuration File​

In the installation folder, edit the config.toml file to set the IoT Edge Server IP address.

  1. Open the configuration file:
cd /usr/lib/AladdinSDS
sudo nano config.toml
  1. Replace localhost with the IoT Edge Server IP address:
# ----------------------------------------------------------------------------
# [edge] - Edge Gateway Configuration
# ----------------------------------------------------------------------------
# Settings for communicating with the Datalogic edge gateway.
[edge]

# host - Edge gateway hostname or IP address
#   Network address of the edge gateway for cloud connectivity.
#   Values:
#     - "localhost": Gateway running on same machine (development/testing)
#     - IP address: Remote gateway (e.g., "192.168.1.100")
#     - Hostname: DNS-resolvable name (e.g., "edge-gateway.local")
host = "localhost"
  1. Save and exit using these keys:
Ctrl + X    // to close the file
Y           // to accept the change
ENTER       // to exit
  1. Restart the service to apply the configuration change:
sudo systemctl restart aladdin-sds.service
  1. Verify the service status:
sudo systemctl status aladdin-sds.service

Aladdin SDS Status

note

You can find the OpenAPI documentation at http://localhost:9000/docs. Once AladdinSDS is installed and enabled, the OpenAPI documentation will also be available outside of localhost (e.g. https://IP_ADDRESS_POS:9000/docs).