StarQuest Technical Documents

StarLicense for Windows Quick Start Guide

Last Update: 10 April 2009
Product: StarLicense for Windows
Version: 1.x or later
Article ID: SQV00SL004

Abstract

This document is a guide for installing and configuring the StarLicense software on a Windows computer. Read the complete document before starting your installation.

Solution

This solution describes how to perform the following procedures:

Step 1: Install StarLicense
Step 2: Obtain License
Step 3: Configure the StarLicense Software
Step 4: Configure the StarSQL Client Licensing

Before You Begin

Before you begin, review the following list to ensure that you have the information and files you need, and that your computer environment provides the minimum requirements.

General Requirements

• You have requested and downloaded the StarLicense software. All software packages are distributed as compressed files that you download from the StarQuest Ventures Web site. From a browser enter the address http://www.starquest.com/ and click on Download for Trial under the Products menu if the prerequisite software has not been downloaded.
• You have the Download Instructions that were sent to the email address specified in the StarQuest Product Download Request form. You need these instructions and Internet access to license the software.
• You have the StarSQL ODBC driver installed and ODBC data sources configured for access to DB2.
• You have access to a Windows user ID that has administrative authority on the computer where StarLicense will be installed.

StarLicense Requirements

• StarLicense listens for StarSQL licensing requests on port 4999, by default. If this computer is protected by a firewall, open port 4999 to allow incoming requests. Alternatively, modify the StarLicense service to listen on a port that is already open. Configuring the StarLicense listening port will be addressed in this document.

Step 1: Install StarLicense

1. Log on to Windows as a user with Administrator authority.
2. Extract the contents of the downloaded starlicense-i8632.zip file into a temporary directory.
3. Run the setup.exe program to start the installation and accept the default StarLicense for Windows setup type.

Step 2: Obtain License

1. From a computer that has access to the Internet, preferably the computer running StarLicense, click on or browse to the following URL:

   http://starcust.starquest.com/Registration/index.html#license

2. On the StarQuest Online Licensing Form web page, enter in the e-mail address used for the original download request and the Registration Key you received in the download confirmation email.
3. Enter the Host ID or IP Address of the computer where StarLicense is installed.
   • To find the Host ID, run the label or dir command from a Windows command prompt. The Host ID is the Volume Serial Number. Enter this value on the form, omitting any spaces or hyphens (e.g., 6C1772A9).
   • If the computer has multiple IP Addresses configured, any one of the IP Addresses can be used. Enter the address in decimal dot notation (e.g., 192.168.44.12).
4. Select the License Server radio button. Click Next.
5. Review the information provided. If any changes are required, click Previous and modify the values as needed. Otherwise, click the Accept button.
6. Copy the license key for use in Step 3. You will also receive an e-mail with the license key.

Step 3: Configure the StarLicense Software

1. Select StarLicense Manager from the StarLicense for Windows program group of the Start menu.
2. From the StarLicense Manager window, select Connect to Server from the File menu. Select [LOCAL MACHINE] from the drop-down list in the Connect to StarLicense Server dialog and click OK.
3. Right click the server name in the left pane and select Configuration (first select Start if the service is not running).
4. Click the Licenses tab and click the Add button.
5. In the Add License Key dialog enter or paste in the license key obtained in Step2. Click OK.
6. If you want to change the port on which StarLicense listens for licensing requests, do so under the Listeners tab. Remove the existing entry for port 4999 and add a new entry specifying the desired port to use.
7. Click OK to close the StarLicense Config dialog and return to the StarLicense Manager window.
8. Click Licenses in the left pane to display the server license information in the right pane. A status of Hot indicates that StarLicense is configured and listening for license requests.

Step 4: Configure the StarSQL Client Licensing

StarSQL ODBC Driver

StarSQL for Java JDBC Driver

StarSQL ODBC Driver

Windows

1. On the StarSQL client computer, launch the StarSQL License Configuration utility from Start --> Programs --> StarSQL --> License Configuration.
2. Under the License Servers tab, click the Add button.
3. Select the Product and enter in the name or IP Address of the computer running StarLicense. Specify the port number that StarLicense listens on for licensing requests, the default is 4999.

UNIX or Linux

1. Log on as root user.
2. Enter the configure command from the StarLicense installation directory to display the StarLicense Configuration Menu. The StarLicense Configuration Menu presents the following options:

   StarLicense Configuration Menu

   1) Add license with Registration Key (via Internet)
   2) Add license with License Key
   3) Remove a License Key

   4) Start License Server daemon
   5) Stop License Server daemon
   6) Display License Server status
   7) Test licensing checkout
   8) Display StarLicense configuration

   9) Configure client to use a remote License Server
   10) Remove a client-server connection

   11) Licensing Help
   12) Exit

3. Select option 9) Configure client to use a remote License Server.
4. Enter the IP Address of the License Server. Press Enter.
5. Enter the port number of the License Server. If the default port, 4999, is acceptable, leave this field blank and press Enter.
6. When prompted to choose a ProdID, enter the ProdID of the license being used on the License Server and press Enter.
7. Select option 7) Test licensing checkout to confirm that the license configuration is correct.
8. Select option 12) to Exit.

StarSQL for Java JDBC Driver

1. On the StarSQL for Java client computer, open the StarLicense.properties file in a text Editor.
   • On Windows, open the file from Start --> Programs --> StarSQL for Java--> Edit StarLicense.properties. This will open the StarLicense.properties file in Notepad.
   • On UNIX/Linux and Mac OS X, locate the StarLicense.properties file in the StarSQL for Java directory and open it using your preferred text editor.
2. Uncomment the [ClientServer0] section and specify: the hostname of the StarLicense server, the port number on which StarLicense listens for licensing requests, and the appropriate Product ID. For example:

   [ClientServer0]
   hostname=mystarlicenseserver
   port=4999
   PRODUCTID=SQ

3. Save and close the StarLicense.properties file.