lictool - command to obtain and install license files |
lictool [options] [--] |
-h, --help |
Display a help message. |
-r, --request |
Request a license. |
-f, --file FILE |
Install a license file named FILE. |
-c, --cpu |
Show the cpu id for the current host. |
You should use the lictool command to obtain a license for the current cacd installation tree. Basically, there are two modes of running lictool. First, when you use the -r option, you request a license file from the server. You should therefore be connected to the internet at that moment. Just after you have invoked the command, you are asked to enter some information, like your name, company and e-mail address. After the request is completed, the license server will send you an e-mail containing further instructions. In some cases (depending on your privileges), lictool will automatically install the new license file for you, and no e-mail will be sent in that case. The second mode of lictool is used when installing a license file that was requested using the -r option. Usually, the e-mail that you received explains how to invoke the command in this case. The invocation looks something like lictool -f license.txt The command will, in this case simply install the license file in your cacd installation tree, at the proper location. Of course, you should have write permission in that tree, so you should probably only invoke lictool when you have the same user id as when you first installed the tree. Note that a bookkeeping is maintained at the license server based on e-mail addresses and cpu-ids. If you request a license file for the first time (i.e., when the license server does not know your e-mail address yet), then you are automatically granted permission to use the software for a 3 month period. After that period, you should fill in a form (found on the web-site), and send it to us. We will then notify the license server of your e-mail address and cpu-id (multiple cpu-ids are also allowed). The lictool command is then able to fetch new license files until the expiration date (and you need to fill in the form again, but usually this is necessary only after 1 year or more). Thus, each time you invoke lictool with the -r option, you should use the same e-mail address. |
On linux systems, the license mechanism uses the MAC address of your ethernet card to compute a unique id (called the cpu id) for your machine. Therefore, in order to run tools from the cacd tree, you should have an ethernet card installed. This ethernet card should be accessible through the interface eth0. You may use the command /sbin/ifconfig or /usr/sbin/ifconfig to view your ethernet interfaces. One of them should be eth0. To bring an interface up, you should usually use /sbin/ifconfig eth0 up or /usr/sbin/ifconfig eth0 up. |
$ lictool --cpu $ lictool -r $ lictool -f license.txt |
Kees-Jan van der Kolk Copyright (C) 2003, Delft University of Technology, The Space Team. All rights reserved. |
$ICDPATH/share/lib/license/license_file-cpuid |
generated license file |
$ICDPATH/share/lib/license/userinfo |
cached user information |