The license data setup file is used to apply license configuration settings without user interaction. License settings allow for automatic activation of a product key, connection to a license server, and to suppress various end-user notifications. This file is typically used by IT Admins who are deploying our software with SCCM and want to configure the licensing during the deployment.
The license data setup file
Download the file LicenseDataSetup-Template.txt to get started.
- Edit this file to enable/disable the items listed below. Any text after a "#" is seen as a comment.
- Blank values will result in no change to an existing setting.
- This file can be used for both standalone and concurrent/network licensed applications.
How to use
There are three methods to apply license data/settings to the software.
- For Surfer 16+, Grapher 14+, and Strater 5.6+ - all three options below work, and licensing is set for all users on the computer.
- For Surfer 14/15, Grapher 13, and Strater 5.5 - only option 3 below will work, and licensing is set only for the running user.
Option 1: Apply license settings during installation
This is the best option for new installs using SCCM.
First, a file named "LicenseDataSetup.txt" will need to be placed in a shared location on the same computer that you are installing the program. This can be any shared location on the computer. In the example command below, the file was placed in C:\Temp\. The CMDLINE value must include all quote characters, and the file path must be a full absolute path.
msiexec /i "Surfer_16_Installer.msi" /quiet CMDLINE="ALLUSERS=""TRUE"" LIC_CONFIG_FILE=""C:\Temp\LicenseDataSetup.txt"""
Option 2: Apply license settings during one-time run of program
This is the best option for making licensing changes after the program is already installed.
Place a file named "LicenseDataSetup-<program>.txt" where <program> is replaced with "Surfer", "Surfer Beta", "Grapher", "Grapher Preview", or "Strater" in the folder C:\ProgramData\Golden Software\Shared\ on the same computer where you are installing the program.
Then wait for any user on the computer to run the program. The license settings will be applied automatically. The "LicenseDataSetup-<program>.txt" file will renamed as "LicenseDataSetup-<program>-Applied.txt" so that the change is applied only once.
Option 3: Apply license settings during launch of the program
Run the installed program EXE file once with the /licenseSettingsFile switch.
Example command:
"C:\Program Files\Golden Software\Grapher\Grapher.exe" /licenseSettingsFile="C:\ProgramData\Golden Software\Shared\LicenseDataSetup.txt"
Note: The CMDLINE value must include all quote characters, and the file path must be a full absolute path.
License Settings Available
The table below provides additional information about the available options that can be set using the license settings file.
Option |
Values |
Default |
Description |
Server |
<IP or hostname> |
Specify a server IP address or hostname to configure the application for network-licensed use automatically. Note: The application will activate the standalone license if both Server and ProductKeyToActivate are specified. However, the server license is given priority and will be used over the standalone license. |
|
ProductKeyToActivate |
<pkid string> |
Specify a Product Key to activate a standalone license to this PC automatically. Note: The application will activate the standalone license if both Server and ProductKeyToActivate are specified. However, the server license is given priority and will be used over the standalone license. |
|
HideExpiration |
True False |
False |
True hides the display of the maintenance expiration date in the License Information dialog in both standalone and network-licensed modes. |
HideProductKey |
True False |
False |
True hides the display of the Product Key in the License Information dialog in standalone mode. The License Information dialog does not display the PKID when using a concurrent license seat. |
DisableCommuting |
True False |
False |
True disables the commuter-license function in the License Information dialog. |
HideUpdate |
True False |
False |
True hides minor version update notifications from the end user. This overrides the File | Options 'automatically check for updates' flag for updates. |
HideUpgrade |
True False |
False |
Starting with Surfer v17 and Grapher v17, this setting is not used. Use 'HideUpdate' to hide both major and minor version updates. True hides major version upgrade notifications from the end user. This overrides the File | Options 'automatically check for updates' flag for updates. |
HideRegistration |
True False |
False |
True hides the end-user registration notification from the end user. |
SetCEIP |
Enable Disable |
No change |
Enable allows tracking to be specified by the end user as normal. Disable turns off anonymous usage tracking and ignores any user setting that attempts to enable tracking. |
*The default behavior is how the software behaves if the setting is not defined. The default behavior will not change a previously applied setting.
**The SetCEIP setting can be overwritten by the user in the software Options dialog by checking the Track Usage box.
Related articles:
Attachments:
Comments
0 comments
Please sign in to leave a comment.