Installation

Introduction

APCrypt is a command-line driven server-based application that applies standard Acrobat security features to PDF documents. APCrypt is designed to run in tandem with other processes in an unattended environment and to handle high-volume and on-demand production needs.

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 4.0 and higher, there are two additional environmental variables that need to be set for APCrypt on all UNIX platforms. If you run APCrypt from the apcrypt script created during installation, these environmental variables will be set by the script. If you run apcryptapp directly, you will need to set these environmental variables to run APCrypt. Once APCrypt is installed, you can view the variables needed by looking at the apcrypt 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 APCrypt. It also contains license information for APCrypt.

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 APCrypt 5.0

In previous versions of APCrypt, the APCrypt registration number was required as a command line option with the -r flag each time apcryptapp was run. An apcrypt script was provided that automatically added -r and the registration number to the apcryptapp command line when the script was run.

In the current release, in addition to getting the registration number from the command line, APCrypt can get the registration number from a license file in the appligent home directory. On unix systems, license files are created by the installation script and stored in the ${APPLIGENT_HOME}/license directory. For windows, the license file is created by the installer and stored in the All Users/Application Data/Appligent/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.

To upgrade a Demo Version of APCrypt 5.0

As mentioned in the previous paragraph, registration numbers are now stored in the license directory. The license file for ApCrypt 5.0 is called APCT_50.arn. To upgrade a demo version of ApCrypt, change the demo number stored in the license file to your new registration number. If you call the apcryptapp executable with the -r option directly from a script or program that you wrote, update the number in that file.

Type apcrypt -v on the command line and press Enter. The new registration number, and a message that it is valid, should be displayed.

Supported Platforms

Windows: NT, 2000, XP, Vista & above
AIX: 5.2 & above on Power
Linux: 32 bit and 64 bit
Solaris: 10 and above on SPARC
HPUX: 11i v2 & above on Itanium
OSX: 10.5 & above on Intel x86