[interchange-cvs] interchange - jon modified README.rpm-dist
interchange-cvs at icdevgroup.org
interchange-cvs at icdevgroup.org
Wed Dec 3 12:35:50 EST 2003
Date: 2003-12-03 17:35:50 GMT
Modified: . README.rpm-dist
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
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 @@
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.
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.
+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
+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
+perl -MCPAN -e'install Bundle::InterchangeKitchenSink'
+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.
-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
@@ -81,7 +129,7 @@
The foundation-demo RPM relies upon the following things in the Apache
--- One of the following two default setups:
+-- Standard document root and CGI binary locations:
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
@@ -101,7 +149,7 @@
-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 @@
The initial administrative user name is "interch", and the password is
-"pass". CHANGE IT.
+"pass". Change the password as soon as possible.
More information about the interchange-cvs