source: server/doc/install-howto @ 832

Last change on this file since 832 was 832, checked in by geofft, 15 years ago
nelhage is much more awesome than CPAN.pm
File size: 3.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.
[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
[812]34* Copy over root's dotfiles.
[803]35
[788]36* Install various dependencies of the scripts system, including syslog-ng,
[798]37  glibc-devel.i386, python-twisted-core, mod_fcgid, nrpe, nagios-plugins-all.
[788]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
[387]44* Install the full list of RPMs that users expect to be on the
45  scripts.mit.edu servers.  See server/doc/rpm and
[562]46  server/doc/rpm_snapshot.  (Note that this is only a snapshot, and not
47  all packages may in fact be in use.)
[387]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
[832]53  - export PERL_MM_USE_DEFAULT=1
[812]54  - Run 'cpan', accept the default configuration, and do 'o conf
55    prerequisites_policy follow'.
[818]56  - Parse the output of perldoc -u perllocal | grep head2 on an existing
57    server, and "notest install" them from the cpan prompt.
[812]58
59* Install the Python eggs and Ruby gems and PEAR/PECL doohickeys that are on
60  the other scripts.mit.edu servers and do not have RPMs.
[818]61  - Look at /usr/lib/python2.5/site-packages for Python eggs and modules.
62  - Look at `gem list` for Ruby gems.
63  - Look at `pear list` for Pear fruits (or whatever they're called).
[785]64
[812]65* echo 'import site, os.path; site.addsitedir(os.path.expanduser("~/lib/python2.5/site-packages"))' > /usr/lib/python2.5/site-packages/00scripts-home.pth
66
[387]67* Install the credentials (machine keytab, daemon.scripts keytab, SSL
68  certs).
69
[812]70* Attempt to check out server/fedora/config/etc into /etc. The easiest way to
71  do this is to create a checkout of etc in another directory and mv -f this on
72  top of /etc.
[387]73
[562]74  - If you are setting up a test server, pay attention to
75  /etc/sysconfig/network-scripts and do not bind scripts' IP address.
[812]76  You will also need to modify /etc/ldap.conf, /etc/openldap/ldap.conf, and
[562]77  /etc/httpd/conf.d/vhost_ldap.conf to use scripts.mit.edu instead of
78  localhost.
79
[812]80* Install fedora-ds-base and set up replication (see /mit/scripts/doc
81  and /mit/geofft/Public/fedora-ds-enable-ssl-and-kerberos.diff).
[785]82
[818]83* Install nslcd / nss-ldapd, which, unlike nss-ldap, doesn't crash every few
84  hours. Add /sbin/service dirsrv start and /sbin/nslcd to /etc/rc.local, or
85  better yet package nss-ldapd properly.
86
87* Make the services dirsrv, postfix, and httpd start at boot.
88
[803]89* Run fmtutil-sys --all, which does something that makes TeX work.
90
[562]91* (Optional) Beat your head against a wall.
92
[387]93* I recommend setting noatime for the root filesystem in /etc/fstab.
94
95* Possibly perform other steps that I've neglected to put in this
96  document.
Note: See TracBrowser for help on using the repository browser.