head	1.31;
access;
symbols
	TIGRIS_1_1_0RC2:1.31
	TIGRIS_1_1_0RC1:1.31
	TIGRIS_1_1:1.31.0.4
	TIGRIS_1_0_8:1.31
	TIGRIS_1_0_8RC3:1.31
	TIGRIS_1_0_8RC2:1.31
	TIGRIS_1_0_8RC1:1.31
	TIGRIS_1_0_7:1.31
	TIGRIS_1_0_7RC3:1.31
	TIGRIS_1_0_7RC2:1.31
	TIGRIS_1_0_7RC1:1.31
	TIGRIS_1_0_6:1.31
	TIGRIS_1_0_6RC5:1.31
	TIGRIS_1_0_6RC4:1.31
	TIGRIS_1_0_6RC3:1.31
	TIGRIS_1_0_6RC2:1.31
	TIGRIS_1_0_6RC1:1.31
	TIGRIS_1_0_5:1.31
	TIGRIS_1_0_5RC6:1.31
	TIGRIS_1_0_5RC5:1.31
	TIGRIS_1_0_5RC4:1.31
	TIGRIS_1_0_5RC3:1.31
	TIGRIS_1_0_5RC2:1.31
	TIGRIS_1_0_5RC1:1.31
	TIGRIS_1_0_4:1.31
	TIGRIS_1_0_3:1.31
	TIGRIS_1_0_2:1.31
	TIGRIS_1_0_1:1.31
	TIGRIS_1_0:1.31.0.6
	TIGRIS_1_0_0:1.31
	TIGRIS_1_0_0_RC1:1.31.0.2
	dlr:1.1.1
	TIGRIS_0_9_2_4:1.27
	TIGRIS_0_9_2_3:1.27
	HELM_PEER_PORT_BRANCH:1.1.1.1
	TURBINE_PEER:1.29
	TIGRIS_0_9_2_1:1.29
	TIGRIS_0_9_2:1.27.0.4
	TIGRIS_0_9_0:1.27.0.2
	TIGRIS_0_8_4:1.25.0.2
	TIGRIS_NOV_12_2000:1.23
	OLDHELM:1.23.0.2
	TIGRIS_NOV_11_2000:1.23
	TIGRIS_SEP_13_2000:1.14.0.2
	TIGRIS_BASELINE:1.15;
locks; strict;
comment	@# @;


1.31
date	2001.03.15.06.05.46;	author brian;	state Exp;
branches;
next	1.30;

1.30
date	2001.03.15.04.36.43;	author brian;	state Exp;
branches;
next	1.29;

1.29
date	2001.01.22.20.11.15;	author lucas;	state Exp;
branches;
next	1.28;

1.28
date	2001.01.19.01.50.30;	author lucas;	state Exp;
branches;
next	1.27;

1.27
date	2000.12.12.19.08.41;	author lucas;	state Exp;
branches;
next	1.26;

1.26
date	2000.12.06.08.43.58;	author lucas;	state Exp;
branches;
next	1.25;

1.25
date	2000.11.28.19.17.25;	author lucas;	state Exp;
branches
	1.25.2.1;
next	1.24;

1.24
date	2000.11.17.23.40.18;	author lucas;	state Exp;
branches;
next	1.23;

1.23
date	2000.10.24.21.15.03;	author lucas;	state Exp;
branches;
next	1.22;

1.22
date	2000.10.21.06.04.17;	author lucas;	state Exp;
branches;
next	1.21;

1.21
date	2000.10.18.21.15.39;	author manoj;	state Exp;
branches;
next	1.20;

1.20
date	2000.10.17.22.09.15;	author manoj;	state Exp;
branches;
next	1.19;

1.19
date	2000.10.06.07.08.57;	author lucas;	state Exp;
branches;
next	1.18;

1.18
date	2000.10.06.06.32.11;	author lucas;	state Exp;
branches;
next	1.17;

1.17
date	2000.10.03.08.26.39;	author lucas;	state Exp;
branches;
next	1.16;

1.16
date	2000.10.03.08.25.28;	author lucas;	state Exp;
branches;
next	1.15;

1.15
date	2000.09.18.23.11.25;	author manoj;	state Exp;
branches;
next	1.14;

1.14
date	2000.08.22.23.49.24;	author lucas;	state Exp;
branches;
next	1.13;

1.13
date	2000.08.22.21.00.34;	author ed;	state Exp;
branches;
next	1.12;

1.12
date	2000.08.22.20.49.48;	author ed;	state Exp;
branches;
next	1.11;

1.11
date	2000.05.11.19.08.15;	author jrobbins;	state Exp;
branches;
next	1.10;

1.10
date	2000.05.11.17.28.49;	author jrobbins;	state Exp;
branches;
next	1.9;

1.9
date	2000.05.11.17.05.26;	author jrobbins;	state Exp;
branches;
next	1.8;

1.8
date	2000.05.11.04.37.45;	author jrobbins;	state Exp;
branches;
next	1.7;

1.7
date	2000.05.06.20.01.32;	author jrobbins;	state Exp;
branches;
next	1.6;

1.6
date	2000.05.06.19.32.24;	author jrobbins;	state Exp;
branches;
next	1.5;

1.5
date	2000.05.06.19.29.44;	author jrobbins;	state Exp;
branches;
next	1.4;

1.4
date	2000.05.06.19.25.47;	author jrobbins;	state Exp;
branches;
next	1.3;

1.3
date	2000.03.25.00.50.46;	author jrobbins;	state Exp;
branches;
next	1.2;

1.2
date	2000.02.24.22.17.59;	author jrobbins;	state Exp;
branches;
next	1.1;

1.1
date	2000.02.10.02.04.03;	author jrobbins;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2001.02.21.00.37.02;	author dlr;	state Exp;
branches;
next	;

1.25.2.1
date	2000.12.06.08.42.38;	author lucas;	state Exp;
branches;
next	;


desc
@@


1.31
log
@
Obtained from:
Submitted by:
Reviewed by:

Revert, coz it does actually work as expected this way.
@
text
@<TABLE BORDER="0" CELLPADDING="2" WIDTH="100%" BGCOLOR="white">

<TR>
<TD WIDTH="100%" BGCOLOR="#CCCC99"><STRONG><font color="000033"
FACE="Arial, Helvetica, sans-serif">
Tigris Insfrastructure Installation Instructions Using RPMs
</font></STRONG></TD>
</TR>

<TR>
<TD WIDTH="100%" HEIGHT="100" BGCOLOR="#f0f0f0">


<p>Before installing tigris, the following software must also be installed
on the host system.</p>

<p>These instructions assume you are starting with a perfectly clean
installation of one of the following operating systems:</p>

<ul>
<li>RedHat 6.1</li>
<li>RedHat 6.2</li>
</ul>

<p>Your installation experience will be far more pleasurable if this
is a completely fresh install, with no changes. When doing the
install, <b>turn off the installation of the web server</b>.  If you do
install the default web server, you must remove Apache, mod_perl and
PHP packages.</p>

<p>Each RPM file installs new files in a location of its choosing.
Once you have the system up and working you can reconfigure it to use
different paths if you need to.</p>

<p>Note that the versions identified here are the ones for which Tigris was
developed.  Earlier or later versions of the same software may also work,
but use at your own risk.</p>


<p><b>Steps:</b></p>

<ol>

<li>Download RPMs <i>last updated on 01/22/2001</i>:
<ul>
<li><a
href="http://www.tigris.org/download/tigris-rpms.tar.gz">tigris-rpms.tar.gz</a>
30Mb, or</li>
<li><a href="http://www.tigris.org/download/tigris-rpms/">individual
files</a> 
</li>
</ul>
</li>

<br>
<li>If neeed, uncompress and unpack the archive into RPM files:
<ul>
<li><tt>tar xfz tigris-rpms.tar.gz</tt></li>
</ul>
</li>

<br>
<li>Preparation for Qmail and Ezmlm:

<ul>

<li>
Stop sendmail, if it is running.
</li>

<li>
Remove the sendmail package with <tt>rpm -e --nodeps sendmail</tt>
</li>

<li>
Make sure the command <tt>hostname</tt> returns the fully qualified
domainname of your machine.  An alias (CNAME) will not do.
</li>

</ul>

</li>


<br>
<li>Uninstall the default apache, PHP and mod_perl

<ul>
<li><tt>rpm -e mod_perl</tt></li>
<li><tt>rpm -e php</tt></li>
<li><tt>rpm -e apache</tt></li>
<li>TODO: get the exact package names, these might not be the exact spelling</li>
</ul>
</li>

<br>
<li>Install the RPMs: <tt>rpm -Uvh *.rpm</tt>
</li>

<br>
<li>Logout and back in again

<p>The RPMs add some lines to a .profile file so that environment
variables will be set on each login.  You need to log out and back in
to get these environment variables before staring qmail and apache.</p>


</li>


<br>
<li>Start qmail

<ul>
<li>Create alias files named <tt>.qmail-root</tt>, <tt>.qmail-postmaster</tt>,
and <tt>.qmail-mailer-daemon</tt> in <tt>/var/qmail/alias</tt> . Each of these
files should contain an address where mail for root@@, postmaster@@, and
MAILER-DAEMON@@, respectively, should be sent
<li><tt>/etc/rc.d/init.d/qmail start</tt></li>

</ul>
</li>
<br>
<li>Start the cvs-pserver

<ul>
<li><tt>/etc/rc.d/init.d/tigris-cvs-pserver start</tt></li>
</ul>

<br>
<li>Return to the sandbox <a href="http://joist.tigris.org/source/browse/sandbox/INSTALL?rev=1&content-type=text/x-cvsweb-markup">INSTALL</a> document
to complete setting up tigris.
</li>

</ol>



</td>
</tr>

</table>
@


1.30
log
@
Obtained from:
Submitted by:
Reviewed by:

Link to the version-browsing page so the latest one can be selected - I
can't figure out a better way to link to "the most current version".
@
text
@d131 1
a131 1
<li>Return to the sandbox <a href="http://joist.tigris.org/source/browse/sandbox/INSTALL">INSTALL</a> document
@


1.29
log
@keeping the date correct
@
text
@d131 1
a131 1
<li>Return to the sandbox <a href="http://joist.tigris.org/source/browse/sandbox/INSTALL?rev=1&content-type=text/x-cvsweb-markup">INSTALL</a> document
@


1.28
log
@updating for new mm.mysql rpm
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 01/18/2001</i>:
@


1.27
log
@Updated with new Turbine RPM
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 12/12/2000</i>:
@


1.26
log
@Updated date
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 12/06/2000</i>:
@


1.25
log
@Updated last modified date
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 11/28/2000</i>:
@


1.25.2.1
log
@Updated date
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 12/06/2000</i>:
@


1.24
log
@Updated date for tarball

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 11/17/2000</i>:
@


1.23
log
@Updated date because of new gamelan and jakarta-oro rpm's

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 10/24/2000</i>:
@


1.22
log
@Updated for new Ant rpm

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 10/20/2000</i>:
@


1.21
log
@Rearrange the sentence, in part to avoid an end-of-sentence period
next to a file name.

Submitted by:	Jason Robbins <jrobbins@@collab.net>
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 10/05/2000</i>:
@


1.20
log
@Note that .qmail files should be added.
@
text
@d115 4
a118 5
<li>Create alias files in <tt>/var/qmail/alias</tt>.
<tt>.qmail-root</tt>, <tt>.qmail-postmaster</tt>, and
<tt>.qmail-mailer-daemon</tt>. Each of these files should contain an
address where mail for root@@, postmaster@@, and MAILER-DAEMON@@,
respectively, should be sent.
@


1.19
log
@Updated instructions after feedback from Manoj

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d115 5
@


1.18
log
@Updating to easier install directions

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@a66 9
<li>These instructions are summarized from,
<a
href="ftp://moni.msci.memphis.edu/pub/qmail/var-qmail/README.var-qmail">README.var-qmail</a>,
and
<a
href="ftp://moni.msci.memphis.edu/pub/qmail/qmail-run/README.qmail-run">README.qmail-run</a>.
For more information on qmail read these documents directly.
</li>

d76 1
a76 1
Make sure the command <tt>hostname -f</tt> returns the fully qualified
@


1.17
log
@Changed order of uninstalls

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d44 1
a44 1
<li>Download RPMs <i>last updated on 10/03/2000</i>:
d49 3
a51 4
<li><a href="http://www.tigris.org/download/tigris-rpms/easy-rpms/">individual
files</a> including the
<a href="http://www.tigris.org/download/tigris-rpms/qmail-rpms">qmail
rpms</a></li>
d63 1
a63 1
<li>Install Qmail and Ezmlm:
a88 5
<li><tt>rpm -Uvh *.rpm</tt></li>

<li>Qmail and ezmlm are now installed, but not running.  You will
start qmail after installing the rest of tigris.

d124 1
a124 1
<li><tt>/etc/rc.d/init.d/qmail-smtpd.init start</tt></li>
d126 4
a129 1
<li><tt>/etc/rc.d/init.d/qmail.init start</tt></li>
d131 2
a133 1
</li>
@


1.16
log
@Updated rpm directions
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d104 2
a106 2
<li><tt>rpm -e php</tt></li>
<li><tt>rpm -e mod_perl</tt></li>
@


1.15
log
@Update to current state: rpm -Uvh is the recommended method now.

Reported by:	Michael Stack <stack@@collab.net>
@
text
@d44 1
a44 1
<li>Download RPMs:
d48 1
a48 1
27Mb, or</li>
d90 1
a90 13
<li><tt>rpm --rebuild qmail-1.03-102memphis.src.rpm</tt></li>

<li><tt>rpm -Uvh /usr/src/redhat/RPMS/i386/qmail-1.03-102memphis.i386.rpm</tt></li>

<li><tt>rpm -Uvh functions-3-3.i386.rpm</tt></li>

<li><tt>rpm -Uvh daemontools-0.53-103memphis.i386.rpm</tt></li>

<li><tt>rpm -Uvh ucspi-tcp-0.84-102memphis.i386.rpm</tt></li>

<li><tt>rpm -Uvh qmail-run-4-4.i386.rpm</tt></li>

<li><tt>rpm -Uvh ezmlm-idx-mysql-0.53.324-1.i386.rpm</tt></li>
@


1.14
log
@Moved tigris-rpms-current to tigris-rpms

PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@a122 2


d124 1
a124 40
<li>Install the RPMs
<p>This hasn't been well tested, but <tt>rpm -Uvh *.rpm</tt> should
work. RPM should reorder packages as appropriate so that Tigris is
installed correctly. </p>

<p>Or, if you prefer a slower, more testable, and probably more
reliable procedure, do the following.  <tt>rpm -Uvh
<i>filename</i>.rpm</tt>, where <i>filename</i> is each of the rpm
file names in the following order:</p>

<ul>
<li>apache</li>
<li>MySQL</li>
<li>MySQL-client</li>
<li>MySQL-shared</li>
<li>MySQL-devel</li>
<li>IBMJava118-SDK</li>
<li>jdk-ibm</li>
<li>ApacheJServ</li>
<li>cvs</li>
<li>cj</li>
<li>gnu.regexp</li>
<li>jaf</li>
<li>java1.2-collections</li>
<li>jsdk</li>
<li>mm.mysql.jdbc</li>
<li>village</li>
<li>javamail</li>
<li>mod_auth_mysql</li>
<li>mod_hosts_access</li>
<li>perl-DBI</li>
<li>perl-Msql-Mysql-modules</li>
<li>perl-Rcs</li>
<li>perl-GD</li>
<li>perl-Chart</li>
<li>perl-TimeDate</li>
<li>webmacro</li>
<li>swish-e</li>
<li>MHonArc</li>
</ul>
a125 1

@


1.13
log
@correct locations for downloading current rpms
@
text
@d47 1
a47 1
href="http://www.tigris.org/download/tigris-rpms-current.tar.gz">tigris-rpms-5.tar.gz</a>
d49 1
a49 1
<li><a href="http://www.tigris.org/download/tigris-rpms-current/easy-rpms/">individual
d51 1
a51 1
<a href="http://www.tigris.org/download/tigris-rpms-current/qmail-rpms">qmail
d59 1
a59 1
<li><tt>tar xfz tigris-rpms-current.tar.gz</tt></li>
@


1.12
log
@avoid the old tigris rpm -- point people back to the sandbox INSTALL
document.  also, add mod_hosts_access in to the instructions.
@
text
@d47 1
a47 1
href="http://www.tigris.org/download/tigris-rpms-5.tar.gz">tigris-rpms-5.tar.gz</a>
d49 4
a52 2
<li><a href="http://www.tigris.org/download/tigris-rpms-5/">individual
files</a></li>
d59 1
a59 1
<li><tt>tar xfz tigris-rpms-5.tar.gz</tt></li>
@


1.11
log
@emphasized need to not have apache, php, and mod_perl
@
text
@d153 1
a162 1
<li>tigris</li>
d190 2
a191 23
<li>Start apache

<ul>
<li><tt>/usr/tigris/scripts/apachectl start</tt></li>
</ul>
</li>

<br>
<li>Tigris is now installed and can be accessed on your machine at
URL <tt>http://local.tigris.org/</tt>.   If you want to browse your
new tigris site from another machine, you must add an entry in the
/etc/hosts file for that machine for local.tigris.org.

<ul>
<li>To exercise tigris, see the <a href="/script.html">tigris demo script</a>.
</ul>
</li>

<br>
<li>Change tigris root password
<ul>
<li>This is part of the <a href="/script.html">tigris demo script</a>.
</ul>
a193 21



<br>
<li>Choose a permanent hostname

<ul>
<li>This step has not been written in detail yet.</li>

<li>Set up DNS "star" entries (A and MX) for your new hostname.</li>

<li>Replace local.tigris.org with your host name in all
config files and tigris domain config servlet.</li>

<li>Force tigris to regenerate vhost files</li>

<li>Restart qmail and apache.</li>
</ul>
</li>

</li>
@


1.10
log
@added logout/login step
@
text
@d25 5
a29 3
<p>Your installation experience will be far more pleasurable if this is
a completely fresh install, with no changes. Also remove the existing
Apache, mod_perl and PHP packages.</p>
d111 1
a111 1
<li>Uninstall the default apache
d115 3
@


1.9
log
@added step to uninstall apache
@
text
@d161 12
@


1.8
log
@updated to latest rpms
@
text
@d107 11
@


1.7
log
@added a step to encourrage people to change the default root password
@
text
@d45 1
a45 1
href="http://www.tigris.org/download/tigris-rpms-3.tar.gz">tigris-rpms-3.tar.gz</a>
d47 1
a47 1
<li><a href="http://www.tigris.org/download/tigris-rpms-3/">individual
d55 1
a55 1
<li><tt>tar xfz tigris-rpms-3.tar.gz</tt></li>
@


1.6
log
@added more spacing
@
text
@d180 5
d186 3
@


1.5
log
@corrected version number in download link
@
text
@d52 1
d59 1
d107 1
a107 1

d150 1
a150 1

d161 1
d169 1
a169 1

d182 1
@


1.4
log
@updated install instructions and script, added download to nav bar
@
text
@d45 1
a45 1
href="http://www.tigris.org/download/tigris-rpms-2.tar.gz">tigris-rpms-3.tar.gz</a>
d47 1
a47 1
<li><a href="http://www.tigris.org/download/tigris-rpms-2/">individual
@


1.3
log
@fixed broken links
@
text
@d6 1
a6 1
Helm Installation Instructions
d14 2
a15 1
<p>Last modified February 1, 2000</p>
d17 2
d20 4
a23 6
<p><b><font size="+1" color="#000033">Step 1: Prerequisite Software</font></b></p>

<p>Before installing Helm, the following software must also be installed
on the Helm host system. These should all be easily locatable and
downloadable from the Internet. We are working hard to make Helm easier
to install, so if you have trouble, please let us know.</p>
d25 7
a31 4
<p>These packages may have other dependencies; please follow the installation
instructions of each package closely. Install the software in locations
that are convenient for you; all file paths that Helm uses are fully
customizable.</p>
d33 2
a34 2
<p>Note that the versions identified here are the ones for which Helm was
developed. Earlier or later versions of the same software may also work,
a36 1
<table width="100%" bgcolor="cccc99">
d38 1
a38 124
<tr>
<td BGCOLOR="#F0F0F0" valign="top">MySQL 3.22.23b</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/MySQL-3.22.27-1.i386.rpm">MySQL-3.22.27-1.i386.rpm</a><br>
<a href="http://helm.tigris.org/download/MySQL-devel-3.22.27-1.i386.rpm">MySQL-devel-3.22.27-1.i386.rpm</a><br>
<a href="http://helm.tigris.org/download/MySQL-client-3.22.27-1.i386.rpm">MySQL-client-3.22.27-1.i386.rpm</a>
</td>
</tr>


<tr>
<td BGCOLOR="#F0F0F0">qmail 1.03</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/qmail-1.03.tar.gz">qmail-1.03.tar.gz</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">ezmlm 0.53</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/ezmlm-0.53.tar.gz">ezmlm-0.53.tar.gz</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">ezmlm-idx 0.322 (install with MySQL support)</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/ezmlm-idx-mysql-0.53.324-1.i386.rpm">ezmlm-idx-mysql-0.53.324-1.i386.rpm</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">Perl 5.005_03</td>
<td BGCOLOR="#F0F0F0">
<a href="http://www.perl.org/">www.perl.org</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">DBI-1.1 and Msql-Mysql-modules-1.2200</td>
<td BGCOLOR="#F0F0F0">
<a href="http://www.cpan.org/">www.cpan.org</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">CVS 1.10.6 (see patch below)</td>
<td BGCOLOR="#F0F0F0">
<a href="http://www.cyclic.com/">cyclic.com</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">CGI.pm</td>
<td BGCOLOR="#F0F0F0">
<a href="http://www.perl.org/">www.perl.org</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">JDK 1.1</td>
<td BGCOLOR="#F0F0F0">
<a href="http://java.sun.com/products/jdk/1.1/">jdk 1.1</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">JDK 1.1 Collections</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/collections1_1.zip">collections1_1.zip</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">JSDK 2.0</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/jsdk20-solaris2-sparc.tar">jsdk20-solaris2-sparc.tar</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">mm.mysql JDBC 1.1i</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/mm.mysql.jdbc-1.2b.tar.gz">mm.mysql.jdbc-1.2b.tar.gz</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">Apache 1.3.6</td>
<td BGCOLOR="#F0F0F0">
<a href="http://www.apache.org/dist/apache_1.3.9.tar.Z">apache_1.3.9.tar.Z</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">Apache-JServ 1.0 or 1.1</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/ApacheJServ-1.1.tar.gz">ApacheJServ-1.1.tar.gz</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">WebMacro</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/webmacro.jar">webmacro.jar</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">Village</td>
<td BGCOLOR="#F0F0F0">
<a href="http://helm.tigris.org/download/village.jar">village.jar</a>
</td>
</tr>

<tr>
<td BGCOLOR="#F0F0F0">Helm</td>
<td BGCOLOR="#F0F0F0">
<a href="http://www.tigris.org/download/helm-latest.zip">helm-latest.zip</a><br>
OR<br>
<a href="http://www.tigris.org/download/helm-latest.tar.gz">helm-latest.tar.gz</a><br>
</td>
</tr>
</table>
d40 1
d42 9
d52 5
a56 1
<p><b>Helm Patches</b></p>
d58 1
a58 2
<p>Some of the software needs to be patched from the standard
distributions to work with Helm. These patches are noted as follows:</p>
d61 10
d72 1
a72 6
 <code>CVS: cd /path/to/source/of/cvs-1.10.6; patch -p1 < cvspatches/cvs.patch</code><br>
  This patch enables CVS password files to work using MySQL databases
  instead of a flat file and enables Helm acls for access
  control. Commit this patch before compiling CVS;
  you will need to use the <code>--enable-mysql</code> and <code>--enable-helm</code>
  options to configure.
a73 1
</ul>
d75 3
a77 2
<hr>
<p><b><font size="+1" color="#000033">Step 2: The Helm Database</font></b></p>
d79 4
a82 48
<p>Set up a mysql database for Tigris, along with a username (with
password) that has full privileges for the domain (see the MySQL
documentation). For example:</p>
<pre>
        $ mysqladmin create tigris
        $ mysql -u root mysql
        mysql> GRANT ALL PRIVILEGES ON tigris.* TO tigris@@localhost
                   IDENTIFIED BY 'password';
</pre>

<p>To create the proper tables, run the SQL commands in
build_database.sql. e.g.,:</p>

<code>
        $ mysql -u tigris -p tigris < sql/build_database.sql
</code>

<p>Note that in order to bootstrap Helm, you will need an initial user
with full privileges. It goes something like this:</p>

<pre>
     $ mysql -u tigris -p tigris
     mysql> INSERT INTO domain_users VALUES ('username',
                 PASSWORD('password'), 'email@@address', 'Real Name',
                 NULL);
     mysql> INSERT INTO domain_privs VALUES ('username', 'Y', 'Y',
                 'Y', 'Y', 'Y', 'Y');
     mysql> INSERT INTO User VALUES (1,'username',PASSWORD('password'),
            'Real Name','Optional Address','','City','CA','94901','Country','Country',
            '000-000-0000','','000-000-0000','000-000-0000','',
            'User Email Address',20000117010840,19990428154611);
     mysql> INSERT INTO UserRole VALUES (1,10);
</pre>

<hr>
<p><b><font size="+1" color="#000033">Step 3: Configuring the Software</font></b></p>


<p>The Helm system needs three unix users: one for Apache (note that the
Apache httpd need not run as this user), one for CVS, and one for
Qmail. They should all also be members of a group specific to the
domain.  I use usernames tigrisa, tigrisc, tigrisq, with group tigris.</p>

<p><b>Helm configuration files (and other stuff):</b></p>

<p>You will need to edit the following files to represent your setup. The
necessary lines to be edited are all marked with CONFIG and
instructions, so search for it:</p>
d84 1
a84 11
<ul>
<li>conf/helm.conf</li>
<li>perl/cgi/update.cgi</li>
<li>perl/Helm/Config.pm</li>
<li>conf/WebMacro.properties</li>
<li>conf/jserv.conf</li>
<li>conf/jserv.properties</li>
<li>conf/helm-site.properties</li>
<li>conf/helm-zone.properties</li>
<li>cvspatches/root/log_accum</li>
</ul>
d86 1
a86 1
<p><b>Apache:</b></p>
d88 1
a88 3
<p>Add the line <code>"Include /path/to/helm/conf/helm.conf"</code> to
your <code>httpd.conf</code>. This file contains all necessary
configuration information for Apache and for JServ.</p>
d90 1
a90 4
<p>The htdocs directory, as specified in the config table, should be
owned and writable by the Helm CVS user (not the Helm Apache
user). Note that this need not necessarily be the same directory
actually listed in the DocumentRoot directive in httpd.conf.</p>
d92 1
a92 2
<p>Note that this sets up the servlets to be available under /helm - to
log in, go to http://hostname/helm/TLogin.</p>
d94 1
a94 1
<p><b>CVS:</b></p>
d96 1
a96 3
<p>In addition to the patch above, 
the CVS root should be set up a directory owned by the Helm CVS
user, and all files within it should be owned by that user.</p>
d98 2
a99 2
<p>The CVSROOT module must be set up in a very specific way in order for
Helm to work properly:</p>
d101 1
a101 3
<ol>
<li> The files in helm/cvs/root should be added to CVSROOT, and to the
   checkoutlist file (so that they can be properly used). </li>
a102 34
<li> CVSROOT/loginfo,v should be removed, and loginfo made writeable
   (chmod +w) by the Helm CVS user (which should already own the
   file).  For some reason, keeping this file under RCS management
   doesn't work with the way Helm udpates the file right now. This
   will be fixed in a future release.</li>

<li> CVSROOT/history must be made world-writable. For some reason, this
   seems to be necessary, although it shouldn't be. I believe it is a
   bug in CVS related to the problem referenced in item 2 above.</li>

<li> Make the directory CVSROOT/commitlogs</li>

<li> So that the files are used by CVS, the following entries need to be
   made in the following CVSROOT module files:<br>
<pre>
commitinfo:
ALL $CVSROOT/CVSROOT/commit_prep

editinfo:
DEFAULT $CVSROOT/CVSROOT/cvsedit

rcsinfo:
ALL $CVSROOT/CVSROOT/rcstemplate

config:
MysqlUser=<i>helm db user</i>
MysqlPasswd=<i>helm db passwd</i>
MysqlDB=<i>helm db</i>
MysqlDefaultUser=<i>helm CVS user</i>
MysqlPasswdTable=domain_users
MysqlUsernameCol=username
MysqlPasswdCol=password
MysqlEncrypt=mysql
</pre>
a103 1
</ol>
a104 3
<p>Further, when setting up the pserver entry in inetd.conf, you must add
the -L option. And run it as the domain CVS user, not as root (this helps
with security).</p>
d106 9
d116 31
a147 1
<p><b>Qmail</b></p>
d149 1
a149 2
<p>You will need to set up several of the control files in qmail for the
domain and project hosts.</p>
d152 6
d159 1
a159 2
<li> Add each domain name (domain.org, project1.domain.org,
project2.domain.org, etc...) to control/rcpthosts.</li>
d161 4
a164 1
<li> Add "domain.org:<i>helm-qmail-user</i>" to control/virtualhosts</li>
a165 2
<li> Add "project.domain.org:<helm-qmail-user>-project" to
control/virtuahosts for each project</li>
d167 4
a170 3
<li> Add each virtual host to a line in /etc/hosts.allow of the form<br>
<code>tcp-env: 127.0.0.1, VHOST, VHOST, VHOST : setenv = RELAYCLIENT</code><br>
Where VHOST is the FQDN of a virtual host.</li>
d172 2
d175 1
d177 11
a187 3
<p>The project domains part should be automated at some point. At this
time they are not. But since you'll have to set up DNS anyway, this
extra step shouldn't be too much of a problem.</p>
d189 1
a189 2
<hr>
<p><b><font size="+1" color="#000033">Step 4: Try It Out</font></b></p>
d191 6
a196 2
<p>At this point, you should be able to start Apache and go to<br>
<code>http://<yourhost>/helm/TView?page=index.html</code>.</p>
a197 1
<br>
@


1.2
log
@added helm download link
@
text
@d153 1
a153 1
<a href="http://helm.tigris.org/download/helm.jar">helm.jar</a><br>
d155 1
a155 1
<a href="http://helm.tigris.org/download/helm-latest.tar.gz">helm-laatest.tar.gz</a><br>
@


1.1
log
@added project_download.html with same content as INSTALL, jason!
@
text
@d149 9
@


1.1.1.1
log
@Replacing the HEAD with the HELM_PEER_PORT_BRANCH.
@
text
@d6 1
a6 1
Tigris Insfrastructure Installation Instructions Using RPMs
d14 1
a14 2
<p>Before installing tigris, the following software must also be installed
on the host system.</p>
a15 2
<p>These instructions assume you are starting with a perfectly clean
installation of one of the following operating systems:</p>
d17 6
a22 4
<ul>
<li>RedHat 6.1</li>
<li>RedHat 6.2</li>
</ul>
d24 4
a27 9
<p>Your installation experience will be far more pleasurable if this
is a completely fresh install, with no changes. When doing the
install, <b>turn off the installation of the web server</b>.  If you do
install the default web server, you must remove Apache, mod_perl and
PHP packages.</p>

<p>Each RPM file installs new files in a location of its choosing.
Once you have the system up and working you can reconfigure it to use
different paths if you need to.</p>
d29 2
a30 2
<p>Note that the versions identified here are the ones for which Tigris was
developed.  Earlier or later versions of the same software may also work,
d33 119
d153 1
a153 1
<p><b>Steps:</b></p>
d155 2
a156 1
<ol>
a157 1
<li>Download RPMs <i>last updated on 01/22/2001</i>:
d159 7
a165 5
<li><a
href="http://www.tigris.org/download/tigris-rpms.tar.gz">tigris-rpms.tar.gz</a>
30Mb, or</li>
<li><a href="http://www.tigris.org/download/tigris-rpms/">individual
files</a> 
a167 1
</li>
d169 52
a220 2
<br>
<li>If neeed, uncompress and unpack the archive into RPM files:
d222 9
a230 1
<li><tt>tar xfz tigris-rpms.tar.gz</tt></li>
a231 1
</li>
d233 10
a242 2
<br>
<li>Preparation for Qmail and Ezmlm:
d244 2
a245 1
<ul>
d247 1
a247 3
<li>
Stop sendmail, if it is running.
</li>
d249 3
a251 3
<li>
Remove the sendmail package with <tt>rpm -e --nodeps sendmail</tt>
</li>
d253 2
a254 4
<li>
Make sure the command <tt>hostname</tt> returns the fully qualified
domainname of your machine.  An alias (CNAME) will not do.
</li>
d256 3
a258 1
</ul>
d260 34
d295 1
d297 3
a300 2
<br>
<li>Uninstall the default apache, PHP and mod_perl
a301 7
<ul>
<li><tt>rpm -e mod_perl</tt></li>
<li><tt>rpm -e php</tt></li>
<li><tt>rpm -e apache</tt></li>
<li>TODO: get the exact package names, these might not be the exact spelling</li>
</ul>
</li>
d303 1
a303 3
<br>
<li>Install the RPMs: <tt>rpm -Uvh *.rpm</tt>
</li>
d305 2
a306 2
<br>
<li>Logout and back in again
d308 1
a308 3
<p>The RPMs add some lines to a .profile file so that environment
variables will be set on each login.  You need to log out and back in
to get these environment variables before staring qmail and apache.</p>
d310 2
d313 1
a313 1
</li>
d315 2
d318 3
a320 9
<br>
<li>Start qmail

<ul>
<li>Create alias files named <tt>.qmail-root</tt>, <tt>.qmail-postmaster</tt>,
and <tt>.qmail-mailer-daemon</tt> in <tt>/var/qmail/alias</tt> . Each of these
files should contain an address where mail for root@@, postmaster@@, and
MAILER-DAEMON@@, respectively, should be sent
<li><tt>/etc/rc.d/init.d/qmail start</tt></li>
a322 3
</li>
<br>
<li>Start the cvs-pserver
d324 3
a326 3
<ul>
<li><tt>/etc/rc.d/init.d/tigris-cvs-pserver start</tt></li>
</ul>
d328 2
a329 4
<br>
<li>Return to the sandbox <a href="http://joist.tigris.org/source/browse/sandbox/INSTALL?rev=1&content-type=text/x-cvsweb-markup">INSTALL</a> document
to complete setting up tigris.
</li>
d331 2
a332 1
</ol>
d334 1
@


