License Server in the cloud
When pdfToolbox is used in a run time container such as Docker it is difficult to activate it, since that would require to store activation information in the container image. But then the image cannot be used for additional instances (scalable cloud).
In such environments License Server in the cloud should be used.
Terms
License Server in the cloud has an internal database for all users. Each user has a Wallet in which her resources (Cartridges) are saved. The Wallet is referenced via a Wallet ID, that the user will receive when the first Cartridge is purchased. (Cartridges can be purchased from those partners where also regular pdfToolbox Licenses are available.)
The URL for License Server in the cloud is
licenseserver.callassoftware.com
Using License Server in the cloud
It is straightforward to use License Server in the cloud on command line or in the SDK.
The parameter to reference a License Server needs to specify the URL of License Server in the cloud and an additional parameter "lsmessage" needs to specify the Wallet ID.
Example
docker run callassoftware/pdftoolbox-cli ./pdfToolbox --licenseserver=licenseserver.callassoftware.com --lsmessage=<Wallet ID> ./"Create page images from all images.kfpx" ./ “Some.pdf“
Monitoring License Server in the cloud
In order to monitor what Cartridges are available for a Wallet ID and what Cartridges are currently in use the License Server in the cloud webinterface can be used. The License Server in the cloud URL has to be entered into the Browser URL input field
https://licenseserver.callassoftware.com
The Wallet identifier is then to be entered into the input field to display the information for that Wallet.