README

   1 README file for creating Moira
   2
   3 This is the root directory of MIT Project Athena's Moira service
   4 management system source code.
   5
   6 The Makefiles are set up so that the source tree can be
   7 separate from the tree(s) containing binaries.  We have
   8 found this useful since we have to have separate sets of binaries,
   9 for the IBM RTPC and Vaxstation II machines.
  10
  11 The default value of the root of the Moira source tree
  12 (this directory) is /mit/moiradev/src.  You can set it
  13 to something else by specifying, for example, "make SRCDIR=/x/y/z"
  14 if you want the source in /x/y/z.
  15
  16 Here are the steps for building the Moira source.
  17
  18 1.  Create a directory to hold the tree of object files,
  19     say it's /foo/bar/baz.
  20
  21 2.  Cd to that directory and run the command:
  22
  23         make -f /x/y/z/util/makeconfig SRCDIR=/x/y/z
  24
  25     where /x/y/z is the root of the source tree (not necessary
  26     if the root is /mit/moiradev/src).  This creates the necessary
  27     directories and copies Makefiles into them.
  28
  29 3.  Cd to util/imake.includes.  Read through config.Imakefile, turning
  30     on appropriate flags for your installation.  Change SRCTOP appropriately.
  31
  32 4.  Still in the top of the object directory (/foo/bar/baz
  33     of Step 1), type "make world" (or "make world  SRCDIR=/x/y/z).
  34
  35 5.  Run "make install".  You may want to check that programs
  36     are installed where you want.  Then add the appropriate
  37     directories to your PATH environment variable.