Installation

Introduction

StampPDF Batch is a server-based, command-line-driven application that lets you stamp new text or images into PDF documents. Any text or image added by StampPDF Batch becomes a permanent part of the document.

Memory Requirements

Minimum free memory available to run the application: 512 MBytes.

Windows Installation

Windows installation is handled by the installer and does not require any special handling.

Unix Installation

Setting environmental variables (All Unix Platforms)

In version 5.1 and higher, there are two additional environmental variables that need to be set for StampPDF Batch on all UNIX platforms. If you run StampPDF Batch from the stamppdf script created during installation, these environmental variables will be set by the script. If you run stamppdfapp directly, you will need to set these environmental variables to run StampPDF Batch. Once StampPDF Batch is installed, you can view the variables needed by looking at the stamppdf script created by the installer.

Setting the Appligent home directory (All Unix Platforms)

The environmental variable that stores the location of the Appligent home directory is APPLIGENT_HOME. The default location for the Appligent home directory is /usr/local/appligent. The Appligent home directory contains the library files and resources needed to run StampPDF Batch. It also contains license information for StampPDF Batch.

Example:

export APPLIGENT_HOME=/usr/local/appligent

Setting the APDFL library path (All Unix except AIX)

The APDFL library path must be added to the LD_LIBRARY_PATH variable. The APDFL library path is located in a subdirectory of the APPLIGENT_HOME directory.

The path should be set to ${APPLIGENT_HOME}/APDFLX.X.X/Libs

Example:

export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${APPLIGENT_HOME}/APDFLX.X.X/Libs

Setting the APDFL library path ( AIX Only )

The APDFL library path for AIX must be added to the LIBPATH variable. The APDFL library path is located in a subdirectory of the APPLIGENT_HOME directory.

The path should be set to ${APPLIGENT_HOME}/APDFLX.X.X/Libs.

Example:

export LIBPATH=${LIBPATH}:${APPLIGENT_HOME}/APDFLX.X.X/Libs

Registration Numbers for StampPDF Batch 5.1 and higher

In previous versions of StampPDF Batch, the StampPDF Batch registration number was required as a command line option with the -r flag each time stamppdfapp was run. A stamppdf script was provided that automatically added -r and the registration number to the stamppdfapp command line when the script was run. In the current release, in addition to getting the registration number from the command line, StampPDF Batch can get the registration number from a license file in the appligent home directory. License files are created by the installation script and stored in the ${APPLIGENT_HOME}/license directory. With a valid license file, the -r is no longer required on the command line. The -r option can still be used as in previous versions, and will override the value in the license file.

Using Fonts

Base14, OpenType, TrueType, Type1 and Unicode (see Encoding) fonts are all supported in StampPDF Batch. In previous versions, Type1 fonts were used in StampPDF Batch by including the FontFile parameter. In StampPDF Batch 5.2.2  and higher, you should only specify the font name.

In order to use a non-Base14 font, the font must be stored in one of the Appligent font directories  (See Font Directories below). You can run the command
$ stamppdf –listfonts
to see a list of all font names available for stamping. The font name should be used exactly as it is shown in the font list.
Some of the classic Base14 fonts are no longer included with the application resources.  In particular Times and Helvetica.  Both of these fonts are automatically substituted; but, may not appear identical to the classic fonts.  If the new font appearance are not accept-able; simply use the versions of Times and Helvetica available on your system.  This can be done by setting the Font Directories; please see below.

Font Directories
There are two font directories. The default font directory is found under the AppligentHome directory in APDFLX.X.X/Resource/Font.

Windows

The AppligentHome directory is in the AllUsers Application data directory.
Windows XP: C:\Documents and Settings\All Users\Application Data\Appligent
Windows Vista and later: C:\ProgramData\Appligent

Environment variables can be set on Windows under the System Properties. To display the System Properties, right click on “My Computer” and select properties. On the bottom of the Advanced tab, click the button labeled “Environment Variables”. Under system variables, you will see an entry for AP_FONT_DIR. Select this entry, and click edit. You can then change the
variable’s value to the path of the current font directory. Multiple directories can be added by placing a semicolon in between each directory path.

Unix

/usr/local/appligent
You can also specify an additional font directory, the AP font directory. The path to the AP font directory is saved in an environment variable called AP_FONT_DIR. You will be prompted to enter a font directory during installation.

As the other environment variables for StampPDF Batch, AP_FONT_DIR is set in the stamppdf script. The directory set in an environment variable in the script, or be set for the shell. See ManualInstall.pdf for more information on setting the AP_FONT_DIR and other environment variables on Unix.