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 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, and setting the paths
  31     to your include files, libs, etc for Kerberos Hesiod and Zephyr.*
  32     Note that we are not licensed to distribute gdss, so it is not
  33     included in this distribution.  Therefore you will probably not
  34     want to define it.  Change SRCTOP appropriately.
  35
  36 4.  Cd to include.  Read through moira_site.h adjusting the paths to
  37     what you want on your system.  Also change the #define of
  38     MOIRA_SERVER to be the name of the server you are planning on
  39     using.
  40
  41 5.  Still in the top of the object directory (/foo/bar/baz
  42     of Step 1), type "make world" (or "make world  SRCDIR=/x/y/z).
  43
  44     Note: the mmoira client uses X11r4 and motif 1.1.
  45
  46     Notes on building the server: When building the server (if you are
  47     using Ingres) make sure to define the environment variable
  48     II_SYSTEM appropriately, and add the ingres/bin directory to your
  49     path.  Building the server also requires having perl in your path.
  50     It is only used in one place, in order to get around an ingres
  51     bug that sets certain field sizes incorrectly when doing an ascii
  52     dump of the database, causing data to be lost.  The perl script is
  53     src/backup/esql_fix.pl.
  54
  55 6.  Run "make install".  You may want to check that programs
  56     are installed where you want.  Then add the appropriate
  57     directories to your PATH environment variable.
  58
  59 * Moira and Hesiod are registered trademarks of the Massachusetts
  60 Institute of Technology (MIT).  Kerberos, and Zephyr are trademarks of
  61 MIT.  No commercial use of these trademarks may be made without prior
  62 written permission from MIT.