How To: Use DSim Outside of DSim Desktop

Modified on Tue, 9 Jul at 6:08 PM

How To: Use DSim Outside of DSim Desktop

One of the advantages of DSim Desktop is that it sets up the terminal shell used for running DSim so that you do not have to worry about the details involved in making that happen. Once you have become proficient on how DSim works within DSim Desktop, you may want to run DSim in a terminal shell outside of DSim Desktop, so that it can be included in your own scripts. This article explains what is needed to run DSim outside of DSim Desktop.


1. Navigate to the DSim installation folder:

  • Windows: C:\Users\<username>\AppData\Local\metrics-ca\dsim\<version>
  • Linux: $HOME/metrics-ca/dsim/<version>

2. In your shell, run the shell_activate script appropriate for it.

  • .\shell_activate.ps1 for PowerShell
  • source shell_activate.bash for Bash

This activates DSim for the current shell only.

3. Optionally, you can activate DSim for future shell sessions by including the appropriate script in your PowerShell profile or .bashrc configuration file.

4. Set the environment variable DSIM_LICENSE to point to your license file. For example, if you let DSim Desktop generate your license,

  • In Windows, set it to: C:\Users\<user>\AppData\Local\metrics-ca\dsim-license.json
  • In Linux, set it to: $HOME/metrics-ca/dsim-license.json

5. Use the DSim commands in the DSim User Manual as if you're working on-prem.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article