| 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 | If you just use the default setup, it will generate packages |
|---|
| 12 | in /usr/src/redhat. |
|---|
| 13 | |
|---|
| 14 | * Use the Makefile to build the scripts.mit.edu-specific Fedora |
|---|
| 15 | packages. |
|---|
| 16 | - export PATH=$PATH:/usr/sbin |
|---|
| 17 | - make download |
|---|
| 18 | - make setup |
|---|
| 19 | - make all |
|---|
| 20 | - openafs-devel is a build-dependency of accountadm, so you'll need to |
|---|
| 21 | install it by hand when that fails. |
|---|
| 22 | Then install all the packages as root. |
|---|
| 23 | |
|---|
| 24 | * Rebuild mit-zephyr on a 32-bit machine, like the one at Joe's home. |
|---|
| 25 | |
|---|
| 26 | * Run "make suexec" and "make suexec-install" to overwrite |
|---|
| 27 | /usr/sbin/suexec with one that works. The one installed by the |
|---|
| 28 | newly-built Apache RPM is misconfigured. |
|---|
| 29 | |
|---|
| 30 | * Check out the scripts /etc configuration, which is done most easily by |
|---|
| 31 | - svn co https://scripts.mit.edu:1111/server/fedora/config/etc |
|---|
| 32 | - \cp -a etc / |
|---|
| 33 | |
|---|
| 34 | * Copy over root's dotfiles. Note that this sets the umask to 077, so you |
|---|
| 35 | should do 'umask 022' when installing things that aren't secret keys. |
|---|
| 36 | |
|---|
| 37 | * Install various dependencies of the scripts system, including syslog-ng, |
|---|
| 38 | glibc-devel.i386, python-twisted-core, mod_fcgid, nrpe, nagios-plugins-all. |
|---|
| 39 | |
|---|
| 40 | * Disable SELinux and NetworkManager. |
|---|
| 41 | |
|---|
| 42 | * Figure out why Zephyr isn't working and why the openafs /usr/vice/etc <-> |
|---|
| 43 | /etc/openafs mapping isn't in sync. |
|---|
| 44 | |
|---|
| 45 | * Install the full list of RPMs that users expect to be on the |
|---|
| 46 | scripts.mit.edu servers. See server/doc/rpm and |
|---|
| 47 | server/doc/rpm_snapshot. (Note that this is only a snapshot, and not |
|---|
| 48 | all packages may in fact be in use.) |
|---|
| 49 | |
|---|
| 50 | * Install the full list of perl modules that users expect to be on the |
|---|
| 51 | scripts.mit.edu servers. See server/doc/perl and |
|---|
| 52 | server/doc/perl_snapshot. |
|---|
| 53 | |
|---|
| 54 | * Install rails (versions 1.1.6 and 1.2.2). |
|---|
| 55 | |
|---|
| 56 | * Install the Python eggs and Ruby gems that are on the other scripts.mit.edu |
|---|
| 57 | servers and do not have RPMs. |
|---|
| 58 | |
|---|
| 59 | * Install the credentials (machine keytab, daemon.scripts keytab, SSL |
|---|
| 60 | certs). |
|---|
| 61 | |
|---|
| 62 | * Attempt to check out server/fedora/config/etc into /etc. This involves |
|---|
| 63 | individually renaming directories out of the way, copying over any |
|---|
| 64 | configuration files from SVN (and the .svn directory), and moving the |
|---|
| 65 | original directory back. |
|---|
| 66 | |
|---|
| 67 | - Configure Apache. |
|---|
| 68 | |
|---|
| 69 | - Try not to misconfigure PAM or SSH in the process. |
|---|
| 70 | |
|---|
| 71 | - If you are setting up a test server, pay attention to |
|---|
| 72 | /etc/sysconfig/network-scripts and do not bind scripts' IP address. |
|---|
| 73 | You will also need to modify /etc/ldap.conf and |
|---|
| 74 | /etc/httpd/conf.d/vhost_ldap.conf to use scripts.mit.edu instead of |
|---|
| 75 | localhost. |
|---|
| 76 | |
|---|
| 77 | * Install fedora-ds-base and set up replication (see /mit/scripts/doc). |
|---|
| 78 | |
|---|
| 79 | * Run fmtutil-sys --all, which does something that makes TeX work. |
|---|
| 80 | |
|---|
| 81 | * (Optional) Beat your head against a wall. |
|---|
| 82 | |
|---|
| 83 | * I recommend setting noatime for the root filesystem in /etc/fstab. |
|---|
| 84 | |
|---|
| 85 | * Possibly perform other steps that I've neglected to put in this |
|---|
| 86 | document. |
|---|
