[cobalt-users] UNPROOFREAD (by an expert) a novice's guide to installing SPAMASSASSIN with fixes to some common problems

[jale@xxxxxxxxxx]

Someone may want to proofread this and post a new one with the subject line 
starting with PROOFED
-------------
<DISCLAIMER> - THIS WORKED FOR ME, IT WILL PROBABLY NOT WORK FOR YOU. IT 
WILL MOST LIKELY CRASH AND BURN YOUR SYSTEM WHICH IS NOT MY PROBLEM. 
PROCEED WITH CAUTION AND ASSUME IT IS ALL WRONG.
<END DISCLAIMER>
----------------------
If I knew a way to get this into the archives without posting it, I'd do 
it. But I figure this is a good way to be sure it is there.
------------------
The following is a pretty much step by step method to installing 
SPAMASSASSIN on a RAQ3i, other machines are probably the same or similar.
------------------
While installing SPAMASSASSIN I encountered many errors, that I learned 
what they meant - other modules had to be brought up to date first, and you 
have to be careful about deleting old files as you go to make new versions 
work.
------------------
This is listed in the order that I found I had to install things, as I got 
an error, I backtracked, installed the version of other dependent programs, 
then came back to where I was ... you may want to check the versions of 
what you have or work backwards and find out what is not up to snuff on 
your system. So the order below and the programs updated were done so 
because we were told we needed to do so by the various installers. You may 
need others, you may not need the same set that we did. Follow the concept 
and it may work for you.
If you need to find a particular installer, search at http://search.cpan.org/

------------------
Logon as admin (SSH or telnet, whichever you use, that's another post)

# su root

You can use wget in front of the various files to download them straight to 
the RAQ, but we could not since we have too much firewalling. So we used a 
PC and a browser and downloaded all the files, then ftp'd them to the 
server, we put them in a directory:

/home/sites/siteX/users/siteadmin-name/raq  (we used our own site for siteX)

then we copied all of the install files (ending in .gz) to

/usr/tmp/name-we-made-up

as we needed them. So where you see http below, you could probably use wget 
http instead and go straight to the RAQ box.

Wherever I put # at the front of the line, that is my root-prompt 
(remember, this is for Linux dummies to be able to do this)
Also, since we incorporated some of the new security measures, we had to 
enable execution on gcc:

# chmod +x /usr/bin/gcc

------------------
Check what version of File::Spec you are on, it has to be at least 0.8. 
This will tell you:

# perl -MFile::Spec -e 'print "$File::Spec::VERSION\n"'

If you have to update this on your system:

http://www.cpan.org/modules/by-module/File/File-Spec-0.8.tar.gz

(since this is the first one, I will go into detail, remember this is Raq 
for Idiots, 101)
The file was ftp's to /home/sites/siteX/users/siteadmin-name/raq after 
downloading to our PC
Then we copied it to our working directory:

# mkdir /usr/tmp/filespecins
# cd /usr/tmp/filespecins
# cp /home/sites/siteX/users/siteadmin-name/raq/File-Spec-0.8.tar.gz .
 (there is a period . at the end of that line meaning *here*)
# tar -xzvf File-Spec-0.8.tar.gz

Then we started the install (we did them one at a time so we could easily 
see errors in each step)

# cd File-Spec-0.8
# perl ./Makefile.PL make
# make test
# make install UNINST=1
# cd  /usr/tmp
# rm -r filespecins

The last step was only done if we had no errors, if you have errors, 
correct them by installing other needed upgrades and repeat other steps in 
this set.

WARNING - BE CAREFUL with rm -r   --- if you do a cd / then rm -r you will 
remove every file on your system. I don't believe you want to do that. You 
only do that to a customer that does not pay there bill. They may not pay 
their bill after that, but the personal satisfaction is really worth it.

------------------
Now we'll assume you get the picture, here are the next files without every 
line of instruction.

Updating HTML-Tagset

http://search.cpan.org/CPAN/authors/id/S/SB/SBURKE/HTML-Tagset-3.03.tar.gz

# mkdir /usr/tmp/tagsetins
# cd /usr/tmp/tagsetins
# cp /home/sites/siteX/users/siteadmin-name/raq/HTML-Tagset-3.03.tar.gz .
 (there is a period . at the end of that line meaning *here*)
# tar -xzvf HTML-Tagset-3.03.tar.gz
# cd HTML-Tagset-3.03.tar.gz
# perl ./Makefile.PL make
# make test
# make install UNINST=1
# cd /usr/tmp
# rm -r tagsetins

If you get warnings at the end that say something like:

## Differing version of HTML/Entities.pm found. You might like to
rm /usr/lib/perl5/site_perl/5.005/HTML/Entities.pm

You should copy/paste those names to a text file so you don't lose them. 
Then do an rm command on each one. The UNINST above hopefully took care of 
this for you.

--------------
The HTML-Parser html parser 3.0+ - first I had to update the html-tagset 
then the parser

Updating HTML-Parser

http://search.cpan.org/CPAN/authors/id/G/GA/GAAS/HTML-Parser-3.26.tar.gz

# mkdir /usr/tmp/parserins
# cd /usr/tmp/parserins
# cp /home/sites/siteX/users/siteadmin-name/raq/HTML-Parser-3.26.tar.gz
 (there is a period . at the end of that line meaning *here*)
# tar -xzvf HTML-Parser-3.26.tar.gz
# cd HTML-Parser-3.26.tar.gz
# perl ./Makefile.PL make
# make test
# make install UNINST=1
# cd /usr/tmp
# rm -r parserins

-----------------------
The rest is brief because it is from other posts, but everything is here, I 
think.:

Now you need all the SpamAssassin files - these are the most current as of 
9-19-2002

http://spamassassin.taint.org/released/Mail-SpamAssassin-2.41.tar.gz
http://www.cpan.org/modules/by-module/Pod/podlators-1.24.tar.gz
http://www.cpan.org/authors/id/DEWEG/Time-HiRes-01.20.tar.gz
http://www.cpan.org/modules/by-module/Pod/PodParser-1.18.tar.gz

# mkdir /usr/tmp/spamassins

copy the 4 files above to this folder, you should know what to do by now, 
here is the order of things

tar -xzvf PodParser-1.18.tar.gz
tar -xzvf podlators-1.22.tar.gz
tar -xzvf Time-HiRes-01.20.tar.gz
tar -xzvf Mail-SpamAssassin-2.31.tar.gz

The only difference we made was we did not group the command together like 
shown below. Since we were having errors, thus this writeup, we chose to do 
them line by line so we could easily spot our failures. So where you see:
(perl ./Makefile.PL make;make test;make install)
you can use the same format as above . Now we used the UNINST=1 also, but 
not sure if we should have done that

cd PodParser-1.18
(perl ./Makefile.PL make;make test;make install)
cd ../podlators-1.24
(perl ./Makefile.PL make;make install)
cd ../Time-HiRes-01.20
(perl ./Makefile.PL make;make test;make install)
cd ../Mail-SpamAssassin-2.41
(perl ./Makefile.PL make;make test;make install UNINST=1)
cd /tmp
rm -r spamassins

MOST IMPORTANTLY, DON'T FORGET THIS LINE:

# chmod -x /usr/bin/gcc

That is a security thing, nothing to do with this install.

Hope this helps someone save the 3 days it took us to compile this.
Jale