source: server/doc/install-howto @ 788

Last change on this file since 788 was 788, checked in by geofft, 16 years ago
More install instructions, and Makefile fixes from myself and Quentin.
File size: 2.7 KB
RevLine 
[371]1This document is a how-to for installing a Fedora scripts.mit.edu server.
[181]2
[788]3* Check out the scripts.mit.edu svn repository. Configure svn not to cache
4  credentials.
[387]5
6* cd to server/fedora in the svn repository.
7
8* Run "make install-deps" to install various prereqs.
9
[785]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
[387]14* Use the Makefile to build the scripts.mit.edu-specific Fedora
15  packages.
[785]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.
[387]22
[562]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
[788]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
[387]39* Install the full list of RPMs that users expect to be on the
40  scripts.mit.edu servers.  See server/doc/rpm and
[562]41  server/doc/rpm_snapshot.  (Note that this is only a snapshot, and not
42  all packages may in fact be in use.)
[387]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
[785]50* Install the Python eggs and Ruby gems that are on the other scripts.mit.edu
51  servers and do not have RPMs.
52
[387]53* Install the credentials (machine keytab, daemon.scripts keytab, SSL
54  certs).
55
[562]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.
[387]60
[562]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
[785]71* Install fedora-ds-base and set up replication (see /mit/scripts/doc).
72
[562]73* (Optional) Beat your head against a wall.
74
[387]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.