source: server/doc/install-howto @ 812

Last change on this file since 812 was 812, checked in by geofft, 16 years ago
One day this will be a makefile or a maintainer script
File size: 3.3 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
[812]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
[387]58* Install rails (versions 1.1.6 and 1.2.2).
59
[812]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.
[785]62
[812]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
[387]65* Install the credentials (machine keytab, daemon.scripts keytab, SSL
66  certs).
67
[812]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.
[387]71
[562]72  - If you are setting up a test server, pay attention to
73  /etc/sysconfig/network-scripts and do not bind scripts' IP address.
[812]74  You will also need to modify /etc/ldap.conf, /etc/openldap/ldap.conf, and
[562]75  /etc/httpd/conf.d/vhost_ldap.conf to use scripts.mit.edu instead of
76  localhost.
77
[812]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).
[785]80
[803]81* Run fmtutil-sys --all, which does something that makes TeX work.
82
[562]83* (Optional) Beat your head against a wall.
84
[387]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.
Note: See TracBrowser for help on using the repository browser.