TASKING License Management System

Online TLM User Manual

For detailed infor­ma­tion about the TASKING License Man­age­ment (TLM) please see the online man­u­al:

- TLM User Man­u­al

Supported License Types

The spe­cif­ic license type for your toolset will deter­mine its allowed usage and trans­fer­abil­i­ty. The TLM license key that you receive from TASKING will auto­mat­i­cal­ly con­fig­ure the license type for you. 

Node-locked License

Node licens­es locks your soft­ware to the com­put­er it was installed on. For instal­la­tion infor­ma­tion for this license type please see: 

- Installing Serv­er-Based Licens­es
- Installing Client-Based Licens­es

Floating license

Float­ing licens­es are locat­ed on a license serv­er and can be used by mul­ti­ple users on a net­work. For instal­la­tion infor­ma­tion for this license type please see:

- Installing Serv­er-Based Licens­es

License Server Types

The license ser­vice type spec­i­fies the process used to val­i­date the license.

Client-Based (Stand­alone): License and all asso­ci­at­ed infor­ma­tion is stored on the user’s com­put­er. This ser­vice type is avail­able for node-locked licens­es only.

Serv­er-Based (Net­work): License and all asso­ci­at­ed infor­ma­tion is stored on a licens­ing serv­er that runs on your com­pa­ny’s net­work or TASKING licens­ing servers. This ser­vice type is avail­able for both node-locked and float­ing licens­es.

How to obtain a License

A license key is required to install and val­i­date all TASKING prod­ucts. If you have not received a key fol­low the steps below to obtain one.

Obtaining a Server-based License (floating or node-locked)

1. Order a TASKING prod­uct from TASKING or one of its cer­ti­fied dis­trib­u­tors.
2. Your license key will be sent via email or reg­u­lar mail.
3. The license serv­er will bind the license to the first com­put­er that uses the license.

Obtaining a Client-based License (node-locked)

1. Down­load the get­cid pro­gram on the com­put­er you want to install a TASKING prod­uct on.
2. Exe­cute the get­cid pro­gram and make note of your com­put­er ID.
   
3. Order a TASKING prod­uct from TASKING or one of its cer­ti­fied dis­trib­u­tors and pro­vide your Com­put­er ID.
4. A license key and file will be sent to you via email or reg­u­lar mail.

How to install a License

Installing Server-based Licenses (floating or node-locked)

Please Note: If you want to use a local license serv­er first install the local license serv­er before con­tin­u­ing to step 1.

1. Begin the instal­la­tion process for your TASKING prod­uct.
   
2. Enter your pro­vid­ed license key.
   
3. The instal­la­tion pro­gram tries to retrieve the license infor­ma­tion from a remote license serv­er. Wait until the license infor­ma­tion is retrieved. If the license infor­ma­tion is retrieved suc­cess­ful­ly sub­se­quent dialogs are already filled-in and you only have to con­firm the con­tents of the dialogs by click­ing the Next but­ton. If the license infor­ma­tion is not retrieved suc­cess­ful­ly you have to enter the infor­ma­tion by hand.
4. Select the license type. If it is already filled in and grayed out you can just click Next.
   
   or
   
5. (For float­ing licens­es only) Select Remote license serv­er or Local license serv­er.
   
6. (For local license servers only) Enter the serv­er name and port num­ber of the local license serv­er.
   
7. Click Next and fol­low the rest of the instruc­tions to com­plete the instal­la­tion.

Installing Client-based Licenses (node-locked)

1. Begin the instal­la­tion process for your TASKING prod­uct.
   
2. Enter your pro­vid­ed license key.
   
3. Select Node-locked client based license, then select Next to con­tin­ue.
   
4. Enter the con­tents of your licens­ing file (licfile.txt is stored in the etc direc­to­ry of your prod­uct).
   
5. Click Next and fol­low the rest of the instruc­tions to com­plete the instal­la­tion.

How to install a local License Server

When­ev­er you want to restrict license access to your local office net­work of your com­pa­nies Intranet, you can install a local license serv­er that does not require any Inter­net access. For this, please fol­low the next steps:

• Con­tact our Sup­port team to get the lat­est Local License Serv­er soft­ware. If you had access to the Sup­port Cen­ter (now dep­re­cat­ed) in the past, you can also obtain the lat­est soft­ware from there under LICENSING.
• Install the Local License Serv­er on the com­put­er which is used as the license serv­er.
• Open a com­mand prompt as Admin­is­tra­tor from the bin direc­to­ry of the just installed license serv­er (for exam­ple C:\Program Files\TASKING\taskinglm v2.2r1\bin) and run the fol­low­ing com­mand to obtain the secu­ri­ty ID:

licd -I

• Send this secu­ri­ty ID to your TASKING con­tact per­son. It can be marked (right-click -> Mark) and copied (Enter) with­in the com­mand prompt.
• You will receive an email in return with the license key for your local license serv­er, attached as file licdopt.txt. Save this file into direc­to­ry C:\Tasking\licdopt.txt
• In the mean­while, a sec­ond email is being sent to you with a 16 char­ac­ter license key (used for installing the TASKING prod­uct on your clients) and the license data for your prod­uct. Copy this license data to file C:\Tasking\licdfile.txt
• Add the fol­low­ing line to file licdopt.txt:

LICD_LICFILE=C:\Tasking\licdfile.txt

• To install your local license serv­er as a ser­vice, open the above-men­tioned com­mand prompt as Admin­is­tra­tor from the bin direc­to­ry again, and run the com­mand:

licd --install 

• Final­ly, start this ser­vice by run­ning the com­mand:

net start "TASKING License Service"

To install the TASKING prod­uct on your clients, fol­low the next steps:

• Install the TASKING Prod­uct and fill in the 16 char­ac­ter license key when asked for. Click Next to con­tin­ue.
• Select Local license serv­er and spec­i­fy the Serv­er name and Serv­er port num­ber of your local license serv­er (default port 9090).
• Click Fin­ish to com­plete the instal­la­tion.

For more detailed infor­ma­tion about the license man­ag­er, please refer to the Local License Serv­er chap­ter in our TLM man­u­al.

Rehost a Licence

A node-locked license or a Local License Serv­er license is tied to the Com­put­er ID of your com­put­er or the Secu­ri­ty ID of your license serv­er. At some point, it may be nec­es­sary to use a dif­fer­ent machine to host the license, for exam­ple, if one of your com­put­ers or servers needs to be replaced. This will result in a so-called “rehost” request.

To rehost your license, sub­mit a rehost request with the fol­low­ing infor­ma­tion:

• Com­pa­ny name
• Rea­son for the rehost request
• Ser­i­al num­ber and license key (or com­plete license file)
• For a node-locked license, your new Com­put­er ID
• For a Local License Serv­er license, the Secu­ri­ty ID of your new serv­er

Please send this info to your TASKING con­tact per­son. If any fees are due for the request­ed rehost or a signed Let­ter of Destruc­tion is required, TASKING will con­tact you first before pro­ceed­ing with the request.

How to find the ser­i­al num­ber?

From Eclipse, open menu Help => About <prod­uct name> => Instal­la­tion Details => TASKING License

From a com­mand prompt, the Ser­i­al Num­ber can be obtained by run­ning the com­pil­er with option ‑V, for exam­ple:

ctc -V 

How to find the license key?
The 16-char­ac­ter node-locked license key can be found in file <install>\etc\licopt.txt.
The license key of your local License Serv­er can be found in file licdopt.txt (default in: C:\Tasking).

How to get your new Com­put­er ID (CID) for rehost­ing a node-locked license?
Down­load and run the get­cid pro­gram on the new com­put­er.

How to get your new Secu­ri­ty ID (SID) for rehost­ing a Local License Serv­er license?

• Install the TASKING Local License Serv­er on the new serv­er
• Open a com­mand prompt as Admin­is­tra­tor and run licd ‑I to obtain the secu­ri­ty ID
• For more detailed infor­ma­tion, see “How to install a local license serv­er”

Borrow a License

If you nor­mal­ly use a float­ing license but do not have access to a license serv­er, for exam­ple on a busi­ness trip, you can bor­row a license. This turns one float­ing license seat into a node-locked license for a defined num­ber of days. A bor­rowed float­ing license seat is not avail­able to other users dur­ing that time. You can bor­row a license for a max­i­mum of 128 days, where a day means 24 hours.

The license key itself includes infor­ma­tion about whether the license sup­ports the use of the bor­row fea­ture or not. If this fea­ture is not enabled for your license, please send an email to licadmin@tasking.com, includ­ing the ser­i­al num­ber of your license and the request to have the bor­row fea­ture enabled for the license.

Note: When you need to bor­row dif­fer­ent ver­sions of the same prod­uct, you need to exe­cute the bor­row­ing process for every sin­gle version/revision of the prod­uct.

Depend­ing on your TASKING prod­uct, sev­er­al vari­ants of the licbor­row util­i­ty are avail­able. A GUI vari­ant of licbor­row is present in the bin direc­to­ry of the installed TASKING prod­uct on Win­dows and acces­si­ble through the Win­dows Start menu. If you pre­fer using a com­mand-line vari­ant, down­load it from https://www.tasking.com/support/tlm/downloads/.

Fol­low one of the guide­lines below to bor­row a license, based on your sit­u­a­tion.

Borrow a License on Windows using the GUI based Licborrow

1. From the Start menu, select TASKING <prod­uct name> <ver­sion> -> Bor­row License. The fol­low­ing Bor­row License dia­log or sim­i­lar dia­log appears:
   
2. From the Bor­row license for list, select the prod­uct for which you want to bor­row a license.
3. Enter the num­ber of days you want to bor­row the license, and click Bor­row License.

Borrow a License on Windows using the Command Line based Licborrow

1. Down­load the com­mand line tool licborrowcmd.exe from https://www.tasking.com/support/tlm/downloads.
2. To get a list of avail­able prod­ucts, in a Win­dows com­mand prompt, enter:
   licborrowcmd -l
   This results in a list of installed TASKING prod­ucts. For exam­ple:
   SW160800 v6.0r1 TASKING VX-toolset for TriCore
SW160800 v6.1r1 TASKING VX-toolset for TriCore
SW160800 v6.2r2 TASKING VX-toolset for TriCore
SW160800 v6.3r1 TASKING VX-toolset for TriCore
3. Bor­row a license. For exam­ple, 7 days (-d option) for SW160800 v6.3r1:
   licborrowcmd -d7 SW160800 v6.3r1
If bor­row­ing is suc­cess­ful, you get the response:
   License for SW160800 v6.3r1 successfully borrowed for 7 days from lic1.tasking.com
You can now use your com­put­er in the field.

Borrow a License on Linux on the Command Line

Linux instal­la­tions only have a com­mand line inter­face for licbor­row.

From the bin direc­to­ry of the TASKING prod­uct, run the fol­low­ing com­mand:

licborrow -d7 SW160800 v6.3r1

End of Borrowing

Nor­mal­ly, the bor­row­ing peri­od ends when the num­ber of days has passed. How­ev­er, if you want to return a bor­rowed license ear­li­er, you can set the num­ber of days to 0 (zero).

Use the GUI tool or com­mand-line tool the same way as described above and enter 0 for the num­ber of days, or in the GUI tool click Return License. The tool will respond with, for exam­ple:

License for SW160800 v6.3r1 successfully returned to lic1.tasking.com