Simcenter System Simulation Client for Git - Client - Installation Guide

Simcenter System Simulation Client for Git (also called "Client for Git" or "SCG") is a solution for collaborative management of models, data, and related artifacts for system simulation. This guide covers installing the client-side software once a Client for Git server is available on the network.

Prerequisites

System requirements

• Supported OS: Windows 11, Red Hat Enterprise Linux 8.x, Ubuntu 22.04 and 24.04
• A physical machine with a graphics card/drivers supporting OpenGL 2.0+. If using a VM, enable GPU passthrough.
• 16 GB RAM minimum (see memory configuration below)
• 1 GB disk space minimum
• 2 core CPU minimum

Linux package requirements:

# RHEL
yum install screen
yum install nautilus-python

# Ubuntu
apt-get install screen
apt-get install python-nautilus
apt-get install libxcb-xinerama0

If launching the installer in a Linux VM produces Can't connect to X11 window server...:

xauth list $DISPLAY
xauth add "<output of above command>"
# if `sudo xauth list` still shows issues:
sudo xauth remove "<DISPLAY_ID from output>"
sudo xauth add "<output of the list command>"
sudo ./Installer_build.sh

License agreement

Governed by the Siemens Terms of Use: www.siemens.com/corp/en/index/terms_of_use.htm

Installed software and other requirements

• A Client for Git license file or license server must be available.
• A Client for Git server must already be installed, configured, and reachable on the same network.
• No firewall restrictions should exist between client and server.
• Default port between client and server: 8080 (http). Configurable by the server admin.
• If a reverse proxy is configured, the default port becomes 443 (https).
• The client listens locally (not externally reachable) on two ports: 6565 for SCG_CORE.exe and 9090 for SCG_UX.exe. Both are configurable during client installation.

License manager installation

Licenses are managed by the Siemens License Server, downloadable from: https://support.sw.siemens.com/en-US/product/1586485382/downloads

Uses a license file (VENDOR can be ugslmd or saltd) identifying the server host and feature expiry dates. If a Simcenter product license already exists, only confirm it includes the Client for Git feature: lms_il_sdm_15. Full installation steps are in the Simcenter Amesim installation manual.

License management

The server requires feature lms_il_sdm_15 — one consumed per actively-using client. The feature auto-returns to the pool after 10-20 minutes of inactivity, even if Client for Git services keep running.

Required environment variables:

• VENDOR ugslmd: set SC1D_LICENSING_TYPE=ugs, and SPLM_LICENSE_SERVER=29000@license_server_hostname
• VENDOR saltd: set SC1D_LICENSING_TYPE=salt, and SALT_LICENSE_SERVER=29000@license_server_hostname

These must be set before Client for Git services launch. Changing them requires restarting the services via the Client for Git Configuration shortcut.

Installing on Windows

The installer auto-detects an existing installation and offers an upgrade — no need to manually uninstall first. Only one client version can be installed at a time. Installation requires administrator privileges; configuration (done afterward by the end user) does not.

1. Launch Simcenter_Client_For_Git_EC_[date].exe. The installation wizard opens (Welcome dialog).
2. Click Next — opens Select Destination Directory (default: Program Files; browsable to a custom path, which is created if it doesn't exist).
3. Click Next — opens Select Start Menu Folder (default: "Simcenter Client for Git").
4. Click Next — installation begins and file extraction progress is shown.
5. Click Finish to complete.

Post-install:

• A configuration wizard shortcut is created on the desktop (no admin rights needed to run it).
• The Configure Ports dialog lets you set the UX server port (default 9090) and gRPC port (default 6565) if the defaults are already in use.
• Agents launch automatically, and shortcuts are added to the Startup folder for both agents.
• If the server admin configured a reverse proxy (https), see "Configuring for Reverse Proxy" below.

Installing on Linux

1. Launch Simcenter_Client_For_Git_EC_[date].sh. Installation requires admin privileges; configuration does not.
2. Click Next — Select Destination Directory (default /opt/Simcenter, browsable to a custom path).
3. Click Next — installation proceeds with progress display.
4. Click Finish.

Post-install:

• The tool must be manually launched by each user.
• Configure Ports dialog (same defaults: UX Server 9090, gRPC 6565).
• Shortcuts to auto-start the agents are added to the user's crontab; details for license setup (SC1D_LICENSING_TYPE, LMS_LICENSE) must be manually added to those crontab entries, and the user session restarted. Edit with crontab -e.
• Reverse proxy considerations apply here too if configured server-side.

Verifying and configuring the client installation

On Windows, after launching Client_for_Git_Configuration, two Windows Taskbar icons should appear: one for SCG_Core.exe, one for SCG_UX.exe. Icon status meanings:

Status	Description
Running	Agent works properly; Client for Git can be used.
Stopped	Agent stopped (error or explicit user action); must be restarted.
Neutral	Agent not started; must be started manually.

Double-click an agent icon to open its utility (start/stop/restart). Agents auto-launch at Windows session start and auto-restart on crash. The license is only consumed while a tool is actively using Client for Git services (e.g., File System Client open), and is released automatically after 10-20 minutes of inactivity.

Configuring memory usage

Config files live in the installation's bin folder (default Windows path: C:\Program Files\Simcenter\Client For Git\bin):

SCG_CORE.vmoptions  ->  -XX:MaxRAM=16g
SCG_UX.vmoptions    ->  -XX:MaxRAM=1024m

Values are bytes with optional k/m/g suffixes. SCG_CORE handles all core SCG APIs (some local, some server calls) — default should rarely need changing (from 2404, uploads no longer consume excessive memory). SCG_UX backs the UI layer calling into core APIs.

Client properties file

%appdata%\Simcenter\scg\config\scg_config.properties:

GRPC_CLIENT_INBOUND_MSG_SIZE=50   # must not be changed
grpc_port=6565                    # default
SCG_USER_TOKEN=1234567890         # random token
LOG_LEVEL=INFO                    # DEBUG, WARN, ERROR also valid
workflow_port=9090                # default
THREAD_OPTION=0                   # 0 = unlimited threads during repo creation; positive int caps it

After any property change, restart SCG_CORE via the "Restart" action in its system tray context menu. THREAD_OPTION is useful for managing memory during upload of very large collections.

Configuring for Reverse Proxy

If the server admin has enabled https for all clients (see the Server Installation Guide), they should share a trust store file named cacerts. Replace the client's default file at:

{client directory}/jre/lib/security/cacerts

No agent restart is required after replacing this file.

Deploying a pre-configured client

For consistent multi-user rollouts, you can prepare a reference configuration and bundle it with the installer so users don't need to manually enter the server URL.

1. Prepare a reference configuration on a test machine:
   • Install and launch the client; complete configuration so services start.
   • Set the server URL under Settings (right-click empty space in a file-explorer folder → Simcenter Client for Git). The client validates server reachability.
   • Do NOT download or create local collections — that generates user-specific data unsuitable for sharing.
2. Configure optional external tools — the Compare Tool and Resolve Tool — only if they're available at a consistent path across all target users.
3. Stop Client for Git services — quit SCG_CORE and SCG_UX (via system tray on Windows, or double-click stop_exe.bat in the install folder).
4. Configure the package — locate the scgclientdb folder:
   • Linux: ~/.Simcenter/.scg/config/scgclientdb
   • Windows: %appdata%\Simcenter\scg\config\scgclientdb Compress it into an archive (e.g. .zip) — this is the portable configuration.
5. Deploy — perform a standard client install on each target machine.
6. Copy the portable configuration to each target machine's config path (replacing the existing scgclientdb folder) before first launch:
   • Linux: ~/.Simcenter/.scg/config/
   • Windows: %appdata%\Simcenter\scg\config\
7. Launch Client for Git — it starts with the pre-configured server URL and any configured external tools.

A reference configuration created on one OS can be reused on the other (Windows ↔ Linux).

Uninstalling

Warning: uninstalling loses record of all versions previously downloaded from the server. The downloaded files themselves are not deleted, but even reinstalling won't let you recover this version-tracking information. Upload any local modifications before uninstalling — you cannot upload them afterward even if you reinstall.

Before uninstalling, quit both SCG_UX and SCG_CORE agents so all installation files can be removed.

1. Run uninstall.exe from the installation folder.
2. Click Next to start the uninstall process.
3. Click OK to dismiss the "files/folders not removed" notice, then Finish.