Chapter 4 - Configuring a License

DBXL comes with a trial license. If you decide to purchase DBXL, you will receive a license file via email. When you add that license to DBXL, it replaces the trial or current license on your DBXL instance. There are two methods to do this; choose one of the options in sections 4.1 and 4.2. Section 4.3 explains how to remove old licenses.

4.1 Add a license using the Web DBXL Admin Tool

1. Open your browser and go to http://<servername>/QdabraWebService, where <servername> is the site where DBXL is installed. If prompted for a username and password, enter your credentials.
2. Click License in the header menu. The Manage License page loads.

3. In the Add License Pack section, click Browse and locate the license file. This field only accepts valid, base64-encoded binary data files.
4. Enter the contact email associated with the license pack you selected in step 3.
5. Click Add License Pack.

6. A confirmation message appears. Click OK to dismiss it. The newly added license is displayed in the Installed License Packs table, showing the license's expiration date, serial number, name, contact email, and the allowed number of DocTypes and Docs. If you have configured a license that allows querying the Active Directory Web Service, the ADWS column is checked.

4.2 Add a license without opening DAT

Licenses can be added to DBXL using the DBXL Admin Tool (as explained above) or using the DBXL Licensing web service.

1. To add a license using the web service, copy your license file to the server where DBXL is installed. Make a note of the file path.
2. Open a web browser on the server and navigate to http://<servername>/QdabraWebService/default.htm, with <servername> replaced with the correct address for your install.
3. Expand the Web Service Descriptions (click +Show to expand).

4. Click License Management Service under the Administrative/Internal Functions category in the Web Service Descriptions.
5. Select AddLicenseFromFile on the DbxlLicensing page.

6. Enter the contact email for your license and the file path to the local copy of the license.

7. Click Invoke.

8. The XML response shows Success as true or false.

9. If there are any errors configuring the license, they are returned as well. For example:

4.3 Remove a license in Web DAT

If you have renewed your DBXL license, you may want to remove old and expired licenses on the Manage License page. Click the Delete button for that license row.

For help, active customers can use the Customer Support Portal. For anything else, use Contact Us or e-mail [email protected].

4.4 Summary

• DBXL ships with a trial license; adding a purchased license file replaces the trial or current license.
• The easiest method is the Manage License page in the Web DBXL Admin Tool (http://<servername>/QdabraWebService, then License).
• Without DAT, call AddLicenseFromFile on the License Management Service with the contact email and the server-side path of the license file; the XML response reports Success and any errors.
• Remove old or expired licenses with the Delete button on the Manage License page.

Next: Chapter 5 - Rendering Service: Installation