GlobalCapture and GlobalSearch licensing is a bit of a deep dive.
The following information should make licensing easier to understand, and licensing issues easier to troubleshoot.
All purchased copies of GlobalSearch will have to register their software with Square 9's Fulfillment department. The features your implementation is licensed for are stored in a Features file and cross-checked against our licensing database. Your Features file will be initially provided by Square9 Fulfillment. Any additional changes to your feature licensing can be pulled down by hitting "Activate" in the GlobalSearch registration window. Additionally, if you've lost or misplaced your ssFeatures file, Square9 Support can provide you with a copy. Please note, the user running the application pool will be performing the update to the .lic file, and will need full access to the inetpub directory to do so. Once the file is updated, newly licensed features will be available effective immediately.
Your GlobalSearch ssFeatures.lic file lives in your IIS website directory under the Getsmart website in the bin directory. If this file does not exist after registration, please contact Square 9 Support, as this will likely cause issues with your implementation.
The ssFeatures file can be read in almost any text editor and should look something like the example below:
Example of a 4.3.1.X and up ssFeatures.lic file
All GlobalSearch implementations should contain the following serial codes:
License files prior to 4.3.1 had a different format. Registering pre-4.3.1 licenses will require a Square 9 Support Technician.
Example of a Pre 4.3.1 ssFeatures.lic file
The pipe character (|) at the start of the license file is typical; however, it is no longer required. It is important to note that trailing whitespace in the file can cause issues, as well as duplicate license lines.
The components listed below are licensed features and NOT included with the base package of GlobalSearch. Please contact your Regional Sales Manager for pricing and information.
Prefix in ssFeatures.lic
|PDF Creator (multi-core)||FP[# of cores]|
If a contract is updated and features are added to either GlobalSearch or GlobalCapture, updating your ssFeatures file can be very easily done through the system UI.
On your server, in the GlobalSearch LAN Client, open the logo menu (the round button in the top left) and hit "Register". Under the "Web Registration" section, hit "Activate." You should recieve a modal response window letting you know your features have been updated. Checking your ssFeatures file should show the file was modified.
Browse to the "Manage" module and navigate to the Registration section. From here, you can Activate Features on the GC Engine and Server separately. Click "Activate Features" and wait for the loading prompt to stop. You'' recieve a message when your features have been updated.
Customers need to register their software in order to use it. If the software isn't registered you will receive an index error. After indexing 500 documents, you get the message that the software needs to be registered.
Error messages customer's might get when trying to register via web are listed below. Many of these errors may be Contract Related, so if you encounter an error you're not sure how to solve, contact a Square 9 Technician.
GlobalSearch desktop client and GlobalSearch web client use Token 'Licenses' to keep track of license consumption. These are commonly referred to as "Tokens" or "Seat Licenses." GlobalCapture uses a similar licensing schema, however it is separate from GlobalSearch's licensing system and will be addressed in a separate section. Token Licenses should not be confused with Feature Licensing (see above), which has to do with Registration. License Tokens exist in order to manage user sessions.
License Clean displays all active sessions, when they were initiated and when they were last active. Additionally, buttons at the top of the UI allow you to return a single token or all tokens, as well as refresh the window to monitor changes. Additionally, it displays the total amount of seat licenses available to users. The types of licenses are as follows:
GlobalSearch licensing is monitored by ssLicenseClean service on the server, which should be running as your application pool user (usually SSAdministrator.) This service is responsible for maintaining active licenses and returning inactive licenses. There is also the License Manager, which can be found in the server GetSmart directory as ssLicenseClean.exe. The GlobalSearch License Manager is a utility, which may be run as a service on the Server, that will remove Token License Files either manually or through a predetermined automatic removal setting. Using the License Manager’s user interface, an admin can force the removal of Token License Files displayed in the grid.
License Clean has two settings in the interface:
Users who have their tokens returned will be able to immediately pull a new token, provided a license is available for them to use. Users who have their tokens automatically or forcibly revoked will be prompted to renew their license token.
After version 3.6 these license tokens are now stored in the ssMaster database in the ssLicenses table in place of XML flat files in the getsmart website as they were previously.
License Tokens are temporary tokens with a UID to associate a user and IP address with a GlobalSearch session. Occasionally, however, users will get a license token error when trying to pull a license token. See below for the code key for License Token errors.
If you get no error code and an “Unable to retrieve license” response then it is possible the secured user is set in Database Security to have Web Only access but the customer's serial does not include Web Only seats as selected in Database Security. Attempt to connect after changing the user to use a Full License. If this corrects the issue and the customers contract indicates they have the appropriate Web Only seats, their serial will need to be regenerated as it may be in error.
GlobalCapture and GlobalSearch have separate licensing files, and separate serial codes. Please be aware that improper licensing may break your software. If you have any questions about your license codes, please contact Square 9 Support.
Like GlobalSearch, GlobalCapture has an ssFeatures.lic file as well. This file is comprised of two parts - a file for GlobalCapture Engine (GCE) and a file for GlobalCapture Server (GCW). During registration, these two files are merged into one ssFeatures file located in the CaptureAPI Web Directory in wwwroot.
GCE Licensing holds your engine features, such as PDF Conversion and Unstructured OCR, whereas your GCW licensing holds Seat Licensing data, such as the number of Validation or Scanning licenses available. These are visible in your GlobalCapture Administration Module.
|Rapid Adapt Classification||GCW||GBLCAPLAS-001||RPD||LF/M|
|Table Field Extraction||GCE||GBLCAPDL-008||TFC||LF|
*EG1 = Everybody Gets 1 *LF = Licensed Feature *M= Multiple Can Be Licensed
From GlobalCapture's Administration module, you can manage your Seat Licenses by using groups or individual users. Seat licensing is a powerful tool that lets you control who consumes a seat license and for how long.
All of your Modules (Validation, Analytics, Scan, Administration and Design) can be assigned to specific users and groups. Giving a user or group access to a seat means that at any time, if a seat is free, they can consume that license for a designated amount of time or until they return the license via the "log out" button in GlobalCapture.
Licenses have the ability to be overallocated so that multiple groups or users can access the modules independently. However, no more licenses can ever be in use than the total amount that the system is licensed for per your Contract.
Ex. 10 GlobalCapture Validation licenses may be distributed among several groups and users, however, the Contract for the Account is only licensed for 5. Therefore no more than 5 of the Validation licenses may be in use at the same time.
Each seat license has 1) Priority settings 2) A timeout in seconds 3) An allocation count 4) A license type 5) A designated user or group.
Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.