2. Installation

Junkbuster is available as raw source code, or pre-compiled binaries. See the Junkbuster Home Page for current release info. Junkbuster is also available via CVS. This is the recommended approach at this time. But please be aware that CVS is constantly changing, and it may break in mysterious ways.

2.1. Source

For gzipped tar archives, unpack the source:

 tar zxvf ijb_source_2.9*
 cd ijb_source_2.9*
 

For retrieving the current CVS sources, you'll need the CVS package installed first. To download CVS source:

  cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
  cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co current
  cd current
 

This will create a directory named current/, which will contain the source tree.

Then, in either case, to build from source:

 autoconf           #recommended for CVS source
 ./configure
 make
 su
 make install
 

For Redhat and SuSE Linux RPM packages, see below.

2.2. Red Hat

To build Redhat RPM packages, install source as above. Then:

 autoconf              #recommended for CVS source
 ./configure
 make redhat-dist
 

This will create both binary and src RPMs in the usual places. Example:

   /usr/src/redhat/RPMS/i686/junkbuster-2.9.8-1.i686.rpm

   /usr/src/redhat/SRPMS/junkbuster-2.9.9-1.src.rpm

To install, of course:

 rpm -Uvv /usr/src/redhat/RPMS/i686/junkbuster-2.9.9-1.i686.rpm
 

This will place the Junkbuster configuration files in /etc/junkbuster/, and log files in /var/log/junkbuster/.

2.3. SuSE

To build SuSE RPM packages, install source as above. Then:

 autoconf             #recommended for CVS source
 ./configure
 make suse-dist
 

This will create both binary and src RPMs in the usual places. Example:

   /usr/src/suse/RPMS/i686/junkbuster-2.9.9-1.i686.rpm

   /usr/src/suse/SRPMS/junkbuster-2.9.9-1.src.rpm

To install, of course:

 rpm -Uvv /usr/src/suse/RPMS/i686/junkbuster-2.9.9-1.i686.rpm
 

This will place the Junkbuster configuration files in /etc/junkbuster/, and log files in /var/log/junkbuster/.

2.4. OS/2

The OS/2 version of Junkbuster requires the EMX runtime library to be installed. The EMX runtime library is available on the hobbes OS/2 archive, among many other locations: http://hobbes.nmsu.edu/cgi-bin/h-search?sh=1&button=Search&key=emxrt.zip&stype=all&sort=type&dir=%2Fpub%2Fos2%2Fdev%2Femx%2Fv0.9d

Junkbuster is packaged in a WarpIN self- installing archive. The self-installing program will be named depending on the release version, something like: ijbos123.exe. In order to install it, simply run this executable or double-click on its icon and follow the WarpIN installation panels. A shadow of the Junkbuster executable will be placed in your startup folder so it will start automatically whenever OS/2 starts.

The directory you choose to install Junkbuster into will contain all of the configuration files.

If you would like to build binary images on OS/2 yourself, you will need a working EMX/GCC environment, plus several Unix-like tools. The Hobbes OS/2 archive is a good place to start when building such an environment. A set of Unix-like tools named gnupack is located here: http://hobbes.nmsu.edu/cgi-bin/h-search?sh=1&key=gnupack&stype=all&sort=type&dir=%2Fpub%2Fos2%2Fapps

Once you have the source code unpacked as above, you can build the binaries from the current/ directory:

 autoconf
 sh configure
 make
 

2.5. Windows

Click-click. (I need help on this. Not a clue here. Also for configuration section below. HB.)

2.6. Other

Some quick notes on other Operating Systems.

For FreeBSD (and other *BSDs?), the build will need gmake instead of the included make. gmake is available from http://www.gnu.org. The rest should be the same as above for Linux/Unix.