Command line activation of FotoWare applications using FotoWare License Tool
Overview
FotoWare License Tool is a command-line activation utility that can be used to manage the activation of all FotoWare applications via the command line. It can also be used when software deployment requires scripting of the activation sequence.
FotoWare License Tool replaces the older FotoWare Application Activation wizard (fwappactwiz).
Where to get it?
When you install a FotoWare server product (Index Manager or Color Factory, for example) FotoWare License Tool is automatically installed. Look for the FotoWare License Tool in your list of installed applications.
Alternatively, you can find the utility in the FotoWare Customer Portal in Utilities in the Downloads section.
How to start it?
- Once you have installed the utility, open the Windows Start menu and search for FotoWare License Tool.
- Select it in the Start menu to open a command prompt and display the utility help text.
Note: You need administrative privileges to run this utility.
Usage
General syntax
fwlicensetool [options]
Options
| Flags | Description |
|---|---|
| -?, -h, --help | Display this help |
| -v, --version | Display version information |
| -a, --activate <license> | Activate a license key |
| -l, --list | List all licenses, pass optional "c" for compact list |
| -d, --deactivate <Fulfillment ID | License key | "all"> | Deactivate a license |
| -r, --remove <Fulfillment ID | License key | "all"> | Remove a license |
| --repair | Repair broken licenses. Run the command without additional options to repair all broken licenses on the system |
| --renew | Renew all licenses with less than 30 days to expiry. Note: This option only works if the agreement has been renewed and when the renewed agreement is using the same license keys. If the license has already expired, you can use the activate commands. |
| -p, --proxy <proxyserver:port> | Use HTTP proxy for activating or deactivating |
| -c, --credentials <username:password> | Provide proxy credentials |
| --oa, --offline_activation <License key> | Create an offline activation request file. See here. |
| --or, --offline_response <Filename> | Read and activate the offline activation response file. See here. |
| --vf, --validate_feature <Feature> | Check if a feature is valid. --version_date is also required |
| --vd, --version_date <VersionDate> | Specify version date corresponding to app release, <yyyy.mm>. This argument is only used with --validate_feature |
| -i, --installservice | Install FlexNet license service (Windows only) |
| -u, --uninstallservice | Uninstall FlexNet license service (Windows only) |
| --ba, --batch-activate <input file> | Activate a batch of license keys from the text file. You can use any text file containing the licenses, for example, the .CSV file from the Customer Portal. |
Renewing subscription licenses
From 6th June 2023, we reuse the same license keys when renewing an agreement. Instead of activating new license keys, you can use the --renew option in FotoWare License Tool to renew or reactivate your existing license keys. This option only works for licenses that are within 30 days of their expiry date, if the license has already expired, this command won't work and you need to use the --deactivatecommand instead.
Simplified activation of multiple keys
If you need to activate several license keys at the same time on the same machine, you can use batch activation. You can use any text file containing the licenses as the command argument, for example, the .CSV file from the Customer Portal. Use the --ba, --batch-activate <input file> option to activate all of the licenses at the same time.
Offline activation
Offline activation is used when the computer where the FotoWare software is activated does not have a working internet connection.
An offline activation consists of the following steps:
- Generating an offline activation request file on the computer that's intended to run the software.
- Uploading the activation request file to FotoWare: Go to https://licenses.fotoware.com/offline-activation (requires a FotoWare Customer Portal account) to upload the file.
- Using the response file received in the previous step to activate the software on the computer.
The command used to create the activation request file in step 2 and the command used to activate the offline response file in step 3 are described in the Options table above.