Interchange Guides: Installation

Davor Ocelic

This documentation is free; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


The purpose of this document is to guide you through the complete Interchange installation routine.

While the concepts will be properly explained and elaborated on, the intention is to make this document a collection of pointers to other parts of Interchange documentation.

People installing from distribution-specific packages (Debian GNU, Red Hat-based platforms, Gentoo, ...) do not need a guide this comprehensive — the package maintainers have already taken care of most of the issues.

The Guide is intended for people who want to install Interchange from generic tarballs. You might want to prefer tarballs over distribution-specific packages if you are either using a non-standard platform, or want to always access the latest releases (when distribution-specific packages are lagging behind). So far, it seems the tarballs are the cleanest and most preferred installation method.

Those impatient or already familiar with Unix administration and software installations, might want to directly go unpacking the tarball and running perl Makefile.PL; make; make test && make install in there.

Table of Contents

Hardware platform and operating system
C compiler
Web server
UNIX account
Installation location
Catalog name
Installing Interchange
Setting up a catalog
Setting up a catalog using the makecat script
Setting up a catalog manually
Starting Interchange

DocBook! Interchange!