Simcenter 3D Solutions “Invalid format” error when installing Remote Simulation Server using setup wizard on Windows workstation with multiple license servers defined in SPLM_LICENSE_SERVER environment variable.

Introduction to the problem

Starting from SC3D 2306 releases the included Remote Simulation tool can be installed with use of the setup wizard. It can be run from command prompt window when navigating to <server_installation_directory> and opening the “setup.bat” file. In general the setup is straightforward and described in detail in the documentation under the link: Remote Simulation installation and administration guide (siemens.com).

However, there might be some cases where problem might occur. One of scenarios which might result in error is having more than one license servers defined in SPLM_LICENSE_SERVER environment variable. In this case following error might be displayed in command prompt window after selecting “1” for installing a new Remote Solution server:

“docker: invalid reference format: repository name (library/29000@LocalHost) must be lowercase.”

“docker: invalid reference format”

The first error indicates that something might be wrong with SPLM_LICENSE_SERVER environment variable, however it is not providing the correct requirement.

Solution

There are two potential solutions to that problem:

1. The easiest one, but not always possible is to define SPLM_LICENSE_SERVER environment variable with only one license server.

2. This solution requires to modify the installation script. To do it following steps are requires:
   1. Go to <server_installation_directory>/scripts.
   2. Open in text editor file with a name “_setup_full.bat”.
   3. Look for line “-e SPLM_LICENSE_SERVER=%SPLM_LICENSE_SERVER% ^” (should be around line 54).
   4. Modify it by adding quotation marks (“) before and after %SPLM_LICENSE_SERVER% part of command. It should be modified as shown below:

default:              -e SPLM_LICENSE_SERVER=%SPLM_LICENSE_SERVER% ^

modified:          -e SPLM_LICENSE_SERVER="%SPLM_LICENSE_SERVER%" ^

1. 5. Save and close the file.

When one of the solutions is implemented the installation process can be started again by opening the “setup.bat” file in command prompt window from server installation directory. To complete the installation, follow the instruction included in the documentation under the link Remote Simulation installation and administration guide (siemens.com).