How-to Softlock License Server - Activation, Deactivation, and Log Monitoring

Introduction

There are two license scripts available to assist in automatically activating or deactivating online server licenses. These scripts simplify the task and help alleviate the manual effort of managing license servers over the Internet, especially during updates.

Note: These scripts are for online servers only. Offline servers must use the manual procedures outlined in the QPS documentation. These scripts will not work for offline servers. For offline scripts please see: https://qpssoftware.scrollhelp.site/lm/how-to-softlock-license-server-upgrade-or-refresh#:~:text=For%20offline%20activations

For online server activation using the scripts is straightforward and should result in updated license servers with minimal issues. The only requirement is a PowerShell window Run as Administrator in a modern Windows environment.

Finding the Scripts

The scripts are packaged with the QPS License Server package.

1. Visit the QPS website: http://www.qps.nl/

2. Go to the Downloads section.

3. Select any product to download (the License Server package is the same for all products).

4. Scroll down to the optional packages section.

5. Download the QPS License Server package.

6. Install the package on the server where convenient.

Activating a License

1. Open a PowerShell window Run as Administrator.

2. Authorize the shell to make changes to your device (click the shield icon in the tray).

3. Navigate to the directory where the QPS License Server package was installed.

4. Locate the bin\ directory, which contains the scripts.

5. Place your license XML file in the 00-Licenses\ directory (recommended for organization).

6. Run the activation script:

   PowerShell

   .\bin\activate-license.ps1 00-Licenses\5200000-2022323.xml

   Show more lines

   • Use Tab to autocomplete paths and filenames.

   • The license filename includes a date (e.g., 2022323 = March 23, 2022).

Tip: Always use the same license file for both activation and deactivation to ensure consistency.

Deactivating a License

1. Open a PowerShell window Run as Administrator.

2. Navigate to the same directory as above.

3. Use the same license XML file used during activation.

4. Run the deactivation script:

   PowerShell

   .\bin\deactivate-license.ps1 00-Licenses\5200000-2022323.xml

    

   Show more lines

Important: Do not use this script for offline servers. Follow the manual procedure in QPS documentation instead.

Watching the Log

The watch-log.ps1 script allows you to monitor the live log output of a specific license server product. This is useful for confirming server status and troubleshooting.

How to Use

1. Open a PowerShell window Run as Administrator.

2. Navigate to the directory where the QPS License Server package is installed.

3. Run the script with the product name as an argument.

Example

To watch the log for Fledermaus Offshore, use:

PowerShell

bin\watch-log.ps1 Fledermaus Offshore

Show more lines

• You can use Tab to autocomplete the script name and product name.

• To exit the live log view, press Ctrl+C in the terminal.

Conclusion

Activating or deactivating a license using the PowerShell scripts should be straightforward and quick. If there are any issues, please contact QPS Support.