Installation and activation

pdfToolbox CLI offers a wide range of options to analyze, correct and enhance PDF files as well as impositioning features and color conversion.

System requirements

The command line version of pdfToolbox is available for the following operating systems:

  • Mac (Intel): macOS, version 10.7 or newer, 64-bit-compliant
  • Windows:
    • Windows 7 or newer
    • Windows Server 2008 R2 or newer
  • Linux: The minimum required Linux OS versions are shown below (Linux OS versions with a higher number are always supported as well):
    • Debian 7 (and derivates like Ubuntu 12.x )
    • RedHat RHEL6 (and derivates like CentOS6)
    • SuSE SLES11 (and derivates like OpenSuSE11)
    • Note: other Linux distributions are also supported if the version of the glibc is at least v2.10
  • Solaris (Sparc and Intel): Solaris 10 (v5.10) or newer
  • AIX (PPC): AIX 5.3 (oslevel 5300-07) or newer

You can easily test if pdfToolbox CLI is working on your system: Just type pdfToolbox --help in the terminal.

There are 64 bit versions of pdfToolbox CLI available for MacOS, Windows and Linux.  pdfToolbox CLI does also run on 64 bit systems if the required 32 bit compatibility packages are available.

at least 2 GB RAM
at least 10 GB of free Disk Space

Installing the software

Macintosh/Windows

To install the software start the pdfToolbox Server installer. The installation program will then take you through the necessary steps.

Linux/Solaris/AIX

Extract all files from the archive to a destination folder of your choice.

For automation purposes you should set the PATH variable to the path of the pdfToolbox CLI executable.

Additional information is provided in <pdfToolbox CLI directory>/ReadMe.txt

Activation

Before callas pdfToolbox CLI can be used, the software has to be activated.

Request an activation code

Open a terminal window and change to your pdfToolbox CLI installation directory. Type:

pdfToolbox --keycode [--aws] <name> <company> <licenseCode>

Parameters

name
Name of licensee (e.g. "Registered User")
company
Name of company (e.g. "User's company")
licencecode
Licence key obtained from the registration card or the License.pdf provided by callas or the reseller.
To make a request for a trial version, please use the keword "trial" (for a pdfToolbox trial version) for this parameter
The textual output of --keycode has to be send via e-mail to the e-mail address named in the text in order to receive an activation code from the registration server.
aws
For installation on Amazon Web Services (using Windows, Linux 32bit and 64bit)

The textual output of --keycode has to be send via e-mail to the e-mail address named in the text in order to receive an activation code from the registration server.

Activating pdfToolbox CLI

After having received the automatical reply e-mail to the activation request, save the attached licence file to the file system. Then use the following command:

pdfToolbox --activate <activation file>

Parameters

activation file
Full path to Activation PDF

If your SPAM filter has removed the attachment, you can create a new empty text file and copy all lines from the e-mail that are starting with an "@" into the text file. Save it as a UTF-8 encoded plain text file with the name “Activation.txt". This text file can now be used in the exact same fashion as described above for the Activation PDF.

It is necessary to activate the received license file to get a permantent valid license file.

The license file received from the activation server must be activated within the timeframe listed in the license file.

The activated license file will be stored in the user-preferences when the normal activation (command above) is used.

To create an activated license file at a custom location, just use the following command:

pdfToolbox --activate <licence file> -o=<path to result folder/License.txt>

pdfToolbox CLI is searching for the license file at various folders:

  • user-preferences-folder of actual user
  • next to the pdfToolbox CLI binary
  • cachefolder (if set)
  • user-preferences-folder for all users (shared)

When using UNIX-based-systems the environment variable CALLAS_SYSTEM_PREFERENCES the path of the standard /usr/share/callas software/callas pdfToolbox CLI can be changed:

CALLAS_SYSTEM_PREFERENCES=tmp

would result in the searchpath: /tmp/callas software/callas Toolbox CLI 

It is highly recommended to use the option --cachefolder instead.

Time-limited trial version

After requesting and entering a trial activation code, pdfToolbox CLI can be tested without any restrictions. When the evaluation period has expired, processing PDF files will no longer be possible until you request and enter a new activation code.

Activation using the Standalone application

Using Windows and MacOS, also the activation dialog of the Standalone Application can be used for requesting an activation as well as using a Keycode or just for a trial version. Also the activation itself can be done using that Interface.

All activations (for Desktop, Server as well as for the DeviceLink Addons) can be done using this dialog.

Deactivate pdfToolbox using the CLI

As the activation (and the resulting license file) is bound to the hardware. It is necessary to deactivate a license on one machine before an activation takes place on the new machine.

pdfToolbox --deactivate <activation code>
activation code
Unique identifier for each license

The respective license will be removed from the system

To complete the deactivation, the output of the command has to be sent manually to the activation server by e-mail.

The activation code for all license are listed using the status command:

pdfToolbox --status

Deactivation using the Standalone application

Similar to the deactivation using the CLI, the Desktop on Windows and MacOS can be used for deactivation.

The selected license will be removed from the system as well and the necessary e-mail to the activation server will be sent automatically.

0 Comments

Send Your Comment

E-Mail me when someone replies to this comment