│ Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Grooper Licensing

Web Service Grooper.Services

Serves runtime licenses to Grooper applications using a self-hosted web service.

Remarks

The Grooper Licensing service provides a secure, centralized mechanism for distributing and validating runtime licenses to Grooper applications and services within your environment. This service is required for self-hosted licensing scenarios, where Grooper clients and servers obtain their licenses from a local or on-premises license server rather than from the cloud.

The Grooper Licensing service is implemented as a self-hosted web service, running as a Windows service on a designated server. It exposes a secure HTTP(S) endpoint that Grooper applications contact to check out, validate, and manage licenses for all Grooper features and modules.

Licensing Modes

Grooper supports two primary licensing modes:

  • Cloud-Hosted Licensing:
    Licenses are obtained from the BIS cloud licensing service. No local license server is required.
  • Self-Hosted Licensing:
    Licenses are served by a local Grooper Licensing service instance. This is the mode enabled and managed by this class.

How It Works

  • The Grooper Licensing service is installed and configured on a server in your environment.
  • Grooper applications and services are pointed to the service's URL (e.g., http://servername:13900/LicenseService.svc) via the 'License Serial# or URL' property on the Root node.
  • When a Grooper client starts, it contacts the licensing service to check out a license. The service validates the request and issues a license package if available.
  • The service manages license checkouts, returns, and updates, ensuring compliance with your purchased license entitlements.
  • All communication can be secured using HTTPS, and the service can be configured to require certificates for added security.

Configuration and Setup

  1. Install the Service:
    Use the Grooper Command Console to install the Grooper Licensing service on your chosen server: GCC services install
  2. Activate or Import a License:
    • If you received a serial number, use GCC license download to activate.
    • If you have a license file, use GCC license import to import it.
    • For evaluation licenses, contact your sales associate.
  3. Configure Clients:
    Set the 'License Serial# or URL' property on the Root node to the full URL of your license service.
  4. Network Access:
    Ensure all Grooper clients and services can reach the license server on the configured port (default: 13900).

Best Practices

  • Run the Grooper Licensing service on a stable, always-available server.
  • Use HTTPS for secure communication, especially in production environments.
  • Document the service URL and keep license files and serial numbers secure.
  • Monitor the service and event logs for licensing errors or usage issues.
  • Restart Grooper services and applications after changing the license configuration.

Impact

  • If the Grooper Licensing service is unavailable or misconfigured, Grooper applications may be unable to start or may run in a restricted mode.
  • Proper configuration ensures compliance, security, and uninterrupted access to all licensed Grooper features.

Properties

NameTypeDescription
Web Service Settings
Service Settings
Notification