| 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. | 
|---|
| 35 |  | 
|---|
| 36 | * Install various dependencies of the scripts system, including syslog-ng, | 
|---|
| 37 | glibc-devel.i386, python-twisted-core, mod_fcgid, nrpe, nagios-plugins-all. | 
|---|
| 38 |  | 
|---|
| 39 | * Disable SELinux and NetworkManager. | 
|---|
| 40 |  | 
|---|
| 41 | * Figure out why Zephyr isn't working and why the openafs /usr/vice/etc <-> | 
|---|
| 42 | /etc/openafs mapping isn't in sync. | 
|---|
| 43 |  | 
|---|
| 44 | * Install the full list of RPMs that users expect to be on the | 
|---|
| 45 | scripts.mit.edu servers.  See server/doc/rpm and | 
|---|
| 46 | server/doc/rpm_snapshot.  (Note that this is only a snapshot, and not | 
|---|
| 47 | all packages may in fact be in use.) | 
|---|
| 48 |  | 
|---|
| 49 | * Install the full list of perl modules that users expect to be on the | 
|---|
| 50 | scripts.mit.edu servers.  See server/doc/perl and | 
|---|
| 51 | server/doc/perl_snapshot. | 
|---|
| 52 |  | 
|---|
| 53 | - Run 'cpan', accept the default configuration, and do 'o conf | 
|---|
| 54 | prerequisites_policy follow'. | 
|---|
| 55 | - Copy the autobundle file into /root/.cpan/Bundle, and run | 
|---|
| 56 | perl -MCPAN -e 'notest install Bundle::Snapshot_...' in a screen. | 
|---|
| 57 |  | 
|---|
| 58 | * Install rails (versions 1.1.6 and 1.2.2). | 
|---|
| 59 |  | 
|---|
| 60 | * Install the Python eggs and Ruby gems and PEAR/PECL doohickeys that are on | 
|---|
| 61 | the other scripts.mit.edu servers and do not have RPMs. | 
|---|
| 62 |  | 
|---|
| 63 | * echo 'import site, os.path; site.addsitedir(os.path.expanduser("~/lib/python2.5/site-packages"))' > /usr/lib/python2.5/site-packages/00scripts-home.pth | 
|---|
| 64 |  | 
|---|
| 65 | * Install the credentials (machine keytab, daemon.scripts keytab, SSL | 
|---|
| 66 | certs). | 
|---|
| 67 |  | 
|---|
| 68 | * Attempt to check out server/fedora/config/etc into /etc. The easiest way to | 
|---|
| 69 | do this is to create a checkout of etc in another directory and mv -f this on | 
|---|
| 70 | top of /etc. | 
|---|
| 71 |  | 
|---|
| 72 | - If you are setting up a test server, pay attention to | 
|---|
| 73 | /etc/sysconfig/network-scripts and do not bind scripts' IP address. | 
|---|
| 74 | You will also need to modify /etc/ldap.conf, /etc/openldap/ldap.conf, and | 
|---|
| 75 | /etc/httpd/conf.d/vhost_ldap.conf to use scripts.mit.edu instead of | 
|---|
| 76 | localhost. | 
|---|
| 77 |  | 
|---|
| 78 | * Install fedora-ds-base and set up replication (see /mit/scripts/doc | 
|---|
| 79 | and /mit/geofft/Public/fedora-ds-enable-ssl-and-kerberos.diff). | 
|---|
| 80 |  | 
|---|
| 81 | * Run fmtutil-sys --all, which does something that makes TeX work. | 
|---|
| 82 |  | 
|---|
| 83 | * (Optional) Beat your head against a wall. | 
|---|
| 84 |  | 
|---|
| 85 | * I recommend setting noatime for the root filesystem in /etc/fstab. | 
|---|
| 86 |  | 
|---|
| 87 | * Possibly perform other steps that I've neglected to put in this | 
|---|
| 88 | document. | 
|---|