[ic] HOW-TO for installing Interchange 4.8.3 (RPM) on Mitel SME v5
Tom Carroll
interchange-users@interchange.redhat.com
Thu Jan 10 20:32:00 2002
How to set up Interchange 4.8.3 in Mitel SME v5
-----------------------------------------------
Originally written by Justin Funke (March 12, 2001)
Contributions provided by Jon Pamment (November 2001)
Modifications made by Tom Carroll (January 4, 2002) (egor@carrollweb.net)
Thanks to Justin and Jon for their earlier work!
Description
-----------
This how-to will get you started with the RedHat e-commerce package
Interchange.
Notes
-----
There may be better ways of setting up Interchange under SME v5, but this
will at least get you up and running with a demo catalog and allow you to
start the IC learning process. This has not been used in a production
environment! The Interchange package is installed on the system through
the use of an ibay. The ibay is built with permissions for everyone to
access and this is a major security problem if you have other users on
your LAN. TEST AT YOUR OWN RISK!
Details
-------
Your catalogs are located in the /var/lib/interchange/~ directory. An
e-smith specific rpm was contemplated, however after getting familiar with
the application the decision was made that it is not necessary since all
security is handled through the CGI script for the store. The primary
risk is that your store pages can be modified by others within your own
lan. Nothing of importance is stored within the ibay itself. After many
failed attempts, Interchange would not work like Gallery or PHPMyAdmin
through the /opt/~ directory.
Procedures
----------
1. Make an ibay on your e-smith server with permissions set to "edit and
read" for everyone no password required. Make sure execute cgi is enabled.
2. Install the interchange rpms and required support files.
Note: Not all these modules are needed, but a minimum required
listing has not been put together to show what modules.you need
for various features. This is what I have downloaded and
installed personally:
rpm -ivh http://ftp.interchange.redhat.com/interchange/4.8/rpm/interchange\
-4.8.3-1.noarch.rpm
rpm -ivh http://ftp.interchange.redhat.com/interchange/4.8/rpm/interchange\
-foundation-4.8.3-1.noarch.rpm
rpm -ivh http://ftp.interchange.redhat.com/interchange/4.8/rpm/interchange\
-foundation-demo-4.8.3-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Archive-Tar-0.22-10.i\
386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Archive-Zip-0.11-1.i3\
86.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Business-UPS-1.13-10.\
i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Compress-Zlib-1.13-1.\
i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Crypt-SSLeay-0.27-1.i\
386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-DBD-Pg-1.00-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-File-CounterFile-0.12\
-10.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-HTML-Parser-3.25-1.i3\
86.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-HTML-Tagset-3.03-1.i3\
86.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-IO-stringy-1.220-1.i3\
86.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Image-Size-2.93-1.i38\
6.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-MIME-Base64-2.12-1.i3\
86.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Mail-Sendmail-0.78-10\
.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Newt-1.08-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-OLE-Storage_Lite-0.09\
-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Parse-RecDescent-1.80\
-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-SOAP-Lite-0.50-1.i386\
.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-SQL-Statement-0.1020-\
1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Safe-Hole-0.08-1.i386\
.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Spreadsheet-ParseExce\
l-0.22.3-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Spreadsheet-WriteExce\
l-0.32-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Storable-1.0.11-1.i38\
6.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Term-ReadLine-Perl-0.\
9908-10.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-TermReadKey-2.14-10.i\
386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Tie-Watch-1.0-10.i386\
.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-Time-HiRes-01.20-10.i\
386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-URI-1.12-1.i386.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-XML-Parser-2.30-1.i38\
6.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-libnet-1.0703-10.i386\
.rpm
rpm -ivh http://ftp.interchange.redhat.com/perl/perl-libwww-perl-5.53-1.i3\
86.rpm
** The following rpm's are not listed in the CPAN list, but were required
for me to use Interchange with MySQL support on SME v5:
rpm -ivh ftp://rpmfind.net/linux/redhat/7.1/en/os/i386/RedHat/RPMS/perl-DB\
D-MySQL-1.2215-1.i386.rpm
rpm -ivh ftp://rpmfind.net/linux/redhat/7.1/en/os/i386/RedHat/RPMS/mysql-d\
evel-3.23.36-1.i386.rpm
rpm -ivh ftp://rpmfind.net/linux/redhat/7.1/en/os/i386/RedHat/RPMS/perl-DB\
I-1.14-10.i386.rpm
3. Add a soft link to start interchange server on e-smith reboot run level
7.
ln -s /etc/rc.d/init.d/interchange /etc/rc.d/rc7.d/S95interchange
4. Be sure to set the interch user password using the passwd utility.
5. Set permissions and ownerships on the installed interchange files and
directories.
chown interch.interch /usr/lib/interchange -R
6. Make the catalog - The catalog is based on the server www.myserver.com
and an ibay name "pub"
/usr/lib/interchange/bin/makecat
Catalog name = "foundation"
Enter path to httpd.conf file: "/etc/httpd/conf/httpd.conf"
Server name: "www.myserver.com/pub"
DemoType? "foundation"
permtype? "M"
InterchangeUser? "interch"
CatUser? "root"
InterchangeGroup? <blank>
MailOrderTo? "orders@myserver.com"
CatRoot? "/var/lib/interchange/foundation"
CgiDir? "/home/e-smith/files/ibays/pub/cgi-bin"
CgiUrl? "/pub/cgi-bin/foundation"
Aliases? "/foundation"
DocumentRoot? "/home/e-smith/files/ibays/pub/html"
SampleHtml? "/home/e-smith/files/ibays/pub/html/foundation"
ImageDir? "/home/e-smith/files/ibays/pub/html/foundation/images"
ImageUrl? "/pub/foundation/images"
INET or UNIX mode? "UNIX"
Do you use CGIWRAP or SUEXEC? "n"
Your company name "Foundation Store"
Sample data type?: "tools"
Set to 1 if you want to use MySQL, PostgreSQL, or Oracle: .. <enter>
Account name that will control this catalog:..... "interchange"
Administrative password: ........................."pass"
Set to 1 to display demo helper features in your store: "1"
run "sh /var/lib/interchange/test/config/makedirs"? "y"
run "sh /var/lib/interchange/test/config/installsample"? "y"
Add catalog to interchange.cfg? "y"
7. Let it finish and watch for any errors.
8. Change ownership and group for the catalog back to "interch" since we
just built the catalog as root.
chown interch.interch /var/log/interchange/error.log
chown interch.interch /var/lib/interchange -R
9. Check the following permissions
ls -al /home/e-smith/files/ibays/pub/cgi-bin/foundation
-rwsrwxr-x 1 interch interch foundation
if it does not have these permissions use the following:
chmod 4771 /home/e-smith/files/ibays/pub/cgi-bin/foundation
ls -al /usr/lib/interchange/etc/socket
srw-rw-rw- 1 interch interch socket
if it does not have these permissions use the following:
chmod 666 /usr/lib/interchange/etc/socket
10. The makecat utility has a bug in it that copies support files to the
/var/www/html/~ directory instead of where the files should be copied
to on a SME O/S. To correct this, just do the following:
mv /var/www/html/foundation /home/e-smith/files/iabys/pub/html/
mv /var/www/html/interchange /home/e-smith/files/ibays/pub/html/
11. Restart the interchange server as user interch.
su -c "/usr/lib/interchange/bin/interchange -r" interch
12. Check to make sure it is working at
http://www.myserver.com/pub/foundation
13. If you receive any errors, you may need to do a full reboot,
shutdown -r now
Note: If you experience a problem on the links at the top of the page not
working because the "pub" directory is coming up twice - redo the
catalog configuration and remove the italicized "pub" from line 3 of
the catalog configuration script.