home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume25 / QBATCH / part03 / INSTALL < prev   
Text File  |  1991-11-04  |  5KB  |  102 lines
  1.  
  2.     QBATCH Version 2.0 Installation notes and bewares
  3.  
  4.     The QBATCH system and its related programs were
  5.     written by Alan D. Saunders and are
  6.     Copyright (c) Vita Services Ltd. 1990 and
  7.     Copyright (c) Vita Fibres Ltd. 1991
  8.  
  9.     PLEASE read the NOTICE file for details.
  10.  
  11. FIRST READ ALL OF THE TEXT FILES IN THIS DIRECTORY!!! Then read those in the
  12. 'doc' directory. Then you will know what QBATCH is, and the conditions you
  13. are deemed to have accepted by compiling, installing, and using it.
  14.  
  15. Especially read the file doc/chap.09 (security). Some of the concepts outlined
  16. here may be overruled by it's contents.
  17.  
  18. Once you are satisfied, change directory to the src directory, and have
  19. a look at config.h.  You should find configuration options available
  20. which are supported by your system.  If not, there should be enough
  21. information contained therein to allow you to add further options if
  22. you both feel it necessary, and are capable.  Define the configuration
  23. for your platform by commenting out those options which are not
  24. supported, and uncommenting those (one in each group) which are.
  25.  
  26. Then look at the Makefile, and ensure that BINDIR is set to where you
  27. want the binaries installed, and that MANDIR is where you want the
  28. manual pages. Also check to see  if the defined paths for SPOOLPATH
  29. and QUEUEPATH are satisfactory for your system.  QUEUEPATH is where the
  30. actual queue files themselves go. The directory must exist. It must be
  31. world searchable, but should only be root writeable.  SPOOLPATH is
  32. where the batch files are created, again, the world should be able to
  33. look at the contents of these files (jcl and monitors), but only root
  34. should be able to create and delete them.
  35.  
  36. Now, if you are not your systems administrator, you are at his (or her)
  37. mercy.  Certain of the QBATCH programs need to be able to set user and
  38. group id's so they must be owned by root, and setuid. The Makefile
  39. assumes that the person running make, is actually root, and changes
  40. file modes accordingly.  Some of the programs simply will not work
  41. properly if they don't have the right modes and/or are not owned by
  42. root.
  43.  
  44. Try 'make' and see if there are any errors.  If you can resolve them,
  45. do so, BUT LET ME KNOW!!, I will include fixes, and or release patches
  46. as needed.
  47.  
  48. If you get a clean compilation, but are not logged in as root, remove
  49. the executables, and call your sysadmin to re-make as root.
  50.  
  51. Make the directories defined in QBATCH.h as SPOOLPATH and QUEUEPATH, and
  52. ensure they have the correct permissions.
  53.  
  54. If there are environment variables defined for users which are
  55. meaningless in a batch context (or harmful) create a file '.qxenv' in
  56. QUEUEPATH containing a list (one per line) of those environment
  57. variables to be EXCLUDED from batch jobs. Ensure it is readable
  58. (only) by root.
  59.  
  60. If you are going to implement fixed context queues, create a file in
  61. QUEUEPATH called '.<queuename>rc' setting up the context and environment
  62. for the jobs, for each queue created using the -f option of qc.  (see
  63. the man page for qc).
  64.  
  65. Then make install, create some queues,  and try it out.
  66.  
  67. BEWAREs
  68.  
  69. QBATCH is only as good as the scripts it is running.  It has been
  70. running now for a year on several sparcstations and servers, and the
  71. only problems we have encountered have been on file permissions, where
  72. files have been created in the foreground in a setuid script(??), and
  73. the batch job has tried to delete those files
  74. .... The batch job unless running in a fixed context queue with #QCONTEXT
  75. specified in the .<queuename>rc file, runs under the user's real uid!
  76. In these cases, the script hangs until someone types something on the
  77. system console.
  78.  
  79. Job control. I am aware that some systems do not support this (alright
  80. call me a liar!) Job control is only used in QBATCH, to group together
  81. any children which may be forked by a running job.  This is so that a
  82. signal (SIGSTOP, SIGCONT, and SIGKILL) sent to the pid of a running
  83. job, is actually propagated through it's children.  Unless you can find
  84. a way round this, if you need to do such a thing, you'll have to
  85. examine the 'ps' output to identify the children if any, and kill them
  86. by hand. (the job itself of course will receive the original signal).
  87.  
  88. truncate(), ftruncate(). Some systems don't support this either. It
  89. won't do any damage to QBATCH to leave it out, it's only there for
  90. tidiness' sake.  The queue files will grow as jobs are added, and
  91. shrink as they are processed or canceled.  Truncate is used to ensure
  92. that unused trailing space in a queue file is returned to the system.
  93. If you don't have it, and can't emulate it, You'll have to live with
  94. it.  If it becomes a problem, you'll have to periodically tidy up
  95. manually.
  96.  
  97. Enjoy ... Alan Saunders August 30 1991
  98.  
  99. If you do come across any problems, with security or anything else
  100. relating to QBATCH, please contact me, as I hope you will if you design
  101. any enhancements or bug fixes.
  102.