source: server/doc/install-howto @ 803

Last change on this file since 803 was 803, checked in by geofft, 16 years ago
More steps yay
File size: 3.0 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.
[796]11  If you just use the default setup, it will generate packages
[785]12  in /usr/src/redhat.
13
[387]14* Use the Makefile to build the scripts.mit.edu-specific Fedora
15  packages.
[796]16  - export PATH=$PATH:/usr/sbin
[785]17  - make download
18  - make setup
19  - make all
20  - openafs-devel is a build-dependency of accountadm, so you'll need to
[796]21    install it by hand when that fails.
[785]22  Then install all the packages as root.
[387]23
[796]24* Rebuild mit-zephyr on a 32-bit machine, like the one at Joe's home.
25
[562]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
[788]30* Check out the scripts /etc configuration, which is done most easily by
[797]31  - svn co https://scripts.mit.edu:1111/server/fedora/config/etc
[788]32  - \cp -a etc /
33
[803]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
[788]37* Install various dependencies of the scripts system, including syslog-ng,
[798]38  glibc-devel.i386, python-twisted-core, mod_fcgid, nrpe, nagios-plugins-all.
[788]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
[387]45* Install the full list of RPMs that users expect to be on the
46  scripts.mit.edu servers.  See server/doc/rpm and
[562]47  server/doc/rpm_snapshot.  (Note that this is only a snapshot, and not
48  all packages may in fact be in use.)
[387]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
[785]56* Install the Python eggs and Ruby gems that are on the other scripts.mit.edu
57  servers and do not have RPMs.
58
[387]59* Install the credentials (machine keytab, daemon.scripts keytab, SSL
60  certs).
61
[562]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.
[387]66
[562]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
[785]77* Install fedora-ds-base and set up replication (see /mit/scripts/doc).
78
[803]79* Run fmtutil-sys --all, which does something that makes TeX work.
80
[562]81* (Optional) Beat your head against a wall.
82
[387]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.
Note: See TracBrowser for help on using the repository browser.