source: trunk/athena/bin/olc/DOC.server-layout @ 9909

Revision 9909, 2.0 KB checked in by ghudson, 28 years ago (diff)
From bert: A description of the layout of the server installation.
Line 
1This file describes where various things get installed and/or stashed
2temporarily on the installed server.  It was written to clarify the
3partial reorganization done in February 1997, the excuse being the
4Solaris port of the server.
5
6Wherever "ol??" appears in a directory or file name, it should be
7replaced with one of "olc", "olta" or "owl".
8
9NOTE TO FUTURE DEVELOPERS:
10   We tried to minimize the number of places where stuff gets installed.
11   If you decide to install files somewhere like
12        /var/server/I_like_putting_things_where_dont_belong,
13   then someone may come and break your fingers one day. =)
14
15*** BINARIES:
16
17/usr/athena/etc
18        OLC server binaries (olcd, rpd, lumberjack, polld, olcm)
19            [NB: the Athena release 8.1 should contain these on all platforms.]
20        Discuss server binaries (discussd, disserve)
21
22/usr/athena/bin
23        OLC client binaries (olc, olcr)
24        Discuss client binaries (dspipe)
25
26*** CONFIGURATION:
27
28/etc/athena/ol??
29        srvtab
30        database (contains titles and instance limits)
31        ds_prefix (location of the Discuss archives)
32        topics
33        motd*
34        translations (maps machtype output -> more useful description)
35        hours
36        services (I need to figure out what this is good for, if anything)
37/etc/athena/ol??/acls
38        ACLs for various OLC operations
39/etc/athena/ol??/specialties
40        ACLs for "allowed" specialties (currently, a bunch of empty files)
41/etc/athena/ol??/olcm
42        Files used by OLCM (the program that inserts mail into the OLC queue)
43
44*** QUEUE ETC.:
45
46/usr/spool/ol??
47        Database backups
48        queue        (the current queue)
49        queue.tmp    (copy of the current queue)
50        punt_zephyr  (file generated by the server if Zephyr is losing)
51/usr/spool/ol??/questions
52        Question info, logs (censored and not)
53        qlist_-1.log (historic symlink to the current queue)
54/usr/spool/ol??/donelogs
55        Done'd questions, until they are picked up by "lumberjack"
56/usr/spool/ol??/admin
57        Error logs and other output of interest to software maintainers.
58/usr/spool/ol??/stats
59        Usage statistics
60
61*** OTHER:
62
63/var/.....?
64        Ms. Rebecca P. Davis, Esq.
65
66/tmp
67        tkt_ol?? (OLC ticket file, auto-generated regularly by the server)
Note: See TracBrowser for help on using the repository browser.