7.1 Requesting a License Key
The ST-Developer tools, such as the EXPRESS compiler or AP203 Checker, require a license key. Applications that you build using the ST-Developer libraries do not need a key and can be distributed without restriction.
To request a key, fill in the request form at the URL below. Selecting STEP Tools | Request License Key on the Windows Start menu will take you to this form and fill in most information. The Windows installer will also take you to this form.
http://www.steptools.com/register/
On Windows, the ST-License Key Browser shown in Figure 7.1 will display the host identifier of your machine (an 8-digit hex number) as well as all keys installed on your machine.
On MacOS or UNIX platforms, use the stshowkeys command line tool to list the host identifier and license keys installed on the machine. This tool is in $ROSE_BIN .
% stshowkeys
CPU identifier for this machine:
Host type ..... Sun SPARC/Solaris
Host ident .... 7234799f
License Information ----------------
No licenses found
When you fill in the key request form, you will also need the host identifier of your machine (an 8-digit hex number) as well as the 6-digit STEP Tools license number that we assigned when you purchased your software.
Your request will be handled by our support staff and a key will be sent via email. When you receive your key, install it as described in the sections below. If you have any problems, please contact us at license@steptools.com .
7.2 Installing Keys on Windows
On Windows, license keys are kept in the registry. The key will arrive via email as a " .stkey " attachment. Save the file and double-click on it to load it into the registry. You can also run the ST-License Key Browser and select the Load Key File button.
Since the stkey files are just registry settings, you could also load them on your machine by running regedit and loading the key file using the File | Import , or by changing the file extension to " .reg " and double clicking the file.
After you install the license, run the ST-License Key Browser or the stshowkeys tool to list all STEP Tools product license keys. Save your key file in case you ever need to re-install.
7.3 Installing Keys on MacOS/UNIX
On MacOS and UNIX systems, the license keys for all STEP Tools products installed on your system are normally kept in the file $ROSE/license . If your system administrator prefers to rename or keep this file elsewhere, set the $ROSE_LICENSE environment variable to indicate the new location of the file:
setenv ROSE_LICENSE /usr/local/common/step_keys
Your key will be sent to you in the body of an email message. To install the key, use a text editor cut and paste the license key text into this file.
# Sample STEP Tools license file
# License keys are series of hex digits beginning with a $.
# Lines beginning with a hash are ignored.
#
$e2c6081885 e2030f93cc 0bcd8919e7 e3c68c120a a3dc8c296b d4a2b8354a
d4f4bf2c02 d4ffb57e51 cef5bd7e49 82f2e82900 80ebb82042 d7d2cc176f
e382ed6e53 86e6df707e 82a4e36c18 8dafef730f
After you have added the license, you may verify the license with the stshowkeys tool. With no arguments, the stshowkeys program looks for an installed key file. It can also be given a filename argument to check the contents of a specific file.
% stshowkeys
CPU identifier for this machine:
Host type ..... Sun SPARC/Solaris
Host ident .... 7234799f
License Information ----------------
User name ............ Dave Shabotnick
User organization .... Foobar International
License serial ....... 17d4-7234799f-31fa4d1c-484
Licensed package ..... ST-Developer v9.0
License type ......... Single CPU/Node-locked
Host CPU type ........ Sun SPARC
Host identifier ...... 7234799f
Usable on this host: YES