Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Perl HTML Groff AGS Script Perl6 C Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



                           I N T E R C H A N G E

Interchange 4.7.1

Copyright (C) 1996-2001 Red Hat, Inc. <>

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 completely unsupported, without warranty of any kind. We
are interested in problems, suggestions, or comments, but do not have
time to offer free individual support in most cases. Our professional
services group offers paid consulting services, which are detailed at:


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 on a Unix-like
operating system.


More information is in the following files and directories:

pdf/           Documentation viewable with xpdf, gv, or Adobe Acrobat Reader.

pod/           Documentation viewable with perldoc.

README.cvs     How to access the CVS repository to track the development of
               Interchange as it happens.

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

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

WHATSNEW       Change information for all versions in this version family.


Major files/directories in the distribution:

Makefile.PL    The installation script.

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.       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.        The installation test script.


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

Here is the quick installation summary:

gzip -dc interchange-4.7.1.tar.gz | tar xvf -
cd interchange-4.7.1

Then you will need to make your first Interchange catalog. See the
section 'DEMO' below.

Remember to check for documentation and
help from other users if you have any trouble.


                                 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:


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 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 man, POD, and PDF formats. Extended
documentation is available at:

which includes user-annotated documentation, HTML versions of the manual,
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 ports. It should work on any Unix with Perl 5.005 or higher and
the necessary Perl modules.


                        K N O W N   P R O B L E M S

Apache with suEXEC:

vlink/UNIX socket mode will not work well unless you do the install as
a normal user. If you are going to support multiple users, you must use
tlink/INET mode.


Something went wrong with that request. Please try again.