Launch a simulation |

Once you define your simulation you can launch it. There are two launch modes:

Interactive mode to be able to communicate with the simulation in progress.
Unattended mode when the goal is to leave the simulation running without any external interaction.

Interactive mode

This mode allows you to launch your simulation and get information or perform specific operations with simulated devices while running.

This is the default mode if no parameter is specified when launching. Parameter -i, --interactive also allows to enable this mode. For more information about parameters see Launch parameters.

The log of the application is redirected to a file inside the logs folder of the installation directory, <installation_dir>/logs/.

After entering in interactive mode, the prompt simulator> is displayed so you can type any supported CLI commands:

$ ./dsimulator

Simulator started.
simulator> 
────────────────────────────────────────────────────────────────────────────────────────

For more information about the existing commands in an interactive session, see Command Line Interface (CLI).

If a simulation is passed using -s, --simulation parameter, the IoT Device Simulator asks for your Digi Remote Manager credentials if they are not provided with -u, --user and -p, --password parameters.

Some interactive execution examples:

Windows

Interactive session without parameters
```
PS C:\> .\dsimulator.bat
```
Interactive session with Remote Manager account user and password
```
PS C:\> .\dsimulator.bat -u <user> -p <password>
```
Interactive session with simulation and Remote Manager account user
```
PS C:\> .\dsimulator.bat -s samples\gs-sample -u <user> -i
```

Linux or MacOS

Interactive session without parameters
```
$ ./dsimulator
```
Interactive session with Remote Manager account user and password
```
$ ./dsimulator -u <user> -p <password>
```
Interactive session with simulation and Remote Manager account user
```
$ ./dsimulator -s samples/gs-sample -u <user> -i
```

Unattended mode

In this case, the path to the simulation to run must be included with the parameter -s, --simulation and the interactive parameter should not be included.

For more information about parameters see Launch parameters.

The application logs out to the console and to a file inside logs folder of the installation directory <installation_dir>/logs/.

The IoT Device Simulator asks for your Remote Manager credentials if they are not provided with -u, --user and -p, --password parameters.

Some unattended execution examples:

Windows

Unattended session with a simulation

PS C:\> .\dsimulator.bat -s samples\gs-sample

Unattended session with simulation and Remote Manager account user and password
```
PS C:\> .\dsimulator.bat -s samples\gs-sample -u <user> -p <password>
```

Linux or MacOS

Unattended session with a simulation
```
$ ./dsimulator -s samples/gs-sample
```
Unattended session with simulation and Remote Manager account user and password
```
$ ./dsimulator -s samples/gs-sample -u <user> -p <password>
```