Summary

This article is about Trusted Storage Toolkit Setup 101; walkthrough provided below

Synopsis

This walkthrough takes you from downloading the Trusted Storage Toolkit through creating an entitlement and ultimately checking out a license from trusted storage with your FLEX-enabled application.

Discussion

NOTE: This walkthrough uses example data that you'll need to modify to fit your needs, including pathing, hostname, and vendor daemon.

1. Extract FLEXnet Publisher v11.4.1(vendor) to new toolkit directory. (this means make a new toolkit)
2. Update lm_code.h with vendor & trl keys and vendor name. ...machind/lm_code.h
3. Change LM_seeds to make sure they're unique.
4. Copy publisher.xml (from Orders) to <platform>\ActivationSettings\
5. Change seed 0's to 8 digit hexadecimal numbers.
6. Update makefile.act with the Vendor Name (this is the trusted storage makefile)
7. Update the following file with the vendor name in place of runtimeloadname and item path.
   (Windows) machind\activation\prep_xml\vendor_daemon.xml
   (UNIX) machind\activation\prep_xml\vendor_daemon_unix.xml
   (Mac) machind\activation\prep_xml\vendor_daemon_mac.xml
8. (Windows only) Copy ...platform/demo.rc file to <vendor>.rc and modify with vendor info.
9. Build kit.
   (Windows) > nmake -f makefile.act clean (clears out old make)
   > nmake -f makefile.act
   (UNIX) > make -f makefile.act clean (clears out old make)
   > make -f makefile.act
   Copy FnpCommsSoap.so from the platform/publisher directory to platform directory.
10.  (Windows only) Build the dynamic linking library.
    > build MD
    Copy FnpCommsSoap.dll from the platform/publisher directory to platform directory.
11. installanchorservice publisher_name product_name.
    (Windows - located in /platform) > installanchorservice.exe superman RetailActivation
    (UNIX - located in /platform/publisher) > install_fnp.sh
    (UNIX) > setenv LD_LIBRARY_PATH .
12. Test appactutil and serveractutil.
    > appactutil -a
    > serveractutil -a

NOTE: When you first create Ops, you need to change:
Administer Operations|Configure Alerts|Processing of Trusted Activations, Detection and Notification Interval to 1 Seconds (default is 1 Days).

BUILD VCG (Vendor Certificate Generator)

• Download the VCG SDK from the website and extract it into the required directory.
• Open the file machind\vcg_code.h and enter into here the vendor daemon name, security seeds used by your company (note that the template may not include LM_SEED in the template, so you may have to add it after the ENCRYPTION_SEED section), and lm_strength (note that lm_strength will change with newer versions). These can be found in the machind\lm_code.h file from your FLEXlm / FLEXnet Licensing installation.
• Once this is done, save the file and edit the vcg.mak file in the platform specific directory that has also been created.
• Replace "VENDOR = demo" with "VENDOR = " and the name of your vendor daemon (same as in the vcg_code.h file).
• Copy platform\lmprikey.h from your FLEX toolkit folder to the platform directory of your VCG toolkit.
• Now build the VCG using the standard compiler: >nmake vcg.mak

IMPORT VCG INTO OPS

Once this is done you can then import this into the FlexNet Operations system.

To configure FLEXnet Operations with your own production VCG:

1. Copy your platform-specific VCG into an ops_install_dir/custom/platform/bin directory, where platform corresponds to the operating system on which FLEXnet Operations is running:
   i86_n3 (Windows)
   i86_re3 (Linux)
   sun4_u8 (Solaris)
   If your VCG was built on any of the three Linux platforms supported by the VCG kit, use a platform directory of i86_re3.
   The file will be made executable when it is copied into the site directory. The VCG is run from the site directory, but will be preserved on an upgrade or reconfiguration of the site directory if it is located in the custom tree, so make sure and copy over both vcg.exe and publisher.xml.
   NOTE: You'll need to do a flexnet site make to incorporate new VCG.) Also, make sure any entitlement you later create uses a Transaction Key that coincides with the correct VCG.
2. In the FLEXnet Operations web application, click the Administer Operations button. Click Create a License Generator Configuration in the left navigation pane.
3. From the License Technology choice list, select FLEXnet Licensing. (To create a license generator configuration for a different license technology, see Creating a License Generator Configuration.)
4. View or change the values of the following settings. Required fields are indicated with an asterisk. If a default value exists, it is listed as the first choice.
   http://bruce:8818/flexnet/help/Operations/opsCreateVcgConfig.htm
   ----------------------------------------------------------------
5. Click Save to save the configuration for this VCG.
6. Stop FLEXnet Operations.
7. To load files from the custom directory into the site directory, in the ops_install_dir directory, type flexnet site make.
8. Restart FLEXnet Operations

CREATE ENTITLEMENT IN OPS

(...make an entitlement called supermanRetailENT with supermanFeature...)

Install Anchor Service as admin (vendor is publisher, app is product)
> install_dir\i86_n3\installanchorservice.exe superman appactutil

1. Make sure you have the vendorfnp.dll, FnpComms*.dll (from /platform/publisher directory), and application in appactutil directory.
2. ./appactutil -served -comm soap -commServer http://bruce:8818/flexnet/services/ActivationService -entitlementID supermanRetailACT
   This should show: ACTIVATION REQUEST SUCCESSFULLY PROCESSED
3. Check local TS with "appactutil -view" to verify license is activated.

CHECKOUT A LICENSE