


Static Entitlement tokens
A static entitlement token can be used to run an application on a workstation when the PFBucket entitlement system is not being used.
Once a static entitlement token is generated, that entitlement is tied to a single machine and cannot be moved elsewhere.
When using a static entitlement, internet access on the workstation is required to launch the application. If no internet connection is available on the workstation, please install the PFBucket entitlement server on your local network instead.
Please note that static entitlements should be generated for operator workstations only, and will not work with the PFBucket entitlement server.
Generating Static Tokens
Generating a static entitlement token is possible for any unassigned product entitlement, and is achieved by visiting the PFAccount Admin Portal at https://pfaccount-thepixelfarm.co.uk, selecting the Product Entitlement Manager option and then selecting the Static token type.
Clicking the Generate Static Token link next to your entitlements will display a page where you can enter information about your workstation.
You will be asked to enter two pieces of information: the PFHostID for your operator's workstation, and the workstation machine name. The PFHostID is a unique identifier associated with your computer, and can be found by running your application and waiting until the Entitlement Error window appears. This will display the PFHostID as a string of 12 characters:
Please note that PFTrack requires a suitable hardware identifier on your machine to generate a PFHostID. We do not recommend or support the use of virtual machines or similar to run PFTrack using static entitlements because they are unable to provide such an identifier.
Once the token is generated, it can be downloaded to your workstation and copied to the appropriate location for your operating system (note this may require Administrator privileges on your computer):
Operating System | Entitlement Token Location |
---|---|
Windows | C:\Program Files\The Pixel Farm\license.txt |
macOS | /Applications/The Pixel Farm/license.txt |
Linux | /var/thepixelfarm/license.txt |
If the static token is lost (for example, the operating system is re-installed after wiping the hard drive), it can easily be recovered by visiting the PFAccount Admin Portal, clicking the Information button for the entitlement, and then clicking Download Token link.
Releasing Static Tokens
If you wish to move your entitlement to another machine you can release your static entitlement in the PFAccount Admin Portal by clicking the Information button for the entitlement, and then clicking Release Entitlement from the popup window. This will allow you to either generate another static entitlement token for a different machine, or move your entitlement into a bucket to use with the PFBucket entitlement server.
Releasing an entitlement from a machine will invalidate the entitlement token stored in your license.txt file at:
/Applications/The Pixel Farm/license.txt
so this file should be removed. If PFTrack attempts to run with an invalid token, it will display the error message "This entitlement token can no longer be used to run PFTrack".