Acquiring ScripTouch Licenses: Difference between revisions

From Scriptel Wiki
Jump to navigation Jump to search
 
(36 intermediate revisions by 3 users not shown)
Line 2: Line 2:
[[Category:ScripTouch Remote]]
[[Category:ScripTouch Remote]]
[[Category:Scriptel Customer Portal]]
[[Category:Scriptel Customer Portal]]
In order to acquire licenses you will need an account on the [[Scriptel Customer Portal]]. You can sign up for a new account by going to [https://scriptel.com/portal the portal] and hitting the "Create New Account" button.
In order to acquire any Scriptel license you will need an account on the '''[https://portal.scriptel.com/#/login Scriptel Customer Portal]'''. If you have already been assigned a license, you already have an account. If not, you can sign up for a new account by going to the portal and hitting the "Create New Account" button.


If your organization is already registered with Scriptel you can have someone in your organization send you an invite or you can contact [[Scriptel Support]].
If your organization is already registered with Scriptel you can have someone in your organization send you an invite or you can contact '''[[Scriptel Support]]'''.


==Downloading a License File==
== Downloading a License File ==
In order to use paid software from Scriptel you'll need to have a license that will be granted to you as part of your purchase or evaluation. Licenses are granted through the use of the [[Scriptel Customer Portal]]. Each organization has a profile with which all licenses are associated. The licenses are downloaded together as part of a license file.
In order to use paid software from Scriptel you'll need to have a license that will be granted to you as part of your purchase or as a free evaluation. Licenses are granted through the use of the [[Scriptel Customer Portal]]. Each organization has a profile with which all licenses are associated. The licenses are downloaded together as part of a license file.


===Using the ScripTouch Toolbox===
== About Licenses and Installing Them ==
The simplest way to download the license file for your organization is by using the ScripTouch Toolbox:
Licenses are stored in a file. Any number of licenses may be stored in a single file. The application requiring the license looks through a set of directories for license files until it finds a license that allows the operation that it is trying to perform. The license file needs to be downloaded to your computer or remote share. There are three ways to do this. Use which ever you are more comfortable with.
#Download and install the [[ScripTouch Toolbox]] which can be retrieved from the [http://scriptel.com/support/downloads/ download page] on your client computer. For more information on installing the [[ScripTouch Toolbox]] please see this [[Installing ScripTouch Toolbox|installation guide]].
 
== Installation (Use Any of These) ==
You may use any of the following applications to install a Scriptel license: '''Sign and Save''', the '''ScripTouch Toolbox''' or a '''Web browser'''.
 
 
=== Using Sign and Save to Acquire Licenses ===
#Download and install the '''[[ScripTouch Sign and Save]]''' application which can be retrieved from the '''[http://scriptel.com/support/downloads/ download page]''' on your client computer. For more information on installing the '''[[ScripTouch Sign and Save]]''' application please see this '''[[ScripTouch Sign and Save installation |installation guide]]'''.
#Select '''License > License Updater'''.
#:<div style="padding:1rem;">[[File:SaSLicenses.png|300x300px]]</div>
#Fill in your portal credentials, click '''Login''', and once you have succeeded, click '''Download Licenses'''
#:<div style="padding:1rem;">[[File:SaSLicenseUpdater.png|300x300px]]</div>
 
=== Using the ScripTouch Toolbox to Acquire Licenses ===
The ScripTouch Toolbox application may be used to download the license:
#Download and install the '''[[ScripTouch Toolbox]]''' which can be retrieved from the '''[http://scriptel.com/support/downloads/ download page]''' on your client computer. For more information on installing the '''[[ScripTouch Toolbox]]''' please see this '''[[Installing ScripTouch Toolbox|installation guide]]'''.
#Open the ScripTouch Toolbox by using the icon created on the desktop.
#Open the ScripTouch Toolbox by using the icon created on the desktop.
#Select '''Settings > Online Settings'''.
#Select '''Settings > Online Settings'''.
<div style="padding:1rem;">[[File:Installing_ST_Remote_step3.jpg|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step3.jpg|300x300px]]</div>
#Enter your e-mail address and password for the [[Scriptel Customer Portal]] into the '''Registered E-mail''' and '''Registered Password''' fields.
#Enter your e-mail address and password for the [[Scriptel Customer Portal]] into the '''Registered E-mail''' and '''Registered Password''' fields.
#*If you don't have an account yet hit the '''Not Registered?''' link. A web browser will open and will give you the opportunity to create an account.
#*If you don't have an account yet hit the '''Not Registered?''' link. A web browser will open and will give you the opportunity to create an account.
<div style="padding:1rem;">[[File:Installing_ST_Remote_step4.jpg|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step4.jpg|300x300px]]</div>
#Click on '''Check Credentials.'''  
#Click on '''Check Credentials.'''
#*It should come back with a message that your credentials are valid. If your credentials aren't valid you can try resetting your password by going to the [https://scriptel.com/portal portal] and hitting '''Forgot Password''' button and following the on screen instructions. If this doesn't work please contact [[Scriptel Support]].
#*It should come back with a message that your credentials are valid. If your credentials aren't valid you can try resetting your password by going to the '''[https://scriptel.com/portal portal]''' and hitting '''Forgot Password''' button and following the on screen instructions. If this doesn't work please contact '''[[Scriptel Support]]'''.
<div style="padding:1rem;">[[File:Installing_ST_Remote_step5a.JPG|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step5a.JPG|300x300px]]</div>
#:[[File:Installing_ST_Remote_step5b.jpg|300x300px]]
#Select your '''Primary Organization''' from the drop down menu and then click on '''Save.'''
#Select your '''Primary Organization''' from the drop down menu and then click on '''Save.'''
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step5b.jpg|300x300px]]</div>
#Plug the Scriptel signature pad into your computer.
#Plug the Scriptel signature pad into your computer.
#:[[File:Installing_ST_Remote_step7.gif|300x300px]]
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step7.gif|300x300px]]</div>
#Click '''Settings > Enable Online''' to enable the online functionality of the Toolbox.
#Click '''Settings > Enable Online''' to enable the online functionality of the Toolbox.
#Click '''Settings > Check for Licenses'''. The Toolbox will download the license file and place it in the correct location for your user account. You'll get the following message when the file gets downloaded successfully:
#Click '''Settings > Check for Licenses'''. The Toolbox will download the license file and place it in the correct location for your user account. You'll get the following message when the file gets downloaded successfully:
#:[[File:Toolbox License File Download Success.png|300x300px]]
#:<div style="padding:1rem;">[[File:TBCheckForLicenses.png|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Toolbox License File Download Success.png|300x300px]]</div>


===Using a Web Browser===
=== Using a Web Browser to Acquire Licenses ===
In cases where you're behind a restrictive proxy or don't want to install the ScripTouch Toolbox it's also possible to retrieve the license file and place it in the correct location manually:
You may use a web browser to download the licenses rather than using the Toolbox. You will need to manually copy the license file the correct location:
#Log into the '''[https://scriptel.com/portal Scriptel Customer Portal]''' using your registered e-mail and password.
#Log into the '''[https://scriptel.com/portal Scriptel Customer Portal]''' using your registered e-mail and password.
<div style="padding:1rem 1rem 1rem 2rem;">[[File:Installing ST Remote step9.jpg|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Installing ST Remote step9.jpg|300x300px]]</div>
#If you're prompted for your organization make sure the correct organization is selected and press '''Choose'''.
#If you're prompted for your organization make sure the correct organization is selected and press '''Choose'''.
<div style="padding:1rem 1rem 1rem 2rem;">[[File:Scriptel Portal Organization Chooser.png|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Scriptel Portal Organization Chooser.png|300x300px]]</div>
#Navigate to the '''Licenses''' tab and hit the '''Download License''' button.
#Navigate to the '''Licenses''' tab and hit the '''Download License''' button.
<div style="padding:1rem 1rem 1rem 2rem;">[[File:Installing_ST_Remote_step10.jpg|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step10.jpg|600x249px]]</div>
#This will download a license file with an extension of '.lic' to your hard disk. Find this file and place it in 'C:\Program Files (x86)\Scriptel Corporation\Licenses'. You may need to create this folder.
#This will download a license file with an extension of '.lic' to your hard disk. Find this file and place it in 'C:\Program Files (x86)\Scriptel Corporation\Licenses'. You may need to create this folder.
#*For a complete list of locations you can put the license files and for information on how to change the location where you can put the license files please see [[Change ScripTouch Remote License Path]].
#*For a complete list of locations you can put the license files and for information on how to change the location where you can put the license files please see '''[[Change ScripTouch Remote License Path]]'''.


==Verify License is Installed Correctly==
==Verify License is Installed Correctly==
You can use the '''[[ScripTouch Toolbox]]''' to verify that your license file has been downloaded and installed correctly. Make sure a licensed device is plugged in to your computer and then start the ScripTouch Toolbox. Go to '''Help > License Viewer'''.
You can use the '''[[ScripTouch Toolbox]]''' to verify that your license file has been downloaded and installed correctly. Make sure a licensed device is plugged in to your computer and then start the ScripTouch Toolbox. Go to '''Help > License Viewer'''.


You'll see a window like the following:
'''You'll see a window like the following:'''


<div style="padding:1rem;">[[File:ScripTouch Toolbox License Viewer.png|300x300px]]</div>
<div style="padding:1rem;">[[File:ScripTouch Toolbox License Viewer.png|300x300px]]</div>


There are three windows in the License Viewer:
'''There are three windows in the License Viewer:'''
*Entitlements granted to this computer - These are the components for which this computer is presently licensed for. Any entitlements in this box are licensed and are ready to be used. If the box is blank you're not currently licensed for any Scriptel software products. There are several entitlements you could be granted:
*'''Entitlements granted to this computer''' - These are the components for which this computer is presently licensed for. Any entitlements in this box are licensed and are ready to be used. If the box is blank you're not currently licensed for any Scriptel software products. There are several entitlements you could be granted:
**mouse_signing - Enables '''[[Touch Signing]]'''
**enable_citrix - Enables '''[[ScripTouch Remote]]''' for Citrix XenApp and XenDesktop.
**enable_citrix - Enables '''[[ScripTouch Remote]]''' for Citrix XenApp and XenDesktop.
**enable_rdp - Enables '''[[ScripTouch Remote]]''' for Microsoft Remote Desktop.
**enable_rdp - Enables '''[[ScripTouch Remote]]''' for Microsoft Remote Desktop.
*Entitlements not granted to this computer (and why) - This box contains detected licenses that do not currently apply to your computer. The box will list possible entitlements and why it doesn't apply to this computer. Usually this indicates the ScripTouch device associated with the license isn't attached to the computer.
**msign_desktop** - Enables '''[[Scriptel mSign]]'''
*License Files Found - This box contains information about the license files that were found and the path that was searched to find those licenses.
*'''Entitlements not granted to this computer (and why)''' - This box contains detected licenses that do not currently apply to your computer. The box will list possible entitlements and why it doesn't apply to this computer. Usually this indicates the ScripTouch device associated with the license isn't attached to the computer.
*'''License Files Found''' - This box contains information about the license files that were found and the path that was searched to find those licenses.


If you believe you should be licensed for a component that isn't showing up in '''Entitlements granted to this computer''' please contact '''[[Scriptel Support]]'''.
If you believe you should be licensed for a component that isn't showing up in '''Entitlements granted to this computer''' please contact '''[[Scriptel Support]]'''.
Line 59: Line 76:
It is possible to purchase licenses from Scriptel that do not come pre-associated with a particular ScripTouch device. This is useful if you're not sure exactly where you'll need to use the licenses ahead of time and want to allocate the licenses as needed.
It is possible to purchase licenses from Scriptel that do not come pre-associated with a particular ScripTouch device. This is useful if you're not sure exactly where you'll need to use the licenses ahead of time and want to allocate the licenses as needed.


If you purchase licenses like this you'll need to associate the licenses to devices prior to using them. This can be done by
If you purchase licenses like this you'll need to associate the licenses to devices prior to using them. This can be done through the following steps.
#Log in to the '''[https://scriptel.com/portal/ Scriptel Customer Portal]'''.
#Log in to the '''[https://scriptel.com/portal/ Scriptel Customer Portal]'''.
#If prompted choose the organization you'd like to manage.
#If prompted choose the organization you'd like to manage.
#Go to the '''Licenses''' tab. You'll see a list of provisioned licenses, next to those licenses you'll see a '''Restrictions''' column. In the '''Restrictions''' column is a list of restrictions associated with the provisioned licenses.
#Go to the '''Licenses''' tab. You'll see a list of provisioned licenses, next to those licenses you'll see a '''Restrictions''' column. In the '''Restrictions''' column is a list of restrictions associated with the provisioned licenses.
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step10.jpg|300x300px]]</div>
#:<div style="padding:1rem;">[[File:Assigning a license restriction.PNG|600x285pxpx]]</div>
#Find a license where the '''DEVICE''' restriction is colored red instead of gray. This indicates that the license isn't allocated yet. Click the '''DEVICE''' label.
#Find a license where the '''DEVICE''' restriction is colored red instead of gray. This indicates that the license isn't allocated yet. Click the '''DEVICE''' label.
#You'll be prompted for the UUID of the device you'd like to associate with this license.
#You'll be prompted for the UUID of the device you'd like to associate with this license.

Latest revision as of 15:21, 7 May 2021

In order to acquire any Scriptel license you will need an account on the Scriptel Customer Portal. If you have already been assigned a license, you already have an account. If not, you can sign up for a new account by going to the portal and hitting the "Create New Account" button.

If your organization is already registered with Scriptel you can have someone in your organization send you an invite or you can contact Scriptel Support.

Downloading a License File

In order to use paid software from Scriptel you'll need to have a license that will be granted to you as part of your purchase or as a free evaluation. Licenses are granted through the use of the Scriptel Customer Portal. Each organization has a profile with which all licenses are associated. The licenses are downloaded together as part of a license file.

About Licenses and Installing Them

Licenses are stored in a file. Any number of licenses may be stored in a single file. The application requiring the license looks through a set of directories for license files until it finds a license that allows the operation that it is trying to perform. The license file needs to be downloaded to your computer or remote share. There are three ways to do this. Use which ever you are more comfortable with.

Installation (Use Any of These)

You may use any of the following applications to install a Scriptel license: Sign and Save, the ScripTouch Toolbox or a Web browser.


Using Sign and Save to Acquire Licenses

  1. Download and install the ScripTouch Sign and Save application which can be retrieved from the download page on your client computer. For more information on installing the ScripTouch Sign and Save application please see this installation guide.
  2. Select License > License Updater.
  3. Fill in your portal credentials, click Login, and once you have succeeded, click Download Licenses

Using the ScripTouch Toolbox to Acquire Licenses

The ScripTouch Toolbox application may be used to download the license:

  1. Download and install the ScripTouch Toolbox which can be retrieved from the download page on your client computer. For more information on installing the ScripTouch Toolbox please see this installation guide.
  2. Open the ScripTouch Toolbox by using the icon created on the desktop.
  3. Select Settings > Online Settings.
  4. Enter your e-mail address and password for the Scriptel Customer Portal into the Registered E-mail and Registered Password fields.
    • If you don't have an account yet hit the Not Registered? link. A web browser will open and will give you the opportunity to create an account.
  5. Click on Check Credentials.
    • It should come back with a message that your credentials are valid. If your credentials aren't valid you can try resetting your password by going to the portal and hitting Forgot Password button and following the on screen instructions. If this doesn't work please contact Scriptel Support.
  6. Select your Primary Organization from the drop down menu and then click on Save.
  7. Plug the Scriptel signature pad into your computer.
  8. Click Settings > Enable Online to enable the online functionality of the Toolbox.
  9. Click Settings > Check for Licenses. The Toolbox will download the license file and place it in the correct location for your user account. You'll get the following message when the file gets downloaded successfully:

Using a Web Browser to Acquire Licenses

You may use a web browser to download the licenses rather than using the Toolbox. You will need to manually copy the license file the correct location:

  1. Log into the Scriptel Customer Portal using your registered e-mail and password.
  2. If you're prompted for your organization make sure the correct organization is selected and press Choose.
  3. Navigate to the Licenses tab and hit the Download License button.
  4. This will download a license file with an extension of '.lic' to your hard disk. Find this file and place it in 'C:\Program Files (x86)\Scriptel Corporation\Licenses'. You may need to create this folder.
    • For a complete list of locations you can put the license files and for information on how to change the location where you can put the license files please see Change ScripTouch Remote License Path.

Verify License is Installed Correctly

You can use the ScripTouch Toolbox to verify that your license file has been downloaded and installed correctly. Make sure a licensed device is plugged in to your computer and then start the ScripTouch Toolbox. Go to Help > License Viewer.

You'll see a window like the following:

There are three windows in the License Viewer:

  • Entitlements granted to this computer - These are the components for which this computer is presently licensed for. Any entitlements in this box are licensed and are ready to be used. If the box is blank you're not currently licensed for any Scriptel software products. There are several entitlements you could be granted:
  • Entitlements not granted to this computer (and why) - This box contains detected licenses that do not currently apply to your computer. The box will list possible entitlements and why it doesn't apply to this computer. Usually this indicates the ScripTouch device associated with the license isn't attached to the computer.
  • License Files Found - This box contains information about the license files that were found and the path that was searched to find those licenses.

If you believe you should be licensed for a component that isn't showing up in Entitlements granted to this computer please contact Scriptel Support.

Associating Devices with Provisioned Licenses

It is possible to purchase licenses from Scriptel that do not come pre-associated with a particular ScripTouch device. This is useful if you're not sure exactly where you'll need to use the licenses ahead of time and want to allocate the licenses as needed.

If you purchase licenses like this you'll need to associate the licenses to devices prior to using them. This can be done through the following steps.

  1. Log in to the Scriptel Customer Portal.
  2. If prompted choose the organization you'd like to manage.
  3. Go to the Licenses tab. You'll see a list of provisioned licenses, next to those licenses you'll see a Restrictions column. In the Restrictions column is a list of restrictions associated with the provisioned licenses.
  4. Find a license where the DEVICE restriction is colored red instead of gray. This indicates that the license isn't allocated yet. Click the DEVICE label.
  5. You'll be prompted for the UUID of the device you'd like to associate with this license.
    • You can get the UUID by using the ScripTouch Toolbox. Use the Copy UUID link on the Information tab.
  6. Paste the UUID of the device you'd like to license into the Device UUID field and hit Submit.
  7. The DEVICE field will turn gray and the license is ready to use with your device. Re-download the license file for your organization as described above and the license should begin functioning.

If you accidentally assign the wrong device to a license please contact Scriptel Support.