Applying Keys After Product Installation
PDF-XChange licenses can be downloaded from your account in two forms:
•a KeyFile - a file with the extension .xcvault that contains licensing information and the license key string itself.
ousers double click a Key File to apply a per user license.
ocan be passed to XCVault.exe.
ocan be passed to an installer
•as KeyData - a long string, more than 250 characters, that is the key sting itself.
ocan be copy/pasted into the software GUI to apply a Per User license
ocan be passed to XCVault.exe
ocan be passed to an installer
XCVault.exe
When PDF-XChange products are installed, by default a utility called XCVault.exe is put in %programfiles%\Tracker Software\Vault and .xcvault license files are associated with it.
Figure 1. Windows Settings, Default Apps by File Type
All the options available to XCVault.exe are detailed here: XCVault Command Line Options.
•A KeyFile can be passed to XCVault.exe by using the switch /AddKeys.
•KeyData can be passed to XCVault.exe by using /AdKeyData.
Use a script to apply licenses remotely/in an unattended setup by calling XCVault.exe and passing the license key to it.
Per User licensing requires that XCVault.exe be run as the target user. A logon script or Group Policy based script is a good choice here, it must be run in the user session so it can put the key in the user's HKCU hive, specifically HKEY_CURRENT_USER\Software\Tracker Software\Vault
Per Machine licensing requires that XCVault.exe be run with elevated rights. This will put the key in HKLM hive, specifically HKEY_LOCAL_MACHINE\SOFTWARE\Tracker Software\Vault
Per User Examples - run as the target user
xcvault.exe /AddKeys "c:\\UNC\path\to\Personal.xcvault" - Adds the license defined in Personal.xcvault to HKCU that applies only to to the current user.
xcvault.exe /AddKeys "c:\\UNC\path\to\Personal.xcvault" /S - Adds the license defined in Personal.xcvault to HKCU that applies only to to the current user, and suppresses information about the result.
xcvault.exe /AddKeys "c:\\UNC\path\to\Personal.xcvault" /R - Adds the license defined in Personal.xcvault to HKCU in plain text (not encrypted) that applies only to to the current user.
xcvault.exe /AddKeyData "PXP10-CxL56n1SDEgUuF...+LB7kDyA" - Adds the license defined in "<KEYDATA>" to HKCU that applies only to to the current user.
xcvault.exe /AddKeyData "PXP10-CxL56n1SDEgUuF...+LB7kDyA" /S - Adds the license defined in "<KEYDATA>" to HKCU that applies only to to the current user, and suppresses information about the result.
xcvault.exe /AddKeyData "PXP10-CxL56n1SDEgUuF...+LB7kDyA" /R - Adds the license defined in "<KEYDATA>" to HKCU in plain text (not encrypted) that applies only to to the current user.
Per Machine Examples - run as admin. /M is required.
xcvault.exe /AddKeys "c:\\UNC\path\to\Personal.xcvault" /M /R - Adds the license defined in Personal.xcvault to HKLM in plain text (not encrypted) that applies to all users. This must be run with elevated privileges.
xcvault.exe /AddKeyData "PXP10-CxL56n1SDEgUuF...+LB7kDyA" /M /R - Adds the license defined in "<KEYDATA>" to HKLM in plain text (not encrypted) that applies to all users. This must be run with elevated privileges.
Please note the following when using XCVault.exe to perform the unattended installation
•The command must be issued by the user for whom the license is to be applied.
•System accounts can only be used for Per Machine licensing and never Per user as they do not have access to the target user's HKCU registry hive.
•Although relative paths can be used, using the full literal paths to both the XCVault.exe executable and the .xcvault file is recommended.
•An .xcvault file can only be used on a network resource when the user running the command has read-access to the file