-----------------------------------------------------------------------------

                           I N T E R C H A N G E

Interchange 4.7.6

Copyright (C) 1996-2001 Red Hat, Inc. <interchange@redhat.com>

Originally based on Vend 0.2, with portions from Vend 0.3
Copyright 1995-96 by Andrew M. Wilcox

See the file LICENSE for redistribution terms.

This program is offered without warranty of any kind. We are interested
in problems, suggestions, or comments, but do not offer free individual
support in most cases. Our professional services group offers paid
consulting services, which are detailed at:

http://www.redhat.com/ecommerce

-----------------------------------------------------------------------------

Interchange is a full-featured electronic catalog system with
online ordering; real-time credit card processing hooks; high-end
database access and retrieval with SQL support; product categorizing,
merchandising, and discounting; basic customer relationship management;
dynamic content presentation; content management; internationalization
and localization support; real-time tax and shipping hooks; reporting;
and web-based administration.

Interchange absolutely REQUIRES Perl 5.005 or Perl 5.6 or later on a
Unix-like operating system.

-----------------------------------------------------------------------------

More information is in the following files and directories:

pod/           Documentation.

README.rpm     Notes on using Interchange when installed from RPM packages.

README.debian  Notes on using Interchange when installed from Debian packages.

README.cvs     How to access the CVS repository to track ongoing development.

WHATSNEW       Changes per version for this version family.

-----------------------------------------------------------------------------

Major files/directories in the distribution:

Makefile.PL    Script to create a Makefile, used for installation.

dist/          The distribution files, exclusive of executable
               files and modules. Includes:

               interchange.cfg.dist   Distribution interchange.cfg
               foundation/            Demo catalog application
               src/                   C and Perl code for CGI links
               lib/                   Back-end administrative interface
               usertag/               Some fairly standard usertags

extra/         Some not-always-needed Perl libraries.

hints.pl       OS-specific configuration settings. None currently used.

lib/           The library modules needed to run Interchange.

scripts/       The executable files, relocated to bin/ in the install
               directory.

test.pl        The installation test script.

-----------------------------------------------------------------------------

                          I N S T A L L A T I O N

You can install Interchange as root for a multi-user system-wide setup, or
as an unprivileged user who will be the only one modifying Interchange files.

Here is the quick installation summary:

gzip -dc interchange-4.7.?.tar.gz | tar xvf -
cd interchange-4.7.?
./configure

Then you will need to make your first Interchange catalog, as described in
the next section.

-----------------------------------------------------------------------------

                                 D E M O

There is a demo catalog included called 'foundation'.

To install the demo, go to the directory where you installed Interchange
(default is "interchange" in your home directory, /usr/local/interchange
for root installations, or /usr/lib/interchange for RPM installations)
and run:

bin/makecat

Follow the prompts and after restarting the Interchange server you
should be able to access the demo catalog.

Please note that some functionality (notably the reporting features)
may not be available if you are not using an SQL database such as
MySQL or PostgreSQL.

Visit http://demo.akopia.com/ to see a live demo on our servers.

-----------------------------------------------------------------------------

                         D O C U M E N T A T I O N

The included documentation is in POD and man(1) formats. The developer web
site it located at:

http://interchange.redhat.com/

It offers user-annotated documentation, the documentation in other formats,
and a user-contributed code library.

-----------------------------------------------------------------------------

                         C O M P A T I B I L I T Y

Interchange is regularly tested on Linux, FreeBSD, and Solaris. It
has also been used on OpenBSD, Digital UNIX/Tru64, SCO, AIX, and other
Unix variants. It should work on any Unix with Perl 5.005 or higher and
the necessary Perl modules.

-----------------------------------------------------------------------------

(end)