Installation Instructions

To install ImageGear, download an electronic version from our Web Site www.accusoft.com. Please contact AccuSoft Customer Service at (508) 351-6956 for instructions on downloading your specific version of ImageGear for Unix.

The name of the ImageGear installation package for Unix is:

ImageGear15.3.tar.gz for Unix 32-bit platforms

ImageGear15.3-64.tar.gz for Unix 64-bit platforms

To install ImageGear, perform the following steps:

NOTE: The AccuSoft License Manager requires Sun JRE 1.3 or newer. GCJ does not work because it lacks some necessary classes.

1. Move the installation file into your home directory $HOME and run: tar zxvf {installation filename}
    

2. In order for ImageGear to work, there must be a license file installed. The license key is kept in the file with the name accusoft.<solution name>.imagegear. ImageGear installation comes with predefined solution name as 'AccuSoft 1-101-15' for 32-bit platforms, and 'AccuSoft 1-105-15' for 64-bit platforms. The blank accusoft.AccuSoft 1-101-15.imagegear license file is included in the installation. The license obtained from the AccuSoft web site needs to be inserted into this file. When it's done, the variable IMAGE_GEAR_LICENSE_DIR has to be defined, and should contain the path to the license file (for example $HOME/AccuSoft/ImageGear15/Pro/Unix/). If the IMAGE_GEAR_LICENSE_DIR variable is not defined, ImageGear will look for the license file in /usr/lib/ directory.
    

3. In order to let the linker find the shared libraries, define the LD_LIBRARY_PATH environment variable. For example: LD_LIBRARY_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux
   The ImageGear application uses the IMAGE_GEAR_LIBRARY_PATH variable to set a path to the ImageGear libraries. For example: IMAGE_GEAR_LIBRARY_PATH=$HOME/AccuSoft/ImageGear/Professional Edition/Unix/Bin/Linux

Automated Installation Script

1. Extract the ImageGear15.3.tar.gz (ImageGear15.3-64.tar.gz for 64-bit platforms), which is typically done by running
      tar zxvf ImageGear15.3.tar.gz
    

2. Located in the AccuSoft/ImageGear15/Pro/ folder (AccuSoft/ImageGear15-64/Pro/ folder for 64-bit platforms) after extracting is the install.sh script, running it:
      Examples:
      AIX (C Shell)-> ./install.sh
      HPUX (C Shell)-> ./install.sh
      Linux (bash)-> . install.sh
      Solaris (Korn Shell) -> .install.sh
   
   will search for and modify the current user's shell profile files to add ImageGear's environment variables for the current folder and attempt to run the java AccuSoft License Manager. Optionally a destination directory can be used as an argument. For example:
      . install.sh $HOME/ImageGear15/Pro
   
   In this case the contents of the AccuSoft/ImageGear15/Pro/ directory will be copied to the specified directory and the environment variables and licensing is done for this location.

Manual Installation

1. After downloading an evaluation copy of ImageGear for Unix, move the installation file into your home directory $HOME and extract the files. A typical method is to run:
      tar zxvf {installation filename}
    

2. In order for ImageGear to work there must be a license key installed. This license key is kept in the file with the name: 'accusoft.<solution name>.imagegear'. ImageGear for Unix comes with a predefined solution name as 'AccuSoft 1-101-15' for 32-bit platforms, and 'AccuSoft 1-105-15' for 64-bit platforms. The blank "accusoft.AccuSoft 1-101-15.imagegear" license file is included in the installation. A license obtained from the AccuSoft web site needs to be inserted in this file. To do this:

a. Run the EnvParamsUtility included in the installation. This is located at:
$HOME/AccuSoft/ImageGear15/Pro/Utils/<Unix OS>/EnvParamsUtility
To run it, go to the directory above and type: ./EnvParamsUtility
This will generate a Hardware ID of the form: mac-00-A0-C9-73-06-20
You will use this Hardware ID to generate a License Key in the next step.

b. For evaluation start the WebEvalClient Utility on AccuSoft's website at:
https://www.accusoft.com/licensing/v1/webevalclient/product.aspx
If you have already purchased development license, start the WebEvalClient Utility on AccuSoft's website at:
https://www.accusoft.com/licensing/v1/WebProductClient/login.aspx

Select the Unix OS type (or Java to obtain IGJava license), and Login with the email and password you registered with AccuSoft. Enter the Hardware ID from the previous step (not required for Java), and you will be given the License Key. You will need to put this License Key in the license file in the next step.

c. Open the "accusoft.AccuSoft 1-101-15.imagegear" file in an editor. It's located at:
$HOME/AccuSoft/ImageGear15/Pro/Unix/accusoft.AccuSoft 1-101-15.imagegear

Copy the License Key from the previous step and save the file.

3. Now that the license file is created, the variable IMAGE_GEAR_LICENSE_DIR has to be defined, and should contain the path to the license file (for example: $HOME/AccuSoft/ImageGear15/Pro/Unix/ assuming the default install).
   
   If the IMAGE_GEAR_LICENSE_DIR variable is not defined ImageGear will look for the license file in /usr/lib/ directory. In order to let the linker find the shared libraries, you need to define:
   
   For Linux and Solaris:
   LD_LIBRARY_PATH environment variable. For example: LD_LIBRARY_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux
   
   For AIX:
   LIBPATH environment variable. For example: LIBPATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/AIX
   
   For HP-UX:
   SHLIB_PATH environment variable. For example: SHLIB_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/HP-UX
   
   The ImageGear application uses the IMAGE_GEAR_LIBRARY_PATH variable to set a path to the ImageGear libraries. For example:
   IMAGE_GEAR_LIBRARY_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux
   
   Here is an example Linux .bash_profile with all the necessary variables defined:
   
   # User specific environment and startup programs
   PATH=$PATH:$HOME/bin:.
   BASH_ENV=$HOME/.bashrc
   USERNAME=""
   LD_LIBRARY_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux
   IMAGE_GEAR_LIBRARY_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux
   IMAGE_GEAR_LICENSE_DIR=$HOME/AccuSoft/ImageGear15/Pro/Unix
   
   export USERNAME BASH_ENV PATH LD_LIBRARY_PATH IMAGE_GEAR_LIBRARY_PATH
   IMAGE_GEAR_LICENSE_DIR
    

INSTALLING THE OPTIONAL PDF PLUG-IN (Linux, Solaris, and AIX 32-bit)

It is necessary to install additional files for the optional PDF extension. Because the ImageGear for Unix PDF and PS support implementation is based on Adobe PDF and PostScript library, some additional steps are necessary for proper installation.

1. The following environment variables must specify a path to the PDF component files:
   
   For Linux and Solaris:
   LD_LIBRARY_PATH environment variable. For example: LD_LIBRARY_PATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux
   
   For AIX:
   LIBPATH environment variable. For example: LIBPATH=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/AIX
    

2. See the "PDF Component" chapter of the ImageGear User Guide for more ImageGear PDF initialization details.
    

INSTALLING THE OPTIONAL PDF PLUG-IN (HP-UX 32-bit and all 64-bit platforms)

It is necessary to install additional files for the optional PDF extension. Because the ImageGear for Unix PDF and PS support implementation for these platforms is based on Artifex Ghostscript, some additional steps are necessary for proper installation. There are two possible ways to get this done:

1. The subdirectory /accugs contains the files necessary to run the Unix version of Ghostscript. It is possible to set up the environment variable IMAGE_GEAR_ACCUGS to point to this directory. For example:
   IMAGE_GEAR_ACCUGS=$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux/accugs
   
    

2. If this variable is not defined, then the PDF extension will search the /accugs directory with all files in the subdirectory /usr/local. So the alternate way is to copy /accugs to /usr/local.
    

INSTALLING IMAGEGEAR JAVA

ImageGear Java package can be found in /AccuSoft/ImageGear15/Pro/Java/. To extract the ImageGear Java files, use a utility such as gzcat, zcat or gunzip and pipe the output to tar. For example:

gunzip < java.tar.gz | tar xvf -

Linux users must use the GNU zip version of zcat.
 

OTHER INSTALLATION DIRECTIVES

• There is a demo application included with this build located in: /Samples/filters. The "filters" sample requires Motif to be installed, and provides basic dialogs to load and save images, load and unload extensions, change TIFF filter's control parameter, and so on. ImageGear itself does not require Motif, but does require libc, libm and libpthread.

• This release allows you to load extensions not only with the shared version of ImageGear(libIGCORE.so) but with the static version also (libIGCORE.a).

• Please note that due to a conflict of the standard BOOL type used in a previous version of ImageGear with one of the X include files (Xdm.h), the BOOL type is not defined any more, but AT_BOOL type is defined and should be used instead.
   

NOTES ON EXTRACTING FILES

To extract the Installation files, use a utility such as gzcat, zcat or gunzip and pipe the output to tar. For single files use:
gunzip < ImageGear*.tar.gz | tar xvf -
 

Directory Structure

The installation will create the following directory structure, assuming that the home directory is the install directory:

$HOME/AccuSoft/
$HOME/AccuSoft/ImageGear15/
$HOME/AccuSoft/ImageGear15/Pro/

$HOME/AccuSoft/ImageGear15/Pro/Documentation/
$HOME/AccuSoft/ImageGear15/Pro/Documentation/Help/
$HOME/AccuSoft/ImageGear15/Pro/Documentation/Releasenotes/

$HOME/AccuSoft/ImageGear15/Pro/Java/
$HOME/AccuSoft/ImageGear15/Pro/Java/Bin/
$HOME/AccuSoft/ImageGear15/Pro/Java/Documentation/
$HOME/AccuSoft/ImageGear15/Pro/Java/Samples/

$HOME/AccuSoft/ImageGear15/Pro/Unix/
$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/
$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/AIX/
$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/HP-UX/
$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Linux/
$HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/Solaris/

$HOME/AccuSoft/ImageGear15/Pro/Unix/Include/
$HOME/AccuSoft/ImageGear15/Pro/Unix/Samples/

$HOME/AccuSoft/ImageGear15/Pro/Utils/
$HOME/AccuSoft/ImageGear15/Pro/Utils/AIX/
$HOME/AccuSoft/ImageGear15/Pro/Utils/HP-UX/
$HOME/AccuSoft/ImageGear15/Pro/Utils/Linux/
$HOME/AccuSoft/ImageGear15/Pro/Utils/Solaris/
$HOME/AccuSoft/ImageGear15/Pro/Utils/lib/
 

Description of Installed Files

All the files installed using the install procedure as described above will be installed in the directory structure shown above. Depending on the version of the library you have purchased, the file names will change, as well as the file sizes and usage requirements. Also included will be one or more sample programs installed in the subfolder named "samples". These sample programs can be used as guides or examples of how to use the libraries in your applications. You may cut and paste freely from these sample programs into your own applications.

The following is a list of those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/:
SoftwareLicense.rtf - license agreement
INSTALL.txt - installation instructions

The following is a list of those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/Unix/:
accusoft.AccuSoft 1-101-15.imagegear - license file for 32-bit platforms
accusoft.AccuSoft 1-105-15.imagegear - license file for 64-bit platforms

The following is a list of those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/Unix/Bin/:
Resource - PDF resource directory

AIX/libIGCORE15.a - ImageGear Core static library for AIX
AIX/libIGCORE15.o -> libIGLZW15.so.15 - ImageGear LZW shared library for AIX
AIX/libIGPDF15.so -> libIGPDF15.so.15 - ImageGear PDF shared library for AIX
AIX/libACE.so - PDF shared library for AIX
AIX/libAGM.so - PDF shared library for AIX
AIX/libBIB.so - PDF shared library for AIX
AIX/libBIBUtils.so - PDF shared library for AIX
AIX/libCoolType.so - PDF shared library for AIX
AIX/libJP2K.so - PDF shared library for AIX
AIX/libnserver.so - PDF shared library for AIX
AIX/libOPP.so - PDF shared library for AIX
AIX/libpdfl.so - PDF shared library for AIX

HP-UX/libIGCORE15.a - ImageGear Core static library for HP-UX
HP-UX/libIGCORE15.so -> libIGCORE15.so.15 - ImageGear Core shared library for HP-UX
HP-UX/libIGLZW15.so -> libIGLZW15.so.15 - ImageGear LZW shared library for HP-UX
HP-UX/libIGPDF15.so -> libIGPDF15.so.15 - ImageGear PDF shared library for HP-UX
HP-UX/accugs - PDF Ghostscript files for HP-UX
HP-UX/accugs/fonts - PDF Ghostscript font files for HP-UX

Linux/libIGCORE15.a - ImageGear Core static library for Linux
Linux/libIGCORE15.so -> libIGCORE15.so.15 - ImageGear Core shared library for Linux
Linux/libIGLZW15.so -> libIGLZW15.so.15 - ImageGear LZW shared library for Linux
Linux/libIGMED15.so -> libIGMED15.so.15 - ImageGear Medical shared library for Linux
Linux/libIGPDF15.so -> libIGPDF15.so.15 - ImageGear PDF shared library for Linux
Linux/libACE.so - PDF shared library for Linux
Linux/libAGM.so - PDF shared library for Linux
Linux/libBIB.so - PDF shared library for Linux
Linux/libBIBUtils.so - PDF shared library for Linux
Linux/libCoolType.so - PDF shared library for Linux
Linux/libJP2K.so - PDF shared library for Linux
Linux/libnserver.so - PDF shared library for Linux
Linux/libOPP.so - PDF shared library for Linux
Linux/libpdfl.so - PDF shared library for Linux

Solaris/libIGCORE15.a - ImageGear Core static library for Solaris
Solaris/libIGCORE15.so -> libIGCORE15.so.15 - ImageGear Core shared library for Solaris
Solaris/libIGLZW15.so -> libIGLZW15.so.15 - ImageGear LZW shared library for Solaris
Solaris/libIGPDF15.so -> libIGPDF15.so.15 - ImageGear PDF shared library for Solaris
Solaris/libACE.so - PDF shared library for Solaris
Solaris/libAGM.so - PDF shared library for Solaris
Solaris/libBIB.so - PDF shared library for Solaris
Solaris/libBIBUtils.so - PDF shared library for Solaris
Solaris/libCoolType.so - PDF shared library for Solaris
Solaris/libJP2K.so - PDF shared library for Solaris
Solaris/libnserver.so - PDF shared library for Solaris
Solaris/libOPP.so - PDF shared library for Solaris
Solaris/libpdfl.so - PDF shared library for Solaris

The following is a list of those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/Documentation/:
Help/IG_UNIX.pdf - electronic documentation (manual) for ImageGear
Help/LDK_Unix.pdf - electronic documentation (manual) for ImageGear licensing and deployment
Help/LDK_Java.pdf - electronic documentation (manual) for ImageGear licensing and deployment for Java
Help/AccuLicManager_UNIX_MAC.pdf - electronic documentation (manual) for AccuSoft License Manager

Releasenotes - product release notes

The following is a list of so -> libIGCORE15.so.15 - ImageGear Core shared library for AIX

AIX/libIGLZW15.s those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/Unix/Include/:
accuimg.h include files (header files)
accuosd.h "
accustd.h "
accuvers.h "
accucnst.h "
accufunc.h "
commapi.h "
cpmapi.h "
datadict.h " ( MED component )
dcm.h " ( MED component )
dspl.h "
fltr.h "
gear.h "
gearerrs.h "
gearestr.h "
geartags.h "
i_CORE.h "
i_ART.h " ( ART component )
i_LZW.h " ( LZW component )
i_MED.h " ( MED component )
i_PDF.h " ( PDF component )
metadata.h "
mpage.h "

The following table is a list of those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/Unix/Samples/filters/. They are all the source files related to the sample applications that come with ImageGear:
dlg_dspl.c dlg_dspl.h
dlg_error.c dlg_error.h
dlg_extensions.c dlg_extensions.h
dlg_formatlist.c dlg_formatlist.h
dlg_ip.c dlg_ip.h
dlg_jpeg.c dlg_jpeg.h
dlg_open.c dlg_open.h
dlg_pdf.c dlg_pdf.h
dlg_saveas.c dlg_saveas.h
dlg_tiff.c dlg_tiff.h
filters.c filters.h
Imakefile

The following table is a list of those files that are installed in $HOME/AccuSoft/ImageGear15/Pro/Utils/. They are all the source files related to the sample applications that come with ImageGear:
<platform>/EnvParamsUtility - environment parameters utility for <platform>
AccuSoftLicenseManager.jar - AccuSoft License Manager
lib - Java libraries used by ALM
<platform>/libLicHardwareNatJNI.so.15 - native AccuSoft License Manager library for <platform>

The following table is a list of IGJava files installed in $HOME/AccuSoft/ImageGear15/Pro/Java/:
Bin/igjava.jar - IGJava Class Library
Bin/igbean.jar - IGJava Bean Library
Documentation/LDK_Java.pdf - Licensing help
Documentation/Bean/manual.htm - IGJava Bean help
Documentation/CL/manualL.htm - IGJava Class Library help
Samples/accusoft - IGJava samples' sources
Samples/buildSamples - Executable script to build all IGJava samples
Samples/runBeanDemo - Executable script to run BeanDemo
Samples/runCLDemo - Executable script to run CLDemo
Samples/runThumbnailDemo - Executable script to run ThumbnailDemo
 

NOTE: Java SDK is required to be installed in order for IGJava scripts to run. Java SDK can be downloaded from http://www.sun.com.

Uninstalling ImageGear

To uninstall the ImageGear library, simply delete all the ImageGear files. You may issue the following command if the files were installed in the default directory.:
rm -rf AccuSoft

If the automated install script was used, or if you manually added the IMAGE_GEAR environment variables to your shell profile, you can remove them now.