| 1 | This 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. |
|---|
