INTRODUCING ADOBE ACROBAT READER 2.1 ==================================== Welcome to Adobe Acrobat(R) Reader software--Version 2.1 for UNIX(R). This guide tells you how to install Acrobat Reader on your Sun(R), HP, Silicon Graphics(R), or IBM RISC System/6000(R) workstation. Acrobat Reader is part of the Adobe Acrobat family of software, which lets you view, distribute, print, and save documents in Portable Document Format (PDF)--regardless of the computer, operating system, fonts, or application used to create the original file. PDF files retain all the formatting, fonts, and graphics of the original document, and virtually any PostScript(TM) document can be converted into a PDF file. PDF files can be created using the Acrobat Distiller(TM) program; on Macintosh(R) and Windows(R) systems, they can also be created using the Acrobat PDF Writer printer driver. On all platforms, you can use Acrobat Exchange to enhance PDF files with links and bookmarks. To install Acrobat Reader on your workstation, you must be familiar with basic UNIX commands. If you are not, please consult with your system administrator before beginning this installation. About this guide ---------------- Before you begin using Acrobat Reader, be sure to read this guide for installation instructions and other important information. This guide contains the following information: * Instructions for installing the Acrobat Reader software * System administration information, such as how to move or remove the files * Troubleshooting information About the Acrobat Reader software package ----------------------------------------- The Acrobat Reader software package includes the Acrobat Reader program file, associated files, and the following documents in online form: * "Acrobat Reader Online Guide" (Help-Reader.pdf), which explains how to use and customize the Acrobat Reader software * This document (instguid.txt), which explains how to install the Acrobat Reader files * "Mapping file types" (MapTypes.pdf), which explains how Acrobat Reader uses MIME types to follow cross-document links * "Adobe Acrobat Weblink Plugin" (Help-WWW.pdf), which explains how to set up Acrobat Reader to follow Uniform Resource Locator (URL) links to PDF documents on the World Wide Web System requirements and limitations ----------------------------------- To use Acrobat Reader software, you need the following minimum hardware and software: If you're using a Sun SPARCstation(R): * SunOS(TM) 4.1.3 or 4.1.4, or Solaris(R) 2.3 or 2.4 operating system software (Acrobat Reader will not run under Solaris 2.0, 2.1, or 2.2.) * OpenWindows(TM) (version 3.0 or later), Motif(TM) window manager (1.2.3 or later), or OpenLook version 3.0 * 8 megabytes of available hard disk space * 32 megabytes of RAM If you're using an HP workstation: * 9000 series workstation * HP-UX(TM) 9.0.3 or later operating system software * X Window System(TM) X11R5 running HP-VUE * 8 megabytes of available hard disk space * 32 megabytes of RAM If you're using a Silicon Graphics workstation: * IRIX(TM) 5.3 or 6.2 operating system software * 10 megabytes of available hard disk space * 32 megabytes of RAM If you're using an IBM RS/6000 workstation: * AIX(R) 4.1 or later operating system * Common Desktop Environment (CDE) or Motif window manager * 8 megabytes of available hard disk space * 32 megabytes of RAM Upgrading from Acrobat 1.0 -------------------------- The Acrobat Reader installation script installs the Reader files into a new directory. If you have an earlier version of the Reader software, it is not removed automatically. For more information on removing the files, see "Removing Acrobat Reader Software." If you use the IRIX Software Manager to install Acrobat Reader 2.1, the Software Manager automatically deletes any previous version of Reader that was also installed using the Software Manager. For more information on removing previous versions of Acrobat Reader for SGI, see the Read Me file. PREPARING FOR INSTALLATION ========================== Before beginning the installation, decide where to install the Acrobat Reader files. The following sections describe the installation options. Review these sections carefully before installing the software. Important: On SGI workstations, the Software Manager installs Acrobat Reader in a default location on a local filesystem. You cannot specify a different installation directory or perform a network installation. Local versus network installation --------------------------------- Determine whether a local (stand-alone workstation) or network installation is more appropriate for your situation. For local installation: A local installation guarantees access to the software from a workstation and may significantly improve performance, depending on how much activity there is on the network. To install Reader on your workstation, you must have the root password for the workstation. For network installation: A network installation makes administrative and maintenance tasks easier, particularly when many users want to access the software concurrently. (The number of concurrent users on different workstations is determined by how many licenses have been purchased and installed.) It is easier to upgrade a single copy of software installed on a server than to upgrade multiple copies installed on stand-alone workstations. Note: Network installation should be performed by a system or network administrator. If you perform a network installation, you will need to find appropriate network locations for the installation directory. The software should be installed on a network server machine with high reliability. In addition, the installation files should be placed in a location that is remotely mounted at the same location on all machines. Choosing an installation directory ---------------------------------- Locate a directory and verify that you have at least 8 megabytes of available disk space. The default location for installation of the Acrobat Reader software is the following directory: * For SunOS and HP: /usr/AcroRead * For Solaris 2: /opt/AcroRead * For IRIX: /usr/adobe/AcroRead_2.1 * For AIX: /usr/AcroRead If there is insufficient space in this partition, choose another directory within a different partition. Use the df command to determine the available space within a file system partition containing a particular directory. Type df (or df -k) followed by the name of the directory in which you want to install the software. For example, on Solaris type the following command: # df /usr Filesystem kbytes used avail capacity Mounted on /dev/sd0g 207295 98377 88189 53% /usr There are 207,295 kilobytes (about 207 megabytes) in this partition and about 88 megabytes available, which is enough disk space to install the Acrobat Reader software. See your system documentation for more information on the df command. INSTALLING THE ACROBAT READER SOFTWARE ====================================== Acrobat Reader software is distributed on CD-ROM or from the Adobe Web site. This section contains instructions for installing the software after you have downloaded the Acrobat Reader files or mounted the Acrobat Reader CD-ROM. If you have downloaded the Acrobat Reader files from the Adobe Web site, you must first uncompress and untar the files before beginning the installation. Instructions for downloading and uncompressing the files are available on the Adobe Web site. Installing Acrobat Reader on SGI workstations --------------------------------------------- You use the IRIX Software Manager to to install Acrobat Reader on SGI workstations. When you install Acrobat Reader, the Software Manager deletes previous versions of the Reader. To install Acrobat Reader on an SGI workstation: 1. Choose System > Software Manager. 2. Type the root password. 3. In the Available Software text box, type the pathname of the directory that contains the Acrobat Reader software files. 4. Select both the Upgrade Products and the New Products options. 5. Click Start to begin the installation. When the installation is completed, a message appears indicating that you have installed the software successfully. 6. Click OK to exit Software Manager. Installing Acrobat Reader on Sun, HP, or RS/6000 workstations ------------------------------------------------------------- You use an installation script to install Acrobat Reader on Sun, HP, or RS/6000 workstations. The installation script prompts you to answer questions regarding the installation, such as where you want to place the Reader files. Reasonable default values are provided. Press Return to select the recommended defaults, or enter your own values. To run the installation script: 1. Change to the directory containing the installation script. If you are installing Acrobat Reader from a CD-ROM, change to the acroread directory on the CD-ROM. 2. Start the installation script. The filename of the script may be uppercase or lowercase depending on your system; for example: # ./install.bsh 3. Follow the instructions that appear on your screen. If you make a mistake, you can do either of the following: * Exit at different points in the procedure. * Press the interrupt key sequence (Control+C on most UNIX systems) to cancel the installation. When the installation is complete, a message appears indicating that you have installed the software successfully. Acrobat Reader is now installed. Integrating icons into the OpenWindows desktop ---------------------------------------------- Acrobat Reader provides a script that integrates Acrobat Reader icons into your OpenWindows desktop. You can run this script as root or from your login account. If you are logged in as root, the icons are installed for all users. If you run the script as a normal user, the icons are installed for your use only. To integrate icons into the desktop: 1 In a UNIX shell window, as root, locate the acroread.deskinstall script: # cd /desktop/olwm 2 Run the script: # ./acroread.deskinstall 3 Exit from OpenWindows, and log back on for the changes to take effect. Creating links to the launch script ----------------------------------- You should always start Acrobat Reader using its launch script. To make it easier to use the script, you can create links to the launch script directory. The following example creates a link from the /usr/bin directory: # ln -s /opt/AcroRead/bin/acroread /usr/bin/acroread On SGI workstations, the Software Manager automatically creates the link. Acrobat Reader-installed files ------------------------------ The installation script installs the following files and directories in the installation directory: * The bin directory contains the acroread launch script. * The desktop directory contains files for desktop integration (Sun only). * The fonts directory contains bundled fonts. * The Help directory contains the complete product documentation (including the "Acrobat Reader Online Guide"), the Electronic End User License Agreement, and the Read Me file. * The res directory contains pixmap and bitmap resources. STARTING ACROBAT READER =========================== Now that you have completed the installation procedure, you are ready to start the Acrobat Reader application. Always start the Reader application by using its launch script. If you created symbolic links, and the alternative launch script directory is in the search path set by the PATH environment variable, you can start Acrobat Reader by typing the following: % acroread If you did not create symbolic links to the launch scripts, type the following command to start Acrobat Reader: % /bin/acroread To launch Acrobat Reader so that it appears as an icon on your desktop, type the following command: % acroread -iconic To view one or more files, give the filenames as command-line parameters. For example, to view /share/docs/annual_report.pdf and /user/bob/Schedule.pdf, type: % acroread /share/docs/annual_report.pdf /user/bob/Schedule.pdf By default, only one Reader process can be running. If you type acroread when Reader is already running, the currently running version of Reader becomes active and displays the specified file. If you prefer that a new version of Reader be launched each time you start Reader, type the following command: % acroread +useFrontEndProgram For more information on Acrobat Reader command-line options, type one of the following commands: % acroread -help % acroread -helpall Converting PDF to PostScript ---------------------------- You can convert PDF files to level 1 or level 2 PostScript files from the command line if you are running the X Window System. Command-line printing supports only the standard page size of 8.5 by 11 inches; it does not support shrink-to-fit or scaling commands. If your document contains custom page sizes (such as 11 by 14 inches), open the file in Acrobat Reader and then print it. To convert a PDF file by piping it into Reader and then sending the output to a file, type the following: % cat sample.pdf | acroread -toPostScript > sample.ps To convert one or more PDF files, such as sample1.pdf and sample2.pdf, into PostScript files and place these PostScript files into the directory , type the following: % acroread -toPostScript sample1.pdf sample2.pdf To convert a series of files expressed as both a PDF filename and a corresponding PostScript filename (or pairs), type the following: % acroread -toPostScript -pairs pdf_file_1 ps_file_1 ... To convert a PDF file to a level 2 PostScript file, type the following: % acroread -toPostScript -level2 pdf_file_1 REMOVING ACROBAT READER SOFTWARE ================================ You can remove the Acrobat Reader software by manually deleting the files and directories that were created during the installation procedure. Important: If you used the IRIX Software Manager to install Acrobat Reader on an SGI workstation, use the Manage Installed Software command to remove Acrobat Reader. Otherwise, use the procedure in this section. If you also have installed other Adobe products (such as Adobe Photoshop(R)) on your system, see the Read Me file for important information about removing Acrobat Reader. To remove Acrobat Reader: 1. As the superuser (root account), enter the following commands to remove Reader from the installation directory: # cd # rm -rf 2. To remove the symbolic link to the launch script, delete the file /usr/bin/acroread: # cd /usr/bin # rm acroread TROUBLESHOOTING =============== This section describes Acrobat Reader error messages and provides general troubleshooting information. Command to launch Acrobat Reader not found ------------------------------------------ Error message: acroread -command not found Cause: Either the Acrobat Reader launch script is not on your search path or the launch script you are trying to execute is actually a symbolic link to a file that does not exist. Solution: First, make sure your search path has been updated by typing the following command: % rehash If the launch script still does not work, locate the file that executes Acrobat Reader: % ls -l acroread If the results indicate that acroread is actually a symbolic link to another file (), type the following: % ls -l Continue this process until you have a real file (not a symbolic link) or until you receive the message Ò not found.Ó If you receive this message and Reader was not installed locally, then the network volume holding the Reader installation may be temporarily down or may have been moved to a new location, or the Reader distribution may have been moved or deleted so that the symbolic links are pointing to an invalid location. To resolve this problem: Reinstall the software, carefully following the instructions in this guide. Permission denied to launch Acrobat Reader ------------------------------------------ Error message: acroread: Permission denied Cause: One or more files have their permissions set incorrectly. Solution: Examine the permissions on the Reader launch script to make sure you have proper execute privileges for /bin/acroread. 1996 Adobe Systems Incorporated. All rights reserved. Adobe Acrobat Reader 2.1 Installation Guide for UNIX This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in this manual. Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Adobe, the Adobe logo, Acrobat, the Acrobat logo, Distiller, Adobe Illustrator, and PostScript are trademarks of Adobe Systems Incorporated. Macintosh is a registered trademark of Apple Computer, Inc. HP is a registered trademark and HP-UX is a trademark of Hewlett-Packard Company. Motif is a trademark of Open Software Foundation, Inc. Solaris is a registered trademark of Sun Microsystems, Inc., which has not tested or approved this product. Sun and OpenWindows are trademarks of Sun Microsystems, Inc. SPARC is a registered trademark of SPARC International, Inc. SPARCstation is a registered trademark of SPARC International, Inc., licensed exclusively to Sun Microsystems, Inc. and is based upon an architecture developed by Sun Microsystems, Inc. IRIX is a registered trademark of Silicon Graphics, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. AIX and IBM are registered trademarks, and RS/6000 is a trademark of International Business Machines Corporation. Windows is a trademark of Microsoft Corporation. X Window System is a trademark of the Massachusetts Institute of Technology. All other products or name brands are trademarks of their respective holders. Contains an implementation of the LZW algorithm licensed under U.S. Patent 4,558,302. Written and designed at Adobe Systems Incorporated, 1585 Charleston Road, Mountain View, CA 94039-7900, USA Adobe Systems Europe Limited, Adobe House, Edinburgh EH11 4DU, Scotland, United Kingdom Adobe Systems Co., Ltd., Yebisu Garden Place Tower, 4-20-3 Ebisu, Shibuya-ku, Tokyo 150, Japan For defense agencies: Restricted Rights Legend. Use, reproduction, or disclosure is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013. For civilian agencies: Restricted Rights Legend. Use, reproduction, or disclosure is subject to restrictions set forth in subparagraphs (a) through (d) of the commercial Computer Software Restricted Rights clause at 52.227-19 and the limitations set forth in AdobeÕs standard commercial agreement for this software. Unpublished rights reserved under the copyright laws of the United States. Printed in the USA. (1/96)