ArcPress Version 2.0 for ArcView®GIS Version 3.1 Installation Instructions


Contents

ArcView GIS Version 3.1
System requirements for ArcView GIS Version 3.1 and ArcPress Version 2.0
Installing ArcPress Version 2.0 for ArcView GIS Version 3.1
Setting up your account
ArcView license manager
Installing the license file
To start ArcPress for ArcView
To start ArcPress On-line Help
Known issues and limitations
Questions and feedback
Sources for additional information


ArcView GIS Version 3.1

All new extensions released after the release of ArcView 3.0a will require ArcView GIS Version 3.1 for UNIX® due to minor changes that were made to the ArcView 3.0a executable. ArcView 3.1 must be installed and working properly on your computer before installing the ArcPressTM extension. If you do not have ArcView GIS 3.1, existing ArcView GIS 3.0 or 3.0a users can download the ArcView 3.1 patch from the Environmental Systems Research Institute, Inc. (ESRI), Web page at  www.esri.com. Media for the software can also be obtained by calling ESRI Customer Service at 909-793-2853, extension 1670.

To determine which version of ArcView you are currently using, click on the About ArcView option under the Help menu.



System requirements for ArcView GIS Version 3.1 and ArcPress Version 2.0

The following chart provides information about the system requirements for installing and using ArcView and ArcPress for ArcView on UNIX workstations.
 
 
Platform Operating System Window Manager Minimum Memory* Swap Space*
DigitalTM UNIX Digital UNIX v4.0 CDE or Motif® 64 MB 75 MB
HP® 9000/700 HP-UX® 10.20 (700 series, 8x7 series) CDE or HP VUE® 32 MB 100 MB
IBM® RS/6000TM  AIX® 4.1.4 (RTE-supplied by ESRI) CDE or AIX Windows® Rev.4.1.4.0  32 MB 64 MB
SGI® IRIXTM 6.2, with patches SG0001717, SG0002086, SG0002161, SG0002044, and 6.2_POSIX set.** 6.2 (based on OSF/Motif 1.2.4) 64 MB 100 MB
SUNTM Solaris® 2.x Solaris 2.5 (SunOSTM 5.5) CDE 32 MB 100 MB

*  The Swap Space and the Minimum Memory are based on a single user.
** These patch can be obtained from SGI's Web site www.sgi.com or FTP sire ftp.sgi.com.

top


Installing ArcPress Version 2.0 for ArcView GIS Version 3.1

1. Insert the ArcPress Version 2.0 for ArcView GIS Version 3.1 CD in your CD-ROM drive.

2.  Then become root user (excluding Solaris® 2.x, and IRIXTM 6.x).

% su

You will be prompted for your root user password. If you do not know this password, contact your system administrator.

3. If a cdrom directory does not exist, you can create one using the following:

# mkdir /cdrom

4. To mount the ArcPress CD, use one of the following based on your installation platform (where <dev> stands for the CD-ROM device):

Digital UNIX               mount -t cdfs -r -o nodefperm,noversion /<dev> /cdrom
HP 9000/700              mount -F cdfs -ocdcase /<dev> /cdrom (or use sam)
IBM RS/6000              mount -v 'cdrfs' -p'' -r'' /<dev> /cdrom (or use smit)
SGI                            IRIX 6.x automatically mounts the CD as /CDROM
Solaris 2.x                  includes the Volume ManagementTM software that automatically
                                   mounts the CD, providing immediate access to your CD-ROM.

5. At this point, the ArcPress CD is mounted.  Before installing ArcPress for ArcView from the CD, exit root user mode:

# exit

6. The "install" command has four options from which to select:
Usage: install <-help | -load | -remove | -verify>.

Type "install -help" to read more about the installation procedure.

7. To start the ArcPress CD installation for your platform, go to your $AVHOME location and create a new directory called "arcpress", then move up a directory level -

% setenv AVHOME /<arcview3_install_directory>/arcview3
% cd $AVHOME
% mkdir arcpress
% cd ..

Note: You will need to have write permission to your $AVHOME directory.

8. Type one of the following based on your installation platform:

Digital UNIX            /cdrom/osf/install -load
HP 9000/700          /cdrom/hpux/install -load
IBM RS/6000          /cdrom/ibm/install -load
SGI                         /CDROM/sgi/install -load
Solaris 2.x                /cdrom/cdrom0/solaris2/install -load

This starts the dialog for the menu-driven installation procedure. Default selections are noted in brackets [ ].  Do not accept the default CD-ROM mount point when installing ArcPress. The CD-ROM mount point should read as follows:

/cdrom/<platform>
/cdrom/cdrom0/solaris (Solaris 2.x only)

The path name you specify as the ArcPress installation directory should be the same as the path for your arcview3 directory and cannot contain any uppercase letters.

To obtain a list of options or online help, type "?" at any prompt. You can quit the installation procedure at any time by typing quit or "q". To return to a previous question, type a caret, "^".
 
 

Optional installation component

The install procedure will give you an option to install the sample print files. The sample print files installation option provides an ArcView Color Test Chart rasterized for each ArcPress supported printer. This installation option requires approximately 28 MB disk space. For more information about these print files, see the ArcPress help topic "Configuring your printer for a workstation /Testing your setup."

Sample raster files  (all prints are size 8.5" x 11")

If you don't know which file to send to your printer, check the ArcPress-supported printers list in the on-line help.

 top


Setting up your account

1. Setting a directory for temporary file space (APRESSTMPDIR)

Temporary space is the location on the disk where scratch files are created while the rasterization process is running. These files are removed when the rasterization process is completed. As a general rule, you will need a location that contains at least four times the size of the input file being processed. Once you have checked to see if you have adequate temporary file space available, you can specify the location for temporary files in oyur .cshrc file.

If you do not include an APRESSTMPDIR, temporary files will be written to your /tmp directory.

setenv APRESSTMPDIR /<path_to_temp_space>/

where <path_to_temp_space> is the full UNIX pathname to the directory containing the available space. This line must end with the slash (/) character.

2. Setting environment variables in your .cshrc.

setenv APPRINT $AVHOME/arcpress/etc 
set path=( $path $AVHOME/arcpress/bin )

You can also set up aliases to use ArcPress on the command line or to start the ArcPress GUI outside of ArcView. To start the ArcPress extension outside of ArcView you will need to set an LM_LICENSE_FILE variable.

alias [your_alias_for_command_line] \$AVHOME/arcpress/bin/arcpress
alias [your_alias_for_GUI] \$AVHOME/arcpress/bin/avpress
setenv LM_LICENSE_FILE $AVHOME/sysgen/license.dat

For example, you can use "arcpress" for your $ARCHOME/arcpress/bin/arcpress alias and "avpress" for your $AVHOME/arcpress/bin/avpress alias. We suggest that if you already have ArcPress Version 1.0 or ArcPress for ARC/INFO® 7.1.1 that you NOT set your ArcPress Version 2.0 command line alias to "arcpress".

3. Setting the HOME variable.

The HOME environment variable ($HOME) must be set to a writable directory in your .cshrc file. When you start ArcView, a warning message will appear if the HOME environment variable is not set.

4. Setting the LIBRARY PATH variable.

All UNIX platforms need to set the LIBRARY PATH to include the ArcView lib directory:

Digital UNIX (OSF)
setenv LD_LIBRARY_PATH $AVHOME/lib:/usr/lib

HP 9000/700
setenv SHLIB_PATH $AVHOME/lib

IBM RS/6000
setenv LIBPATH $AVHOME/lib:/usr/lib:/lib

SGI
setenv LD_LIBRARY_PATH $AVHOME/lib:/usr/lib

Solaris2*
setenv LD_LIBRARY_PATH $AVHOME:/usr/openwin/lib:/usr/ucblib:/usr/dt/lib

* Note  ArcPress Version 2.0 for ArcView on the Solaris2 platform is only supported in the CDE environment. Please ensure that CDE is installed on your Solaris2 workstation before using ArcPress.
 

5. Then, at the UNIX prompt,

% source .cshrc

6. UNIX platforms require you to set xhost +  to bring up the ArcPress GUI.

% xhost +

Note You cannot start ArcView and ArcPress for ArcView until the license manager is running.

top


ArcView license manager

The user account that will start the license manager must have the AVHOME variable set.
% setenv AVHOME /<arcview3_install_directory>/arcview3

For more information about setting up the license manager, please refer to the ArcView GIS Version 3.1 Installation Guide for UNIX (av30binstall.html) located in your $AVHOME/avdocs directory or the ArcView GIS Version 3.1 CD . For a detailed discussion of the license manager, refer to the License Manager's Guide included in your ArcView 3.1 package.

The license manager software is distributed with ArcView. The files are located under the $AVHOME/sysgen directory.

There are five options to the 'lmutil' executable - The "adminlicense" utility replaces the "editlicense" utility which was shipped with the previous versions of ArcView. There are three options to the "adminlicense" executable - The license manager daemon manages the ArcView daemon that reads the license information file. The license information file is specific to each site. The sample file provided looks like this:

SERVER   siddhartha    5500439b   1700
DAEMON   ESRI   $AVHOME/sysgen/ESRI
FEATURE  ArcView3    ESRI 1.000   1-jan-00   200    B2EF061B26BCDC05F17D ""
FEATURE  AVArcPress1 ESRI 1.000   1-jan-00   200    ABCE90A16C1C3310DCFD ""

The first line identifies the name and FLEXlm hostid of the workstation (in this case, siddhartha) on your network that will be the server for the license manager (the node from which the license manager daemons will run).

The second line identifies the license daemon for ArcView and its location. The following lines specify the product or features that are to be licensed (e.g., ArcView GIS Version 3.x and ArcPress for ArcView) the name of the daemon that manages the licenses (ESRI), application daemon version (1.000), the time-out date for the product (1-jan-00), the number of users (200), and a keycode for the product. Each line is called a FEATURE line.

Note: Even though you're installing ArcPress Version 2.0 for ArcView GIS Version 3.1, the application daemon version in line 3 will still read 1.000.

To obtain the license file for your site

To obtain the license file/feature line, you will need to provide the hostname and FLEXlm hostid of each workstation or server that will be running the license manager to ESRI or your distributor.

1. The hostname is obtained with the command:

% hostname

2. The FLEXlm hostid is obtained with the command:

% $AVHOME/sysgen/lmutil lmhostid

In the United States

1. Complete the keycode request form included in your installation package. Appendix B of the License Manager's Guide also contains a keycode request form and two examples. Keycode Support will also send, upon request, a keycode request form by E-mail.

2.  Mail, fax, or E-mail the completed form to Customer Service.

Fax number: 909-335-1716
E-mail address: keycodes@esri.com.

Outside the United States

Contact your local Environmental Systems Research Institute, Inc. (ESRI) software distributor for keycode information. ESRI in Redlands cannot respond to requests for keycodes received directly from international users.

top


Installing the license file

Once you have received the license file for your site, append it to your $AVHOME/sysgen/license.dat. You must enter the file exactly as it appears; the license file is case sensitive. Use the ADMINLICENSE command to check and verify your license file for errors. ADMINLICENSE must be run from within your window manager. Keep a copy of the license file you received from ESRI for future reference.

% cd $AVHOME/sysgen
% . /adminlicense

Once you have updated the license.dat file with the new feature line, update the daemons.

% $AVHOME/sysgen/lmutil lmreread -c $AVHOME/sysgen/license.dat

top


To start ArcPress for ArcView

Once ArcPress is installed on your system, it can be invoked during an ArcView session or as a separate utility outside ArcView.

To use ArcPress in ArcView:

1. Open the Extensions Manager and load ArcPress for ArcView Version 2.0.

When the extension is loaded, an ArcPress menu choice is added to the view and layout File menus and an ArcPress button is added to the view and layout button bars.

 2. Create a view or layout document, add data, graphics, etc.

 3. Click the ArcPress icon or select ArcPress from the File menu. An Enhanced PostScript file is written to your temporary directory and loaded into ArcPress.

 4. Use your right mouse button to select either a different Printer (for direct printing or print-to-file) or a Bitmap format (for bitmap export). ArcPress will automatically name your output file with an extension that correlates with the driver you choose. For example, if you choose to export to a PCX file, the filename will be your_input_filename.pcx.

When printing, ArcPress will automatically select the correct Queue which correlates with your printer. This is set in the $AVHOME/arcpress/etc/arcpress.dev file. See the "Before you start ArcPress" section under "Using ArcPress for raster printing and exporting" in the ArcPress on-line help for more details.

When exporting, ArcPress will automatically gray out the Printer and Queue fields.

You may also select other Page Layout, Image and Color options by clicking the Layout , Image, and Color buttons.

 

To start ArcPress when ArcView is not running:

To start the ArcPress GUI from the UNIX prompt, simply type the following:

 % avpress your_postscript_input_file

 To start ArcPress at the command line (useful for batch processing), simply type the following:

 % arcpress

This will display the usage. For more information about using ArcPress at the command line, see "Using ArcPress at the command prompt" under "Using ArcPress for raster printing and exporting" in the on-line help.

top


To start ArcPress On-line Help

ArcPress for ArcView comes with a separate on-line help system to help you learn the software.
To start the help, use the following command:

% setenv HHHOME $AVHOME/hyperhelp
% $AVHOME/hyperhelp/bin/hyperhelp -f $AVHOME/arcpress/help/avpress.hlp

You can set an alias for this command in your .cshrc file:

alias apresshelp \$AVHOME/hyperhelp/bin/hyperhelp -f $AVHOME/arcpress/help/avpress.hlp

top


Known issues and limitations

top

Questions and feedback

The ArcPress on-line help provides FAQ and troubleshooting topics for the ArcPress product. After completing the installation, search the ArcPress help index for 'frequently asked questions'.

ArcView's on-line Help provides detailed information on how to contact ESRI Technical Support with any of your questions or comments. You can access this information by looking at the section "Obtaining technical support" from ArcView on-line help under the  "Need more help" booklet that can be found on the Contents page.

All questions and comments should be forwarded to ESRI Technical Support -

If you are outside the U.S., please contact your local ESRI office or distributor.

top


Sources for additional information

In your use of ArcPress for ArcView, you may find the need for additional information about using the software. Answers to the most frequently asked questions and up-to-date tips can be found in one or more of the resources described below.

Subscribe to ESRI's World Wide Web-based discussion forum list ARCVIEW-L.

ARCVIEW-L provides a medium for users to exchange technical information and expert advice relating to ArcView and AvenueTM. To subscribe send a message to arcview-l-request@esri.com with a subject line of "subscribe". This forum is not an official technical support channel.

Visit the ESRI home page on the Internet

ESRI maintains a wide array of news and information on the World Wide Web. To access this information use the following address: www.esri.com. Our Web site also offers a discussion forum where you can exchange information on ArcView and Avenue with other users via threaded messages (messages about the same topic).

Our site also offers an Internet Relay Chat (IRC) server. Our chat server will allow you to network with other ArcView users and participate in scheduled "on-line conferences", all in real time. The chat server is available at www.esri.com/chat.

Access ESRI's Fax On-Demand server

ESRI maintains a Fax On-Demand server containing up-to-date technical tips, workarounds, and answers to your most frequently asked questions. These are the same documents available via the Web. You may access this database by calling our automated Fax On-Demand service at 909-307-3111 from a touch-tone phone, and then follow the voice-prompted instructions to obtain an index or up to three documents per call. This service is available within the United States and Canada only. Be sure to take advantage of these information services.

top