Skip to main content

License Setup

Using eMachineSim requires license registration. For license inquiries, contact SSIL from the following page:

https://www.ssil.co.jp/product/EMSolution/contact/

You may also use this link:

Contact SSIL for eMachineSim licensing

eMachineSim uses an encrypted license file. The standard file name is:

eMachineSim_license.dat

Keep the file in binary form when copying it between machines.

For most Windows users, place the license file here:

C:\Program Files\SSIL\eMachineSim\eMachineSim_license.dat

If you do not have permission to write under C:\Program Files, use one of the per-user or shared locations listed below, or set an environment variable.

License Search Order​

eMachineSim searches for the license file in this order.

1. Environment Variable​

Set one of the following environment variables to the full license-file path:

set EMACHINESIM_LICENSE_PATH=C:\path\to\eMachineSim_license.dat

or:

set EMACHINESIM_LICENSE=C:\path\to\eMachineSim_license.dat

For a persistent Windows user environment variable:

setx EMACHINESIM_LICENSE_PATH "C:\path\to\eMachineSim_license.dat"

Restart the terminal or Python environment after using setx.

2. Native Module Or Executable Directory​

eMachineSim also checks the directory that contains the native module or executable. For a wheel installation, this is normally the package directory containing:

eMachineSim.pyd

If you place the license file next to eMachineSim.pyd, use:

eMachineSim_license.dat

3. User And System Folders On Windows​

The following folders are also checked:

%APPDATA%\SSIL\eMachineSim\eMachineSim_license.dat
%LOCALAPPDATA%\SSIL\eMachineSim\eMachineSim_license.dat
%PROGRAMDATA%\SSIL\eMachineSim\eMachineSim_license.dat
C:\Program Files\SSIL\eMachineSim\eMachineSim_license.dat

The final C:\Program Files\SSIL\eMachineSim location is the recommended machine-wide location when administrator permission is available.

4. Linux Locations​

On Linux, eMachineSim checks:

$EMACHINESIM_LICENSE_PATH
$EMACHINESIM_LICENSE
$XDG_CONFIG_HOME/ssil/eMachineSim/eMachineSim_license.dat
$HOME/.config/ssil/eMachineSim/eMachineSim_license.dat
/etc/SSIL/eMachineSim/eMachineSim_license.dat
/usr/local/share/SSIL/eMachineSim/eMachineSim_license.dat
/usr/local/emsol/eMachineSim_license.dat

Version Check​

The input JSON contains:

{
  "metaData": {
    "type": "eMachineSimInput",
    "eMachineSimVersion": "0.1.1"
  }
}

The license file also contains an eMachineSimVersion. eMachineSim compares the main.sub part of the input version and the license version. For example, 0.1.1 and 0.1.3 are both treated as 0.1.

The input file is accepted when:

input eMachineSimVersion main.sub <= license eMachineSimVersion main.sub

Check The License​

After installing the wheel and placing the license file, run a small Python check:

import eMachineSim

print(eMachineSim.version())

Then run one of the bundled sample inputs. If the license file is missing, expired, for a different machine, or does not authorize the required module, eMachineSim reports a license error.

Notes​

  • Do not rename the license file unless you are using an environment variable that points to the full path.
  • License contents are encrypted. Do not edit the license file manually.
  • If you need a new license or have trouble with setup, contact SSIL: https://www.ssil.co.jp/product/EMSolution/contact/