Introducing Adobe Acrobat Reader 2.1 ------------------------------------ Welcome to Adobe(TM) Acrobat(TM) Reader software-Version 2.1 for UNIX (R). This guide tells you how to install Acrobat Reader on your 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 PDF. On UNIX systems, PDF files can be created using the Acrobat Distiller(TM) program; on Macintosh(R) and Windows(TM) systems, they can be created using Acrobat Exchange and Acrobat Distiller or the Acrobat PDF Writer printer driver. In addition, some applications, such as Adobe Illustrator 5.5, can save documents directly as PDF files. 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 a CD-ROM containing the Acrobat Reader program file and associated files, and the following documents in online form: - Acrobat Reader Online Guide explains how to use and customize the Acrobat Reader software. - Adobe Acrobat Reader Installation and Getting Started Guide is this manual. It describes how to install the Acrobat Reader files. System Requirements and Limitations ----------------------------------- To use Acrobat Reader software, you need the following minimum hardware and software: If you're using a Sun SPARCstation workstation - Solaris 1.1, 2.3, or 2.4 operating system software (Acrobat Reader will not run under Solaris 2.0, 2.1, or 2.2.) - OpenWindows (version 3.0 or later), Motif window manager (1.2.3 or later), or OpenLook version 3.0 - CD-ROM drive - 8 megabytes of available hard disk space - 8 megabytes of RAM If you're using an HP workstation - 9000 series workstation - HP-UX 9.0.3 or later operating system software - X Window System X11R5 running HP-VUE - CD-ROM drive - 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." 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. 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 and access to a CD-ROM drive. For network installation: A network installation makes administrative and maintenance tasks easier, particularly when many users want to access the software concurrently. 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 /usr/AcroRead directory for SunOS and HP, and the /opt/AcroRead directory for Solaris 2. 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 followed by the name of the directory in which you want to install the software. For example, on Solaris: # 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. This section contains instructions about loading the CD-ROM and installing the Reader software from a CD-ROM drive attached to your workstation. Loading the CD-ROM You can install the software from a CD-ROM drive attached to your local workstation. If the CD-ROM drive isn't mounted, you must log in as root to mount it. If your CD-ROM drive requires a caddy, put the CD-ROM in a caddy and insert the caddy into the drive. If your CD-ROM drive does not use a caddy, load the disc directly into the drive. Load the disc so the printed side is facing up. Note: If your CD-ROM drive requires a caddy and you put the CD-ROM into the drive without a caddy, both the disc and the drive may be damaged. Checking If the CD-ROM Drive Is Mounted Depending on how your workstation is configured, your CD-ROM drive may be mounted automatically. If the CD-ROM drive is not mounted, you must mount it before you can install the Reader software. On Solaris 2.3 or 2.4 workstations, the CD-ROM icon appears on the desktop if your CD-ROM drive is mounted. On other Solaris, SunOS, or HP workstations, determine whether the CD-ROM drive is mounted by typing: # /etc/mount You should see a list of mounted file systems. The CD-ROM drive is mounted on your local workstation if a line similar to the following appears in the list: - If you're using SunOS or Solaris: /dev/sr0 on /cdrom - If you're using HP-UX: /cdrom on device readonly on date where device depends on your system. Check your reference manuals or ask your system administrator. If the CD-ROM drive is not mounted, see "Mounting the CD-ROM Drive" next. Mounting the CD-ROM Drive To mount a CD-ROM drive, you must know your system's root password. If you don't know the password, contact your system administrator. To mount the drive on a local workstation: 1 Open a UNIX window. 2 Become the root user and type the root password: % su root Password: 3 Create the /cdrom directory: # mkdir /cdrom; chmod a+rwx /cdrom 4 Mount the CD-ROM drive. - If you're using SunOS, type: # /etc/mount -rt hsfs /dev/sr0 /cdrom - If you're using Solaris 2, type: # /etc/mount -F hsfs -r /dev/sr0 /cdrom - If you're using HP, type: # /etc/mount device /cdrom -r -t cdfs where device depends on your system. Check your reference manuals or ask your system administrator. 5 Verify that the drive was mounted: # /etc/mount You should see a list of mounted file systems, including the CD-ROM drive you just mounted. Running the Installation Script ------------------------------- 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. 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. To run the installation script: 1 If you don't have write privilege to the installation directory, become the root user and type the root password: % su root Password: 2 Change to the Acrobat Reader directory on the CD-ROM: # cd /cdrom/acroread 3 Start the installation script: - If you're using SunOS or Solaris 2, type: # ./install - If you're using HP, type: # ./INSTALL 4 Follow the instructions that appear on your screen. 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. Skip this section if you are using the Motif window manager. 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 acroread.deskinstall 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 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. - The fonts directory contains bundled fonts. - The Help directory contains the Acrobat Reader Online Guide, the Weblink Online Guide, and the ReadMe file. - The res directory contains pixmap and bitmap resources. - The Tutorial directory contains sample PDF files. Starting the 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 this: % 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 The acroread launch script and the acroread_frontend program ensure that only one version of Reader runs on your desktop. If you type the command acroread when Reader is already running, the currently running version of Reader loads 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 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. To convert a PDF file by piping it into Reader and then sending the output to standard output, type: % 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: % 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: % acroread -toPostScript -pairs pdf_file_1 ps_file_1 ... To convert a PDF file to a level 2 PostScript file, type: % acroread -toPostScript -level2 pdf_file_1 Managing Acrobat Reader ----------------------- This section is for system administrators who need information about managing the Acrobat Reader installation directory. 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. As the superuser (root account), enter the following commands to remove Reader from the installation directory: # cd # rm -rf acroread 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 or acroread: 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: Locate the file that is launching the application by typing the command which acroread in a UNIX shell. This command gives you the name of the file that is executed when you issue the acroread command. Perform a long listing on 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. 1995 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 or its subsidiaries and may be registered in certain jurisdictions. 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. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. 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.