Server Licensing utility (dblic)

dblic [ options ] license-file [ "user-name" "company-name" ]

Option	Description
@data	Reads in options from the specified environment variable or configuration file. See Configuration files. To protect passwords or other information in the configuration file, you can use the File Hiding utility to obfuscate the contents of the configuration file. See File Hiding utility (dbfhide).
-l type	Specifies the license type that matches the licensing model described in your software license agreement. The following license types are supported: Perseat A perseat license restricts the number of client connections to the database server. With per-seat licensing, the network database server can use all CPUs available on your computer, but not more than the maximum allowed by the SQL Anywhere edition you are running. If a CPU contains multiple cores or threads, all cores and threads of the CPU may be used. The personal server is limited to four cores on one CPU. If a core contains multiple threads, all threads of that core may be used. Processor A processor license restricts the number of separate physical processors that can be used by the database server. With CPU-based licensing, the network database server uses up to the number of CPUs specified in your license, but not more than the maximum allowed by the SQL Anywhere edition you are running. If a CPU contains multiple cores or threads, all cores and threads of the CPU may be used. For this license type, the database server treats each physical processor as a CPU and does not treat a dual core or hyperthreaded processor as multiple processors. When you have a processor license, there are no restrictions on the number of client connections to the database server. The personal server is limited to four cores on one CPU. If a core contains multiple threads, all threads of that core may be used. You can further restrict the database server with the: -gt database server option -gta database server option -gtc database server option sa_server_option system procedure with the ProcessorAffinity option This option cannot be used with the -k option.
-k registration-key	Specifies a SQL Anywhere license key. You can use this option to change your database server's edition. For example, if you have the developer edition and want to change to the workgroup edition, you can specify the workgroup edition registration key. This option cannot be used with the -l option.
-o filename	Writes output messages to the named file.
-q	Runs in quiet mode—messages are not displayed.
-u license-number	Specifies the total number of users or processors for the license. If you are adding extra licenses, this is the total, not the number of additional licenses.
license-file	Specifies the path and file name of the server executable or license file for the personal database server, network database server, or MobiLink server you are licensing. You can view the current license information for a server executable by entering only the license file name.
user-name	Specifies the user name for the license. This name appears in the database server messages window on startup. If there are spaces in the name, enclose it in double quotes.
company-name	Specifies the company name for the license. This name appears in the database server messages window on startup. If there are spaces in the name, enclose it in double quotes.

None.

The Server Licensing utility adds licensed users or licensed processors to your SQL Anywhere database server or MobiLink server. You must use this utility only in accordance with your license agreement to license the number of users or processors to which you are entitled. Running this command does not grant you license. The number of CPUs that the database server can use may also be affected by your SQL Anywhere edition, the -gt, -gtc, or -gta database server options, or the sa_server_option system procedure with the ProcessorAffinity option.

This utility also modifies the user and company names displayed at startup by the personal or network database servers, and the MobiLink server.

You can also use this utility to view the current license information for a personal or network database server by entering only the license file name.

Licensing information is stored in a .lic file in the same directory as the server executable. The server looks for a .lic file that has the same base file name as the executable that is being run. For example, if the database server executable was named myserver.exe, then the server looks for a license file named myserver.lic. By default, the following names are used:

Executable	License file name
Personal database server (dbeng16)	dbeng16.lic
Network database server (dbsrv16)	dbsrv16.lic
MobiLink server (mlsrv16)	mlsrv16.lic

When you attempt to start a server, if the corresponding .lic file is not available, then the server does not start. The license file is created by the SQL Anywhere installation program. The dblic utility only modifies existing licenses; it does not create new license files.

Exit codes are 0 (success) or non-zero (failure).

On Unix, the database server executable is not writable by default, so using the Server Licensing (dblic) utility fails. Make sure the executable is writable (for example, using chmod +w) before you use the Server Licensing utility.

Cached connections count toward per seat licensing.

For more information about SQL Anywhere licensing, see [external link] http://www.sybase.com/detail?id=1056242.

Editions and licensing
-gt database server option
-gtc database server option
-gta database server option
ProcessorAffinity option: sa_server_option system procedure
Software component exit codes

The following command, run in the same directory as the database server executable, applies a license for 50 users, in the name of Sys Admin, for company My Co, to a Microsoft Windows network database server. The command must be entered all on one line:

dblic -l perseat -u 50 "C:\Program Files\SQL Anywhere 16\Bin32\dbsrv16.lic" "Sys Admin" "My Co"

The following messages appear on the screen to indicate the success of the license:

SQL Anywhere Server Licensing Utility Version 16.0.0.1403
License applied successfully.
Advanced Edition
Add-on: High Availability
Add-on: In-Memory mode
Add-on: Scale-out Nodes
Licensed nodes: 50
User: Sys Admin
Company: My Co
Install key:

The following command returns information about the license for a database server:

dblic "C:\Program Files\SQL Anywhere 16\Bin32\dbsrv16.lic"

Server Licensing utility (dblic)

Syntax

Privileges

Remarks

See also

Example