10/24/95 Downloading and Installing TapeGen SPECIAL NOTICES Information in this document is correct to the best of our knowledge at the time of this writing. Please send feedback by fax to "AIXServ Information" at (512) 823-4009. Please use this information with care. IBM will not be responsible for damages of any kind resulting from its use. The use of this information is the sole responsibility of the customer and depends on the customer's ability to eval- uate and integrate this information into the customer's operational environment. ABOUT THIS DOCUMENT This document describes the TapeGen tool and provides instructions on how to download and install it. TRADEMARKS AND ACKNOWLEDGEMENTS The following trademarks and acknowledgements apply to this information: AIX is a trademark of International Business Machines Corporation. TAPEGEN INTRODUCTION TapeGen is a service tool from IBM that enables you to create a stacked tape containing SMIT installable fixes. You create a stack file that lists all the images you want stacked onto a tape and TapeGen does the rest. PREREQUISITES The PTF images must be installable through SMIT. This means the fixes must be in installp format. The tape device must have the block size set to 512. The stack file must contain a list of PTF images that are to be written to tape. DOWNLOADING AND INSTALLING TAPEGEN To obtain TapeGen or read the user guide, you may download it via anonymous FTP from any of the servers listed below. Many of these sites are also web servers (example URL: http://service.software.ibm.com) and FixDist servers. Downloading and Installing TapeGen 1 10/24/95 Anonymous FTP Sites Canada rwww.aix.can.ibm.com 204.138.188.126 Germany www.ibm.de 192.109.81.2 Japan fixdist.yamato.ibm.co.jp 202.32.4.20 Nordic ftp.nordic.ibm.com 193.12.214.80 United Kingdom ftp.europe.ibm.com 193.129.186.2 United States service.software.ibm.com 198.17.57.66 The TapeGen client along with the user guide is located in the anonymous FTP directory /aix/tools/tapegen. The fol- lowing steps provide instructions on how to download and install the tool and the Postscript user guide. NOTE: The following procedure must be performed as root. 1. Change to your /tmp directory. cd /tmp 2. Download the tool and documentation. The tool comes with the plain text user guide in /usr/lpp/tapegen/tapegen.text. ftp service.software.ibm.com >login: anonymous >password: "email" (example: johndoe@) > >bin >cd /aix/tools/tapegen >get tapegen.tar.Z (TapeGen tool in compressed tar format) >get tapegen.ps.Z (User guide in compressed Postscript) >quit 3. Install the tool into the /usr file system. You must install it from the / (root) directory in order to access the online help and preserve your .netrc file. cd / (change directory to the root) zcat /tmp/tapegen.tar.Z | tar -xpvf - (uncompress and untar) USING TAPEGEN TapeGen may be executed by typing the following: tapegen -l stack_file -s fix_dir [-d device] [-w work_dir] Note: The flags encased in brackets [ ] are optional flags. Descriptions of the applicable flags are listed below: -L Name of the stack file. One PTF image per line. -S Location of the PTF images. -D Tape device name. The default is /dev/rmt0. -W Location where temporary files will be created. The default is /tmp. Downloading and Installing TapeGen 2 10/24/95 Once the command is executed you will be asked to verify the parameters, see example below: AIX TapeGen Utility Version 1.06 The following parameters will be used to create a stacked tape: STACK FILE stack.list PTF IMAGES DIRECTORY /images/32 TAPE DEVICE /dev/rmt0 TAPE TYPE 8MM WORK DIRECTORY /tmp Do you want to proceed with the above parameters (y/n)? When the parameters are correct and TapeGen is executed then the following informational message will be displayed on the screen. Verifying if the tape device block size is set to 512...done Insert a writeable tape cartridge into /dev/rmt0 and press enter Press enter to start the process. TapeGen will continue to display several informational messages verifing the proc- esses as they are written to the tape. Downloading and Installing TapeGen 3 10/24/95 READER'S COMMENTS Please fax this form to (512) 823-4009, attention "AIXServ Informa- tion". You may also e-mail comments to: elizabet@austin.ibm.com. These comments should include the same customer information requested below. Use this form to tell us what you think about this document. If you have found errors in it, or if you want to express your opinion about it (such as organization, subject matter, appearance) or make sug- gestions for improvement, this is the form to use. If you need technical assistance, contact your local branch office, point of sale, or 1-800-CALL-AIX (for information about support offer- ings). These services may be billable. Faxes on a variety of sub- jects may be ordered free of charge from 1-800-IBM-4FAX. Outside the U.S. call 415-855-4329 using a fax machine phone. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. NOTE: If you have a problem report or item number, supplying that number may help us determine why a procedure did or did not work in your specific situation. Problem Report or Item #: Branch Office or Customer #: Be sure to print your name and fax number below if you would like a reply: Name: Fax Number: ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ END OF DOCUMENT (tapegen.gen, 4FAX# 4924) Downloading and Installing TapeGen 4