Setting up the Squish Floating License Server

Note: This Squish License Server only serves licenses of the Squish GUI Tester (Tester and Execution Subscriptions).

Squish Coco has its own license server.

Squish Test Center has its own activation and license handling mechanism.

Note: The Squish License Server is not available or required while evaluating Squish. Instead use the evaluation license key shown in the Squish Download Area when installing Squish.

Installing Squish License Server

The installer for Squish License Server is available in the Squish Download Area under Downloads > Squish [...] with one of the following filenames (the version number may differ):

  • macOS: squish-license-server-7.0.0-macos.pkg
  • Linux: squish-license-server-7.0.0-linux-x64.run
  • Windows: squish-license-server-7.0.0-windows-x86.exe

Executing the installer will install into one of the following directories:

  • macOS: /opt/squish-license-server
  • Linux: /opt/squish-license-server
  • Windows: C:\Program Files(x86)\Squish License Server\

Generating a Floating License File

After installation, you can find the licenseserver(.exe) program in the bin directory. It is a command-line tool that you need to run from a command prompt window.

Running the licenseserver without arguments will print out a machine-specific identifier and exit. Send the identifier to sales@froglogic.com along with your desired listening TCP port number. A floating license file will be generated which only works on the machine with the same identifier you sent. So take some time and think about which machine you want to host the license server on. Modifying the generated floating license file will invalidate it.

Linux Example

$ /opt/squish-license-server/bin/licenseserver
2022-01-21T12:14:48 Searching for license files (*.cfg) in '/etc/squish-license-server/licenses'
2022-01-21T12:14:48 No license files (*.cfg) were found in '/etc/squish-license-server/licenses'. Ensure license file(s) are in place and restart the server.
2022-01-21T12:14:48 Already activated floating license files can be downloaded from your customer area. To activate a floating license and assign it to this server, send the machine id "f7ff1122a223344f5544ff00", your customer id and the group number of the license you want to activate to our team at <sales@froglogic.com>. The customer id and license group number can be found in the customer area.

Windows Example

C:\>"C:\Program Files (x86)\Squish License Server\bin\licenseserver.exe"
2022-01-21T12:19:06 Searching for license files (*.cfg) in 'C:\ProgramData\Squish License Server\licenses'
2022-01-21T12:19:06 No license files (*.cfg) were found in 'C:\ProgramData\Squish License Server\licenses'. Ensure license file(s) are in place and restart the server.
2022-01-21T12:19:06 Already activated floating license files can be downloaded from your customer area. To activate a floating license and assign it to this server, send the machine id "f7ab1188a223344f8877bb12", your customer id and the group number of the license you want to activate to our team at <sales@froglogic.com>. The customer id and license group number can be found in the customer area.

Downloading the License File

After the license file has been generated, you can downloaded it from the froglogic customer area. Additionally, froglogic support will send it to you via email. Save the license file to the following location. You will need system administrator privileges to do this.

  • Linux: /etc/squish-license-server/licenses
  • macOS: /etc/squish-license-server/licenses
  • Windows: C:\ProgramData\Squish License Server\licenses

Setting up the Service

To set up and start the service, issue one of the following commands as an administrator:

  • Linux: systemctl start squish-license-server.service (or reboot the system once)
  • macOS: sudo /opt/squish-license-server/bin/licenseserver --install-service (installs and immediately starts the service)
  • Windows: Select Start > Services > Squish License Server > Start. Or in an Administrator Command Prompt: sc start squish-license-server (or reboot the system once)

After these steps, Squish License Server should be up and running. For further details on configuration and logging, see License Server.