Troubleshooting

This guide provides solutions for common issues you may encounter while using SysIDE tools.

For issues not covered in this guide, please visit our community forum to get help and share solutions with other users.

For licensing inquiries and direct support, please email us at syside.support@sensmetry.com. Before contacting us, please check the Help us help you section.

Installation Issues

ModuleNotFoundError: No module named ‘syside’

This error occurs when Automator is installed in a virtual environment that hasn’t been activated. To resolve this:

  1. Navigate to the parent folder of your virtual environment in terminal

  2. Run the command based on your OS

Installing SysIDE on WSL

If you are using Windows Subsystem for Linux (WSL), you need to ensure that you have the Linux version of Modeler installed. The Windows version of Modeler will not work in WSL.

Licensing Issues

License Server Connectivity

The license server (hosted at keygen.sh) must be accessible for license activation.

To test your connectivity to the license server, run the following command in your terminal or command prompt:

curl -i https://api.keygen.sh/v1/ping

If the command returns a 200 OK response, similar to the one shown below, your connectivity to the license server is working.

HTTP/1.1 200 OK
Server: Cowboy
[...snip...]
Date: Fri, 04 Apr 2025 13:41:06 GMT
Via: 1.1 vegur

If connectivity fails:

  1. Contact your IT department to add api.keygen.sh to allow list.

  2. Request a temporary offline license from syside.support@sensmetry.com.

License File Cannot Be Validated

If the license file cannot be validated, please contact us at syside.support@sensmetry.com.

Help us help you

When reporting an issue, please provide the following information to help us diagnose your problem:

  1. A clear description of the issue you are experiencing

  2. The relevant .sysml file or files if the model consists of multiple user docs

  3. For Automator issues, include the .py script as well

For Modeler issues, please also provide the SysIDE Modeler output log by following these steps:

  1. Open the Output panel:

    • Press Ctrl-Shift-U (Command-Shift-U for MacOS) or

    • Press Ctrl-Shift-P (Command-Shift-P for MacOS) and type “Output: Focus on Output View”

  2. In the Output panel, select “SysIDE Modeler” from the dropdown menu (instead of “Tasks”)

  3. Copy the entire log output and include it in your report

Below is an example of what the Output panel and log should look like:

../_images/example_output.png