When your simulation is ready, you can launch it. To launch the gs-sample simulation, follow these steps:

  1. Open a terminal or console.

  2. Go to the installation directory:

    • Windows:

      PS C:\> cd <installation_dir>\DeviceSimulator
    • Linux or macOS:

      $ cd <installation_dir>/DeviceSimulator
  3. Execute the simulator with the simulation to launch:

    • Windows:

      PS C:\> .\dsimulator.bat -s samples\gs-sample
    • Linux or macOS:

      $ ./dsimulator -s samples/gs-sample
  4. The application prompts for your Digi Remote Manager credentials to register simulated devices. You can include your account credentials as parameters, see Launch parameters.

  5. As of this point, the simulation is running. You can stop its execution by using Ctrl+C.

    2024-05-08 11:44:51.842 [INFO ] [main] -
    2024-05-08 11:44:51.844 [INFO ] [main] - Simulator started.
    Username: <user_name>
    Password:
    2024-05-08 11:45:01.866 [INFO ] [main] - Validating account information...
    2024-05-08 11:45:03.106 [INFO ] [main] - {"username":"<user_name>"","email":"tech.support@digi.com","first_name":"CORE","last_name":"Embedded Team","last_login":"2024-05-08T09:43:48.310Z","registration_date":"2012-10-31T08:21:00.930Z","enabled":true,"customer_id":1851,"role":"administrator","disable_local_auth":false,"accepted_tos_date":"2023-01-23T08:36:15.107Z"}
    2024-05-08 11:45:03.173 [INFO ] [main] - Starting simulation... This process may take a while depending on the number of devices to simulate.
    2024-05-08 11:45:03.228 [INFO ] [main] - Parsing simulation files...
    2024-05-08 11:45:03.300 [INFO ] [main] - Parsing routes files...
    2024-05-08 11:45:03.300 [INFO ] [main] - [Routes] Parsing routes in JSON file '<installation_dir>/samples/gs-sample/routes/truck_routes/minnesota.json'...
    2024-05-08 11:45:03.326 [INFO ] [main] - Routes are ready!
    2024-05-08 11:45:03.326 [INFO ] [main] - Generating simulated devices...
    2024-05-08 11:45:03.807 [INFO ] [main] - {"username":"<user_name>"","email":"tech.support@digi.com","first_name":"CORE","last_name":"Embedded Team","last_login":"2024-05-08T09:43:48.310Z","registration_date":"2012-10-31T08:21:00.930Z","enabled":true,"customer_id":1851,"role":"administrator","disable_local_auth":false,"accepted_tos_date":"2023-01-23T08:36:15.107Z"}
    2024-05-08 11:45:03.952 [INFO ] [main] - Starting up socket thread pool...
    2024-05-08 11:45:04.119 [WARN ] [main] - Failed to bypass verification for BouncyCastle provider
    2024-05-08 11:45:04.369 [INFO ] [main] - Registering and connecting simulated devices to account '<user_name>"'...
    2024-05-08 11:45:05.103 [INFO ] [main] - [Group - 'Trucks'] Recreating devices with different information...
    2024-05-08 11:45:06.982 [INFO ] [main] - Connecting to host=remotemanager.digi.com, port=3199. DeviceId=000A0003-XXXXXXXX-FF0FF0FF-FF0FF001
    2024-05-08 11:45:06.992 [INFO ] [main] - Connecting to host=remotemanager.digi.com, port=3199. DeviceId=000A0003-XXXXXXXX-FF0FF0FF-FF0FF002
    2024-05-08 11:45:06.993 [INFO ] [main] - Connecting to host=remotemanager.digi.com, port=3199. DeviceId=000A0003-XXXXXXXX-FF0FF0FF-FF0FF003
    2024-05-08 11:45:06.993 [INFO ] [main] - Connecting to host=remotemanager.digi.com, port=3199. DeviceId=000A0003-XXXXXXXX-FF0FF0FF-FF0FF004
    2024-05-08 11:45:06.993 [INFO ] [main] - Connecting to host=remotemanager.digi.com, port=3199. DeviceId=000A0003-XXXXXXXX-FF0FF0FF-FF0FF005
    2024-05-08 11:45:07.728 [INFO ] [pool-11-thread-1] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF001'] Connected successfully
    2024-05-08 11:45:07.729 [INFO ] [pool-11-thread-1] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF002'] Connected successfully
    2024-05-08 11:45:07.729 [INFO ] [pool-11-thread-1] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF003'] Connected successfully
    2024-05-08 11:45:07.729 [INFO ] [pool-11-thread-1] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF004'] Connected successfully
    2024-05-08 11:45:07.729 [INFO ] [pool-11-thread-1] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF005'] Connected successfully
    2024-05-08 11:45:07.794 [INFO ] [main] - All 5 Simulated Devices are online!
    2024-05-08 11:45:07.794 [INFO ] [main] - Refreshing data streams...
    2024-05-08 11:45:08.438 [INFO ] [main] - Starting IPC services to communicate with the user app...
    2024-05-08 11:45:08.439 [INFO ] [main] - Starting device requests broker...
    2024-05-08 11:45:08.452 [INFO ] [main] - Starting data points broker...
    2024-05-08 11:45:08.453 [INFO ] [main] - Waiting for brokers to initialize...
    2024-05-08 11:45:08.453 [INFO ] [main] - Starting user application worker service: 'python <installation_dir>/resources/user_app/simulation_handler.py <installation_dir>/samples/gs-sample -dr 5577 -dp 6577 --log=info --no-stdout'...
    2024-05-08 11:45:08.960 [INFO ] [main] - Communication with user app has started.
    2024-05-08 11:45:08.960 [INFO ] [main] - Scheduling data sample and upload processes, if configured...
    2024-05-08 11:45:08.962 [INFO ] [main] - Starting maintenance window recurring tasks on all devices...
    2024-05-08 11:45:08.962 [INFO ] [main] - [Group - 'Trucks'] Setting devices in service...
    2024-05-08 11:45:08.972 [INFO ] [pool-4-thread-3] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF003'] Entering maintenance window mode with duration of 5m...
    2024-05-08 11:45:08.972 [INFO ] [pool-4-thread-1] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF002'] Entering maintenance window mode with duration of 5m...
    2024-05-08 11:45:08.972 [INFO ] [pool-4-thread-2] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF005'] Entering maintenance window mode with duration of 5m...
    2024-05-08 11:45:08.973 [INFO ] [main] - Assigning routes to the devices and starting geolocation...
    2024-05-08 11:45:08.973 [INFO ] [pool-4-thread-4] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF004'] Entering maintenance window mode with duration of 5m...
    2024-05-08 11:45:08.973 [INFO ] [pool-4-thread-5] - [Device - '000A0003-XXXXXXXX-FF0FF0FF-FF0FF001'] Entering maintenance window mode with duration of 5m...
    2024-05-08 11:45:08.976 [INFO ] [main] - Simulation started.
See Launch a simulation for more information.