Skip to main content

Installation

Run as a Windows Service​

Follow these steps to run the Aladdin SDS as a Windows Service:

  1. Download the .msi installer from Aladdin SDS Installer.

  2. Run the installer. The installation process is two-step:

    • Datalogic SDS Updater service
    • AladdinSDS

  3. Select the installation folder for Datalogic SDS Updater:

    Datalogic SDS Updater Folder

  4. Select the installation folder for Datalogic SDS Updater:

    Datalogic SDS Updater Folder

  5. Check if AladdinSDS is running in the task manager:

    Aladdin SDS Version

  6. Open Aladdin SDS. Check if the version is the same as the one of the binary:

    {
       "version": "1.1.2",
       "memoryUsage": {
          "init": 528482304,
          "used": 23519312,
          "committed": 71303168,
          "max": 8447328256
       },
       "apiVersion": "1.1.2"
    }

  7. You can find the OpenAPI documentation at http://localhost:9000/docs.

Installation Folders​

The Aladdin SDS installation consists of two main components, each located in different directories:

Configuration Files (Shared)​

Both the Datalogic SDS Updater and AladdinSDS services store their configuration files in:

C:\ProgramData\Datalogic\

with the following subdirectories:

  • *C:\ProgramData\Datalogic\SDSUpdater* - SDS Updater configuration and resources

    • config.toml - Updater service configuration
    • downloads/ - Downloaded update packages
    • logs/ - Updater service logs
    • resource/ - Updater resources

  • *C:\ProgramData\Datalogic\AladdinSDS* - AladdinSDS configuration and data

    • config.toml - AladdinSDS service configuration
    • config.properties - Additional configuration properties
    • log4j2.properties - Logging configuration
    • otel.properties - OpenTelemetry configuration
    • dlrmus/ - Runtime modules
    • packages/ - Installed packages and plugins
    • resource/ - Resource files

Application Files and Logs (User-Selected)​

During installation, you select a folder where AladdinSDS application files and logs are stored. By default, this is:

C:\Program Files\Datalogic\AladdinSDS\

This folder contains:

  • AladdinSDS-<version>.jar - Main application JAR file
  • AladdinSDS.exe - Windows service executable
  • DeviceDetectionLib.jar - Device detection library
  • dl-sdk-service-service.exe - Service wrapper executable
  • opentelemetry-javaagent-<version>.jar - Telemetry agent
  • jre/ - Java Runtime Environment
  • certs/ - Certificate files for MQTT/TLS connections
  • log/ - Application runtime logs
  • resource/ - Application resources
  • scripts/ - Utility scripts
note

Configuration changes should be made to the files in C:\ProgramData\Datalogic\, not in the application folder. After modifying configuration files, restart the service for changes to take effect.

Configuring Aladdin SDS​

The primary configuration is managed through the config.toml files located in C:\ProgramData\Datalogic\AladdinSDS\config.toml (for AladdinSDS) and C:\ProgramData\Datalogic\SDSUpdater\config.toml (for the Updater).

For detailed configuration documentation, see:

  • AladdinSDS Configuration - Complete guide for configuring the main AladdinSDS service including MQTT, HTTP API, agent settings, and device filters.
  • SDS Updater Configuration - Guide for the automatic update service configuration including update checks, schedules, and Edge gateway integration.
tip

Always backup the config.toml files before making changes, as incorrect configuration may prevent the service from starting. After modifying configuration files, restart the respective service for changes to take effect.