Skip to content
This repository
branch: cvs-keyword-re…
Fetching contributors…

Cannot retrieve contributors at this time

file 157 lines (98 sloc) 5.556 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157

 Interchange RPM packages for Red Hat Linux and compatible operating systems


The Interchange RPM packages integrate Interchange with a Red Hat Linux
or compatible operating system. Files are installed in the usual Linux
Standard Base locations:

Interchange base: /usr/lib/interchange.

Executables: /usr/lib/interchange/bin.

Configuration: The global Interchange configuration file is
/etc/interchange.cfg. It is only writable by root.

Data: Catalog directories are located by default in /var/lib/interchange.

Invocation: Invocation is the normal /etc/rc.d/init.d startup method.
Interchange installs to be active in run levels 3, 4, and 5; to be killed
in all.

Logs: Logs go in /var/log/interchange. The subdirectory is needed to
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
the Interchange user ID to write/create files.

Sessions and temporary files: /var/cache/interchange.

Documentation: /usr/share/doc/interchange-5.7.1.

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 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.7.1-1.*.rpm

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'


rpm -Uvh interchange-5.7.1-1.*.rpm
rpm -Uvh interchange-standard-5.7.1-1.*.rpm

If you have installed CPAN modules from source, rather than RPM, you'll need
to install the main interchange package without dependency checking because
RPM doesn't know about those modules you installed:

rpm -Uvh --nodeps interchange-5.7.1-1.*.rpm


Interchange, as installed from the RPM, needs a special invocation from
/usr/sbin/interchange. This is because the locations of configuration,
run, and log files differ from the places Interchange has traditionally
expected them.

As either the 'interch' user or the root user you should start or restart
interchange with this command:

/usr/sbin/interchange -r

NOTE: Contrary to other documentation, you SHOULD NOT use 'bin/restart'
or directly call 'bin/interchange' to start or restart Interchange when
you use the RPM installation.


                       Live Demo Catalog in RPM Format


There is a separate RPM that provides a live demonstration catalog called
'standard', which you may optionally use to quickly try out Interchange.
It should not be used as a basis for a real catalog; instead build
your own with the makecat tool in '/usr/lib/interchange/bin/makecat',
as described in the documentation. Do not confuse the 'standard' live demo
with the 'standard' catalog skeleton from which you are encouraged to build
your own catalog.


The standard-demo RPM relies upon the following things in the Apache

-- Standard document root and CGI binary locations:

   DocumentRoot /var/www/html
   ScriptAlias /cgi-bin/ /var/www/cgi-bin/

-- ServerName must be the same as what is revealed by `hostname` when
   the standard RPM is installed. If it is not, temporarily change the
   hostname with a command like 'hostname' and then install
   the standard-demo RPM. Afterwards you can change the hostname back
   to normal.

-- suEXEC not enabled. If you have suEXEC enabled, you are responsible
   for changing permissions and running parameters appropriately. You
   can typically disable suEXEC by running `chmod u-s /usr/bin/suexec'.
   If you want to continue to use suEXEC, you will have to compile the
   appropriate INET mode link program and use it instead of vlink.


rpm -Uvh interchange-standard-demo-5.7.1-1.*.rpm


Once installed, you should be able to access the demo catalog like this
(using your own hostname, of course):


The initial administrative user name is "interch", and the password is
"pass". Change the password as soon as possible.


                              More information

----------------------------------------------------------------------------- has complete documentation, user mailing
list information, and other resources.
Something went wrong with that request. Please try again.