Acquiring ScripTouch Licenses: Difference between revisions

From Scriptel Wiki
Jump to navigation Jump to search
No edit summary
 
(65 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Before you can install ScripTouch Remote, your organization needs an account set up on the [http://scriptel.com/portal Scriptel customer portal] and your new software needs a ScripTouch Remote license. If either of these conditions are not met or you do not know the status of these conditions, please contact our support team at [mailto:support@scriptel.com support@scriptel.com] or by phone at 844-972-7478.
[[Category:ScripTouch Toolbox]]
[[Category:ScripTouch Remote]]
[[Category:Scriptel Customer Portal]]
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.


You will also need to set up a user account on the [http://scriptel.com/portal Scriptel customer portal]. If you need help registering your new account, please visit our guide on new user registrations.
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 you don’t have physical access to the client computer, please see our Installing ScripTouch Remote Alternate Installation guide.
== 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.


To use ScripTouch Remote simply follow the listed steps below:
== Installation (Use Any of These) ==
# Download and install the Scriptel Toolbox by navigating to http://scriptel.com/support/downloads/ on your client computer.
You may use any of the following applications to install a Scriptel license: '''Sign and Save''', the '''ScripTouch Toolbox''' or a '''Web browser'''.
#:[[File:Installing_ST_Remote_step1.jpg]]
 
#Open the Toolbox.
 
=== 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.
#Select '''Settings > Online Settings'''.
#Select '''Settings > Online Settings'''.
#:[[File:Installing_ST_Remote_step3.jpg]]
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step3.jpg|300x300px]]</div>
#Enter your registered e-mail address and password.
#Enter your e-mail address and password for the [[Scriptel Customer Portal]] into the '''Registered E-mail''' and '''Registered Password''' fields.
#*If you do not have a Scriptel customer portal account associated with your organization’s account, please contact our support team at support@scriptel.com or by phone at 844-972-7478.
#*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 have changed your password on your portal account, you will need to update it before proceeding. If you have forgotten or lost your password you can recover it by navigating to http://scriptel.com/portal/#forgot-password.
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step4.jpg|300x300px]]</div>
#:[[File:Installing_ST_Remote_step4.jpg]]
#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 it does not, please contact our support team at support@scriptel.com or by phone at 844-972-7478.
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step5a.JPG|300x300px]]</div>
#:[[File:Installing_ST_Remote_step5a.JPG]]
#:[[File:Installing_ST_Remote_step5b.jpg]]
#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]]
#:<div style="padding:1rem;">[[File:Installing_ST_Remote_step7.gif|300x300px]]</div>
#Click on '''Copy UUID''' and then Select '''Settings > Register Device'''.
#Click '''Settings > Enable Online''' to enable the online functionality of the Toolbox.
#:[[File:Installing_ST_Remote_step8a.jpg]]
#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:Installing_ST_Remote_step8b.jpg]]
#:<div style="padding:1rem;">[[File:TBCheckForLicenses.png|300x300px]]</div>
#Login to http://scriptel.com/portal/#login using your login credentials.
#:<div style="padding:1rem;">[[File:Toolbox License File Download Success.png|300x300px]]</div>
#:[[File:Installing_ST_Remote_step9.jpg]]
 
#Click on the '''Licenses''' tab and click on the red '''Device''' button for a license.
=== Using a Web Browser  to Acquire Licenses ===
#*If no licenses are shown you will need add one by contacting our support team at support@scriptel.com or by phone at 844-972-7478.
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:
#:[[File:Installing_ST_Remote_step10.jpg|800px]]
#Log into the '''[https://scriptel.com/portal Scriptel Customer Portal]''' using your registered e-mail and password.
#On the '''Set Device Restrictions''' dialog box, enter the UUID and click the Submit button.
#:<div style="padding:1rem;">[[File:Installing ST Remote step9.jpg|300x300px]]</div>
#:[[File:Installing_ST_Remote_step11.jpg]]
#If you're prompted for your organization make sure the correct organization is selected and press '''Choose'''.
#In the Toolbox click on '''Settings > Check for License.'''
#:<div style="padding:1rem;">[[File:Scriptel Portal Organization Chooser.png|300x300px]]</div>
#:[[File:Installing_ST_Remote_step12.jpg]]
#Navigate to the '''Licenses''' tab and hit the '''Download License''' button.
#:<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.
#*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:'''
 
<div style="padding:1rem;">[[File:ScripTouch Toolbox License Viewer.png|300x300px]]</div>
 
'''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:
**mouse_signing - Enables '''[[Touch Signing]]'''
**enable_citrix - Enables '''[[ScripTouch Remote]]''' for Citrix XenApp and XenDesktop.
**enable_rdp - Enables '''[[ScripTouch Remote]]''' for Microsoft Remote Desktop.
**msign_desktop** - Enables '''[[Scriptel mSign]]'''
*'''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.


Now your Scriptel signature pad should be connected.
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]'''.
#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.
#:<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.
#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.
#Paste the UUID of the device you'd like to license into the '''Device UUID''' field and hit '''Submit'''.
#:<div style="padding:1rem;">[[File:Installing ST Remote step11.jpg|300x300px]]</div>
#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.


For further assistance, or if you experience any problems, please contact our Support Team at support@scriptel.com or by phone at
If you accidentally assign the wrong device to a license please contact '''[[Scriptel Support]]'''.
844-972-7478 Mon-Fri 8am-5pm EST.

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.