ASA Database Administration Guide

Database Administration Utilities

The License utility

Managing licenses using the dblic command-line utility

Syntax 

dblic [ options ] executable-name user-name company-name

Description 

The License utility adds licensed users to your network database server. You must only use this utility in accordance with your Sybase license agreement to license the number of users to which you are entitled. Running this command does not grant you license. You can also use this utility to view the current license information for a server without starting the server.

Repeated running of the dblic command updates the license information.

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

On UNIX, the dbsrv9 and dbmlsrv9 executables are not writable by default, and so using the license [dblic] utility with those executables will fail. Make sure the dbsrv9 and dbmlsrv9 executables are writable (for example, using chmod +w) before you use the License utility.

The License utility is not supported on NetWare. To license Adaptive Server Anywhere executables on NetWare, you must make sure that the Adaptive Server Anywhere database server on NetWare is not running, and then run the License utility from a Windows machine that can access the NetWare volume containing the Adaptive Server Anywhere software.

License utility options 

@data    

Use this option to read in options from the specified environment variable or configuration file. If both exist with the same name, the environment variable is used.

For more information about configuration files, 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.

For more information, see Hiding the contents of files using the dbfhide command-line utility.

License type (-l)    

Enter the license type that matches the licensing model described in your software license agreement. Valid entries are perseat and processor.

Log output messages to file (-o)    

Write output messages to the named file.

Operating system (-p)    

Enter the operating system for which you are licensed. Allowed values are as follows:

• NetWare    A Novell NetWare operating system.

• UNIX    A UNIX operating system.

• WIN32    A Windows 95/98/Me, Windows NT/2000/XP, or Windows CE operating system.

• WIN64    A 64-bit Windows operating system.

Operate quietly (-q)    

Do not display output messages.

License number (-u)    

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.

Executable name    

Enter the path and file name of the network database server executable (dbsrv9.exe) or MobiLink synchronization server (dbmlsrv9.exe) you are licensing. The path must be either absolute or relative to the current working directory.

You can view the current license information for a server executable without starting the server by entering only the executable name.

User name    

A user name for the license. This name appears on the database server 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 database server window on startup. If there are spaces in the name, enclose it in double quotes.

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 Windows NT network database server. The command must be entered all on one line:

dblic -l perseat -p WIN32 -u 50 dbsrv9.exe "Sys Admin" "My Co"

The following message appears on the screen to indicate the success of the license:

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

SQL Anywhere Studio 9.0.2
Copyright © 1989–2004 Sybase, Inc. Portions copyright © 2001–2004 iAnywhere Solutions, Inc. All rights reserved.