StarLicense for Windows Release 1.07 Release Notes April 2008 Copyright 1994-2008 StarQuest Ventures, Inc. All Rights Reserved. StarQuest Ventures, Inc. PO Box 1076 Point Reyes Station, CA 94956 Telephone: 415-669-9619 FAX: 415-669-9629 Sales: contact@starquest.com Support: contact@starquest.com URL: http://www.starquest.com StarLicense for Windows is a license server for StarQuest products, including StarSQL. A client uses TCP/IP to connect to the server to obtain a product license. StarLicense includes a management application that can be used to configure and monitor StarLicense Servers running on the local or remote machines. ==================== SYSTEM REQUIREMENTS: ==================== * Windows 2000 * Windows XP * Windows Server 2003 * Windows Vista * Windows Server 2008 Installation: ------------- Run SETUP.EXE. You will be prompted for the location to install the program and which features you wish to install (Service, Management Applications, and Documentation); the default is to install all features. You may choose to install only the Management Applications on a a workstation that will be used to administer remote servers. If you choose to install the service, the service will be installed and started at the end of installation. Usage and Configuration: Start the StarLicense Management Console (StarLicense Manager) from the Start menu. Choose "Connect to Server" from the File menu and select [LOCAL MACHINE] or supply the name of a remote machine running the License Server. To configure the server, right click on the server and select Configuration. You will see the following panels: Service Control: You may check the status of the service and stop and start it with the Service Control panel. License: Use this panel to add & view licenses. You will need to contact StarQuest support with the IP address of your server to obtain a license key. Add this license key with the Add button. A license key can also be based on the system host ID rather than the IP address; to obtain your host ID, use the StarLic.exe program supplied with StarSQL. Future versions of the StarLicense Management Console will display this information. Failover: If this server will be functioning as a backup server, use this panel to enter the IP address or host name of the primary server. Listeners: Use this panel to configure a listener on the listener pane, supplying the IP address(es) of your server and a listener IP port. You may use any unused IP port number. You will need to supply this information to the clients. Logging: Use this panel to enable tracing and logging for diagnostic purposes. Close the configuration window after completing configuration. Monitoring connections: There are two items under the Server name in the left pane. The contents of the data in the right pane can be refreshed with Refresh in the View menu, or you can configure autorefresh in the View menu. Licenses: This displays the configured licenses, the current checkout count, the checkout maximum (highwater mark), and checkout failures. Checkouts: This displays the IP address, user name, checkout time, and active application of current clients. You can revoke a license by right-clicking on a connection and selecting "Revoke". You can also use the command line applications starlic-admin and starlic-remote-admin to obtain information about the status of the Server and perform other tasks from a script. Type "starlic-admin /?" or "starlic-remote-admin /?" to get help for these commands. CLEANING UP CONNECTIONS: The StarLicense server uses the system TCP/IP KeepAlive settings to clean up connections from clients that have disconnected uncleanly without releasing their license checkouts. The default values are 2 hours for KeepAliveTime and 1 second for KeepAliveInterval, with default of 5 retries. These values should be sufficient for most users, but if you wish faster cleanup, use regedit to create or change the KeepAliveTime value (DWORD) in the registry entry: HKLM\System\CurrentControlSet\Services\Tcpip\Parameters For instance, create a DWORD value KeepAliveTime=600000 if you wish a cleanup to occur after 600 sec (10 minutes). Refer to the Microsoft documentation for further information. CLIENTS: A client of a StarLicense Server will need to configure the hostname or IP address and the listener port of the server. In StarQuest products such as StarSQL, StarSQL for Java, and SQDR, the configuration of the client is done with the License Configuration application (StarLic.exe). Troubleshooting: In addition to event log messages and the tracing and logging facilities that can be activated by the Logging panel in configuration, additional diagnostic tools can be found in the Program directory. StarQuest support will direct you in the use of these tools if necessary. ============== CHANGE HISTORY ============== 1.07.0428 4/28/08 10298 Client: Revisit lookup order (starlic vs local and configured licenses) 10383 Client: WSAStartup called in DllMain causes problem on Windows Server 2008 as Local System 8455 Zombie checkouts remain after client loses connectivity 10322 Move location of log directory 10347 Installer modifications for Vista and Server2008 10386 add new features to starlic-remote-admin: active-checkout-count 1.06.1203 12/3/06 9942 StarLicense Management Console hangs on Win2003 1.05 - UNIX & client changes only 1.04 - client changes only 1.03 - UNIX & client changes only 1.02.0610 6/10/03: 8250 StarLicense Win&Unix - journaling does not record failed connections 8259 StarSQL Win&Unix - Journal Filenames, should be YYYYMMDD 8271 StarLicense/Win&UNIX - Doesn't read licenses from > 1 failover server 8272 StarLicense - backup server enhancement 8199 Starlicense/Win - removing failover, leaves licenses 8202 Starlicense/Win - purge licenses after connection to the primary had been deleted from the server 8268 StarLicense/Win - Journal retention 8271 StarLicense/Win&UNIX - improve failover 8279 StarLicense/UNIX&Win - improve failover 8280 Exploit multiple server addresses defined by DNS 1.01.0521 5/21/03: 8216/8220 Write and close the journaling log file(s) after each entry 8249 StarLicense Win&UNIX - Journal file contains YYYYDDMM