UNIX Installation


The information provided here applies to EasyCopy Version 7.3 for AIX 4.3+, Compaq Tru64 (Digital UNIX OSF/1) 4.0+, HP-UX 10.2+, IRIX 6.5+, Linux (Intel i386 or Intel IA64), and Solaris (SPARCstation) 2.6+.

Refer to the topic Windows Installation for information about installation of the Windows version of EasyCopy.

Upgrading from a Previous Version

You can use the installation procedure described here if you upgrade from EasyCopy 6.0 or later.

If you upgrade from EasyCopy/X (EasyCopy older than 6.0.0) or FleXprint we suggest that you remove the previous version completely before you start the installation. This is because EasyCopy since version 6.0 introduced a major change in architecture. Previous directory structures and print queue interfaces cannot coexist with newer versions.

Prerequisites

The supported hardware and operating system platforms are:
AIX 4.3+
IBM RS/6000 workstations
 
Compaq Tru64 (Digital UNIX OSF/1) 4.0+
Compaq (Digital) Alpha AXP workstations
 
HP-UX 10.2+
HP 9000 workstations
 
IRIX 6.5+
Silicon Graphics (RISC) workstations
 
Linux
Intel i386 or Intel IA64 based workstations
 
Solaris 2.6+
Sun SPARCstation
 
For download of EasyCopy from
www.augrin.com you need access to the Internet.

For installation from CD-ROM you need a CD-ROM drive (locally available or mountable across a network). If you access the drive across a network, you must include its file system in the exports of the system to which the drive is attached.

The supported printer connections are:

X Server
The graphical user interfaces and the view programs require an X Window System (X11 release 4 or higher).
 
Adobe Acrobat Reader
You need Adobe Acrobat Reader in order to view or print this manual.

You get an extra advantage if you have Adobe Acrobat Reader installed on the same system as EasyCopy. You can then open the manual by pressing a button in EasyCopy's graphical user interface and thus utilize the manual as an online resource.

Adobe Acrobat Reader is distributed on CD-ROM together with EasyCopy, and you can choose to install it together with EasyCopy if it is not installed already on your system.

The same does not happen if you download EasyCopy from our Web site. If you want to install Adobe Acrobat Reader you can download it from www.adobe.com.

 
Web Browser
EasyCopy comes with extensive context-sensitive online help. This resource requires a web browser. The default installation is prepared for an interface to Netscape Navigator because this browser is widely distributed in the UNIX environment.

If you use another browser you can reconfigure this interface.

If a browser interface is not configured you will only get a brief, text based help system.

You can download Netscape Navigator from http://home.netscape.com.

Disk Space

Disk space requirements are approximately 100 MB for a standard installation.

In addition you need generous disk space for temporary files. Temporary disk space requirements for screen capture and print jobs depend on your display, printer, and selections. A minimum of 100 - 500 Mbytes (depending on your printers and applications) is recommended; refer to the guidelines below:

Screen Capture
A full screen capture in full color from a display of 1600x1200 pixels requires approximately 8 MB temporary disk space.
 
Print Jobs (Spooling)
Estimate the requirement by using this formula:

  Disk space requirement (in MB): W x R x H x R x C / 8,388,608

where
W=image width (in inches)
H=image height (in inches)
R=printer resolution (in dots per inch)
C=1 for black-and-white printers
3 for RGB or CMY printers
4 for CMYK printers
24 for dye sublimation printers

Examples:
Letter size 600 dpi color inkjet 8.5 x 600 x 11 x 600 x 4 / 8,388,608 = 16.1 MB
E-size 300 dpi color inkjet plotter 34 x 300 x 44 x 300 x 4 / 8,388,608 = 64.2 MB

Actual disk space requirement may differ from this estimate depending on expansions and reductions due to overhead, encoding, and compression.

 
Graphics Conversion
If you use EasyCGM or EasyCopy/Graphics to print vector graphics you need additional temporary space:

  Disk space requirement (in MB): W x R x H x R / 349,525

where W, H, and R have the same meaning as above.

Examples:
Letter size 600 dpi color inkjet 8.5 x 600 x 11 x 600 / 349,525 = 96.3 MB
E-size 300 dpi color inkjet plotter 34 x 300 x 44 x 300 / 349,525 = 385.2 MB

Before You Install

Before you
start the installation of EasyCopy you should consider these topics:
Primary Key
You will eventually need a unique Primary Key for your workstation (single node license) or the workstation you want to use as license server for EasyCopy, but you do not need this key before you install.

Your pre-installation task with respect to primary key is simple: Don't worry! You need the primary key when you order a password, and a password is all you need to change a demo version into a licensed version. You will not need to reinstall the software later when you get the password.

 
Confirm the printer support
Check how EasyCopy supports the printer(s) you want to use.

Verify that the printer is attached to your system by one of the connection methods supported by EasyCopy. Make a note of the path or address by which your system knows the printer.

 
Check the disk space
Estimate your need for temporary disk space based on your expected use of EasyCopy and the printer(s) you want to use. Use the information provided above to make this estimate.

Use the df command to verify that your system has enough disk space available at the location where you intend to install the software and sufficient temporary disk space in /usr/tmp.

 
Root access
You may need root access to complete the installation and to setup printers. You will normally be able to complete a single-node installation without root access, but if you want to make a network installation you will normally need root access.

Consult your system administrator if the need arises.

Use the su command to get root access:

$ su
Password:
  (type the root password)
#

Installation from CD-ROM

You have all available programs in the product suite for all supported platforms if you have EasyCopy on CD-ROM.

Before you can start the installation you must mount the CD-ROM file system by means of a system specific procedure. If you are familiar with any automatic or menu assisted procedure on your system, follow that procedure. On many systems the mount procedure starts automatically when you place the CD-ROM in the drive.

If no other procedure is at your disposal you can use the following basic procedure.
It requires root access.
Open a console or terminal window, and proceed as described here.

  1. Determine the system.s CD-ROM mount point. Common names are /cdrom, /disc, or /mnt/cdrom. Use the command ls / to detect, for instance, if /cdrom exists.
  2. Enter the mount command with no parameters to get a list of currently mounted devices. Use this list to deduce the name of any previously mounted CD-ROM file system.
  3. Detach the previously mounted file system (use the umount command).
    Do not use the umount command on a system with an automatic mount procedure. If another CD-ROM occupies the drive you can normally use the eject command to detach it.
  4. Load the CD-ROM into the CD-ROM drive
  5. Mount the CD-ROM using the appropriate mount command. The parameters to the mount command are system dependent.
    AIXmount -v cdrfs -r /dev/cd0 /cdrom
    HP-UX 10.x/etc/mount -rF cdfs -o cdcase /dev/dsk/c0t2d0 /cdrom
    IRIXmount -rt iso9660 /dev/scsi/sc0d?l0 /CDROM
    Linuxmount -rt iso9660 /dev/cdrom /mnt/cdrom
    Solaris 2mount -F hsfs -r /dev/dsk/c0t6d0s0 /cdrom
    Tru64mount -rt cdfs -o noversion /dev/rz?c /cdrom
    You must replace the ?-sign by a digit reflecting the SCSI id of your CD-ROM drive.
  6. Change directory to the mounted CD-ROM when it has been mounted
  7. You can now start the installation.
You can extract the primary key by means of the getkey script in the CD-ROM top directory. (You do not need the primary key at this stage, but the script is useful, for example if you want to order a password for another workstation than the one on which you may have made a trial installation).

Installation from the Web

You can download UNIX versions of EasyCopy as .gz compressed archives.

You need gunzip installed on your system in order to uncompress these files.

To see if you have gunzip installed type the command which gunzip in a terminal or console window. If you get a reply like "/usr/local/bin/gunzip" everything is fine. If you get a reply like "no gunzip in /usr/sbin /usr/local/bin /usr/bin ..." you need to install it.

If gunzip is not installed on your system you can download and install it from www.gzip.org.

When you download EasyCopy from www.augrin.com you can only download the software for one platform at a time.

If you want to make a common installation for multiple platforms you should download the installation files to the same directory, for example /usr/tmp.

Before you start the installation you must uncompress and extract the archive(s). The example shown here assumes that you have downloaded EasyCopy for Linux and Solaris to usr/tmp:

  $ cd /usr/tmp
  $ ls
  ec720fp_linux.tar.gz
  ec720fp_sun5.tar.gz
  $ gunzip ec720fp_*.tar.gz
  $ ls
  ec720fp_linux.tar
  ec720fp_sun5.tar
  $ tar xvf ec720fp_linux.tar
  $ tar xvf ec720fp_sun5.tar
  $

The archives are extracted to a common easycopy subdirectory (/usr/tmp/easycopy in this example.

Installation Procedure

Go to the directory where the installation files reside (the CD-ROM mount point or the temporary location where you have unpacked the files you have downloaded), and start the installation:

  $ ./install

Some systems require that you use capital letters for files on a CD-ROM file system:

  $ ./INSTALL

It is important that the install script is started on the command line from a terminal or console window. Do not click on the script's icon in a File Manager window, unless your system supports Common Desktop Environment.

In CDE the required terminal window is opened automatically when you click the icon, but on other systems you may enter an infinite loop if you start the script in a wrong context.

Root Access

The install script will first check if you have root access.

You can supply the root password to switch id to root or continue.

You may need root access to complete the installation and to setup printers. You will normally be able to complete a single-node installation without root access, but if you want to make a network installation you will normally need root access.

Accept License Conditions

Before you start installation you must read and accept the AGI Conditions of Use.

Install Menu

Next, the install script starts the Install menu.

In most cases you can just accept the default choice ([3]) which will install the EasyCopy products on your system.

Choose option [1] to change product component selection before you install. The full product suite (EasyCopy and EasyCGM) will be installed by default. You will need to change the selection if you want EasyCopy/Graphics in stead of EasyCGM.

Only choose option [2] if you will copy everything to another destination and install at a later time. This might for example be the case that you want to copy from the CD-ROM file system to a file server which has no access to a CD-ROM drive.

Select Platforms

By default your current platform is selected.

You may choose to install binaries for several platforms in one common directory on a network file server. This is much easier (also when it comes to maintenance) than installing EasyCopy separately on each workstation.

Available platforms are marked by one asterisk *. Two asterisks ** mark the selected platforms.

You select or unselect a platform by entering its number. Enter q when you have selected all desired platforms.

Installation Setup Menu

In this menu you select details of the installation.
Installation Main Directory
This is the path name of the main target directory for the installation. This directory is referred to in this documentation as the easycopy directory. The default is platform dependent:
AIX/usr/lpp/easycopy
Solaris/opt/easycopy
All other systems/usr/local/easycopy
These defaults are meaningful for a single-node installation.

When you install EasyCopy on a shared network drive there are no "meaningful defaults" in the sense that it all depends on how you normally organize shared network installations. Choose a path that fits your conventions. As an example has /mnt/prod/easycopy been used here.

When you change this directory you will see that the defaults for other paths in this menu are changed as well to keep the structure consistent.

 
Invocation Scripts Directory
The installation program creates invocation scripts ("commands") for the graphical user interface and the command line programs. These scripts prepare environment variables and call the corresponding binary programs.
CommandDescriptionProgramMan page
ecxGraphical User Interfaceecx.binecx(1)
ecviewImage Viewerecview.binecview(1)
eccaptScreen Captureeccapt.bineccapt(1)
ecconvImage Converterecconv.binecconv(1)
ecprintPrint Engineecprint.bin ecprint(1)
eclpdBSD output filtereclpd.bineclpd(1)
ectcpSocket output filterectcp.binectcp(1)
ecqadmPrint queue administrationecqadm.screcqadm(1)
eclpqPrint queue statuseclpq.bineclpq(1)
ecdaemonLicense dispatcherecdaemon.bin
eclicLicense displayeclic.bin
The default is /usr/bin. This is a good choice for a single-node installation, because /usr/bin is always on your path. For a network installation you should select a shared location which is already on the users' path, or can easily be appended. As an example has /mnt/prod/bin been used here.
 
System-wide Initialization File
The system-wide initialization file contains default options as defined by the System Administrator. The default file name is ecrc and it is by default placed in the easycopy directory.
 
System Directory
EasyCopy uses the system directory for printer description files, EasyColor profiles and other system related files. The default is a subdirectory called system in the easycopy directory.
 
Temporary Directory
The programs need to write temporary files. All users must have read and write permissions to this directory. The default proposal is /usr/tmp. The menu displays the free space currently available. Refer to the topic disk space for details about temporary dick space requirements.
 
Manual Pages Directory
The manual pages listed in the table above (ecx(1), etc.) are copied to the system's man directory usr/man/man1 or to the directory you specify. You may also decide not to install the pages.
 
XkeysymDB File
The keyboard definition is stored in a file, XKeysymDB. Normally, this file already exists; it is installed when you install X11R5 or X11R6. The file also existed in the X11R4 distribution, but it was not installed by default. You can choose to install or update XKeysymDB to the version distributed with EasyCopy. The default is not to install or update this file.
 
Install Documentation
EasyCopy documentation (manual in PDF format and online help in HTML format) will by default be installed in a subdirectory called docs in the easycopy directory. You can choose an alternate location, or you can choose not to install any documentation.
 
Default Paper Size
This option determines whether a US (Letter) or International (A4) paper size will apply as default when you later install printers.
 
Default Mail Server
If you want to send images as email attachments by means of the Send To dialog your workstation must connect to an SMTP mail server to deliver outgoing mail. The script proposes the local host (127.0.0.1) as default mail server. Specify host name (or IP-address) of the mail server that is normally used by mail clients in your system. The user may change this specification in the Preferences dialog. The Send To dialog fails if it cannot establish a connection to an SMTP server.

Password Maintenance

You can install your password from the
Install menu. You will probably not do this when you install the first time.

When you have pourchased a license and received the password you can install it by several methods:

If you have made a separate license server installtion you must install the password both on the license server and on the file or application server from which the users have access to EasyCopy. This is because you need to make the password available to the license dispatcher and to create a connection from EasyCopy to the license dispatcher. (This consideration is not necessary if the license server and the application server use a common file system).

License Server Installation

If the machine you want to use as
license server is the same as the application server on which you have installed the UNIX version of EasyCopy, or if the license server has permanent access to the shared network file system, you will not need a separate installation of the license server.

Just start the license dispatcher by means of this command

  # ecdaemon start

Root access required.

Only if your license server has no access to the file system you must perform a separate installation. You can do that by performing a standard EasyCopy installation as decribed above locally on the license server.

Environment Variables

EasyCopy uses the following environment variables. The invocation scripts set the required environment variables before a program is executed.
HOME
Used to get the user's "home" directory. Each user has private initialization files stored in the home directory.
This variable is normally already set in the user's login script.
PRINTER
Used by ecprint to get the printer name. Refer to the -printer option.
ECTOPDIR
Used to get the easycopy directory.
ECBINDIR
The location of binary programs. The invocation scripts set this variable.
ECDOCDIR
The location of the documentation (PDF manual). The HTML-based help files reside in a subdirectory.
ECPRTDIR
The location of the printers directory. You can use this variable to allocate printers among user groups.
ECWEB
Specifies the path to a Web browser used for online help. The installation procedure attempts to locate a Web browser and set the correct path in the ecx invocation script. EasyCopy only requires this variable if neither Netscape Navigator nor NCSA Mosaic can be found on the normal execution path.
ECPDF
Specifies the path to Adobe Acrobat Reader used for online access to the documentation. The ecx invocation script contains the correct path if the Acrobat Reader has been installed as part of the EasyCopy installation or an existing Acrobat Reader could be located by the installation procedure.
SYSDIR
Used to get the easycopy/system directory.
INIFILE
Used to get the system wide initialization file.
TMPDIR
Used to get the directory for temporary files.
DEFAULT_PAGESIZE
Specifies the preferred default page size (US Letter or International A4). The invocation script sets this variable based on the preference chosen during installation.
SCSI_DEST
The destination parameters for a SCSI printer in a Tru64 system. Refer to the topic SCSI Printers.
XENVIRONMENT
Used to get the application defaults file Ecx.
DISPLAY
Used to get the display.

Setting Environment Variables
Setting an environment variable depends on the type of shell you are running.
In Bourne shell and Korn shell, type:
  $ PRINTER=acme; export PRINTER  
  $ DISPLAY=ws1:0.0; export DISPLAY  

In C shell, type:
  $ setenv PRINTER acme  
  $ setenv DISPLAY ws1:0.0  

Copyright © 2004, AGI (autoGraph international), www.augrin.com.