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:
- SSF : GlobalSearch Edition License
- LAN : User Seat License Count
- WXC : GlobalSearch Server License
Pre-4.3.1 ssFeatures.lic File
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]|
Updating Feature Licensing
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 receive 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 will receive 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.
- Code: 0 : Manual Registration data (serial or registration number) incorrect
- Code: 1 : Lease Registered
- Code: 2 : Full Registered
- Code: -1 : Serial number entered does not match serial number in registration database
- Code: -2 : Cannot connect through the Rest Proxy
- Code: -3 : Error when writing License or registration to bin folder
- In SQL, make sure the Default Rest Path and Default Web Path is accurate
- ssMaster > dbo.ssSystem > Default Rest Path = YourInetpubDrive:\inetpub\wwwroot\Square9Rest\
- ssMaster > dbo.ssSystem > Default Web Path = YourInetpubDrive:\inetput\wwwroot\GetSmart\
- Code: -4 : Error getting Unique ID
- Code: -5 : Lease has lapsed
- Code: -6 : Web Registration cloud connection error
- Code: -7 : Serial number has already been registered
- This could occur if the customer is doing a migration and trying to register their software. Submit a request to reset registration
- Code: -8 : Web registration SQL connect Failure. This can also mean the Salesforce contract for this customer is missing data
- Code: -9 : Support contract has expired
- Check support contract to make sure that it hasn't expired.
- Code: -10 : Failure when writing ssFeatures.lic file to GetSmart\bin folder
- Code: -11 : There are not new features to activate at this time
License Manager for GlobalSearch
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:
- Full: Able to use GS Web and GS LAN client
- Web-Only: Able to use GS Web client only
- Web-Only Read-Only: Restricted to use of the Web Client, with read-only access
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:
- Return Licenses that were Accessed X Amount of Time Ago: This is your 'idle' setting - licenses that have not been accessed in X time will be automatically returned. The LAN client will automatically ping the server every minute to update it's last accessed date as long as the client remains open.
- Return Licenses that are X Amount of Time Old: This is a blanket return. After X time, your licenses will be automatically returned, regardless of idle or active token status.
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.
In version 5.0 the license manager is in the Global Search web client admin menu. You can no longer run it from the sslicense clean icon on the server.
5.0 License rules menu
This is located under the Administration section.
The following codes/errors may be returned when the server attempts to create a license for a user's session
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.
- Code: -1 : All licenses are in use
- Code: -2 : Rest Proxy error, see the error log for more information
- Code: -3 : User/Group not secured to any database
- Code: -4 : Error writing new license to ssMaster.dbo ssLicenses table
- Code: -5 : Customer Lease has expired
- Code: -6 : Server-side exception while getting total license seat count
- No Error Code : Unable to retrieve license
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.
A Note of Licensing
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.
In some cases, you may have issues related to Web Registration that are directly related to misconfigured pointers in your ssSystem table within the SSMaster database. It is recommended you verify the path to the registration server and locations defined within.
The path to the registration website is: https://registration.square-9.com/square9regv2.
There are several references to the location of the GetSmart, Square9Rest and Square9API websites. If those are not properly configured, your product may not properly register.
GlobalCapture Web & Seat Licensing
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.
Below are the options for the GlobalCapture Licensing
|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
Classification license: If you don’t have this license then you can only use one template in a classify node. If you don’t have this license you can’t use required fields on your template.
Business Process Management: BPM; needed for managing validation security. Anytime user based security is applied to a validation node, a BPM license is required.
Managing Seat Licenses
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 over-allocated 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.
- Priority settings help determine what license a user in a group will take if that group is secured in multiple places. Lower numbers are a higher priority
- Timeouts will return the license after X seconds if the license isn't manually returned
- How many users from a given group can pull a seat license at a time
- The License Types are as follows:
- Designer (DGN) : Allows access to GlobalAction/GlobalCapture Designer
- Administration (ADM) : Allows access to Administration module
- Analytics (ANL) : Allows access to Analytics Portal
- Validation (VAL) : Allows access to Batch Portal and Validation Station
- Scan (SCN) : Allows access to the GC Scan Station
- Designated licensees can be either users or groups. This will be either pulled from your server's local users and groups if Workgroup mode is enabled, or from your Active Directory Registry if Domain mode is enabled.