home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / docs / howto / installKernels < prev    next >
Encoding:
Text File  |  1992-12-14  |  2.6 KB  |  73 lines
  1. This is a first pass at a description of how to install a new kernel.  Feel
  2. free to add to it and make corrections as needed.
  3.  
  4. 1) find out what files are checked out, if any, and make sure they're
  5. checked in:
  6.  
  7. % cd /sprite/src/kernel
  8. % ~sprite/cmds.gen/listRcsinfo `cat Modules` /sprite/src/lib/include
  9.  
  10. 1a) make sure the dependencies are up to date:
  11.  
  12. % pmake dependall
  13.  
  14. 2) install all the headers:
  15.  
  16. % pmake installhdrsall
  17. % (cd /sprite/src/lib/include; pmake install)
  18.  
  19. 3) *for each machine type*, recompile all the kernel directories:
  20.  
  21. % pmake TM=... clean
  22. % pmake TM=...
  23.  
  24. 4) install all the modules:
  25.  
  26. Move the existing .new kernels out of the way if you want to keep them.
  27. If they are to be kept you should move the "sprite" kernel to "old",
  28. and the "new" kernel to "sprite".  This should be done in /tftpboot
  29. on ginger also.
  30.  
  31. % pmake TM=... install
  32.  
  33. 5) make kernels in your own directory for each machine type, and test them
  34. on as many machine types as possible, especially machines with disks.
  35. To clean up space in /sprite/src/kernel/sprite, remove old kernels that are not
  36. booted on any machine, nor are a default kernel.  The command "oldkernels"
  37. (in /local/cmds) will tell you what old kernels may be removed.
  38. Once a kernel version has been removed its source snapshot can be deleted.
  39. Snapshots are stored in /sprite/src/kernel/Installed.
  40.  
  41.  
  42. 6) make kernels in /sprite/src/kernel/sprite and test them.  make sure
  43. the version number is incremented only for the first compile.  for
  44. example:
  45.  
  46. % pmake ds3100
  47. % pmake NEWVERSION=FALSE sun4
  48. % pmake NEWVERSION=FALSE sun4c
  49. % pmake NEWVERSION=FALSE sun3
  50.  
  51. 7) update kernel/sprite/versionLog to indicate what is different about
  52. the new kernel.  
  53.  
  54. 8) update the notes on the servers' consoles if necessary to say what kernel
  55. should be booted and where the debuggable copies exist.  Updating the notes
  56. on the servers also means checking that there aren't old misleading notes
  57. still on the consoles.
  58.  
  59. 10) Make sure the kernels get copied to ginger for debugging.  Kernels are
  60. kept in /home/ginger/sprite/kernels.  Copies of the kernels should also
  61. be placed in /allspiceA and /assaultA.
  62.  
  63. If space on /home/ginger/sprite is tight (as it usually is), you can
  64. free up 15-20 MB by deleting the source snapshot for an old or broken
  65. kernel.  The snapshots are rdist'd every night from
  66. /sprite/src/kernel/Installed to
  67. /home/ginger/sprite/backup/src/kernel/Installed.  To keep the snapshot
  68. from reappearing, you must either remove it from
  69. /sprite/src/kernel/Installed, or you can add it to the KERNEL_EXCEPT
  70. list in /sprite/admin/distfile.
  71.  
  72. [last revised: $Date: 91/04/08 16:10:10 $]
  73.