│ Grooper Help - Version 25.0
25.0.0024 2,166

license

Manage licensing for a local Grooper license server.

Remarks

The license command group provides tools for managing Grooper licensing in environments where direct access to the public Grooper license server is not available, such as secure or isolated networks. These commands allow you to bind a license to a local server, import or download license files, refresh license status, and rehost licenses when moving to a new machine.

This group supports both online and offline activation scenarios. If the server can temporarily access the internet, you can use GCC license download to bind a license serial number directly to the machine. For servers with no internet access, you can use GCC license view to display the machine ID, which can be sent to Grooper licensing to request a license file. Once received, the license file can be imported using GCC license import.

After binding or importing a license, you should install the Grooper Licensing service using GCC services install and start it with GCC services start. To complete the setup, configure your Grooper repository to use the local license server by copying the "Connection URL" from the service properties and pasting it into the repository's license configuration.

The license group also provides commands to refresh license entitlements after renewal, and to export a rehost token if you need to move the license to a new server. These features help ensure compliance and business continuity during hardware changes or migrations.

Use these commands to set up, maintain, and migrate Grooper licensing in environments where online activation is not possible. For help on a specific command, use: gcc help license <command>

Commands

Below are the commands in this group

download <serialNo>

Download a Grooper license and bind it to this machine.

Downloads a Grooper license from the public license server using the provided serial number and binds it to the current machine. This command requires temporary internet access and is used for online activation.

Examples:

  1. Download and install a license using a serial number:
    gcc license download 12345678-90ab-cdef-1234-567890abcdef

Notes:

  • The license will be permanently bound to this machine and cannot be used for online activation elsewhere.
  • After downloading, use GCC license view to verify the license is installed.

serialNo

The Grooper licensing serial number to download and bind. Enter the serial number as a GUID (with or without dashes).

download <serialNo> <machineId> <directory>

Download a Grooper license file for offline activation on a target machine.

Downloads a Grooper license file (.lic) for a specified machine ID and saves it to a directory. Use this command when preparing an offline license for a machine that cannot access the internet. The resulting file can be transferred and imported using GCC license import.

Examples:

  1. Download a license file for a specific machine ID:
    gcc license download 12345678-90ab-cdef-1234-567890abcdef 00112233445566778899AABBCCDDEEFF C:\Licenses

Notes:

  • The machine ID must be obtained from the target machine using GCC license view.
  • The license file will be saved in the specified directory.
  • After downloading, transfer the file to the target machine and use GCC license import.

serialNo

The Grooper licensing serial number to download. Enter the serial number as a GUID (with or without dashes).

machineId

The unique machine ID of the target server. Obtain this value by running GCC license view on the target machine.

directory

The directory where the license file will be saved. Provide a valid local or network path accessible from this machine.

import <filename>

Import a Grooper license file for local hosting on this machine.

Imports a Grooper license file (.lic) and installs it for use by the local license server. Use this command when you have received a license file from Grooper licensing for offline activation.

Examples:

  1. Import a license file from a specified path:
    gcc license import C:\Licenses\Grooper.lic

Notes:

  • The license file must be a valid Grooper .lic file bound to this machine's ID.
  • After importing, use GCC license view to verify the license is installed.

filename

The full path to the Grooper license file (.lic) to import. Provide the complete file path, including the .lic extension. The file must be accessible from the local machine.

refresh

Check for license updates from the Grooper license server.

Checks for and applies any available updates to the installed Grooper license. Use this command to refresh the license after renewal or to ensure the latest entitlements are active.

Examples:

  1. Refresh the local license:
    gcc license refresh

Notes:

  • Requires internet access to contact the Grooper license server.
  • If updates are found, the license will be updated automatically.
  • Use GCC license view to verify the current license status.

rehost <exportPath>

Unbind the license from this machine and export a rehost token.

Unbinds the Grooper license from the current machine and exports a rehost token file. Use this command when moving a license to a new server. The token file must be sent to Grooper licensing to receive a new serial number.

Examples:

  1. Unbind the license and export a rehost token to a directory:
    gcc license rehost C:\Licenses\RehostTokens

Notes:

  • The exported token file must be emailed to licensing@bisok.com to request a new serial number.
  • After rehosting, the license will no longer be valid on this machine.

exportPath

The directory where the rehost token file will be saved. Provide a valid local or network path. The file can then be sent to Grooper licensing for rehosting.

view

Display information about the Grooper license bound to this machine.
Shows the local machine ID and details about the currently installed Grooper license package, if present. Use this command to view the machine ID required for offline licensing, or to verify which licenses are installed and active on this server.

Examples:

  1. View the local machine ID and license details:
    gcc license view

Notes:

  • If no license is installed, a message will indicate that no local license package is present.
  • The machine ID is required when requesting an offline license file from Grooper licensing.
  • For offline licensing, see also GCC license import and GCC license download.

For help on a specific command, use:
gcc help services <command>

Notification