README

   1 README file for creating Moira*
   2
   3 This is the root directory of MIT Athena's Moira service management
   4 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 different platforms.
  10
  11 Here are the steps for building the Moira source.
  12
  13 1.  Create a directory to hold the tree of object files,
  14     say it's /foo/bar/baz.
  15
  16 2.  Cd to that directory and run the command:
  17
  18         make -f /x/y/z/util/makeconfig SRCDIR=/x/y/z
  19
  20     where /x/y/z is the root of the source tree (not necessary
  21     if the root is /mit/moiradev/src).  This creates the necessary
  22     directories and copies Makefiles into them.
  23
  24 3.  Cd to util/imake.includes.  Read through config.Imakefile, turning
  25     on appropriate flags for your installation, and setting the paths
  26     to your include files, libs, etc for Kerberos, Hesiod and Zephyr.*
  27     Note that we are not licensed to distribute gdss, so it is not
  28     included in this distribution.  Therefore you will probably not
  29     want to define it.
  30
  31     If you are building the server binaries, uncomment the #define
  32     SVRBUILD line, and make sure you have ORACLE_HOME set in your
  33     environment.
  34
  35 4.  Cd to include.  Read through moira_site.h adjusting the paths to
  36     what you want on your system.  Also change the #define of
  37     MOIRA_SERVER to be the name of the server you are planning on
  38     using. (Note that this is only used if hesiod lookup fails.)
  39
  40 5.  Still in the top of the object directory (/foo/bar/baz
  41     of Step 1), type "make world"
  42
  43 6.  Run "make install".  You may want to check that programs
  44     are installed where you want.  Then add the appropriate
  45     directories to your PATH environment variable.
  46
  47 * Moira and Hesiod are registered trademarks of the Massachusetts
  48 Institute of Technology (MIT).  Kerberos, and Zephyr are trademarks of
  49 MIT.  No commercial use of these trademarks may be made without prior
  50 written permission from MIT.