


                                  - 1 -



                        System Turnlog / Checklist

       Pascal 3.2 QA Version ____     Engr:________   Date:_______


                       COMMENTS:
                  Note: "RCS host" currently refers to hpfclw.

         1.  Print out turn log by executing the following on
             hpfclw:
             cd /src/paws/doc; co turnlog.mm; mm turnlog.mm | lp

         2.  Ensure 7946 contents. If not confident that the disc
             has only "good" files on it, then back up present disc
             contents to scratch tape and restore disc from
             previous Rev. master tape.  If you are restoring from
             a tape made by BACKUP, then do an OSINSTALL of
             SYSTEM_P.  (The scratch tape can be restored if the
             previous master failed to load in correctly--if so,
             you're on your own!)

         3.  Run "/src/paws/bin/checkempty" to make sure that
             directories under /src/paws/src on the RCS host system
             are "clean"--there should be nothing in them except
             the RCS directories and any subdirectories. Remove any
             "checked out" files lying around in the trees under
             /src/paws/src.  Ensure no sources are currently locked
             in the trees under /src/paws/src.

         4.  Boot HP-UX on the turn system.

         5.  Mount a scratch monkey.

         6.  Run /src/paws/bin/rcs2pws -a on RCS host to copy all
             files from under RCS.

         7.  Make sure there were no errors during rcs2pws. Check
             the logfile on RCS host in directory /src/paws/log.
             The file name is cptosrm.XXXYY (XXX=month, YY=day).
             To copy any missed files: cd to HP-UX directory above
             RCS, then if the filename ends in ".c" or ".h" do "co
             -p file >/net/pawsturn/source/dirname/file.TEXT" else
             do "co -p file | expand
             >/net/pawsturn/source/dirname/file.TEXT".

         8.  Boot the turn system from the 7946 with the previous
             QA Revision of PAWS by logging in as user "bootpws".
             Check the date and time with the Version command.

         9.  Run HPROGS:HFSCK on the turn disc (7946). If HFSCK
             fails to rebuild the 7946, PLOAD TABLE, run MKHFS,











                                  - 2 -



             then TABLE, then restore the previous rev full BACKUP.
             Go back to the "Run rcs2pws" step.

        10.  Do a "FILER Volumes" command to check that the system
             volume is MYSYS:.  Default volume can be anywhere.

             NOTE: source files on the turn disc are all in .UX
             format, even though most suffixes are .TEXT. It is
             necessary for them to stay in this format, or else the
             pws2rcs stage will not work correctly.

        11.  Stream  *NEWREVS. FILER version no longer needs to be
             fixed by hand.

             Prompt                                  Sample response
             ====================================    ================
             revno                                   3.2C
             month of revision date (numeric)        5
             day of revision date (numeric)          17
             year of revision date (numeric)         85
             month of revision date (alphabetic)     Aug

        12.  Stream OSFS:TURNIT

             Prompt: Have you updated revision numbers (Editor,
             Filer, Libr, Mediainit, Tapebkup)?
             Respond:ENTER key if you have done so or are not going
             to do so; CLR I/O if you forgot to--do the updates,
             then stream *TURNIT again.

             Prompt: Rev.  N.N  DD-Mmm-YY  Input version (20 chars)
             Respond:Rev.  3.1C  5-Apr-85    <<for example>>

             If TURNIT fails part way through, it is permissible to
             fix what went wrong, and chop the front end off TURNIT
             and continue the turn with the new shortened
             streamfile. Call the shortened streamfile
             OSFS:JUNK.TEXT, and remove when the turn completes.
             It is up to you to make sure you're doing this right,
             otherwise restart TURNIT from the beginning.

             If anything going into SYSTEM_P has changed, check
             linkmap (file *LINKMAP--you can find /LINK MAP/ in
             TURNIT, to see what and how to change), to be sure
             RBASE for the boot file is set low enough.  If not,
             edit TURNIT to lower RBASE and restream BEFORE doing
             CHANGESYS. You might want to stop TURNIT after it
             builds SYSTEM_P, but before it finishes, to speed this
             step up.  The criterion for proper RBASE is that RBASE
             + size(SYSTEM_P code) <= FFFFF9A4.












                                  - 3 -



        13.  Stream COMP1:TURNCOMP. Respond to prompts as for
             *NEWREVS.

        14.  Stream ASSM:TURNASSM. Respond to prompts as for
             *NEWREVS.

        15.  Stream PCLIB:TURNCLIB.

        16.  Stream CCOMP:TURNCCOMP.

        17.  Stream HPROGS:TURNEM.  Respond to prompts as for
             *NEWREVS.

        18.  Run *TAPEBKUP and copy the 7946 to TAPE #1 (scratch
             600' tape), verifying copy when done.

        19.  Stream *CHANGESYS

        20.  Reboot from 7946.

        21.  Use HPROGS:HFSCK to check the turn disc.

        22.  Stream OSFS:TURNIT. Prompts etc as for step 7.

             If TURNIT fails part way through, it is best to
             restart TURNIT from the beginning, as this run through
             creates the FINAL system!

        23.  Stream COMP1:TURNCOMP if COMPILER was modified for
             this Rev.  Respond to prompts as for *NEWREVS.

        24.  Stream ASSM:TURNASSM if ASSEMBLER was modified for
             this Rev.  Respond to prompts as for *NEWREVS.

        25.  Stream PCLIB:TURNCLIB.

        26.  Stream CCOMP:TURNCCOMP.

        27.  Stream HPROGS:TURNEM.  Respond to prompts as for
             *NEWREVS.

        28.  Run *TAPEBKUP and copy the 7946 to TAPE #2 (scratch
             600' tape), verifying copy when done.

        29.  Stream *CHANGESYS

        30.  Reboot PAWS from the 7946.  Check the date and time.

        31.  Stream #5:/TOOLS/SRMCLEAN to move the new source files
             into directory /PWS_SOURCE and clean the directory
             /NEWCODE.











                                  - 4 -



        32.  Stream #5:/TOOLS/BUILDSRM to copy a running version
             onto SRM.

        33.  Boot HP-UX on the turn system.

             The next two steps can be done in parallel, because
             they are independent and run on different systems.

        34.  Run pws2rcs on RCS host to compare and checkin the
             source on the turn system with the master copy under
             RCS on RCS host.  File the log file (in /src/paws/log)
             with the turn documentation. The file name will be
             "cmplog.MMMdd" where MMM is the month and dd is the
             date. Check this for errors (use "grep -i error"
             before doing "allnewrev"!!!

        35.  From a PAWS on the SRM, stream BUILDNODE for each nn
             in /WORKSTATIONS/SYSTEMnn on the SRM.

        36.  After pws2rcs is finished on the RCS host, boot PAWS
             on the turn system from the 7946 by logging in as user
             "bootpws".

        37.  Get 17 initialized 3-1/2" micro-floppies. These should
             be formatted single-sided (format option 4 if using
             9122 or clones) with default interleave. Also get 9
             initialized double-sided.

        38.  Stream *UPGRADEBM; insert the single-sided micros as
             requested.  Stream *UPGRADEDB; insert the double-sided
             micros as requested.

             Label the micros with Revision and volume name.

        39.  Run HPROGS:BACKUP.CODE and copy the 7946 using path
             relative to "/", to a 600' tape labelled 3.2x, where x
             is the new Revision letter.

        40.  Run "/src/paws/bin/checkempty" on the RCS host to make
             sure that directories under /src/paws/src on the RCS
             host system are "clean"--there should be nothing in
             them except the RCS directories and any
             subdirectories. Remove any "checked out" files lying
             around.  Ensure no sources are currently locked.

        41.  Run /src/paws/bin/allnewrev on the RCS host to bump
             the revision number of all RCS files to 4.1 or 5.1 or
             6.1 or whatever.  This script runs in background, so
             check the log (usually in /src/paws/log) to see when
             it's complete.  Enter the log name as
             "/src/paws/log/newrev.mmmdd", where mmmdd is the











                                  - 5 -



             current month and day.  DON'T RUN allnewrev AS ROOT!
             Check the log file for errors.

        42.  File this Turnlog in the "QA" binder, and file final
             tape copy with previous revs.

        43.  Test bugfixes, etc from microfloppy version (copy
             micros to another Winchester or SRM at this stage for
             ease of test, or use the version from "BUILDSRM")

             **NOTE - We keep all master copies of tapes/discs
             (previous revisions) during QA. Always get a new tape
             for revision master, and 14 new micro-floppies for
             UPGRADEBM.  Scratch tapes #1 and #2 may be recycled.

             **NOTE - record on the Turnlog, or on a separate page
             to be filed with the Turnlog, any ad hoc measures you
             may have had to take to get the turn done (eg. editing
             TURNIT, moving files from place to place)

             Now, request timelogs from the previous rev back from
             QA users, and distribute the new rev, with timelogs,
             logging the distribution.




































