source: server/doc/install-howto @ 788

Last change on this file since 788 was 788, checked in by geofft, 14 years ago
More install instructions, and Makefile fixes from myself and Quentin.
File size: 2.7 KB
Line 
1This document is a how-to for installing a Fedora scripts.mit.edu server.
2
3* Check out the scripts.mit.edu svn repository. Configure svn not to cache
4  credentials.
5
6* cd to server/fedora in the svn repository.
7
8* Run "make install-deps" to install various prereqs.
9
10* Create a scripts-build account, and set up rpm to build in $HOME.
11  Or you can just use the default setup, which will generate packages
12  in /usr/src/redhat.
13
14* Use the Makefile to build the scripts.mit.edu-specific Fedora
15  packages.
16  - make download
17  - make setup
18  - make all
19  - openafs-devel is a build-dependency of accountadm, so you'll need to
20    install it by hand.
21  Then install all the packages as root.
22
23* Run "make suexec" and "make suexec-install" to overwrite
24  /usr/sbin/suexec with one that works. The one installed by the
25  newly-built Apache RPM is misconfigured.
26
27* Check out the scripts /etc configuration, which is done most easily by
28  - svn co http://scripts.mit.edu:1111/server/fedora/config/etc
29  - \cp -a etc /
30
31* Install various dependencies of the scripts system, including syslog-ng,
32  glibc-devel.i386, python-twisted-core, and mod_fcgid.
33
34* Disable SELinux and NetworkManager.
35
36* Figure out why Zephyr isn't working and why the openafs /usr/vice/etc <->
37  /etc/openafs mapping isn't in sync.
38
39* Install the full list of RPMs that users expect to be on the
40  scripts.mit.edu servers.  See server/doc/rpm and
41  server/doc/rpm_snapshot.  (Note that this is only a snapshot, and not
42  all packages may in fact be in use.)
43
44* Install the full list of perl modules that users expect to be on the
45  scripts.mit.edu servers.  See server/doc/perl and
46  server/doc/perl_snapshot.
47
48* Install rails (versions 1.1.6 and 1.2.2).
49
50* Install the Python eggs and Ruby gems that are on the other scripts.mit.edu
51  servers and do not have RPMs.
52
53* Install the credentials (machine keytab, daemon.scripts keytab, SSL
54  certs).
55
56* Attempt to check out server/fedora/config/etc into /etc. This involves
57  individually renaming directories out of the way, copying over any
58  configuration files from SVN (and the .svn directory), and moving the
59  original directory back.
60
61  - Configure Apache.
62
63  - Try not to misconfigure PAM or SSH in the process.
64
65  - If you are setting up a test server, pay attention to
66  /etc/sysconfig/network-scripts and do not bind scripts' IP address.
67  You will also need to modify /etc/ldap.conf and
68  /etc/httpd/conf.d/vhost_ldap.conf to use scripts.mit.edu instead of
69  localhost.
70
71* Install fedora-ds-base and set up replication (see /mit/scripts/doc).
72
73* (Optional) Beat your head against a wall.
74
75* I recommend setting noatime for the root filesystem in /etc/fstab.
76
77* Possibly perform other steps that I've neglected to put in this
78  document.
Note: See TracBrowser for help on using the repository browser.