Applies your software license to your SQL Anywhere database server or MobiLink server.
dblic [ options ] filename "user-name" "company-name"
Use this option to read 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).
Enter the license type that matches the licensing model described in your software license agreement. The following license types are supported:
|-o filename||Write output messages to the named file.|
|-q||Run in quiet mode—do not display messages.|
|-u license-number||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.|
Enter 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||A user name for the license. This name appears on the Server Messages window on startup. If there are spaces in the name, enclose it in double quotes.|
|company-name||The company name for the license. This name appears on the Server Messages window on startup. If there are spaces in the name, enclose it in double quotes.|
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.
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 (dbeng10)||dbeng10.lic|
|SQL Anywhere network database server (dbsrv10)||dbsrv10.lic|
|MobiLink server (mlsrv10)||mlsrv10.lic|
When you attempt to start a server, if the corresponding .lic file is not available, then the server does not start.
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.
The Server Licensing utility is not supported on NetWare. To license SQL Anywhere executables on NetWare, you must make sure that the SQL Anywhere database server on NetWare is not running, and then run the Server Licensing utility from a Windows computer that can access the NetWare volume containing the SQL Anywhere software.
For more information about SQL Anywhere licensing, visit http://www.ianywhere.com/products/sa_licensing.html.
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 Windows network database server. The command must be entered all on one line:
dblic -l perseat -u 50 dbsrv10.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: