Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 158 lines (98 sloc) 5.556 kB
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
1 -----------------------------------------------------------------------------
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
2
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
3 Interchange RPM packages for Red Hat Linux and compatible operating systems
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
4
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
5 -----------------------------------------------------------------------------
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
6
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
7 The Interchange RPM packages integrate Interchange with a Red Hat Linux
8 or compatible operating system. Files are installed in the usual Linux
9 Standard Base locations:
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
10
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
11 Interchange base: /usr/lib/interchange.
12
13 Executables: /usr/lib/interchange/bin.
14
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
15 Configuration: The global Interchange configuration file is
16 /etc/interchange.cfg. It is only writable by root.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
17
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
18 Data: Catalog directories are located by default in /var/lib/interchange.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
19
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
20 Invocation: Invocation is the normal /etc/rc.d/init.d startup method.
21 Interchange installs to be active in run levels 3, 4, and 5; to be killed
22 in all.
23
24 Logs: Logs go in /var/log/interchange. The subdirectory is needed to
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
25 allow the Interchange user ID to write/create files. A configuration file
26 is added to /etc/logrotate.d to do log rotation.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
27
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
28 Run: Run files go in /var/run/interchange. This includes the UNIX-domain
29 socket and catalog status files. The subdirectory is needed to allow
30 the Interchange user ID to write/create files.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
31
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
32 Sessions and temporary files: /var/cache/interchange.
33
e28246e @machack666 update copyright dates and version numbers for release
machack666 authored
34 Documentation: /usr/share/doc/interchange-5.7.7.
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
35
36 On a dedicated production server, it is wise to segregate as many of these
37 directories as possible onto their own partitions, to prevent problems if
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
38 one partition runs out of inodes or disk space, or you have a disk failure.
39
40
41 DEPENDENCIES
42
43 Interchange requires many Perl modules from CPAN. Many of these do not
44 usually come supplied with your operating system, so you will need to
45 install them yourself. It's best to locate RPMs for each of the needed
46 Perl modules and install them. To get a complete list of dependencies, do:
47
e28246e @machack666 update copyright dates and version numbers for release
machack666 authored
48 rpm -qp --requires interchange-5.7.7-1.*.rpm
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
49
50 Unfortunately, there's not currently a reliable, steady source of the latest
51 CPAN modules in RPM format for most operating systems. Thus the easiest way
52 to install them is to use CPAN to build the modules from source. First set
53 up CPAN and install its auxiliary modules:
54
55 perl -MCPAN -e'install Bundle::CPAN'
56
57 Then install the main modules Interchange uses:
58
59 perl -MCPAN -e'install Bundle::Interchange'
60
61 Instead you may want to install a bundle that includes many optional but
62 useful modules:
63
64 perl -MCPAN -e'install Bundle::InterchangeKitchenSink'
65
66
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
67 INSTALL
68
e28246e @machack666 update copyright dates and version numbers for release
machack666 authored
69 rpm -Uvh interchange-5.7.7-1.*.rpm
70 rpm -Uvh interchange-standard-5.7.7-1.*.rpm
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
71
b0baa2a @jonjensen Bump version to 5.7.1, and update some instructions.
jonjensen authored
72 If you have installed CPAN modules from source, rather than RPM, you'll need
73 to install the main interchange package without dependency checking because
74 RPM doesn't know about those modules you installed:
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
75
e28246e @machack666 update copyright dates and version numbers for release
machack666 authored
76 rpm -Uvh --nodeps interchange-5.7.7-1.*.rpm
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
77
78
79 STARTING/RESTARTING INTERCHANGE
80
81 Interchange, as installed from the RPM, needs a special invocation from
82 /usr/sbin/interchange. This is because the locations of configuration,
83 run, and log files differ from the places Interchange has traditionally
84 expected them.
85
86 As either the 'interch' user or the root user you should start or restart
87 interchange with this command:
88
89 /usr/sbin/interchange -r
90
91 NOTE: Contrary to other documentation, you SHOULD NOT use 'bin/restart'
92 or directly call 'bin/interchange' to start or restart Interchange when
93 you use the RPM installation.
94
95
96 -----------------------------------------------------------------------------
97
98 Live Demo Catalog in RPM Format
99
100 -----------------------------------------------------------------------------
101
102 There is a separate RPM that provides a live demonstration catalog called
dca6619 @perusionmike * Make dist/standard the template that comes with Interchange.
perusionmike authored
103 'standard', which you may optionally use to quickly try out Interchange.
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
104 It should not be used as a basis for a real catalog; instead build
105 your own with the makecat tool in '/usr/lib/interchange/bin/makecat',
dca6619 @perusionmike * Make dist/standard the template that comes with Interchange.
perusionmike authored
106 as described in the documentation. Do not confuse the 'standard' live demo
107 with the 'standard' catalog skeleton from which you are encouraged to build
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
108 your own catalog.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
109
110
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
111 APACHE ASSUMPTIONS
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
112
dca6619 @perusionmike * Make dist/standard the template that comes with Interchange.
perusionmike authored
113 The standard-demo RPM relies upon the following things in the Apache
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
114 installation:
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
115
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
116 -- Standard document root and CGI binary locations:
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
117
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
118 DocumentRoot /var/www/html
119 ScriptAlias /cgi-bin/ /var/www/cgi-bin/
c9b1cf5 @jonjensen Changed /usr/local/interchange references to /usr/lib/interchange to …
jonjensen authored
120
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
121 -- ServerName must be the same as what is revealed by `hostname` when
dca6619 @perusionmike * Make dist/standard the template that comes with Interchange.
perusionmike authored
122 the standard RPM is installed. If it is not, temporarily change the
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
123 hostname with a command like 'hostname new.host.name' and then install
dca6619 @perusionmike * Make dist/standard the template that comes with Interchange.
perusionmike authored
124 the standard-demo RPM. Afterwards you can change the hostname back
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
125 to normal.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
126
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
127 -- suEXEC not enabled. If you have suEXEC enabled, you are responsible
128 for changing permissions and running parameters appropriately. You
129 can typically disable suEXEC by running `chmod u-s /usr/bin/suexec'.
130 If you want to continue to use suEXEC, you will have to compile the
131 appropriate INET mode link program and use it instead of vlink.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
132
133
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
134 INSTALL
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
135
e28246e @machack666 update copyright dates and version numbers for release
machack666 authored
136 rpm -Uvh interchange-standard-demo-5.7.7-1.*.rpm
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
137
138
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
139 USING THE DEMO
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
140
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
141 Once installed, you should be able to access the demo catalog like this
142 (using your own hostname, of course):
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
143
dca6619 @perusionmike * Make dist/standard the template that comes with Interchange.
perusionmike authored
144 http://hostname/standard/
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
145
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
146 The initial administrative user name is "interch", and the password is
1ea500f @jonjensen Update for release, and begin painful process of documenting dependen…
jonjensen authored
147 "pass". Change the password as soon as possible.
5550c3a @perusionmike Initial import of changed Challenger with UI instead of Minimate.
perusionmike authored
148
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
149
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
150 -----------------------------------------------------------------------------
151
152 More information
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
153
71d22bb @jonjensen Update RPM documentation to cover interchange-foundation-demo and
jonjensen authored
154 -----------------------------------------------------------------------------
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
155
60c4edb @jonjensen Update some notices, URLs, etc.
jonjensen authored
156 http://www.icdevgroup.org/ has complete documentation, user mailing
b31a690 @jonjensen Move DEV_4_7_0 development branch to repository trunk.
jonjensen authored
157 list information, and other resources.
Something went wrong with that request. Please try again.