Server Licensing utility (dblic)

Applies your software license to your SQL Anywhere database server or MobiLink server.

Syntax

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

Option	Description
@data	Reads in options from the specified environment variable or configuration file. See Using configuration files. If you want 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 perseat licensing, the network database server uses all CPUs available on the computer unless the network database server is limited by the -gt option or by the edition you are running. The personal server is limited to one CPU. Processor A processor license restricts the number of separate physical processors that can be used by the database server. The number of CPUs that can be used by the database server may be further limited by the -gt option or by the SQL Anywhere edition you are running. The personal database server is limited to one CPU. The database server treats each physical processor as a CPU for the purposes of this license type, 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.
-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 on 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 on the database server messages window on startup. If there are spaces in the name, enclose it in double quotes.

Remarks

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 or the -gt server option. See:

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
SQL Anywhere personal database server (dbeng11)	dbeng11.lic
SQL Anywhere network database server (dbsrv11)	dbsrv11.lic
MobiLink server (mlsrv11)	mlsrv11.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). See Software component exit codes.

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

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

Example

The following command, executed 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 dbsrv11.lic "Sys Admin" "My Co"

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

Licensed nodes: 50
User: Sys Admin
Company: My Co

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

dblic dbsrv11.lic

Discuss this page in DocCommentXchange.
Send feedback about this page using email.