2.90:Grooper Licensing (Service): Difference between revisions

From Grooper Wiki
← Older edit
Undo revision 16071 by Rpatton (talk)
Tag: Undo
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<blockquote>
__NOINDEX__
Once you have your Grooper Repository initialized and connected, you need to activate your Grooper license.  When you purchased Grooper, you should have received a license key GUID, something like "1a2b3c4d-5e6f-7g8h-9i10-j11k12l13m14". You will need this GUID to license your Grooper installation.
{{AutoVersion}}
</blockquote>


{| class="wikitable" style="margin:left"
<blockquote>{{#lst:Glossary|Grooper Licensing}}</blockquote>
! Previous Versions
|-
|
[[Grooper Licensing - 2021|Grooper 2021]]<br>
[[Grooper Licensing - 2.90|Grooper 2.90]]
<br>
|}


There are three ways to license Grooper:
For client-server environments, a '''Grooper Licensing''' service is installed and started on the host server using [[Grooper Config]].  Then, a '''License Server''' object is created in [[Grooper Design Studio]] and configured with the host server's name and port number.  Next, the license is activated using the "Activate Online" button and entering Grooper serial number, or, if necessary, imported from a .lic file using the "Import License Package" button. 
* cloud hosted
* stand-alone
* self hosted


Client machines can then be set up to access licensing information by creating their own '''License Server''' object, referencing the host server's name and port number (Note: You will also need to add the server's machine id to the '''Machines''' folder to accomplish this).


Cloud hosted licensing is the easiest but ''least'' secure method of licensing.
* It is easiest because a Grooper Repository is licensed simply by entering the license GUID into a property at the root node in Grooper Design.  Licensing is decremented over the internet.
* However, all that's required to license the repository is the GUID.  It is not locked to any individual server or machine on use.
** This means any user with the license GUID and an internet connection can use the license.  Make sure to keep your GUID secure and do not share with anyone that you do not wish to have access.
* Also, be aware licensing is authorized by a licensing server internal to BIS.  If that server goes down, you may temporarily loose licensing.
** This is an exceptionally rare occurrence and our disaster recovery plan will switch to an alternate licensing server.  However, that switchover could take between one and two hours, in which time Grooper would not be licensed.


== Installing a Grooper Licensing service ==


The "stand-alone" and "self hosted" methods require additional setup using '''Grooper Config''' but are ''more'' secure.
<tabs style="margin:20px">
* These installations are more secure because the license is locked to an individual machine when the license key is activated. 
<tab name="Prereqs" style="margin:20px">
** If a user attempts to use the license GUID to license another Grooper installation, licensing will fail.
=== Before you begin ===
** For "self hosted" installations, licensing is distributed to client workstations via a URL provided by the '''Grooper Licensing''' service '''''not''''' the license GUID.


== Cloud Hosted Licensing ==
The Grooper Licensing service will allow one licensed machine to hand out licensing information to other workstations.
{|cellpadding=10 cellspacing=5
|valign=top style="width:40%"|
To license your Grooper repository using "cloud hosted" licensing, perform the following steps:


#Open the Grooper Web Client in a web browser. At the top you will see that the software is currently "UNLICENSED".
To do this, the machine installing the service must have an installed version of Grooper that has been activated with a product key or licensing package.
#Click the "Design" icon.
|
[[File:2023-Install and Setup-Licensing 01.png]]
|-
|valign=top|
#<li value=3>With the repository selected in the root node, make sure the "Root" tab is selected.
#Click to the right of the '''''License Serial# or URL''''' property and paste your activation key.
#Click the "Save" button.  


{|cellpadding=10 cellspacing=5 style="margin:12px"
|-
|style="font-size:200%; background-color:#662d91; color:white; width:28px; text-align:center"|'''&#8252;'''
|style="border: 4px solid #662d91"|
IMPORTANT: Again, when licensing Grooper this way, the GUID is not connected to any one machine. Your GUID can be used by any user with access to a web browser. Make sure to keep your GUID secure and do not share with anyone that you do not wish to have access.
|}
|
[[File:2023-Install and Setup-Licensing 02.png]]
|-
|valign=top|
#<li value=6>Close and re-open Grooper Design Studio. At the top the "LICENSEE" should now reflect your current license. You may begin using Grooper!
|
[[File:2023-Install and Setup-Licensing 03.png]]
|-


|}
</tab>
<tab name="Step 1" style="margin:20px">
=== Open Grooper Config ===


== Stand-Alone Licensing ==
:1. Open the Grooper Config application.  You will need to run the program as an administrator by right-clicking the icon and selecting "Run as Administrator" to install or edit the Grooper Licensing service (or any other service for that matter).


This portion of the article will instruct you how to perform "stand-alone" licensing.  It instructs you how to activate a Grooper license on an individual machine, using Grooper Config.


{|cellpadding="12" cellspacing="4" style="margin:12px"
[[file:1572450648459-124.png|center|900px]]
|-
|style="font-size:125%; background-color:#36b0a7; color:white; width:28px; text-align:center"|'''FYI'''
|style="border: 4px solid #36b0a7"|
If you ''only'' complete the steps below, you will have created a "stand-alone" licensed installation.
* Grooper will ''only'' be licensed to the machine ID activating the license.


Be aware these steps are also prerequisite to creating a "self hosted" licensed installation.  You must have an activated license in order for the '''Grooper Licensing''' service to hand out licensing information to client workstations! 
* The steps below describe how to activate a license on the host server.
* Importantly, the machine running the '''Grooper Licensing''' service (i.e. the host machine/server) ''must'' be the one that initially registers and activates the license.
|}


<tabs style="margin:20px">
:2. Navigate from the "Repository Connections" tab to the "Services" tab.
<tab name="Obtain a Grooper License" style="margin:20px">
=== Obtain a Grooper License ===


Frist, you will need to obtain a Grooper license in order to register and activate your installation.  You may receive your license in one of two ways.


# As a license key.
[[file:1572535141248-694.png|center|900px]]
#* This is by far the most common method.  You will receive a serial number key you can use to activate the product online (something like "a1bc2de3-12a3-a123-a1b2345c6de7")
# As a license package.
#* This is much less common.  A license package is a ".lic" file you can use to activate the product.  This is typically used for "locked down" environments where activating online is not an option.


{|cellpadding="12" cellspacing="4" style="margin:12px"
|-
|style="font-size:250%; background-color:#f89420; color:white; width:28px; text-align:center"|&#9888;
|style="border: 4px solid #f89420"|
If you are planning on installing a '''Grooper Licensing''' service to hand out licenses to other workstations, the machine activating the license '''''must''''' be the one to install the service. 


If you try to install the '''Grooper Licensing''' service on a product that has '''''not''''' activated a license as described in the next steps, it will fail to distribute licensing to other machines.
|}
</tab>
</tab>
<tab name="Open Grooper Config" style="margin:20px">
<tab name="Step 2" style="margin:20px">
=== Install the Service ===
 
:1. Press the "Install.." button in the toolbar to create a new Grooper service.
 
 
[[file:1572535205265-188.png|center|900px]]
 
 
:2. Select "Grooper Licensing" from the list of services and press the "OK" button.


=== Open Grooper Config ===


{|cellpadding=10 cellspacing=5
[[file:1572535507088-954.png|center]]
|valign=top style="width:40%"|
License activation and management is performed in the Grooper Config application.  Open Grooper Config and you will immediately see two things relating to licensing.


# The '''''License''''' property will inform you if the product has activated and registered a license.  In this case, we have not registered a license yet.  So, the property informs us ''No License Found''.
# The "Manage License..." button.  This button will navigate us to a license activation window.


{|cellpadding="10" cellspacing="5"
|-style="background-color:#36b0a7; color:white"
|style="font-size:14pt"|'''FYI'''||License activation changed somewhat in Grooper version 2021.  Prior to this version, license activation was performed in Grooper Design Studio.  As of Grooper 2021, license activation is performed in Grooper Config.
|}
|
[[File:Grooper-config-license-activation-1.png]]
|}
</tab>
</tab>
<tab name="Activate the License" style="margin:20px">
<tab name="Step 3" style="margin:20px">
=== Activate the License ===
=== Configure the Service ===
 
Enter the necessary information.  The "Host Name" property will be the name of the Machine installing the service.  You must also enter the username and password credentials for the account running the service.
 
The account specified must:
* Have the Logon as Service permission on the machine running the service.
* Have access to the Grooper database (if Windows security is being used for SQL connections).
* Have access to the Grooper file store location.
 
''In other words, the account should be able to fully access the Grooper Repository, since the repository consists of a the database and the file store.''
 
 
 
[[image:1572536699626-852.png|center]]
 


{|cellpadding=10 cellspacing=5
|valign=top style="width:40%"|
# Press the "Manage License..." button.
# The "Manage Licese" window will appear.
# Select the '''''Activation Method''''' property and use the dropdown menu to choose how you're activating the license.
#* For this tutorial we will choose ''OnlineActivation''.  This is the most common method, activating online with a serial number key.
|
[[File:Grooper-config-license-activation-2.png]]
|-
|valign=top|
# Select the '''''Serial Number''''' property.
# Enter your license serial number key.
# Press the execute button to activate your license.
|
[[File:Grooper-config-license-activation-3.png]]
|-
|valign=top|
# Upon successful license activation, you will see the following notification.
# Press the "OK" button to continue.
|
[[File:Grooper-config-license-activation-4.png]]
|}
</tab>
</tab>
<tab name="Verify Your License" style="margin:20px">
<tab name="Step 4" style="margin:20px">
=== Verify Your License ===
=== Start the Service ===
{|cellpadding=10 cellspacing=5
 
|valign=top style="width:40%"|
:1. Select the newly created service and press the "Start" button.
After activating your license, you will see the '''''License''''' property change from ''No License Found'' to ''Installed''.  It will also list your company's name (or who the license is registered to).
 
|
 
[[File:Grooper-config-license-activation-5.png]]
[[file:1572538757058-545.png|center|900px]]
|-
 
|valign=top|
 
You can also view more specific information about your license from Grooper Config.
''You will see the icon's color next to the service change from red to green, indicating the service is running.''
 
 
[[file:1572538762619-620.png|center|900px]]
 


# Select the '''''License''''' property.
# Press the ellipsis button at the end.
# This brings up a window displaying basic information about your license: the serial number used to activate Grooper, the licensee name, its expiration and last time the license was reset.
# Select the '''''Licenses''''' property and press the ellipsis button at the end to view even more specific information about your license.
|
[[File:Grooper-config-license-activation-6a.png]]
|-
|valign=top|
This will bring you a window displaying the specifics of your product license, including licensed OCR engines, how many concurrent connections to Grooper Design Studio can be made, volume licensing, and worker thread licensing.
|
[[File:Grooper-config-license-activation-7.png]]
|}
</tab>
</tab>
</tabs>
</tabs>


== Self Hosted Licensing ==
== Licensing Grooper from an active Grooper Licensing service ==
 
<tabs style="margin:20px">
<tab name=Prereqs style="margin:20px">
=== Before you begin ===
A machine already running a licensed version of Grooper may create a Grooper Licensing service to hand out licenses to workstations.  If you connected to a Grooper Repository from an existing database connection rather than creating a local one, this may be how you need to access your licensing.  You may also need to add the server running the service to the Machines folder.
 
You will need to add a License Server to point to the Grooper Licensing service.  However, Grooper Design Studio first needs connection information to the machine running the service.  You add this connection information manually by adding a networked machine ID to the Machines folder.  Once the machine running the service is added to the list of machines in Grooper Design studio, the workstation can access the Grooper Licensing service.
 
:1. Open the Grooper Design Studio application.
 
 
[[file:1572460443763-874.png|center|900px]]
 
 
:2. Expand the "Infrastructure" folder from the Node Tree in the left hand panel and select the "Machines" folder.
 
 
[[file:1572533161679-972.png|center|900px]]
 
 
:3. Using the property panel to the right of the Node Tree, select the "Add Machine..." button from the toolbar.
 
 
[[file:1572533232056-554.png|center]]
 
 
:4. Type the server's machine ID who is running the Grooper Licensing service and press the "OK" button.
 


{|cellpadding=10 cellspacing=5
[[file:1572533380890-285.png|center]]
|valign=top style="width:40%"|
 
# Imagine you have a second workstation from a machine you've already licensed (using the "stand-alone" licensing method).  Opening Grooper Design Studio for the first time on the second workstation, you will see that the repository is listed as "UNLICENSED" and several tabs and options will not be available to you.  
 
''The added machine ID will appear in the list of Machines when selecting the "Machines" folder as well as a Machines object as a child of the Machines Folder in the Node Tree.''
 
 
[[file:1572533477629-237.png|center|900px]]
 
 
</tab>
<tab name="Step 1" style="margin:20px">
=== Add a License Server ===
 
:1. Expand the "Infrastructure" folder from the Node Tree in the left hand panel and select the "License Servers" folder.
 
 
[[file:1572466314477-343.png|center|900px]]
 
 
:2. Right click on the "License Servers" folder.  Select "Add" and "License Server..."
 
 
[[file:1572466437216-382.png|center|900px]]
 
 
:3. Type a name for the License Server and press the "OK" button.
 
 
[[file:1572466547904-722.png|center]]


No big deal.  That's what "self hosted" licensing is for!  With one machine already running a licensed version of Grooper, you can install the '''Grooper Licensing''' service to hand out licenses to multiple other workstations.
|
[[File:2023 License Activation - 2023 01 Self Hosted Licensing 01.png]]
|}


Self-hosted licensing is accomplished in three steps:
</tab>
# Activate the Grooper license on the machine that will be the host server for licensing.
<tab name="Step 2" style="margin:20px">
#* See the [[#Stand-Alone Licensing]] instructions above for instructions.
=== Configure the License Server ===
# Install the '''Grooper Licensing''' service.
#* [[#Installing a Grooper Licensing Service|See below]]
# License client workstations
#* [[#Licensing Client Workstations|See below]]


=== Installing a Grooper Licensing Service ===
Using the "Server Name" property, select the server running the Grooper Licensing service and press "Save".


Once a license has been activated on a machine, you can distribute licensing to client workstations by installing a '''Grooper Licensing''' service.  This makes the single licensed machine a host, serving licenses to multiple machines. Installing the '''Grooper Licensing''' service is the first step in creating a "self hosted" licensing setup.
* Grooper Services are various executable applications that run as a Windows Service to aid Grooper. 
* The '''Grooper Licensing''' service will allow one licensed machine to hand out licensing information to other workstations.
* To do this, the machine installing the service must have an installed version of Grooper that has been activated with a product key or licensing package. 
** Refer to the [[#Stand-Alone Licensing]] tutorial for more information on how to activate your license.


<tabs style="margin:20px">
[[file:1572466731546-713.png|center]]
<tab name="Open Grooper Config" style="margin:20px">
=== Open Grooper Config ===


{|cellpadding=10 cellspacing=5
|valign=top style="width:40%"|
Services are installed and configured in the Grooper Config application.


{|cellpadding="12" cellspacing="4" style="margin:12px"
|-
|style="font-size:250%; background-color:#f89420; color:white; width:28px; text-align:center"|&#9888;
|style="border: 4px solid #f89420"|
You must run Grooper Config as an administrator to install, configure, start and stop services.
|}
|
[[File:Grooper-config-grooper-licensing-1.png]]
|}
</tab>
</tab>
<tab name="Add a New Grooper Licensing Service" style="margin:20px">
<tab name="Step 3" style="margin:20px">
=== Add a New Service ===
=== Set the License Server on the Grooper Root ===
 
:1. Select the Grooper Root at the top of the Node Tree in the left hand panel.  You will see the a property panel in the panel to the right.
 
 
[[file:1572469797042-163.png|center|900px]]
 
 
:2. Using the property panel on the right, select the created License Server from the drop down list on the "License Server" property.
 
 
[[file:1572467068025-912.png|center]]


{|cellpadding=10 cellspacing=5
|valign=top style="width:40%"|
# Press the "Edit Services..." button to add a new service.
|
[[File:Grooper-config-grooper-licensing-2.png]]
|-
|valign=top|
This will bring up a Service Manager window to install, configure and otherwise manage Grooper services.


# Press the "Install..." button.
# This will bring up a window to install a Grooper Service.
# Select '''Grooper Licensing'''
# Press the "OK" button to continue.
|
[[File:Grooper-config-grooper-licensing-3.png]]
|-
|valign=top|
# '''Grooper Licensing''' runs as a web service.  Client machines will point to the host machine, port number and URL path indicated here via the '''''Connection URL'''''.
#* The settings here are populated by default.  However, you can edit these if necessary.
# You must always enter service user authentication in order for the service to run.  Use the '''''User Name''''' and '''''Password''''' property to enter service user authentication.
# Press the "Execute" button to continue.
|
[[File:Grooper-config-grooper-licensing-4.png]]
|-
|valign=top|
{|cellpadding="10" cellspacing="5"
|-style="background-color:#36b0a7; color:white"
|style="font-size:14pt"|'''FYI'''||You may also configure default service user settings on the main Grooper Config screen.  If you enter authentication credentials here, you do not need to enter them when configuring the service.  This can save you time when installing and configuring multiple services.
|}
|
[[File:Grooper-config-grooper-licensing-5.png]]
|}
</tab>
</tab>
<tab name="Start the Service" style="margin:20px">
<tab name="Step 4" style="margin:20px">
=== Start the Service ===
=== Verify your licensing ===
{|cellpadding=10 cellspacing=5
 
|valign=top style="width:40%"|
Navigate from the "Grooper Root" tab to the "Licensing" tab.  If successful, you will see your licensing information populated below.
# Upon pressing the "Execute" button, a new '''Grooper Licensing''' server is added to the list of services.
 
# However, notice its '''''Status''''' is listed as ''Stopped''
 
#* Also, the icon next to the item is red.
[[file:1572467318228-805.png|center]]
|
[[File:Grooper-config-grooper-licensing-6.png]]
|-
|valign=top|
We need to start the service in order for this machine to start hosting license distribution.


# Select the service you wish to start.
# Press the "Start" button.
|
[[File:Grooper-config-grooper-licensing-7.png]]
|-
|valign=top|
# Upon successfully starting the service, you will see the '''''Status''''' change to ''Running''
# The icon next to the item will also change from red to green.


Now, this machine can use this '''Grooper Licensing''' service to hand out licensing information to workstations.  We will discuss how to configure workstations to do this in the next tutorial.
|
[[File:Grooper-config-grooper-licensing-8.png]]
</tab>
</tab>
</tabs>
</tabs>


=== Licensing Client Workstations ===
== Registering a license to an individual machine ==


Once the '''Grooper Licensing''' service is installed and running on a server, all you have to do is copy out a connection URL and paste it into an unlicensed Grooper Repository's root node.
While not strictly applicable to setting up the Grooper Licensing service, you do need an active license in order for the service to hand out licensing information to client workstations!  Importantly, the machine running the Grooper Licensing service ''must'' be the one that initially registers and activates the license.


<tabs style="margin:20px">
<tabs style="margin:20px">
<tab name="Copy the Connection URL" style="margin:20px">
<tab name="Prereqs" style="margin:20px">
=== Copy the Connection URL ===
=== Before you begin ===


{|cellpadding=10 cellspacing=5
You will need to obtain a Grooper license key or license package.
|valign=top style="width:40%"|
The first thing you will need is the '''''Connection URL''''' from the '''Grooper Licensing''' service.


From the machine running the '''Grooper Licensing''' service, open Grooper Config.
{|style="background-color:#f89420" cellpadding="10" cellspacing="5"
|-style="color:white"
|style="font-size:16pt"|'''!'''||If you are planning on installing a Grooper Licensing service to hand out licenses to other workstations, the machine activating the license ''must'' be the one to install the service.
|}


# Press the "Edit Services..." button.
|
[[File:Grooper-config-grooper-licensing-connection-2.png]]
|-
|valign=top|
This will bring up the "Service Manager" window.


# Select the running '''Grooper Licensing''' service.
</tab>
# Press the "Edit..." button.
<tab name="Step 1" style="margin:20px">
#* Note: We won't actually edit the service.  We're just doing this to find the '''''Connection URL''''' needed to license the unlicensed workstation.
=== Open Grooper Design Studio ===
|
 
[[File:Grooper-config-grooper-licensing-connection-3.png]]
:1. Open the Grooper Design Studio application.
|-
 
|valign=top|
 
In this window, copy the '''''Connection URL''''' listed here.
[[file:1572460443763-874.png|center|900px]]
 
 
:2. Select the Grooper Root at the top of the Node Tree in the left hand panel.  You will see the a property panel in the panel to the right.
 
 
[[file:1572461624005-286.png|center|900px]]
 


You can close out of this window and Grooper Config at this point.
|
[[File:Grooper-config-grooper-licensing-connection-4.png]]
|}
</tab>
</tab>
<tab name="Open Grooper Design Studio on the Unlicensed Machine" style="margin:20px">
<tab name="Step 2" style="margin:20px">
=== Open Grooper Design Studio on the Unlicensed Machine ===
=== Enter your licensing information ===
 
:1. Navigate from the "Grooper Root" tab to the "Licensing" tab in the right hand panel.
 
 
[[file:1572461632313-935.png|center]]
 
 
:2. Press the "Activate Online..." button to enter in a license key.
 
 
[[file:1572461639556-337.png|center]]
 
 
:3. Enter your license key serial number and press the "OK" button.
 
 
[[file:1572461644390-524.png|center]]
 
 
''Alternatively, you may activate Grooper by importing a .lic licensing package file by selecting "Import License Package..."''
 
 
[[file:1572462277829-775.png|center]]


{|cellpadding=10 cellspacing=5
|valign=top style="width:40%"|
Open Grooper Design Studio on the Unlicensed Machine.  This machine will also either need to connect to existing Grooper Repository or have a new one created from Grooper Config at this point.


# Select the root node of the Grooper Repository's node tree.
# Make sure you have the "Root" tab selected.
# We will use the '''''License Serial# or URL''''' property to point to the Grooper Licensing service running on the other machine using the Connection URL we copied earlier.
|
[[File:2023 License Activation - 2023 02 Licensing Client Workstations 01 Open Grooper Design Studio 01.png]]
|}
</tab>
</tab>
<tab name="Point to the License Server" style="margin:20px">
<tab name="Step 3" style="margin:20px">
=== Verify your licensing ===


=== Point to the License Sever ===
If successful, your licensing information will populate below.  If you do not see any licensing information, click the "Refresh" button at the end of the toolbar.
{|cellpadding=10 cellspacing=5
|valign=top|
# Select the '''''License Server URL''''' property and paste the copied URL from the '''Grooper Licensing''' service.
#* Note: You can also simply type in the URL.
# Now if you save and refresh the page, you will see that you are no longer UNLICENSED.
# You will also see you have access to a new tab called "Licensing".
|
[[File:2023 License Activation - 2023 02 Licensing Client Workstations 02 Point to the License Server 01.png]]
|-
|valign=top|
That's it!  This machine is licensed now, using the product license distributed by the '''Grooper License''' service.


# You can verify the product is licensed by navigating to the "Licensing" tab.  You can also view specifics about the product license here, as well.
 
|
[[file:1572461674132-642.png|center]]
[[File:2023 License Activation - 2023 02 Licensing Client Workstations 02 Point to the License Server 02.png]]
|}
</tab>
</tab>
</tabs>
</tabs>
[[Category:Articles]]
[[Category:Version 2.90]]

Latest revision as of 11:04, 5 August 2025


This article is about an older version of Grooper.

Information may be out of date and UI elements may have changed.

2025202320212.90

Grooper Licensing is a Grooper Service that distributes licenses to multiple workstations running Grooper applications.

For client-server environments, a Grooper Licensing service is installed and started on the host server using Grooper Config.  Then, a License Server object is created in Grooper Design Studio and configured with the host server's name and port number.  Next, the license is activated using the "Activate Online" button and entering Grooper serial number, or, if necessary, imported from a .lic file using the "Import License Package" button. 

Client machines can then be set up to access licensing information by creating their own License Server object, referencing the host server's name and port number (Note: You will also need to add the server's machine id to the Machines folder to accomplish this).


Installing a Grooper Licensing service

Before you begin

The Grooper Licensing service will allow one licensed machine to hand out licensing information to other workstations.

To do this, the machine installing the service must have an installed version of Grooper that has been activated with a product key or licensing package.


Open Grooper Config

1. Open the Grooper Config application. You will need to run the program as an administrator by right-clicking the icon and selecting "Run as Administrator" to install or edit the Grooper Licensing service (or any other service for that matter).



2. Navigate from the "Repository Connections" tab to the "Services" tab.



Install the Service

1. Press the "Install.." button in the toolbar to create a new Grooper service.



2. Select "Grooper Licensing" from the list of services and press the "OK" button.



Configure the Service

Enter the necessary information. The "Host Name" property will be the name of the Machine installing the service. You must also enter the username and password credentials for the account running the service.

The account specified must:

  • Have the Logon as Service permission on the machine running the service.
  • Have access to the Grooper database (if Windows security is being used for SQL connections).
  • Have access to the Grooper file store location.

In other words, the account should be able to fully access the Grooper Repository, since the repository consists of a the database and the file store.



Start the Service

1. Select the newly created service and press the "Start" button.



You will see the icon's color next to the service change from red to green, indicating the service is running.



Licensing Grooper from an active Grooper Licensing service

Before you begin

A machine already running a licensed version of Grooper may create a Grooper Licensing service to hand out licenses to workstations. If you connected to a Grooper Repository from an existing database connection rather than creating a local one, this may be how you need to access your licensing. You may also need to add the server running the service to the Machines folder.

You will need to add a License Server to point to the Grooper Licensing service. However, Grooper Design Studio first needs connection information to the machine running the service. You add this connection information manually by adding a networked machine ID to the Machines folder. Once the machine running the service is added to the list of machines in Grooper Design studio, the workstation can access the Grooper Licensing service.

1. Open the Grooper Design Studio application.



2. Expand the "Infrastructure" folder from the Node Tree in the left hand panel and select the "Machines" folder.



3. Using the property panel to the right of the Node Tree, select the "Add Machine..." button from the toolbar.



4. Type the server's machine ID who is running the Grooper Licensing service and press the "OK" button.



The added machine ID will appear in the list of Machines when selecting the "Machines" folder as well as a Machines object as a child of the Machines Folder in the Node Tree.



Add a License Server

1. Expand the "Infrastructure" folder from the Node Tree in the left hand panel and select the "License Servers" folder.



2. Right click on the "License Servers" folder. Select "Add" and "License Server..."



3. Type a name for the License Server and press the "OK" button.



Configure the License Server

Using the "Server Name" property, select the server running the Grooper Licensing service and press "Save".



Set the License Server on the Grooper Root

1. Select the Grooper Root at the top of the Node Tree in the left hand panel. You will see the a property panel in the panel to the right.



2. Using the property panel on the right, select the created License Server from the drop down list on the "License Server" property.



Verify your licensing

Navigate from the "Grooper Root" tab to the "Licensing" tab. If successful, you will see your licensing information populated below.



Registering a license to an individual machine

While not strictly applicable to setting up the Grooper Licensing service, you do need an active license in order for the service to hand out licensing information to client workstations! Importantly, the machine running the Grooper Licensing service must be the one that initially registers and activates the license.

Before you begin

You will need to obtain a Grooper license key or license package.

! If you are planning on installing a Grooper Licensing service to hand out licenses to other workstations, the machine activating the license must be the one to install the service.


Open Grooper Design Studio

1. Open the Grooper Design Studio application.



2. Select the Grooper Root at the top of the Node Tree in the left hand panel. You will see the a property panel in the panel to the right.



Enter your licensing information

1. Navigate from the "Grooper Root" tab to the "Licensing" tab in the right hand panel.



2. Press the "Activate Online..." button to enter in a license key.



3. Enter your license key serial number and press the "OK" button.



Alternatively, you may activate Grooper by importing a .lic licensing package file by selecting "Import License Package..."



Verify your licensing

If successful, your licensing information will populate below. If you do not see any licensing information, click the "Refresh" button at the end of the toolbar.


Retrieved from "https://wiki.grooper.com/index.php?title=2.90:Grooper_Licensing_(Service)&oldid=29902"