[interchange-cvs] interchange - jon modified README.rpm-dist

[interchange-cvs at icdevgroup.org]

User:      jon
Date:      2003-12-03 17:35:50 GMT
Modified:  .        README.rpm-dist
Log:
Update for release, and begin painful process of documenting dependencies
and problems with threaded Perls now common.

Revision  Changes    Path
1.4       +57 -9     interchange/README.rpm-dist


rev 1.4, prev_rev 1.3
Index: README.rpm-dist
===================================================================
RCS file: /var/cvs/interchange/README.rpm-dist,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -u -r1.3 -r1.4
--- README.rpm-dist	22 Jul 2002 15:27:22 -0000	1.3
+++ README.rpm-dist	3 Dec 2003 17:35:50 -0000	1.4
@@ -22,8 +22,8 @@
 in all.
 
 Logs: Logs go in /var/log/interchange. The subdirectory is needed to
-allow the Interchange user ID to write/create files. Interchange drops
-a file in /etc/logrotate.d to do log rotation.
+allow the Interchange user ID to write/create files. A configuration file
+is added to /etc/logrotate.d to do log rotation.
 
 Run: Run files go in /var/run/interchange. This includes the UNIX-domain
 socket and catalog status files. The subdirectory is needed to allow
@@ -31,17 +31,65 @@
 
 Sessions and temporary files: /var/cache/interchange.
 
-Documentation: /usr/share/doc/interchange-x.y.z.
+Documentation: /usr/share/doc/interchange-5.0.0.
 
 On a dedicated production server, it is wise to segregate as many of these
 directories as possible onto their own partitions, to prevent problems if
-one partition runes out of inodes or disk space, or you have hard or soft
-disk corruption problems.
+one partition runs out of inodes or disk space, or you have a disk failure.
+
+
+DEPENDENCIES
+
+Interchange requires many Perl modules from CPAN. Many of these do not
+usually come supplied with your operating system, so you will need to
+install them yourself. It's best to locate RPMs for each of the needed
+Perl modules and install them. To get a complete list of dependencies, do:
+
+rpm -qp --requires interchange-5.0.0-1.i386.rpm
+
+Note that some of the dependencies are not actually necessary. For example,
+the Cybercash modules (CCMck*) are only needed if you use the Cybercash
+payment gateway, which is now rare. The Apache::* modules are only needed
+if you use the mod_perl-native server option, which is also very rare. DBI
+is only needed if you're going to use an SQL database. But that's quite
+common.
+
+Unfortunately, there's not currently a reliable, steady source of the latest
+CPAN modules in RPM format for most operating systems. Thus the easiest way
+to install them is to use CPAN to build the modules from source. First set
+up CPAN and install its auxiliary modules:
+
+perl -MCPAN -e'install Bundle::CPAN'
+
+Then install the main modules Interchange uses:
+
+perl -MCPAN -e'install Bundle::Interchange'
+
+Instead you may want to install a bundle that includes many optional but
+useful modules:
+
+perl -MCPAN -e'install Bundle::InterchangeKitchenSink'
+
+
+PERL BUILD
+
+As of the date of this writing, there are problems using Interchange with
+a threaded Perl, so you must have or install an unthreaded Perl build.
+The RPMs built for Red Hat Linux 8.0, 9, Fedora Core, and Red Hat Enterprise
+Linux 3.0 all assume you'll be using a custom Perl build in /usr/local.
+This is unfortunate but is considered the best workaround at the moment.
 
 
 INSTALL
 
-rpm -Uvh interchange-4.9.x.i386.rpm interchange-foundation-4.9.x.i386.rpm
+rpm -Uvh interchange-5.0.0-1.i386.rpm
+rpm -Uvh interchange-foundation-5.0.0-1.i386.rpm
+
+Your version of RPM may correctly recognize Perl modules even if they
+were not installed via RPM. But it may not. If not, you'll need to install
+the main interchange package without dependency checking:
+
+rpm -Uvh --nodeps interchange-5.0.0-1.i386.rpm
 
 
 STARTING/RESTARTING INTERCHANGE
@@ -81,7 +129,7 @@
 The foundation-demo RPM relies upon the following things in the Apache
 installation:
 
--- One of the following two default setups:
+-- Standard document root and CGI binary locations:
 
    DocumentRoot /var/www/html
    ScriptAlias  /cgi-bin/ /var/www/cgi-bin/
@@ -101,7 +149,7 @@
 
 INSTALL
 
-rpm -Uvh interchange-foundation-demo-4.9.x.rpm
+rpm -Uvh interchange-foundation-demo-5.0.0-1.i386.rpm
 
 
 USING THE DEMO
@@ -112,7 +160,7 @@
 http://hostname/foundation/
 
 The initial administrative user name is "interch", and the password is
-"pass". CHANGE IT.
+"pass". Change the password as soon as possible.
 
 
 -----------------------------------------------------------------------------