Utility: appgen

Syntax

appgen {-h} {-s}

Description

Generate application license codes.

Parameters

None

Switches

• -h
  Print appgen usage summary on stderr.

• -s
  Operate in server mode. The default is interactive mode.

Required

appgen is part of the Fire application licensing development kit and requires a Fire application licensing development license (mxappdev) in order to run.

Notes

The unique “developer identification” (devid) obtained from your development license will be used to generate license codes. The license server must be running and reachable when the appgen command is used.

Example (Interactive mode)

In interactive mode, appgen outputs a series of prompts. Enter a valid value or just <return> to accept the default.

%appgen
Fire application license generating program: appgen 2.04
**** Your developer ID is 101 ****
Enter ^D (eof) to cancel...
Product name: myapp
Version number: 1
NODELOCKED license (y/n) [n] ?
Network SERVER machine type (i386,sun4,ibm,hp): hp
Network SERVER host id (decimal): 1875603
User limit (0 -> 255) [8]:
Expiry year (0,1993 -> 2054) [No expiry]: 2004
Expiry date quarter:
   Particular day = day-month (numeric)
   End of     March = 1
   End of      June = 2
   End of September = 3
   End of  December = 4
Expiry date [1]:

At this point, appgen will produce license codes for the specified product and version.

**************************************************
Product myapp
Version 1
NETWORK license. SERVER Host id 1875603 (decimal) (HP9000_700)
License codes : 823C 93E9 3024 5290 4852
---------------------------- 8< --------------------
Licman script for insertion :-
licman -i -p myapp -v 1 -k 823C 93E9 3024 5290 4852
---------------------------- >8 --------------------
License expires end of March 2004
Limited to 8 users.
****************************************************
Enter ^D (eof) to cancel... (^D)
Product name :Cancelled.
%

Example (Server mode)

In server mode, appgen waits for single line commands from its stdin. The expected command line format is:

cmd {parameters...}

where cmd is "E" (Exit) or "L" (License code request). appgen will reply with either "A <license codes>" or "E <Error message>".

For license requests (L), the expected parameters are space or comma separated:

machine,host,product,version,nusers,exp_year,exp_date

where:

• machine = machine name (string: e.g. i386, sun4, ibm, hp)

• host = host id (hexadecimal) (string: e.g. 51006dc)

• product = application name (string: 16 characters max. as for applib)

• version = version number (numeric: as in applib)

• nusers = Limited no of users (numeric: 0 if unlimited)

• exp_year = Expiry year (numeric: 0 if none)

• exp_date = Expiry date, ignored if expiry_year is 0. This can be a quarter (numeric: 1,2,3,4) or a day (string: day-month)

The machine/host combination can be either the Fire license server identification in the case of a Network license, or the identification of a machine to which the license is Node-locked. The interpretation is defined when the license keys are inserted into the license file using licman.

A utility getnodeid is supplied with the installation. This will output the host id in hexadecimal to stdout.

When appgen starts, it will acknowledge its readiness to receive requests by outputting the developer id number obtained from your mxappdev license and also the appgen name and version number. If there are any start-up errors, appgen will output "E <Error message>" and immediately exit.

appgen will exit on receipt of the "E" command. There will not be any acknowledgment.

Example (server mode from keyboard)

%appgen -s
A 101 appgen 2.04
L hp 1875603 myapp 1 8 1998 1
A 823c 93e9 3024 5290 4852
E

Example (Installing application licenses)

The codes may be installed as a NETWORK license (where machine/host specify the SERVER) using:

licman -i -p myapp -v 1 -k 823c 93e9 3024 5290 4852

To NODELOCK the license to the machine/hostid add: "-m machine -n hostid"

licman -i -p myapp -v 1 -k 823c 93e9 3024 5290 4852 -m hp -n 1875603

See Also