2021:Grooper Licensing (Service): Difference between revisions

From Grooper Wiki
← Older editNewer edit →
Line 95: Line 95:
== Licensing Grooper from an active Grooper Licensing service ==
== Licensing Grooper from an active Grooper Licensing service ==


<tabs style="margin:20px">
{|cellpadding=10 cellspacing=5
<tab name=Prereqs style="margin:20px">
|valign=top style="width:40%"|
=== Before you begin ===
Imagine you have a second workstation from the machine you've already licensed.  Opening Grooper Design Studio for the first time on the second workstation, you will see this error message.  It's letting you know the product is not yet licensed.
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.
No big deal.  That's what the '''Grooper Licensing''' service is for! The first machine already running a licensed version of Grooper can create a '''Grooper Licensing''' service to hand out licenses to the second workstation (or multiple workstations).  
* Refer to the previous [[#Installing a Grooper Licensing Service|Installing a Grooper Licensing Service]] for information on how to set up the '''Grooper Licensing''' service.
|
[[File:Grooper-config-grooper-licensing-connection-1.png]]
|}


:1. Open the Grooper Design Studio application.
<tabs>
<tab name="Copy the Connection URL" style="margin:20px">
=== Copy the Connection URL ===


{|cellpadding=10 cellspacing=5
|valign=top style="width:40%"|
The first thing you will need is the '''''Connection URL''''' from the '''Grooper Licensing''' service.


[[file:1572460443763-874.png|center|900px]]
From the machine running the '''Grooper Licensing''' service, open Grooper Config.


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


:2. Expand the "Infrastructure" folder from the Node Tree in the left hand panel and select the "Machines" folder.
# Select the running '''Grooper Licensing''' service.
 
# Press the "Edit..." button.
 
#* Note: We won't actually edit the service. We're just doing this to find the '''''Connection URL''''' needed to license the unlicensed workstation.
[[file:1572533161679-972.png|center|900px]]
|
 
[[File:Grooper-config-grooper-licensing-connection-3.png]]
 
|-
:3. Using the property panel to the right of the Node Tree, select the "Add Machine..." button from the toolbar.
|valign=top|
 
In this window, copy the '''''Connection URL''''' listed here.
 
[[file:1572533232056-554.png|center]]
 
 
:4. Type the server's machine ID who is running the Grooper Licensing service and press the "OK" button.
 
 
[[file:1572533380890-285.png|center]]
 
 
''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]]
 


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="Step 1" style="margin:20px">
<tab name="Open Grooper Design Studio on the Unlicensed Machine" style="margin:20px">
=== Add a License Server ===
=== Open Grooper Design Studio on the Unlicensed Machine ===
 
: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]]
 
 
</tab>
<tab name="Step 2" style="margin:20px">
=== Configure the License Server ===
 
Using the "Server Name" property, select the server running the Grooper Licensing service and press "Save".
 
 
[[file:1572466731546-713.png|center]]
 
 
</tab>
<tab name="Step 3" style="margin:20px">
=== 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%"|
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.


# Press "OK" to continue.
|
[[File:Grooper-config-grooper-licensing-connection-5.png]]
|-
|valign=top|
# Select the root node of the Grooper Repository's Node Tree.
# We will use the '''''License Server URL''''' property to point to the '''Grooper Licensing''' service running on the other machine using the '''''Connection URL'''''' we copied earlier.
|
[[File:Grooper-config-grooper-licensing-connection-6.png]]
|}
</tab>
</tab>
<tab name="Step 4" style="margin:20px">
<tab name="Point to the License Server" style="margin:20px">
=== Verify your licensing ===
 
Navigate from the "Grooper Root" tab to the "Licensing" tab.  If successful, you will see your licensing information populated below.
 
 
[[file:1572467318228-805.png|center]]


=== Point to the License Sever ===
{|cellpadding=10 cellspacing=5
|valign=top|
# Select the '''''License Server URL''''' property.
# Paste the copied URL from the '''Grooper Licensing''' service.
#* Note:  You can also simply type in the URL.
# Press the "Save" button.
|
[[File:Grooper-config-grooper-licensing-connection-7.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:Grooper-config-grooper-licensing-connection-8.png]]
|}
</tab>
</tab>
</tabs>
</tabs>

Revision as of 14:22, 20 September 2021

Grooper Licensing is a Grooper Service that distributes licenses to workstations running Grooper applications.  Except for stand-alone Grooper installs, a Grooper Licensing service is required for all deployment scenarios.

Grooper can be licensed as "stand-alone" installations, where a single license is activated and registered to a local machine. Or, you can use a licensed installation as a server to hand out licenses to client machines. In this case, the licensed machine will run a Grooper service, called Grooper Licensing (also referred to as a "Grooper License Server"). The client Grooper installations will then call to the service to receive their licensing. This way, a single product license can be used to register multiple Grooper installations.

For client-server environments, a Grooper Licensing service is installed and started on the host server using Grooper Config.  Once the service is installed and running, client machines can access licencing via a connection URL referenced using the License Server URL property of a Grooper Repository's Root Node in Grooper Design Studio.


Installing a Grooper Licensing Service

Open Grooper Config

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 previous Licensing Grooper to an Individual Machine tutorial for more information on how to activate your license.

Services are installed and configured in the Grooper Config application.

⚠ You must run Grooper Config as an administrator to install, configure, start and stop services.

Add a New Service

  1. Press the "Edit Services..." button to add a new service.

This will bring up a Service Manager window to install, configure and otherwise manage Grooper services.

  1. Press the "Install..." button.
  2. This will bring up a window to install a Grooper Service.
  3. Select Grooper Licensing
  4. Press the "OK" button to continue.

  1. 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.
  2. 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.
  3. Press the "Execute" button to continue.

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.

Start the Service

  1. Upon pressing the "Execute" button, a new Grooper Licensing server is added to the list of services.
  2. However, notice its Status is listed as Stopped
    • Also, the icon next to the item is red.

We need to start the service in order for this machine to start hosting license distribution.

  1. Select the service you wish to start.
  2. Press the "Start" button.

  1. Upon successfully starting the service, you will see the Status change to Running
  2. 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.

Licensing Grooper from an active Grooper Licensing service

Imagine you have a second workstation from the machine you've already licensed. Opening Grooper Design Studio for the first time on the second workstation, you will see this error message. It's letting you know the product is not yet licensed.

No big deal. That's what the Grooper Licensing service is for! The first machine already running a licensed version of Grooper can create a Grooper Licensing service to hand out licenses to the second workstation (or multiple workstations).

Copy the Connection URL

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.

  1. Press the "Edit Services..." button.

This will bring up the "Service Manager" window.

  1. Select the running Grooper Licensing service.
  2. Press the "Edit..." button.
    • Note: We won't actually edit the service. We're just doing this to find the Connection URL needed to license the unlicensed workstation.

In this window, copy the Connection URL listed here.

You can close out of this window and Grooper Config at this point.

Open Grooper Design Studio on the Unlicensed Machine

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.

  1. Press "OK" to continue.

  1. Select the root node of the Grooper Repository's Node Tree.
  2. We will use the License Server URL property to point to the Grooper Licensing service running on the other machine using the Connection URL' we copied earlier.

Point to the License Sever

  1. Select the License Server URL property.
  2. Paste the copied URL from the Grooper Licensing service.
    • Note: You can also simply type in the URL.
  3. Press the "Save" button.

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.

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=2021:Grooper_Licensing_(Service)&oldid=7074"