Online Activation
Trusted activations are normally done programmatically as transactions between a client or server activation utility and the FlexNet Operations server. The activation utility generates a request that is submitted programmatically and the FlexNet Operations server generates a response that is used to complete the activation.
The following sections describe the client and server utilities used to perform online trusted storage license activation. For syntax and options, type the utility name in the FlexNet Publisher Licensing Toolkit <platform_dir> command window.
Note:The exercises in this getting started section are based on a Windows platform installation of the FlexNet Publisher Licensing Toolkit. To do the exercises on a UNIX machine, adjust the path and file name syntax for the UNIX environment.
The client-side online activation utilities are appcomptranutil (composite transaction) and appactutil (single transaction). These utilities are run, in a command window on the client, with command-line parameters that indicate the FlexNet Operations server host and port, and the activation ID.
Client-side activation requires a product linked to a retail activation license model.
Composite Transaction
For the composite transaction activation utility, appcomptranutil, the command to perform a retail activation looks similar to
appcomptranutil -t http://<hostname:port>/flexnet/services/ActivationService -a <act_ID>
where
| • | <hostname> is localhost, the name of the system on which the license server is running |
| • | <port> is 8888 |
| • | <act_ID> is the activation ID displayed by FlexNet Operations |
Note:For sample commands shown in this getting started section, it is assumed that FlexNet Operations and the activation utilities are running on the same system. If not, replace localhost:8888 with the appropriate host and port values.
Progress messages are displayed at the command line.
Multiple transactions can be invoked in a single command with appcomptranutil. To perform multiple activations in a single command, append additional activations to the command with -a <act_ID>. For example,
appcomptranutil -t http://<hostname:port>/flexnet/services/ActivationService
-a <act_ID1> -a <act_ID2> -a <act_ID3>
Note:To successfully perform multiple activations in a single command, all entitlements must belong to the same account, use the same license type (client or server), and be performed on the same machine.
Legacy, Single Transaction
For the single transaction activation utility, appactutil, the command to perform a retail activation looks like
appactutil -served -comm soap -commServer http://<hostname:port>/flexnet/services/ActivationService
-entitlementID <ent_ID>
where <ent_ID> is the entitlement ID.
Progress messages are displayed at the command line.
New license rights for the products and features you defined in FlexNet Operations are visible in client-side trusted storage when you run the command
appcomptranutil -view
or
appactutil -view
Output is similar to
Trust Flags: FULLY TRUSTED
Fulfillment Type: PUBLISHER ACTIVATION
Status: ENABLED
Fulfillment ID: FID__111ff222_333445555__666e
Entitlement ID: ent_ID
Product ID: NAME=Sample App;VERSION=1.0
Expiration date: 31-dec-2015
Feature line(s):
INCREMENT F1 demo 1.0 31-dec-2015 1 ISSUER="Sample Co." \
ISSUED=1-jan-2015 START=1-jan-2015 SIGN="..."
INCREMENT F2 demo 1.0 31-dec-2015 1 ISSUER="Sample Co." \
ISSUED=1-jan-2015 START=1-jan-2015 SIGN="..."
Server-side activation is performed in a manner similar to client-side activation, and can be performed using a server activation utility such as servercomptranutil or serveractutil.
Server-side activation requires a product linked to one of the following license model types:
| • | Enterprise activation |
| • | Floating borrowable |
| • | Floating transferable |
Composite Transaction
Server-side commands using servercomptranutil are similar to client-side commands using appcomptranutil. For a composite transaction server activation utility, a sample command is
servercomptranutil -t http://<hostname:port>/flexnet/services/ActivationService -a <act_ID> count=1
Multiple transactions can be invoked in a single command with servercomptranutil. To perform multiple activations in the same command, append additional activations to the command with -a <act_ID> count=n, where n is the number of products being activated. For example,
servercomptranutil -t http://<hostname:port>/flexnet/services/ActivationService
-a <act_ID1> count=x -a <act_ID2> count=y -a <act_ID3> count=z
Note:To successfully perform multiple activations in a single command, all entitlements must belong to the same account, use the same license type (client or server), and be performed on the same machine.
Legacy, Single Transaction
Legacy, server-side commands using serveractutil are similar to client-side commands using appactutil. For a single transaction server activation utility, a sample command is
serveractutil –served –comm soap –commServer http://<hostname:port>/flexnet/services/ActivationService -entitlementID <ent_ID> -expiration 1-jan-2018 -licensemodeltype <count>
where
| • | <ent_ID> is the entitlement ID |
| • | licensemodeltype is one of the following: |
| • | activatable for an enterprise activation model |
| • | hybrid for a floating borrowable model |
| • | concurrent for a floating transferable model |
| • | <count> is the number of products, using licensemodeltype, that are being activated |