BSYS OperationMaxc Operations7219. BSYS OPERATIONThis section describes normal operating procedures for backup and archiving by means of BSYS.Further information on BSYS commands may be obtained from the document "BSYS - TenexBackup System" by Smokey Wallace, a copy of which is kept in the Maxc room book case.The procedures are identical for Maxc1 and Maxc2, with the exception that archiving is notpresently supported on Maxc2. Separate sets of backup disk packs are used for the two systems.One should be aware of what procedures can and cannot be performed simultaneously. Only onedump of any kind (incremental or full dump, archiving, or backup to tape) can be in progress at atime. However, it is ok to perform archive retrieval (or retrieval of files from backup) at the sametime as a dump. Of course, since Maxc1 and Maxc2 are independent systems, there are norestrictions relating to simultaneous Bsys operations on the two systems.19.1. Backup ProceduresA full dump of the file system is performed approximately once a month, and incremental dumpsevery weekday, onto disk packs mounted on auxiliary drives. At present, the backup packs consistof two sets of packs for full dumps and enough packs for incremental dumps to last about a month.Successive full dumps alternate between the two sets of full dump packs, and the incremental dumppacks are then recycled until they are all rewritten with data more recent than the last full dump, atwhich point it is necessary to perform another full dump. This procedure ensures that (1) if the filesystem is wiped out, it will be possible to restore it to its state at the time of the last incrementaldump, and (2) if a user loses a file and notices its loss within one month, it will be recoverable.In addition to full and incremental dumps, a full backup to tapes is performed once every threemonths and the tapes stored in Building 34. This provides backup in case of a catastrophe such asa fire in the machine room.BSYS is organized around the use of tapes as the backup medium. Disk packs have been interfacedto BSYS at a very low level, with the result that most of BSYS still thinks it is dealing with tapes.The backup packs are laid out in a manner that allows several logical "tapes" to be stored on eachone. Every such "tape" has a "tape number" (just as with real tapes) whose format is "xxxyy",where xxx is the pack number and yy is the logical "tape" number (or "dump number") on thatpack. Hence, "Parc tape number 21402" means the second dump on pack number 214.When a full dump is performed, each pack contains a single logical "tape", since every pack exceptthe last is completely filled by its respective portion of the full dump. An incremental dump, onthe other hand, typically fills somewhat less than one pack. Hence it is possible to writeincremental dumps for several successive days onto a single pack. When a pack becomes full, thelast incremental dump will usually be split between the last logical "tape" on that pack and the first"tape" on the next pack. This is ok since each "tape" has its own directory and is completely self-contained. (However, the last incremental dump pack should not be allowed to overflow forobvious reasons.)A record of usage of full and incremental dump packs is posted on the Maxc room bulletin board.It should be kept up to date.)fqX ;pi "`rX ]KsA [+) YU VD6$ Ty_ Q5' O=A Mre K5" II CrX ?s O =3. <': :KB 8f 6H 4O 3 c /,3 -D , (` &>' %E #G9% !}R P @ W u:( < B Q KK E  DA y  2>]'Maxc OperationsBSYS Operation7319.2.Incremental DumpsEvery working day, an incremental dump should be performed, preferably during periods of lightMaxc load (e.g. before 8 am or after 5 pm). The procedure is as follows.1.Consult the "Incremental Dumps" chart to determine the pack currently being used forincremental dumps. Mount that pack on any free drive. Wait for it to be on-line before startingBSYS.2.Login as someone with "wheel" or "operator" capabilities and execute the following procedure(user typein is underlined):@ENABLE password !CONNECT BSYS !BSYS TENEX BSYS 4.03 23-MAY-75*INCREMENTAL DUMP (CHANGED FILES) Dump since t&d? No Entire file system? Yes 3.You will now be asked to "Enter backup device (mtan:, dpkn:)". Here you should enterDPKn, where n is the unit number (drive A is unit 0, B is unit 1, ... H is unit 7). Then you will beasked for the pack number. When you supply this, BSYS will attempt a Tenex "Mount" of thepack. Assuming this is successful, one or more of the following things will happen:a)"Pack has no home block. Do you want to initialize the home block?" This should happenonly for a freshly-initialized pack, i.e. one that has not been used for backup before. Since all ourbackup packs have been used many times, you should not see this question.b)"Home block type is xxxxx. Do you want to initialize the home block?" The mounted packhas been used for some other purpose and should probably not be used as a backup pack. (This isespecially true if xxxxx is "TENEX"!)c)"n dumps already written on this pack", followed by a list of the dates and times of the dumps,followed by "Do you want to overwrite these dumps?" If you are appending to the pack that wasused in the previous day's incremental dump (i.e. the most recent date printed out is yesterday), youshould answer "No". If you are recycling a pack from the previous month (i.e. the dates printedare on the order of a month ago), you should answer "Yes".d)If the number of free pages on the pack is less than 2000 and you answered "No" to thequestion about overwriting existing dumps, BSYS will say "Insufficient room for more dumps" andwill ask you to mount another pack (on the same drive). The reason for this check is to ensure thatit will be possible to write the file DIRECTORY on the first logical "tape" of thisdump.4.BSYS will then ask "Listing to file:". We keep incremental dump listings on the BSYSdirectory in files named BSYS/mm-dd-yy.INC, where mm-dd-yy is today's date. So you shouldrespond with, for example, "BSYS/7-25-75.INC". fpi:qX Fp _r [s^ YI Vg26 TH R O`2R MJ#8IiJ#XHYQH HYFQF7QFDBBB4B~BA.v@"A. @~A.?d? ?d!w? ~?d ;25 :'E 8] M 6T 3 2J 1U:, /I ,2"6 *N8( (% %2'8 #GU !}&? E : u2P 4+ R %6 K 2/& 1) D2 ( =\[BSYS OperationMaxc Operations745.Finally, BSYS will ask you to "Enter tape id:". You should respond with the same string asyou gave for the listing filename, e.g. "BSYS/7-25-75.INC".6.The dump should now proceed. BSYS prints a summary of files and pages dumped for eachdirectory (more detailed information is sent to the listing file).7.If the pack becomes full, BSYS will once again request you to "Enter backup device (dpkn:,mtan:)". You should dismount the pack, mount the next incremental dump pack, and repeat step 3above. In this case, you should always answer "Yes" to the question "Do you want to overwritethese dumps?" since you are recycling an old incremental dump pack. Be sure to update the charton the bulletin board.8.When the incremental dump is finished, BSYS will type an asterisk. The last step of the dailybackup procedure is to do an "Expunge" on all directories:*QUIT !DISCUSE SYSTEM TOTAL: 6679 PAGES LEFT, 129401 USED!EXPFILES [Long pause while expunges are done]!DISCUSE SYSTEM TOTAL: 9475 PAGES LEFT, 126705 USED!9.Tear off the listing and put it in the filing cabinet. (Fanfold to 8.5" x 11" for filing.)10.Occasionally you should delete obsolete incremental dump listing files, i.e., ones for dumps thathave been overwritten. This is most conveniently done using the program DELBSYSINC (on theBSYS directory). It requests a date and deletes all files of the form BSYS/mm-dd-yy.INC in whichmm-dd-yy is earlier than the date specified.19.3. Full DumpsThe full dump procedure takes 6 to 8 hours depending on load, so it is usually run during the day(unless you plan to be at Parc all night anyway).1.Consult the "Full Dumps" chart and select the least recently used set of full dump packs. Besure to update the chart. Mount the first pack on any free drive. Wait for it to be on-line beforestarting BSYS.2.Login as someone with "wheel" or "operator" capabilities and execute the following procedure(user typein is underlined):@ENABLE password !CONNECT BSYS !BSYS TENEX BSYS 4.03 23-MAY-75*FULL DUMP (ENTIRE FILE SYSTEM) )fqX ;pi  `s2)2 ^? [2< YB VD2D TyB RD P(8 O K2T I:FkFrFkXDQDI D B+A Q@ A ?A$=vQ= =v ;+9 6o28tF# 2s2J 12H /hQ -, &r #jsF !1 .23* c6.  '2R \8iX Q  UQ QU   i 0 i~ 6 y=]@Maxc OperationsBSYS Operation753.You will now be asked to "Enter backup device (mtan:, dpkn:)". Here you should enterDPKn, where n is the unit number (drive A is unit 0, B is unit 1, ... H is unit 7). Then you will beasked for the pack number. When you supply this, BSYS will attempt a Tenex "Mount" of thepack. Assuming this is successful, one or more of the following things will happen:a)"Pack has no home block. Do you want to initialize the home block?" This should happenonly for a freshly-initialized pack, i.e. one that has not been used for backup before. Since all ourbackup packs have been used many times, you should not see this question.b)"Home block type is xxxxx. Do you want to initialize the home block?" The mounted packhas been used for some other purpose and should probably not be used as a backup pack. (This isespecially true if xxxxx is "TENEX"!)c)"n dumps already written on this pack", followed by a list of the dates and times of the dumps,followed by "Do you want to overwrite these dumps?" The dates printed out should beaproximately two months old. Since you are re-using a full dump pack, you should answer "Yes"to this question.4.BSYS will then ask "Listing to file:". We keep full dump listings on the BSYS directory infiles named BSYS/mm-dd-yy.FULL, where mm-dd-yy is today's date. So you should respond with,for example, "BSYS/7-25-75.FULL".5.Finally, BSYS will ask you to "Enter tape id:". You should respond with the same string asyou gave for the listing filename, e.g. "BSYS/7-25-75.FULL".6.The dump should now proceed. BSYS prints a summary of files and pages dumped for eachdirectory (more detailed information is sent to the listing file).7.When the pack becomes full, BSYS will once again request you to "Enter backup device(dpkn:, mtan:)". You should dismount the pack, mount the next full dump pack, and repeat step 3above.8.When the full dump is finished, BSYS will type an asterisk. The last step of the monthlybackup procedure is to do an "Expunge" on all directories:*QUIT !DISCUSE SYSTEM TOTAL: 6679 PAGES LEFT, 129401 USED!EXPFILES [Long pause while expunges are done]!DISCUSE SYSTEM TOTAL: 9475 PAGES LEFT, 126705 USED!9.Tear off the listing and put it in the filing cabinet. (Fanfold to 8.5" x 11" for filing.)10.Delete the listing file for the full dump that has just been overwritten. fpi:qX Fp _s25 ]KE [ M YT VD2J Ty:, RI O=2"6 Mr8( K% H62'8 FkT D'7 B ?d2X =9# ;% 8]2)2 6@ 3 2< 1UB -2** ,)7 *N &21( %:!!Ir!XQ~   +@Q @ u$QT  + 28tF# 2s2XI R =Z +BSYS OperationMaxc Operations7619.4. Full Backup to TapeThe procedure for backup to tape, performed quarterly, is identical to the full dump procedure withthe following exceptions:1.The first command issued to BSYS should be "BACKUP" rather than "FULL".2.The answer to "Enter backup device (mtan:, dpkn:)" should be MTAn, where n is the tape uniton which the backup tape is mounted.3.The listing file should be BSYS/mm-dd-yy.BACKUP. After completion of the dump, this fileshould be printed in a small font (Gacha6R90) and then deleted.19.5. Continuing Interrupted DumpsBSYS records its state at the beginning of each logical "tape". If Maxc crashes in the middle of adump, this information may be used to restart the dump at the appropriate point. The procedure isas follows:1.Do not change packs or tapes, even if the dump began on a pack or tape different from the onecurrently mounted.2.Start BSYS and issue the "Continue Dump" command. Your responses to the questions "Enterbackup device" and the ones that follow should be the same as the answers you most recently gaveto the same questions.3.BSYS will print "Restarting at user xxxxx" and resume the dump (incremental, full, or backup).19.6. Restoring Files from BackupIndividual files may be restored from backup packs by the following procedure.1.Determine where the file was written, by poking around in the listing files (.FULL and .INC).When you have located in the listing file the name of the file to be restored, go up to the top of thepage to find the "Parc tape number", which will be in the form xxxyy, where xxx is the packnumber and yy the dump number as previously explained.2.Mount the pack so determined on an auxiliary drive.3.Go through the following dialogue (xxx and yy are the numbers determined above):@ENABLE password !BSYS TENEX-BSYS 4.03 25-MAY-75*RESTORE FILES (FROM TAPE) )fqX ;pi  _r [sR Y Vg2XG R2Q Q+$ M2I K? E-rX# As W ?%< >& :2usG 8 5x2E 3.u s 1 .q2#; 'rX" $>sN 2] $B 7T l6 2X3 2P8iLQQL   ` , `~ V p>\Maxc OperationsBSYS Operation77Enter backup device (mtan:, dpkn:) DPKn Mount pack number: xxx Pack xxx mountedn dumps already written on this pack[Listing of dump numbers and dates]nnn free pagesEnter dump # yy Listing to file: TTY: Mounting tape directory4.BSYS will now prompt you with "Restore DPKn:", to which you should respond with the fullfilename to be restored (including directory). Editing and recognition may be used and "*" mayappear in any field; however, BSYS's filename logic is not as good as Tenex's, and you should becareful to specify a complete filename (including version) before hitting carriage return.5.After restoring the specified file(s), BSYS will again prompt with "Restore DPKn:", and furtherfiles in the same dump on the same pack may be restored. When you have no more files torestore, hit Delete.19.7. Restoring the Entire File SystemThis is the procedure to be followed if the file system has been wiped out and it is necessary torestore it from backup.1.Load Tenex using Micro-Exec, go into EDDT, set DBUGSW to 2, and start the system atSYSLOD. To the question "Do you really want to clobber the disc by re-initializing?" answer "Y".After some amount of churning and various error messages ("No SYSJOB", "No EXEC", etc.) youwill end up in the Mini-Exec.2.A copy of BSYS is kept on Save Area 4, so to load and start it:.Load program from area 4..Start.TENEX-BSYS 4.03 25-MAY-75*3.Consult the summary from the most recent incremental dump to determine the logical "tape"on which that dump started. This is in the form xxxyy, where xxx is the pack number and yy thedump number on that pack. Mount the pack. Note that this might not be the current incrementaldump pack. (If there have been no incremental dumps since the most recent full dump, then justmount the first pack of that full dump.)4.Go through the following dialogue:*RESTORE FILES (FROM TAPE) Enter backup device (mtan:, dpkn:) DPKn Mount pack number: xxx fpi:qX Fp_s$)^_]K \]K[Y$W#V! TV S6TVR{R4%RP MO2X K Q IC GZ D}2W BO @ :'rX' 6sQ 4 1y2$/ /\ -W , (2X?%5/$%5"$%5#j/##j#W#j! c2F T 6u) sus= 9 us 2X"U U, ~U $) 3   i  y>]JBSYS OperationMaxc Operations78Pack xxx mountedn dumps already written on this pack[Listing of dump numbers and dates]nnn free pagesEnter dump # yy Listing to file: NIL: Mounting tape directoryRestore DPKn: <*>*.*;* Create users? Yes Creating users...Bypass restore checks? No 5.BSYS first obtains a copy of the DIRECTORY that was written in this dump. Thisdirectory is used to control what files get restored from this and all other backup packs, and is alsoused to restore the correct file attributes. This is why it is important that the first dump restored bethe first logical "tape" of the most recent incremental dump.6.BSYS now restores all appropriate files from the dump, then asks "More tapes?" to which youshould answer "Y". You should now specify the previous dump on the same pack, or the lastdump on the previous pack. You must restore all the dumps on each of the most recent full dumppacks and on each of the incremental dump packs more recent than the last full dump. It isessential that the incremental dumps be restored in reverse chronological order, and that allincremental dumps be restored before any full dump.7.When all files have been restored, answer "N" to "More tapes?"; then give the "Quit"command to exit BSYS and the Mini-Exec "Halt Tenex" command to stop the system. Now reloadand start Tenex in the normal fashion.BSYS also has a "RELOAD DIRECTORIES" command that may be used to restore the entirecontents of one or more user directories from backup, but less than the entire system. You shouldstart by reloading the first pack of the most recent incremental dump, just as for the full restore.19.8. Archive ProceduresWhen users request that files be archived, the files are simply marked for archiving. Twice a week(generally on Monday and Thursday), BSYS is run to archive these files onto two different tapesand then delete the files from disk (if appropriate). At any given moment, there are two "current"archive tapes. Files from successive weeks are appended onto these tapes until they become full.The tapes then have their write rings removed and are kept "forever", and new tapes are used forfurther requests.The effect of archiving a file twice is obtained by simply running the archive system twice, oncewith the first "current" tape mounted and once with the second. Generally, both tapes will end upcontaining the same information. However, occasionally a user will make a new request betweenthe first archive run and the second. In this case, the file gets archived for the first time on thesecond tape and for the second time on the first tape next week. Hence the archive tapes may notbe simply copies of each other.)fqX ;pi _sX]K$[#Y W W6WV!{UV!TVR ZR4R P PjPuPj~PNM,!VL"M,#L~M, I27 G>( F$I DZ= @2S ?Q =S u s% ;I 9us? 73 426 2C 0& -z@ +b )d #$rX sC /0 E R8) E  KN J  P P #> V >]LMaxc OperationsBSYS Operation79When a user requests that an archived file be retrieved, the retrieval request is recorded in twoplaces. File RETRIEVE-REQUESTS.TXT is a human-readable text file containing allrelevant information (filename, tape numbers, requesting user, etc.) This file is deleted once aweek. File RETRIEVE-REQUESTS.BINARY contains the same information in a formreadable by BSYS. Every working day, BSYS is run to process accumulated retrieval requests andrestore archived files from tape to disk.19.9. Organization of the Archive TapesThe archive tapes are consecutively numbered starting at 700.1 First and second archive tapes arepaired. Each tape is labelled with an identifier such as "BSYS/7-21-75.ARC/1" or "BSYS/7-21-75.ARC/2", where the date specified is the starting date for that tape, and the trailing digitdistinguishes the first archive tape from the second. When an archive tape is full, the date onwhich it became full is also written on the label, and the write ring is removed. (Actually, weusually do this before the tape has become completely full so as to avoid having archive runs splitacross two tapes. However, no harm arises if this occurs.)The tape is also marked with the tape unit on which it was written. When possible, files should beappended to a tape using the same drive on which the tape was first written, and first and secondarchive tapes should be written on different drives.19.10. Archiving Files to TapeTwice a week (preferably Monday and Thursday), the following procedure should be followed to write filesonto the archive tapes. User typein is underlined.1.If the newest "first archive" tape (marked ".ARC/1") is not full (i.e. has no ending date), makesure there is a write ring in it and mount it on the drive noted on the label. If it is full, mount thefirst unused tape on unit 2 (if possible).2.Login as yourself (assuming you are a wheel or operator; otherwise login as SYSTEM) and gothrough this dialogue:@ENABLE password !BSYS TENEX BSYS 4.03 23-MAY-75*ARCHIVE (USER FILES) Archival period (days) = 999999 Listing only? No Listing to file: LPT: ------------------------------1Tape number 999 was used on 6-28-79. At this point old tapes were scrounged up and the sequential numberingsystem went to pot. Tapes numbered 671 through 687 cover the period 6-28-79 to 8-28-79. Tapes numbered 039through 540 cover the period 9-2-79 to 6-26-80. At this point new tapes were purchased and put into use. They arenumbered consecutively from 1001 through 1098. fpi:qX Fp _s-4 ]K.* [B Y9 W*5 V!) O`rX( Ks=L{vKs$ J#] HYG F` D2. B=& A.; =Y ;Z :'4 3grX /s ts5 .*3 *27) (:. '#* #2S !t8itXQSQ0( ~J#J  ("(~{^ v o39 D( 3@ .  U=]IBSYS OperationMaxc Operations80Entire file system? Yes List to users? Yes Preface with special message? No Enter backup device (mtan:, dpkn:) MTAn Density (n=800, p=1600): P3.BSYS will now ask "New tape?". If you have mounted a new tape, answer "Yes"; BSYS willthen ask you to supply the tape number. Otherwise, answer "No"; BSYS will ask you to verifythat there is a write ring in the mounted tape.4.BSYS will now space to the end of the used portion of the tape (if any) and start writing newfiles.5.If the tape becomes full, BSYS will rewind it and again ask "Enter backup device (mtan:,dpkn:)". You should label the tape as full, remove its write ring, and put it away. Then mount thefirst unused tape (NOT the "second" archive tape) on the same drive, and go through thisprocedure:Enter backup device (mtan:, dpkn:) MTAn Density (n=800, p=1600): PNew tape? Yes Really?? Yes Parc tape number: nnnn Be sure to label the new tape properly.6.When the archive run is finished, BSYS will report the number of files and pages archived.Dismount the archive tape and put it away.7.Repeat the entire procedure (steps 1-6) to write the "second" archive tape, using the tapemarked ".ARC/2" if you append to an existing tape, and using tape unit 3 if possible. If thesecond archive tape becomes full and you get to step 5, be careful to use another new tape tocontinue archiving on. That is, don't append to the new archive tape written on during the firstarchive.8.If either archive tape is almost full (less than 1/2 inch of unused tape thickness on the reel),mark both tapes as full and remove their write rings before putting them away.9.Go to the Clover room, collect the two listings, and store them in the tape cabinet.Normally, we archive only those files specifically marked by users for archiving. However, it isoccasionally necessary to perform "forced" archiving of all files not referenced within the last n days(n is generally 90). The procedure for forced archiving is identical to the normal archivingprocedure with the following exceptions:1.The reply to "Archival period (days) =" should be 90 (or whatever interval is being used)rather than 999999.2.The reply to "Preface with special message?" should be "Yes". BSYS will then give control to)fqX ;pi _sX^_!w^~_]K\]KT\~]K[%v[)"['[)~[Y$)Y_YW$NWW Ty29 R> P/ Mr2G K H62*. Fk#A Dus B ?dX$)? ?d=$N=B=; ;x;:;x~;:9:9~:89789 4' 1U2@ /* ,2? *NK (:us &O $ !}2G N @2XT  U E" 9./ n( 21( 2 2T y>]yMaxc OperationsBSYS Operation81SNDMSG, to which you should type an appropriate explanatory message, such as "This archiveincludes all files not referenced in the past 90 days. New users will find useful informationpertaining to how the archive system works by logging in on MAXC and using either the SEE orCOPY commands to read the file Archive-System.Doc.", followed by control-Z.19.11. Retrieving Files from TapeThe following procedure should be executed once every working day to retrieve files from thearchive tapes.1.Login as yourself (assuming you are a wheel or operator; otherwise login as SYSTEM) and gothrough this dialogue:@ENABLE password !BSYS TENEX BSYS 4.03 23-MAY-75*RETRIEVE (ARCHIVED FILES) Process retrieval requests for all users? Yes 2.BSYS now sorts through all pending retrieval requests and tells you which tapes to mount:Mount Parc tape number nnnEnter backup device (mtan:, dpkn:) MTAn Density (n=800, p=1600) P[Following question asked only the first time]Listing to file: TTY: 3.BSYS automatically restores all requested files from the mounted tapes, and automaticallynotifies users via SNDMSG. When BSYS is done, it prints an asterisk.If anything goes wrong during the retrieval process, it is possible to retrieve files from the secondarchive tape. You may first have to issue an Interrogate command for the files that were notretrieved from the first tape. Then run BSYS Retrieve in the normal way, but when it asks you tomount the first archive tape, mount the second one instead. BSYS will tell you that you mountedthe wrong tape, but will go ahead anyway, if you tell it to. (Second archive tapes not found in tapecabinets are stored in boxes in the Maxc machine room behind Maxc1 disk drives.) fpi:qX Fp _s P ]K^ [5' YP RrX" OsS M JG2S H|E 8DiE XC@QBQC@Au??S?,?S~?=**==-=~= :n2Y651$)4513g#33g1./{/z%/ ,_2: *E '#O %XT #U !I ?u .Os =J$ TIMESROMAN  TIMESROMAN  TIMESROMAN  TIMESROMAN  TIMESROMAN TIMESROMAN  TIMESROMAN $*2:AGj/J HJMaxcOps19.bravoRWeaverNovember 25, 1980 1:34 PM