__________________________________________________________________________ FixDist Version 1.23 (including TapeGen) User's Guide International Business Machines __________________________________________________________________________ October 1996 This edition of the FixDist User's Guide applies to the fix distribution utility and to all subsequent releases of this product until otherwise indicated in new releases or technical newsletters. The following paragraph does not apply to the United Kingdom or any country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS MANUAL "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you. IBM does not warrant that the contents of this publication whether individually or as one or more groups, will meet your requirements or that the publication is error-free. This publication could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time. It is possible that this publication may contain references to, or information about, IBM products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that IBM intends to announce such IBM products, programming, or services in your country. Any reference to an IBM licensed program in this publication is not intended to state or imply that you can use only IBM's licensed program. You can use any functionally equivalent program instead. Requests for copies of this publication and for technical information about IBM products should be made to your IBM Authorized Dealer or your IBM Marketing Representative. Copyright International Business Machines Corporation 1994. All rights reserved. Notice to U.S. Government Users - Documentation Related to Restricted Rights - Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation. Trademarks and Acknowledgements The following trademarks and acknowledgements apply to this information: o AIX is a trademark of International Business Machines Corporation. o AIXwindows is a trademark of International Business Machines Corporation. o IBM is a registered trademark of International Business Machines Corporation. o InfoExplorer is a trademark of International Business Machines Corporation. o Motif is a trademark of Open Software Foundation. o X Window System is a trademark of Massachusetts Institute of Technology. o PostScript is a trademark of Adobe Systems Incorporated. __________________________________________________________________________ Table of Contents About This Book Chapter 1. FixDist Introduction System Requirements Chapter 2. Downloading And Installing FixDist Chapter 3. Using FixDist Starting FixDist Configuring FixDist Generally Available Fix Types Excluding Fixes / Reducing the Size of the Fix Package Other Fix Types Chapter 4. Using Proxies Active Proxy FTP Passive Proxy FTP Appendix A. Supported Products AIX V4 Database AIX V3 Database CAD/CAM Databases Appendix B. How FixDist Determines Requisites AIX V4 Database AIX V3 Database CAD/CAM Database APPENDIX C. Technical Tips and Hints APPENDIX D. TapeGen Introduction TapeGen Requirements Using TapeGen How TapeGen Works __________________________________________________________________________ About This Book This book contains information on the FixDist utility. It includes an overview of the service and procedural information needed to access and use FixDist. FixDist is a user interface used to download software fixes on the Internet. Who Should Use This Book This book is for the FixDist user responsible for receiving and installing software fixes. How to Use This Book This book contains the following chapters: o Chapter 1, "FixDist Introduction," describes the features of the service. o Chapter 2, "Downloading and Installing FixDist," provides a procedure for downloading and installing the FixDist client code from a file server. o Chapter 3, "Using FixDist," provides a procedure for starting, and configuring the FixDist client code on your workstation. o Chapter 4, "Using Proxies," provides a procedure that allows you to open a connection to the FixDist server through an intermediate machine. o Appendix A, "Supported Products," specifies the supported products for V4, V3 and CATIA Platforms. o Appendix B, "How FixDist Determines Requisites, " explains how FixDist processes requisites. o Appendix C, "Technical Tips and Hints," provides suggested ways to take advantage of the functionality of FixDist. Some internal structures are also examined. o Appendix D, "TapeGen," provides instructions on how to download, install and use TapeGen. _________________________________________________________________________ Chapter 1. FixDist Introduction To help customers browse and download fixes stored at our fix sites, we have released a freely available service tool called FixDist. FixDist is a user interface tool designed to enable customers to select and download a fix and any neccessary requisite fixes. This tool and the anonymous ftp servers are available to customers with Internet ftp access. A companion service tool called TapeGen is provided with FixDist to enable you to create a stacked tape containing SMIT installable fixes. It is installed into the /usr/bin directory. It is a command line utility that uses the FixDist databases to copy the fixes onto tape. See the "TapeGen" section for more information. IBM provides a number of mirrored sites on the Internet where you may freely download AIX related fixes. While not every AIX related fix is available, we are constantly adding more and more product fixes. These sites are anonymous ftp servers. Though we do not guarantee all fixes will be immediately made available, we usually update the servers within 24 hours after the same fix is available from our tape distribution sites. The current list of anonymous ftp servers available for FixDist users are: United States service.software.ibm.com 198.17.57.66 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 With FixDist, you can choose to download immediately or configure to download later. It supports both AIX selective fixes as well as AIX Maintenance Packages. Fix requisites are downloaded with your fix. You can also tell FixDist what requisite fixes you do not need. FixDist enables you to select fixes by APAR number, PTF number or fileset name. Once a fix is selected, the utility attempts to deliver only the necessary fixes to satisfy all requisites. This speeds up delivery of the fix package because any fixes you may have already received are not downloaded. See Appendix B. How FixDist Determines Requisites for information on how to use this option. System Requirements The following table describes the system requirements for each process. 1. Downloading - Internet Access - 400KB in /tmp - AIX Version 3.2.5 or above. - AIX TCP / IP Applications 2. Installing - 600KB in /usr directory - AIX Version 3.2.5 or above. 3. Using FixDist with motif Interface - Internet Access - Graphic Display Adapter - Required disk space will vary depending on the fixes ordered. - AIX Version 3.2.5 or above. - AIXwindows Run Time Environment Version 1.2.0 or above - Motif Window Manager Version 1.1 and above - AIX TCP / IP Applications 4. Using FixDist with curses Interface - Internet Access - Required disk space will vary depending on the fixes ordered. - AIX Version 3.2.5 or above. - AIX TCP / IP Applications 5. The FixDist V4 Database - Internet Access - 2.5MB in target directory - AIX Version 3.2.5 or above. - AIX TCP / IP Applications 6. The FixDist AIX V3 Database - Internet Access - 3.5MB in target directory - AIX Version 3.2.5 or above. - AIX TCP / IP Applications 7. The FixDist CAD/CAM Database - Internet Access - 2.5MB in target directory - AIX Version 3.2.5 or above. - AIX TCP / IP Applications _________________________________________________________________________ Chapter 2. Downloading And Installing FixDist To obtain FixDist or read the user guide, simply download it via anonymous ftp from any of the servers listed in the "Introduction" section of this book. Many of these sites are also web servers (example URL: http://service.software.ibm.com). From the web pages you can read the user guide. The FixDist client along with the user guide is located in the anonymous ftp directory /aix/tools/fixdist. Below is an example of downloading and installing the tool and the PostScript user guide. Note:The following procedures must be performed as "root" 1. Change to your /tmp directory cd /tmp 2. Download the tool and documentation. The tool comes with the user guide in plain text as /usr/lpp/fixdist/fixdist.txt. ftp service.software.ibm.com > login: anonymous > password: "email" (example: johndoe@) > > bin > cd /aix/tools/fixdist > get fd.tar.Z (FixDist tool in compressed tar format) > get FixDist.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/fd.tar.Z |tar -xpvf - (uncompress and untar) To start up FixDist simply run the command: fixdist /usr/bin/fixdist is a script that calls /usr/lpp/fixdist/fixdistm for AIXwindows or CDE desktop users. If you have a dumb terminal fixdist will call /usr/lpp/fixdist/fixdistc. _________________________________________________________________________ Chapter 3. Using FixDist The FixDist utility is a user interface to an anonymous FTP server that contains software fixes for selected AIX products. These fixes can be selected for immediate download, or they can be specified to download at a later time. FixDist does not "install" any fixes onto your system. It simply transfers the needed fixes to a target directory on your system. When a fix is downloaded, you will receive all requisite fixes automatically. Starting FixDist To start the FixDist utility, enter the following: fixdist Configuring FixDist Note: Verify that hardware and software requirements are met (see Chapter 1). 1. Select a database from the menu bar. You may get an informational message if the FixDist Server or the Target Directory entries are not defined. 2. Specify in the FixDist Server field, a fully qualified name or IP address of an IBM FixDist Server. 3. Specify in the Target Directory field, a directory on your system where you wish to have the fixes downloaded. If the directory does not exist, it will be created. We suggest you use different directories for each database (i.e. /tmp/fixes/v4 and /tmp/fixes/v3 and /tmp/fixes/cad). 4. Download the database by clicking on Download/Refresh xxx Database. FixDist will "ftp get" the database from the server. When the database has been successfully received and uncompressed, a list of available fix types will be displayed. 5. Double click on a fix type or highlight a fix type and press the enter key. Generally Available Fixes There are two ways to search for a fix. A toggle button is provided enabling a PTF view or an APAR view. If you are looking for a fix to an APAR then select APAR View. If you are looking for a specific PTF number then select PTF View. Once you have selected the desired fix, you can download that fix by clicking on the Okay button. You will be prompted to specify your AIX Level. Use the Help button for information on how to determine your AIX Level. Package Content Information is then displayed, providing pertinent information on the fixes selected. Clicking Start Download starts the download process. Excluding Fixes / Reducing the Size of the Fix Package You can greatly reduce the size of many fix packages by using an exclusion file. To help you create and maintain an exclusion file, FixDist provides an Exclusion File button. Use this to view, create, append or overwrite an existing exclusion file. This file can be in virtually any format. FixDist makes two passes through the exclusion file. The first pass looks for matching PTF numbers. The second pass looks for matching fileset names. Other Fix Types FixDist supports other fix types, such as maintenance packages. Periodically, other types of fixes will be available. All fix types, other then Generally Available Fixes, are presented through a set of simple windows. By selecting one of these fix types, you are presented with a list of available packages to choose from. Unlike Generally Available Fixes, you are not provided a search facility or a method to exclude parts of the package. After selecting an item, you are presented with package size information. Clicking on Start Download begins the download process. _________________________________________________________________________ Chapter 4. Using Proxies Proxy FTP allows you to open a connection to the FixDist server through an intermediate system (proxy FTP server). This function is useful for those network environments that do not allow your AIX system to perform "ftp gets" directly on the Internet. FixDist supports 2 common types of proxy FTP, Active Proxy and Passive Proxy. Note that the terms Active and Passive are used to more easily delineate between the 2 types FixDist uses. SOCKS is not supported but we have made modifications to FixDist to make it somewhat more friendly in such environments. See the question "What if my RISC System/6000 cannot get to the FixDist server?" in Appendix C. "Technical Tips and Hints". Active Proxy FTP In active proxy mode, FixDist will use your UNIX based system that is directly on the Internet as a gateway. Images will first be ftp'd to your UNIX based system then ftp'd to your AIX system. To use active proxy, the UNIX based system needs to have a standard UNIX login account, password, and enough space in that account's home directory to download the fix. The user login on your UNIX based system should be a regular account with read-write permissions to the home directory of that login. To ensure that you have enough space available on the proxy server, we recommend that you have free space equal to the amount that FixDist says will be needed. In reality, you only need enough space to satisfy the largest individual fix image that is part of your fix package. Example: The fix package you select is 10MBs in size and is composed of 7 individual fix images. The largest image is 3.5MBs in size. You will need no more than 3.5MBs of free space in the home directory on your UNIX based system because each fix image is removed from the proxy server immediately after being transferred to your AIX system. Configuring FixDist to Use Active Proxy FTP From the menu bar, select Options -> Proxy -> Active. Fill in the three fields. Proxy Server The UNIX based system to act as the gateway. Proxy Id The user login id on the proxy server. Proxy Pwd The password for the user login id on the proxy server. If any of these fields are empty, active proxy will not work. FixDist does not check the validity of these entries. Note: Because the fix images are effectively being transferred twice, performance will be affected. The configuration file used to keep this information is in the file $HOME/.fixdist_home/.proxyinfo. The password entry is not retained. Passive Proxy FTP In passive proxy mode, FixDist communicates to the IBM FixDist server by first requesting a proxy server to grant permission to connect to the Internet. This is done by ftping to the proxy server by giving it a port number specified by the system administrator of the proxy server. This enables the client machine to pass through the proxy server. On the proxy server, the login userid is anonymous@server.domain and the password is your current login. Once logged in, all commands entered are being run on the FixDist server not the proxy server. Configuring FixDist to Use Passive Proxy FTP From the menu bar, select Options -> Proxy -> Passive. Fill in the two fields. Proxy Server The UNIX based system to act as the gateway. Port The port number used by the proxy server. If any of these fields are empty, passive proxy will not work. FixDist does not check the validity of these entries. The configuration file used to keep this information is in the file $HOME/.fixdist_home/.proxyinfo. _________________________________________________________________________ Appendix A. Supported Products There are currently six (6) anonymous FTP servers functioning as FixDist servers. These servers are updated daily. They are mirrored with all 3 FixDist databases. AIX V4 Database We keep the latest AIX product fixes available on these servers. Virtually, every IBM AIX Version 4.2 and 4.1 related product is represented. However, there are some fixes that cannot be distributed anonymously. Those fixes will not appear in FixDist. Additionally, there are a few fixes that are not in a format that FixDist can understand. Those will not be available through FixDist but are typically available through other electronic means. AIX V3 Database Virtually, every IBM AIX Verson 3.2.5 related product is represented. However, there are some fixes that cannot be distributed anonymously. Those fixes will not appear in Fixdist. Additionally, there are a few fixes that are not in a format that FixDist can understand. Those will not be available through FixDist, but are typically available through other electronic means. CAD/CAM Database This database currently houses CATIA for AIX fixes. These include the latest tar images as well as the earlier bff images. CADAM for AIX is not yet available. _________________________________________________________________________ Appendix B. How FixDist Determines Requisites AIX V4 Database The AIX V4 fix policy is to deliver the original fix for a specified APAR (Authorized Problem Analysis Report). A fix is composed of one or more installable images that usually replace portions of a software product. The fix package is selectable either by viewing the APAR list or by viewing the PTF-Fileset list. A fileset fix is the AIX V4 representation of a PTF. A Brief Discussion on V4 Filesets The fileset concept is straight forward and quite different from the way AIX V3 fix information is stored. A fix for TCP/IP's ifconfig (interface configuration command) is a good example to compare AIX V3 and AIX V4. In V3, a fix for ifconfig is tracked on the system by PTF number: bos.tcpip.obj U491130 03.02.0000.0000 In V4, the same fix is tracked on the system by fix level: bos.net.tcp.client 4.1.1.1 The level is read Version.Release.Modification.Fix level (VRMF). If the F is 0, like 4.1.1.0, that fileset has no fixes applied to it. If the F is 5, like 4.1.1.5, that fileset is at the 5th fix level meaning only that the fileset has been revised at least 5 times and you have installed the 5th fix level. When a new Modification is shipped, the Fix level resets to 0 like 4.1.2.0. Note that all operating system fixes install as filesets on AIX V4. While the operating system fixes are in fileset format, other IBM and non-IBM products can be in the old-style V3 formats while still other products may install in simple tar format using their own tracking methods. AIX V3 Database The AIX V3 fix policy is to deliver the latest package that contains the fix for an APAR (Authorized Problem Analysis Report). A fix package is composed of PTFs. A PTF is an installable image that usually replaces portions of a software product. PTFs often fix more than just one APAR. As new PTFs are released, some replace the same portions of a software product. In this way, the fix is a cumulative fix. The newer fix is said to "supersede" the previous fix. FixDist for AIX V3 takes this policy a bit further. FixDist delivers fixes using what is commonly referred to as "preventive supersede". This is the process of always delivering the latest fix package. The effect can be seen when you select an APAR that has been fixed for some time or a PTF that has been superseded. FixDist will tell you that the fix you have selected has been superseded by a newer fix. FixDist will always deliver the newest fix. CAD/CAM Database The CAD fix policy is to deliver the original fix for a specified PTF. A fix is composed of one or more installable images that usually replace portions of a software product. The fix package is selectable either by viewing the APAR list or by viewing the PTF list. _________________________________________________________________________ APPENDIX C. Technical Tips and Hints The following technical tips and hints provide suggested ways to take advantage of the functionality of FixDist. Some internal structures are also examined. Where does FixDist keep it's configuration file? The config file is $HOME/.fixdist_home/.fixdistcfg. This file is a flat text file. If the $HOME/.fixdist_home directory does not exist, it is created for you. The directory and the .fixdistcfg file must have read/write access by the effective user. The .fixdistcfg file helps FixDist remember: what FixDist server you use; where it's databases are; whether you wish to download now or later; and what database was last used. How does FixDist talk to the server? FixDist is a stateless application in that it does not keep in contact with the FixDist server. It uses anonymous ftp to get fix images from the server. When FixDist is initially started, it is lacking a database. By clicking on the Database button, it logs into the server via anonymous ftp and gets the specified database. After a database is retrieved from the server, FixDist can search the database and build a list of fixes. When you tell FixDist to start the download, it initiates a number of anonymous ftp gets to the server to retrieve the fixes. FixDist requires the use of a .netrc file. In order to avoid using the $HOME/.netrc file, the $HOME environment variable is changed to $HOME/.fixdist_home. This allows FixDist to create and manipulate it's own .netrc file safely, without the possible loss of the user's normal .netrc file. What files make up FixDist? FixDist is made up of a main driver shell script called /usr/bin/fixdist that calls either the graphical user interface /usr/lpp/fixdistm or the character based user interface /usr/lpp/fixdist/fixdistc. The shell script performs initial setup for FixDist by temporarily resetting your $HOME variable to $HOME/.fixdist_home then determining whether you have a graphical display ($DISPLAY is set). There are various help files and other text files. FixDist is hard coded to look for these files in the /usr/lpp/fixdist directory. How does FixDist keep track of fixes on the server? FixDist keeps track of fixes and their requisites by reading a database that is downloaded to your system. The AIX V4 database is contained in a compressed tar image called 41fd.db.Z (AIX V4 FixDist Database). This database is regularly updated and put on the server in the /aix/fixes/v4/fixdistdb directory. The AIX V3 database is contained in a compressed tar image called fd.db.Z (AIX V3 FixDist Database). This database is regularly updated and put on the server in the /aix/fixes/v3/fixdistdb directory. The CAD/CAM database is contained in a compressed tar image called cad.db.Z (CAD/CAM FixDist Database). This database is regularly updated and put on the server in the /aix/fixes/cad/fixdistdb directory. How often should I refresh the database? You should get a copy of the database every time you use FixDist. Before you begin searching any database, you should check the timestamp displayed on the main menu to see when was the last time you updated a database. If the timestamp is older than one day, you need to refresh the database to ensure you have a current one. Why are outdated AIX V3 fixes unavailable on the FixDist servers? The fix policy for the AIX V3 operating system is based on delivering only the most recent fixes. This policy is commonly referred to as preventive supersedes. The result of this policy on FixDist servers is the deletion and removal of superseded fixes from the database and the deletion of those superseded fixes from the server. What is the fix policy for AIX V4 in lieu of the above question? The fix policy for the AIX V4 operating system is more traditional. Few, if any fixes are superseded in V4. This policy will ensure that any fixes released into the AIX V4 database will remain available for an extended period of time. The AIX V4 FixDist Database will continue to allow the selection and downloading of all fixes for an extended period of time. What is the fix policy for CAD/CAM? CAD/CAM fixes are delivered in much the same way as AIX V4 fixes are. The fix you select is the fix you receive. This is different from the way we deliver fixes for AIX V3, which is to deliver the latest superseding fix. This policy will ensure that any fixes released into the CAD/CAM database will remain available for an extended period of time. Where are the database files kept? The database files are kept in a subdirectory under the target directory you specify. The name of the subdirectory is fddb. How can I use the download later option? By default, the download method is set to immediately download the selected fixes. From the main menu, you can toggle between Now and Later. The later option generates FTP scripts that can be used through a cron job. Normally, FixDist creates a .netrc file that is called by the ftp command. Because there is an inherent file size limitation on the .netrc file of 4096 bytes, FixDist will often create more than one .netrc file, usually calling them .netrc0, .netrc1, etc... etc... By selecting Later as the download method, you are instructing FixDist to create the necessary .netrc* files and hold off executing the ftp command. You can then create your own shell script that executes the ftp command using the .netrc* files created by FixDist. The .netrc* files are created in the $HOME/.fixdist_home directory. When creating a shell script, the logic below should be followed: Copy .netrc0 to .netrc Run ftp Copy .netrc1 to .netrc Run ftp again Copy .netrc2 to .netrc Run ftp again What if my RISC System/6000 cannot get to the FixDist server? FixDist currently supports two types of proxy FTP. See the chapter on "Using Proxies"show for more information. SOCKS is not supported but we have made it easier to work around such limitations. Prior versions of FixDist specified an absolute path to the ftp command (/usr/bin/ftp). Now we are using a relative path. When the ftp command is called by FixDist, we simply call ftp instead of calling /usr/bin/ftp. This simple modification allows you to work with your $PATH environment variable. If you use an ftp command that is not the standard one released by IBM for AIX, you can move your entries in your $PATH variable so that FixDist will find your ftp command before it finds the IBM AIX ftp command. If your ftp program is something like /usr/local/etc/rftp, you can symbolically link or rename it to /usr/local/etc/ftp and add it to the top of your $PATH variable by running export PATH=/usr/local/etc:$PATH Still, some network environments prevent you from using any of the above alternatives. There is a rather tedious way to run FixDist to help you figure out what requisites are needed. This process is to manually get the appropriate FixDist database from the server and use it to generate the ftp scripts as described in the above question "How can I use the download later option?". For file names of the databases, see the above question on "How does FixDist keep track of fixes on the server?". The basic steps to using FixDist when your RISC System/6000 cannot get to the Internet directly or indirectly are: 1. Manually ftp get the database (fd.db.Z or 41fd.db.Z or cad.db.Z) from the FixDist server and put it on your RISC System/6000 in the directory to be your target directory. 2. Untar the database zcat fd.db | tar -xvf - 3. Run FixDist. Specify any system as your FixDist server and specify the target directory as the directory where you just untar'd the database. 4. Click on Apply/Save and FixDist will look for the database files in the target directory. You can use FixDist to access the database when you see the fix type of Generally Available Fixes appear. Set your Download Method to Later so FixDist will not attempt to go to the server. CAUTION: Do not attempt to Refresh your database. Doing so won't overwrite the database but may cause FixDist to hang waiting for a response. How do I install a fix after receiving it via FixDist? FixDist does not install fixes for you. It is a fix distribution tool, not an installation tool. The images received from FixDist are typically in installp format. This means that you can use SMIT to install the fixes. Installing fixes requires that you be the root user. SMIT (calling the installp programs) looks for a table of contents file named .toc in the target directory. If .toc does not exist, it will be created automatically. If it already exists, SMIT may NOT recreate it. We recommend that each time you download a fix, you manually run the inutoc command on the target directory to create the .toc file. Do not rely on SMIT to create it for you because it may already exist when you download fixes repeatedly. Since SMIT may NOT recreate the .toc if one already exists, SMIT may not find the recently downloaded fixes in your target directory. Are there any README files for the fixes? Yes. For each fix downloaded, you will usually find that an additional informational file has been downloaded as well. The info files will have a suffix of .info in the filename. Why do I sometimes get Xt warning messages? Some older versions of AIXWindows, namely R4 releases, periodically display Xt warning messages. If you get these, you can fix this by loading the R4 libraries when FixDist starts. LIBPATH=/usr/lpp/X11/lib:$LIBPATH fixdist __________________________________________________________________________ APPENDIX D. 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. TapeGen Requirements 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. Create the stack file. It must contain a list of PTF images that are to be written to tape. 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. Once the command is executed you will be asked to verify the parameters, see example below: AIX TapeGen Utility Version 1.13 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)? If 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 display several informational messages on the screen to verify the steps of writing to the tape. How TapeGen Works The Concept of "Stacked Tapes" TapeGen puts PTF images onto tape in a format that enables SMIT or installp to update your licensed programs directly from the tape without needing to copy the fix package onto your hard disk first. This tape format is called "stacked tape" because the images are stacked one after another on the tape. SMIT (installp) requires more than just a stacking of PTF images one after another. The install process reads a table of content file in order to find the locations of the images on the tape. The Format of "Stacked Tapes" The first and second image on the tape are reserved, empty images. These reserved areas are not used on fix tapes. They are used by bootable product installation tapes. The third image is a special plain text file called the table-of-contents or toc. As the name implies it contains content information about the images that are on the tape. The remaining images are the actual PTF images. If FixDist is used to created the stack file, they will be ordered on the tape in such a way as to limit the amount of "tape play". Tape play is the process of skipping images to get to another image. The Building of "Stacked Tapes" TapeGen uses the stack file to determine what PTF images will be put on the tape. Then TapeGen verifies that all the images are available to be stacked. Next, each PTF image is opened and it's toc fragment is extracted. All the toc fragments are brought together in an ordered format to create the table-of-contents file that will become the third image on the tape. After rewinding the tape, we begin the actual writing to the tape. We call upon dd (device dump) to write each image to the tape. When the last image is done, the building of the stacked tape is complete.