Generating configuration keys

Once your customers have installed your application, you will need to request that they send you the registration string and licensee name. You must then generate configuration keys, which the customer will use to configure License Manager to run your application.

There are two ways to generate configuration keys:

License Key Generator utility

The License Key Generator utility, lmk, is used to generate configuration keys. As with other Synergy/DE products, you must configure License Manager to allow lmk to run, using the configuration key sent to you by Synergex. Once configured, it cannot be transferred to another machine. In addition, lmk is protected from accidentally being copied into a distribution to your customers. The lmk utility is available on Windows only.

lmk [option] [...]

Options

‑aapp_code

The application code that you created to represent the application.

‑cname

The licensee name (obtained from the customer site).

‑ddays

The number of days since January 1, 1992 that you want the keys to be valid. If you don’t want the product to time out, either omit this option or set days to 0 (zero).

‑fafilename

Append to an existing Synergy key file named filename. The .skf extension will be added if not specified.

‑fcfilename

Create or overwrite a Synergy key file named filename for a specified licensee. The .skf extension will be added if not specified.

‑h

Display a help message that specifies the lmk syntax.

‑rstring

The registration string (obtained from the customer site).

‑uusers

The maximum number of users for app_code.

‑v

Display the version number of lmk.

‑xstring

An extended, developer‑defined data string, which can contain up to 100 characters.

Discussion

Arguments that include spaces must be enclosed in quotation marks. For example, if you want to specify the licensee name ABC Consulting Corporation with the ‑c option, you’d enter it as

-c"ABC Consulting Corporation"

The ‑d option enables you to create a demo license that will expire after a specified number of days. For a utility that calculates the number of days between a given date and January 1, 1992, see LmkEvalDate.zip, available from Synergy CodeExchange in the Resource Center on the Synergex website. It may be easier to create a demo license using the lmkx program, which allows you to enter either a time‑out date or the number of days before time‑out. The lmkx program is included in Licensing_TK_Examples.zip, also available from Synergy CodeExchange.

The ‑x option enables you to include your own string for anything that you want to check regarding the product that is being licensed. For example, you could use this string to check the version number of your application. (Note that you will have to include code in your application to handle the information included in the string.)

Using Synergy key files

The key file enables users to install keys without having to type the configuration key. If you don’t specify the ‑fc option, the keys will display to the screen.

If you create a Synergy key file with the ‑fc option, the file will be created in the current working directory unless you specify a complete path. You can also use a logical to specify the file location.

To put the keys in a Synergy key file,

1. First, create the file with the ‑c and ‑fc options. For example,
lmk -cMickey -fcKEYS:Mickey

creates a file named Mickey.skf for licensee Mickey and places it in the directory specified by the KEYS logical. The file header will include the licensee name and the creation date.

2. Once the file is created, run lmk for each application code, and specify the key file with the ‑fa option. This will generate the keys and place them in the file. For example, to generate 10‑user licenses for the application codes CON5 and MAR5 and place them in the Mickey.skf file, you would use the following:
lmk -acon5 -cMickey -r2580RCK7QG88 -u10 -faKEYS:Mickey
lmk -amar5 -cMickey -r2580RCK7QG88 -u10 -faKEYS:Mickey

For more information about key files, see Configuring License Manager.