Silent Installation (Offline/Online)#
For this installation type, you will use sam_apply.exe
(typically installed in C:\Program Files\SOFiSTiK\common\SOFiSTiK Application Manager (SAM)\sam_apply.exe
).
You can choose the source of the installation packages:
By default,
sam_apply.exe
will download and install from SOFiSTiK repository.Alternatively, you can refer to Get Offline Installation Files to install from your own repository.
Use Offline Installation Files#
Copy the repository directory to a location your clients can access. This location can be one of:
Network Share (SMB)
Web Server (HTTP/HTTPS)
Local Absolute Path (
C:\sofistik_mirror
)
Your repository will contain the newest
sam.msi
. Make sure to deploy it on your clients and keep it updated.Point the client to your repository via
repository
registry key inHKEY_LOCAL_MACHINE\SOFTWARE\SOFiSTiK\SAM
(for example, with reg.exe or regedit.exe).Key:
HKEY_LOCAL_MACHINE\SOFTWARE\SOFiSTiK\SAM
Name:
repository
Type:
REG_SZ
Examples for REG_SZ value:
Value:
file://C:\local\sofistik_mirror
or Value:
file://server/sofistik_mirror
or Value:
http://server/sofistik_mirror
or Value:
https://server/sofistik_mirror
To Start the Installation#
Make sure that your computer/client is ready for installation. See: Anti-virus, Permissions, Ports, Whitelisting, Proxy Settings
On your clients, install SOFiSTiK Application Manager from repository or sam.msi .
Download a configuration file sample_install.json and modify it to your needs. This file describes all products and parameters for the installation/update/deinstallation.
Make sure that all required platform products are installed on your clients (e.g. SOFiPLUS requires Autodesk AutoCAD).
(Optional) Install CodeMeter User Runtime for licensing. The latest setup can be found here: https://www.wibu.com/us/support/user/downloads-user-software.html
In an administrative command shell call:
"C:\Program Files\SOFiSTiK\common\SOFiSTiK Application Manager (SAM)\sam_apply.exe" --cli-input-json "C:\sofistik_mirror\sample_install.json"
Wait for the installation to complete. A Windows reboot might be necessary to apply all changes afterwards.
Note
Each execution of sam_apply.exe
creates a log file (sam_apply_*.log
) in the administrative user’s %TEMP%
directory. The log files are numbered, the highest number corresponding to the latest execution. This log file can be analysed to track down issues during the installation.
sample_install.json#
To download a sample file: sample_install.json
For silent installations, because the command line parameters for several options and products can get really long and complicated,
we decided to put them in a configuration file.
In this *.json
file (e.g. sample_install.json
) all installation settings can be configured to your likings.
A json file is an open-standard file format, comparable with xml or yaml. You can check for syntax errors with online tools when you search for “json validator”.
You can configure the following settings:
Setting |
Description |
||||||||
---|---|---|---|---|---|---|---|---|---|
|
This list field is used to determine wich products will be installed. Per default, the newest service pack available is installed (e.g. “sofiplus_50”). If you know what you do, you can specify the exact service pack with “{product_id}=={servicepack}.{hotfix}” e.g. “sofiplus_50==2.0”. This can make sense if your licenses are too old to use the latest service pack.
|
||||||||
|
SOFiSTiK root directory for installations. |
||||||||
|
Select the user interface language of the products. Can be |
||||||||
|
For example, depending on your AutoCAD 2020 version and language, you have to change the registry key
|
Service Pack Updates#
(Optional) Edit your
*.json
file if needed as described in sample_install.json.If you have an offline repository, update it and download the latest Serivce Pack as described in Get Offline Installation Files. Then run
sam_apply.exe
with your correctsample_install.json
(usually no==
SP restrictions).If you download & install from SOFiSTiK servers, just run
sam_apply.exe
with your correctsample_install.json
(usually no==
SP restrictions).