Help Manual

JDBC Driver Pack

How to License JDBC Driver Pack

How to License the Software

KingswaySoft JDBC Driver offers a few licensing options so that you can choose the best way to license the software depending on your development needs.

  • Developer License - this is designed to be used by developers to create applications. Note that this license does not provide redistribution rights.
  • Single Server License - this is designed to run the JDBC drivers in a server environment, in which case all licenses activated are tied to the server instance. Similarly, this license does not provide redistribution rights either.
  • OEM Developer License - this is the upgraded developer license that offers redistribution rights, which provides ultimate flexbility for development purposes. When you acquire an OEM Developer license, you will be issued a license file in text format which can be directly inserted into your connection string to enable the license.

Single Server License and Developer License

Both Single Server License and Developer License work similarly, and they need to follow an activation process to activate the license. In order to achieve this, please follow the procedures below.

Launching the License Manager

To launch the License Management Interface using the kingswaysoft.jdbc.jar, execute the following command in your command-line interface:

java -jar kingswaysoft.jdbc.jar

After opening the License Manager via the JAR file, there are a few licensing related function buttons available to achieve your license activation or deactivation needs.

  • Change/Update License Key: This button allows you to activate a new license or update an existing license installation.
  • Install License File: Install a license file you have received from us, this is generally used when your computer system does not have an Internet connection, and you have sent us an activation request via Email.
  • Initialize OEM License: Enter and validate the OEM license to access the connection management page.
  • Deactivate License: This applies to Single Server license only, and it allows you to deactivate an existing license installation so that you can move the license to a new server.
  • JDBC Connection Manager: The JDBC connection manager dialog is for configuring and managing connections to various APIs. The connection manager facilitates precise customization of connection settings, including connection string building, proxy setup, and connection testing.

licenseManager

You can add or modify the Commercial License through the following dialog. If your machine has internet access, utilize the web service to directly generate the license file. For JDBC use within an intranet environment, select the email option to receive the license via email.

licenseUpdate

If a license file is received via email, it can be installed using the "Install License File" feature within the License Management Interface.

Activation via License Manager Console

On Linux servers or other systems where the Java interface is not available, license management can be performed via the command line.

To perform license management operations via the command line, including license installation, execute the following command:

java -jar kingswaysoft.jdbc.jar -license

You will be prompted with the following license management operations:

  1. Activate a license using a subscription key.
  2. Install license using a provided license file.
  3. Display the licensing status of the software.
  4. Generate an offline activation request.

Users can select an operation and follow the prompts to enter the required information for license management.

console

OEM License

The OEM license can be entered and validated through the OEM License dialog as seen below. After the OEM license is validated, you will have access to all features of the connection management interface.

oemlic

Users can operate the driver without a license installation by adding an 'OemKey' property directly into the connection string or by specifying it in the connection properties.

Connection connection = DriverManager.getConnection
    ("jdbc:kingswaysoft:ServiceName=Crelate;OemKey=oemkey", null);

Properties connectionProps = new Properties();
connectionProps.put("OemKey", "oemkey");
Connection connection = DriverManager.getConnection
    ("jdbc:kingswaysoft:ServiceName=Crelate;", connectionProps);