SystemLink Installer Fails With Error 1 at JupyterHub Package

Updated Mar 8, 2024

Reported In

Software

  • SystemLink Server
  • SystemLink

Issue Details

When I run the SystemLink installer, it fails with the JupyterHub package, returning "Error 1".  If I deselect the JupyterHub component, all other components install without issue.

Solution

This will occur if you are logged in with a user name that starts with the "$" character.  In this case there are two possible workarounds:
  • You can log in with a user name that does not start with the "$" character and re-run the installer.
  • You can create a particular Windows environment variable and re-run the installer. For example, if the Windows user is "$myuser", you will need to:
  1. Create an environment variable with the name "myuser".
  2. Set the value for that variable to be "$myuser".
envvar.png
 

Additional Information

The JupyterHub installer runs Python code and also dynamically runs the "pip" command to install modules.  The "pip" command interprets "$myuser" as a reference to a Windows environment variable named "myuser".  By creating such a "myuser" Windows environment variable with the value "$myuser", the pip command resolves "$myuser" correclty.