]>
Commit | Line | Data |
---|---|---|
f0a43ad7 | 1 | README file for creating Moira* |
bc4d8d41 | 2 | |
876c836f | 3 | This is the root directory of MIT Athena's Moira service management |
4 | system source code. | |
bc4d8d41 | 5 | |
fca46725 | 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, | |
876c836f | 9 | for different platforms. |
bc4d8d41 | 10 | |
fca46725 | 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. | |
bc4d8d41 | 15 | |
fca46725 | 16 | Here are the steps for building the Moira source. |
bc4d8d41 | 17 | |
fca46725 | 18 | 1. Create a directory to hold the tree of object files, |
19 | say it's /foo/bar/baz. | |
bc4d8d41 | 20 | |
fca46725 | 21 | 2. Cd to that directory and run the command: |
bc4d8d41 | 22 | |
fca46725 | 23 | make -f /x/y/z/util/makeconfig SRCDIR=/x/y/z |
bc4d8d41 | 24 | |
fca46725 | 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. | |
bc4d8d41 | 28 | |
fca46725 | 29 | 3. Cd to util/imake.includes. Read through config.Imakefile, turning |
f0a43ad7 | 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 | |
fca46725 | 42 | of Step 1), type "make world" (or "make world SRCDIR=/x/y/z). |
bc4d8d41 | 43 | |
f0a43ad7 | 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 | |
fca46725 | 56 | are installed where you want. Then add the appropriate |
57 | directories to your PATH environment variable. | |
f0a43ad7 | 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. |