Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 184 lines (130 sloc) 6.186 kb
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
1 # Interchange V4.5.x
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
2 #
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
3 # Copyright (C) 1996-2000 Akopia, Inc. <info@akopia.com>
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
4 #
5 # Originally based on Vend 0.2
6 # Copyright 1995 by Andrew M. Wilcox
7 #
8 # Portions from Vend 0.3
9 # Copyright 1995,1996 by Andrew M. Wilcox
10 #
11 # This program is free software; you can redistribute it
12 # and/or modify it under the terms of the GNU General Public
13 # License as published by the Free Software Foundation; either
14 # version 2 of the License, or (at your option) any later
15 # version.
16 #
17 # This program is distributed in the hope that it will be useful,
18 # but WITHOUT ANY WARRANTY; without even the implied warranty of
19 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 # GNU General Public License for more details.
21 #
22 # You should have received a copy of the GNU General Public
23 # License along with this program; if not, write to the Free
24 # Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
25 # MA 02111-1307 USA.
26
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
27 Welcome to Interchange! This program is completely unsupported, without
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
28 warranty of any kind. The author is interested in problems, suggestions,
29 or comments, but does not have time to offer free individual support
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
30 in most cases. See the Interchange website at http://www.minivend.com/
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
31 for more information.
32
33 --------------------------------------------------------------
34
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
35 I N T E R C H A N G E
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
36
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
37 Interchange is a full-featured electronic catalog system (commonly known
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
38 as a shopping cart) with online ordering capability. It is a high-end
39 database access and retrieval system with SQL support via the Perl DBI.
40
41 A full list of its features is available at:
42
43 http://www.minivend.com/
44
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
45 IMPORTANT NOTE: Interchange 4.5.x requires, repeat REQUIRES, Perl 5.005 or Perl 5.6.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
46
47 The information you need is in the following files:
48
49 README Copyright info, roadmap to installation
50 and pointers to support system
51
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
52 Copying Your Interchange license -- please read.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
53
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
54 QuickStart Document to help you install Interchange
55
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
56 WHATSNEW Change information for all versions in this
57 version family.
58
59 MANIFEST List of all core distribution files.
60
61 Major files/directories in the distribution:
62
63 Makefile.PL The installation scripts
64
65 dist/ The distribution files, exclusive of executable
66 files and modules. Includes:
67
68 minivend.cfg.dist Distribution minivend.cfg
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
69 barry/ The "barry" catalog demo application.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
70 simple/ The not so aptly named "simple" demo
71 application.
72 src/ C and Perl code for CGI links
73 compat/ Some Minivend-3 compatibility tags
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
74 lib/ User interface
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
75 usertag/ Some fairly-standard usertags
76
77 extra/ Some not-always-needed Perl libraries.
78
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
79 lib/ The library modules needed to run Interchange.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
80
81 scripts/ The executable files, relocated to bin in the run
82 directory.
83
84 test.pl The installation test script.
85
86 win/ Windows-specific files
87
88 UNIX INSTALLATION
89 ------------------
90 Here is the short version:
91
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
92 gzip -dc interchange-4.x.x.tar.gz | tar xvf -
93 cd interchange-4*
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
94 perl Makefile.PL
95 make
96 make test && make install
97
98 -- WHEN IN DOUBT, RE-START THE SERVER. It won't take but a few
99 seconds, and changes in configurable options don't take effect
100 until it is done. You may even change a page and not see the
101 effect until the server is restarted.
102
103 WINDOWS INSTALLATION
104 --------------------
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
105 Interchange will not yet run reliably on Windows.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
106
107 -------------------------------------------------------------------
108
109 A V A I L A B I L I T Y
110 A N D
111 C O M P A T I B I L I T Y
112
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
113 Interchange 4 has been tested on Solaris 2, Linux, FreeBSD, and Digital
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
114 UNIX/Tru64. Its predecessor Minivend 3 also reportedly runs on SCO, AIX,
115 and other Unix ports. It should work on any UNIX or Win32 OS with Perl
116 5.005 or higher.
117
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
118 IMPORTANT NOTE FOR BSD USERS: Interchange has been known to segfault when
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
119 reading sockets on Perl. This occurs more frequently on a busy system.
120 The workaround is to set in minivend.cfg:
121
122 MaxServers 0
123 Housekeeping 1
124
125 Windows does not support fork(), so the server runs in the foreground. There
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
126 are other differences, and there may be portablity problems. Interchange is
127 not yet tested to run on Windows; the canonical installation is UNIX.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
128
129 -------------------------------------------------------------------
130
131 D E M O
132
133 There are two demo applications included; one is not so aptly named "simple",
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
134 the other is "barry".
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
135
136 To install the demo, go to the directory where you installed
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
137 Interchange (default is "mvend" in your home directory or /usr/local/minivend
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
138 for root installations) and run:
139
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
140 bin/makecat barry
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
141
142 or
143
144 bin/makecat simple
145
84b0b0c @perusionmike Added QuickStart and edited README. Fixed a few image/splash page
perusionmike authored
146 or
147
148 bin/makecat any_id_you_pick
149
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
150 Follow the prompts and after restarting the Interchange server you
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
151 should be able to access the demo catalog.
152
153 -------------------------------------------------------------
154
155 D O C U M E N T A T I O N
156
157 The documentation is in several man pages and HTML files in the doc/
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
158 subdirectory of the main Interchange directory.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
159
160 There is an extended documentation package available
161 at www.minivend.com.
162
163 -------------------------------------------------------------
164
165 K N O W N P R O B L E M S
166
167 BSDI, FreeBSD, Net BSD:
168 You will need to make sure the following are in effect
169 in minivend.cfg:
170
171 MaxServers 0
172 Housekeeping 1
173
174 Expect lots of crashes if you don't do this.
175
176 Apache with SUEXEC:
177 VLINK/UNIX socket mode will not work well unless you do the
178 install as a normal user. If you are going to support multiple
179 users, you must use TLINK/INET mode.
180
181 Windows:
d6dc450 @perusionmike Changed Interchange name all over, minor exceptions being mvfaq.pod and
perusionmike authored
182 Interchange will not work properly with Windows. No strategy
183 has been yet developed for providing reliable operation on Windows.
Something went wrong with that request. Please try again.