-README file for creating Moira
+README file for building Moira (R)
-This is the root directory of MIT Project Athena's Moira service
-management system source code.
-
-The Makefiles are set up so that the source tree can be
-separate from the tree(s) containing binaries. We have
-found this useful since we have to have separate sets of binaries,
-for the IBM RTPC and Vaxstation II machines.
-
-The default value of the root of the Moira source tree
-(this directory) is /mit/moiradev/src. You can set it
-to something else by specifying, for example, "make SRCDIR=/x/y/z"
-if you want the source in /x/y/z.
+This is the root directory of MIT Athena's Moira service management
+system source code.
Here are the steps for building the Moira source.
-1. Create a directory to hold the tree of object files,
- say it's /foo/bar/baz.
-
-2. Cd to that directory and run the command:
-
- make -f /x/y/z/util/makeconfig SRCDIR=/x/y/z
-
- where /x/y/z is the root of the source tree (not necessary
- if the root is /mit/moiradev/src). This creates the necessary
- directories and copies Makefiles into them.
-
-3. Cd to util/imake.includes. Read through config.Imakefile, turning
- on appropriate flags for your installation. Change SRCTOP appropriately.
-
-4. Still in the top of the object directory (/foo/bar/baz
- of Step 1), type "make world" (or "make world SRCDIR=/x/y/z).
-
-5. Run "make install". You may want to check that programs
+1. If you want to build in the directory with the sources, run
+ ./configure
+ in that directory. If you want to build in another directory, run
+ /path/to/moira/sources/configure
+ from that directory. Note that for this to work you will need to
+ be using a "make" program that supports VPATH.
+
+ Some options you might want to use:
+ --with-com_err=PREFIX (defaults to util/et)
+ --with-krb4=PREFIX (required)
+ --with-hesiod=PREFIX
+ --with-zephyr=PREFIX
+ --with-oracle=PREFIX (defaults to $ORACLE_HOME, if present)
+ --with-afs=PREFIX (defaults to /usr/afsws, if present)
+ --with-readline=PREFIX
+
+ (When building Moira on Athena, you should use the Athena source
+ tree config.site file, either by doing
+ setenv CONFIG_SITE /mit/source/packs/build/config.site
+ before running configure, or by using the Athena build system
+ script /mit/source/packs/build/do.sh.)
+
+2. cd to include. Read through moira_site.h adjusting the paths to
+ what you want on your system. Also change the #define of
+ MOIRA_SERVER to be the name of the server you are planning on
+ using. (Note that this is only used if hesiod lookup fails.)
+
+3. After configuring, run "make" to build everything. The server-side
+ programs will be built if Oracle was found by configure.
+
+4. Run "make install". You may want to check that programs
are installed where you want. Then add the appropriate
directories to your PATH environment variable.
+
+* Moira and Hesiod are registered trademarks of the Massachusetts
+Institute of Technology (MIT). Kerberos, and Zephyr are trademarks of
+MIT. No commercial use of these trademarks may be made without prior
+written permission from MIT.