Barcode Xpress for ActiveX v13.9 - Updated
Server Licensing Utility (SLU)
Developer Guide > Licensing and Distributing > Runtime Licensing > How to Register an Automatically Reported Runtime License (Node-Locked) > Server Licensing Utility (SLU)

The SLU is a simple Windows application that uses License Configuration Files to request a license key from the purchased Runtime licenses. The SLU registers that Runtime license on the system where your application will be running. This utility can be used by developers for testing, by your deployment team, or by your end users to register their Runtime license.

When installing the license, the user you are running as must have Administrator access so that the Registry can be accessed and the license can be added to the system.
The files for the SLU (slu.exe and AccuLicClient.dll) are stored on the development machine by the product installer. You can find them in the sub-path "Common\Licensing\Deployment" in the product's main install location.

To Deploy the License

1. Generate license configuration file

  1. Go to my.accusoft.com to access the Accusoft Customer Portal.
  2. Log in to your account by entering your email and password. Alternatively, you can enter the order number to see only a specific order.
    1. Click the products tab to see the products purchased.
    2. Click on the required product name, version number, deployment.
    3. Click the license button to display the drop down of Standard Deployment Licensing Instructions.
      Note: The Solution Name and Solution Keys are also listed here. These are (later) used to unlock the Accusoft products and enable all licensed features at runtime.
    4. Scroll down to click the license pool button.
    5. For the required product, click the Generate Config File button to create the text file used to license the machine (i.e., the License Configuration file).
    6. Notice the .txt file in the download bar.
    7. Save the text file and note its location, as you have to access it again.

2. Register runtime license for your system using the SLU

  1. Copy SLU.exe from Deployment Resources to your runtime machine.
    Note: Read the readme.txt found in the same directory as SLU.exe for additional steps necessary before running the SLU.
  2. On your runtime machine, double-click the SLU application.
  3. In the Server Licensing Utility dialog, add your License Configuration file(s) as follows:
    1. Click Add and navigate to your License Configuration file(s).
      Tip: The License Configuration File is the .txt file downloaded earlier.
    2. Select the appropriate License Configuration file(s) and click Open.
  4. For annual licenses, add the access key to the [Optional] Specify Access Key text field. For non-annual licenses, skip this step.
    1. Open the Access Key text file that was downloaded previously from the customer portal.
    2. The file is formatted as a table with each row having the 20 character access key, the time that access key was registered (if it has been used already), and the time the access key will expire.
      Choose a row with an access key that has not been previously registered.
    3. Copy and paste the access key into the [Optional] Specify Access Key text field.
  5. After all applicable License Configuration files have been added, click Auto Register (if you are connected to the Internet).
    Note: If not connected to the Internet, follow the instructions in Manually Register Toolkit (Disconnected from the Internet).

The license information along with the system’s hardware information is transmitted to the Accusoft licensing web service. If an unused license is available, a new license key containing information for the system is generated, returned, and is then automatically installed by the Server Licensing Utility.

A message displays informing you whether the licensing was successful or not. Take notice of this message. The message, 'The product has successfully been licensed' is displayed if successful.

3. Add runtime licensing deployment information to your application to unlock the Accusoft product and enable all licensed features at runtime

You have to add the runtime licensing deployment information to your application to unlock the Accusoft product and enable all licensed features at runtime:

  1. Place the licensing function calls in your application to trigger the license
    component.
    1. Call the functions <Set Solution Name> and <Set Solution Key> at the start of your application. The Accusoft product checks that there is a valid license before it lets you use any of the key functionality.
      Note: In the samples provided with our SDK, these function calls have been included for your convenience, but are commented out. To use these commented out function calls, locate them by searching the sample code. (Tip: You can use Ctrl+F and enter the search term "solution" to easily locate these functions).
  2. Copy parameters from the Accusoft Customer Portal to the functions.
    1. Copy the Solution Name from the portal and paste into the placeholder string of SetSolutionName function. Uncomment that function.
    2. Similarly, copy the appropriate Solution Key (based on your programming language) and paste into the placeholder value of the SetSolutionKey function. Uncomment that function.
    3. SetOEMLicenseKey (this will be provided only if OEM license is purchased from our Sales department).
  3. Compile and run your application.

Automatic Registration (Connected to Internet)

Automatic registration works in much the same way as connected Toolkit registration and requires an Internet connection on the system where your application software will be deployed.

The license information along with the system’s hardware information is sent over the Internet to the Accusoft licensing web service. If an unused license is available, a new license key containing information for the system is generated, returned, and is then automatically installed by the SLU. 

Manual Registration (Disconnected from Internet)

Manual registration is used when the system where your application software will be deployed is not connected to the Internet and therefore cannot be registered automatically. This operation is similar to Disconnected Registration with the License Manager.

  1. Copy the Hardware Key and URL to a removable media device, such as a thumb drive, and then take it to a system that is connected to the Internet. 
  2. From the connected system, paste the URL into a browser. A page will appear that contains a field into which you enter the hardware key.
  3. After this hardware key is entered, a license file with the license key is downloaded, which you then save to the removable media device.
  4. Return to the offline system with the removable media device onto which you have saved the license file.
  5. Click Open License File and navigate to the license file. Click OK in the file selection dialog.
    Alternatively, you can open the license file with a text editor, copy the license key to the clipboard, and click Paste License Key to paste the new license key into the License Key field.
  6. Click the License button; the new license will be installed.

 

Is this page helpful?
Yes No
Thanks for your feedback.