Click Here For JSpamFilter Click Here For Latest Downloads. Click Here To Request A Free Trial Of JSpamFilter. Click Here To Purchase JSpamFilter. Click Here For Our Support Section. Click Here For The JSpamFilter Manual. Click Here For A List Of Our FAQs. Click Here For The SiteMap. Click Here To Contact Us. Click Here For Information About Modest Software.

Modest Software, Inc.

Part 4 (JSpamFilter Installation)
Previous Section Part 3 (Pre-Installation Checklist) Part 5 (JSpamFilter License and Log Directory) Next Section
JSpamFilter Manual Symbol Legend

Step Zero: Start and Unpack
Step One: Listen IP
Step Two: Listen Port
Step Three: Talk IP
Step Four: Talk Port
Step Five: Enter License Key
Step Six: Server Name
Step Seven: Local Domain(s)
Step Eight: Path to JVM
Steps Nine - Fifteen: Confirmation of Installed Components

1.) if you are installing over a previous installation of JSpamFilter on Microsoft Windows, please run the UninstallService.bat file first. This will be located in your existing JSpamFilter directory.
Uninstall directions are available by clicking here. Platform-specific configuration notes are available here.
2.) Click here for installation notes for *nix-like operating systems (e.g., Linux, OS X, BSD). It should also be noted that the configuration choices covered below correspond to the entries of the JSpamFilter.conf file and apply to all platforms*. *The installation of the JavaService does not apply to *nix installations.
We are developing additional installation and configuration notes, to be released soon.

Pre-installation Review and Notes:
The description that follows covers the specific steps installing JSpamFilter with the graphical installation assistant. The choices for a the non-graphical installation are the same, though you don't have to follow any particular order.
Keep handy the path to your JRE executable (i.e., the "server" jvm.dll) that you noted in the Pre-Installation step (e.g., C:\j2sdk1.4.2_04\jre\bin\server\jvm.dll). Note this because during the installation process you will need to confirm the location of the JRE and the installer may not "guess" the right location.
If you use the non-graphical installation, note that JSpamFilter is distributed as a Java Archive (.jar) file, and accepts one command-line parameter, which should be the full path to its configuration file. If no file is specified on the command line, the "current" directory will be checked for a file called "JSpamFilter.conf".

JSpamFilter is going to be "inserted" into the mail flow and if your mail server is running, JSpamFilter will not be able to bind to port 25 during the installation process.
  • JSpamFilter now has a graphical Installation Assistant for any windowing system that supports Java. The Installation Assistant speeds the installation process by ensuring that all configuration parameters are valid (e.g., verifies that a mail server is running at the talk IP and port specified, etc.).

    You will need to be able to supply the following pieces of information during the installation:

    IP address JSpamFilter is to listen on
    IP address the Mail Server is listening on
    Port Number JSpamFilter listens on (default is 25)
    Port Number the Mail Server listens on (default is 26)

    Please note that the talk and listen IP addresses, port numbers, or both must be different.
To complete tne installation, you will need either a permanent, non-expiring JSpamFilter license or a current, non-expired Trial License to run JSpamFilter. Trial Licenses are fully-featured, time-limited licenses, you can request a free, no-obligation Trial License by filling out the request form here.

Step Zero:        [Click here to go back to the top of the page.]
Start the graphical installer by double-clicking on the JSpamFilter_Windows.exe to begin the installation process.

The pre-installation archive decompressor will ask you to confirm the installation location.
Choose Directory Successful Decompression

The default location is:


Either accept this location by clicking yes or select a different location (note that you will need to remember where you installed JSpamFilter).

If you are installing JSpamFilter "manually", create a configuration file named "JSpamFilter.conf". See the "Configuration Options" and "Sample Configuration" sections of this manual for more information.

Begin Installation

Step One:        [Click here to go back to the top of the page.]
After the greeting page, the Installation Assistant will begin the installation process by prompting you for the IP address on which you want JSpamFilter to listen (this will be the IP addresses from which mail could be received).

1. What is the IP address you want JSpamFilter to listen on?
The current value is: all

Listen IP Address
Please Take Note! The JSpamFilter Configurator will give you the option of either verifying the current choice or accepting the default. If you are not sure, use the verify function to check that the default selection (or whatever you have chosen) works.
Valid Listen IP Address

The default value for the "listening" IP address is:


And you should leave this choice as it is.

This means that you will be listening for messages sent from any address on the Internet. If you choose to block certain addresses or blocks of addresses, you should do so explicitly later using the block parameter, discussed in detail in Seciont

Block=(IP address or block)

Please Note! Additionally, while JSpamFilter can be installed on any machine in the mail flow, it needs to be the "first link in the chain" in that it needs to be able to "see" the incoming mail as it arrives in order to use the various DNSBL and SURBL lookup functions. That is, for JSpamFilter to determine whether a sending server is on a DNSBL or SURBL list, JSpamFilter has to be able to "see" the IP address from which incomiing mail is being sent.

Step Two:        [Click here to go back to the top of the page.]
2. What is the TCP Port number you want JSpamFilter to listen on?
The current value is: 25 (Simply press your key to accept the current value.)

listen Port

The default value is:


and you should leave this value as port 25 is the standard port on which SMTP mail is sent. The mail servers sending you mail will be sending the mail on port 25, so you should leave this value so that JSpamFilter is listening for incoming connections.
Please Note! If your mail server is still listening on this port, you will receive the following error message:
* I am unable to bind to that IP address and port number.
* This is usually because the mail server is still listening
* on that port, and only one process is allowed to.
* Please verify that the mail server is NOT listening on that port.
* (Response from socket bind was:
* Address already in use: JVM_Bind)

Step Three:        [Click here to go back to the top of the page.]
3. what is the IP address you want JSpamFilter to "talk" to?
The current value is: all (Simply press your <enter> key to accept the current value.)

Talk IP Address

The default value is:


This represents the IP address which the mail server is listening to. You can leave this value at all, but you may want to change it to the specific IP address of your mail server (e.g., an internal address). See the notes in the next step.

Step Four:        [Click here to go back to the top of the page.]
4. What is the TCP Port number you want JSpamFilter to Talk on?
The current value is: 26

Talk Port

The default value is:

Possible error:
I am unable to connect to a mail server at the IP and port entered.
This is usually because there isn't a server there!
You can also try to connect to the mail server using the telnet command:
telnet localhost 26
Please verify that the mail server is listening on that port.
(Response from socket connect was: Connection refused: connect)

A Possible Error Message

Change the mail server to listen on port 26, if you'll be running JSpamFilter on the same machine as the mail server. Notes on changing the "listen" port on various mail servers can be found here.

Please Take Note! You may have to go back and change the "Talk" IP address of your mail server from "all" to the specific IP address of your mail server. (Note: the IP address of the mail server is the IP address that JSpamFilter "talks" to).

Reset the Talk IP Address

Where XXX.XXX.XXX.XXX is the IP address of your mail server.

The Talk IP Address and Port are Valid

Step Five:        [Click here to go back to the top of the page.]
5.) Please paste your one- or two-line license key into the blank below.
If you license key includes an expiration, you must paste both lines.

JSpamFilter License Key

Paste your JSpamFilter License Key into the space provided (note: window may resize after you have pasted the information; this is harmless, just resize back and continue).

Step Six:        [Click here to go back to the top of the page.]
6.) What is the full host name of your mail server?

Mail Server Host Name

Substitute your mail server's fully qualified host name (e.g., for the provided value.

Step Seven:        [Click here to go back to the top of the page.]

7.) What domains are local to your mail server?

Local Domains - You Can Add More Later

Enter at least one domain served by, that is local to, your mail server (e.g., the primary domain name).
Please Note! NOTE: You do not need to supply all the domain names local to your mail server at this stage. In fact, if there are several, just supply one now and add the others later (see: Section 7: Basic Server and Domain Configuration).

Step Seven, Cont'd:        [Click here to go back to the top of the page.]

What is the full path to your filter file?

Path to the Filter File

Make sure that the stated default path is correct or change it to the path to your filter file (e.g., this was the directory in which JSpamFilter was installed).

Step Seven, Cont'd:

Confirmation of correct path to filter file

Path to Filter File Confirmed

Step Seven, Cont'd:

You have successfully completed the basic configuration!
Now, we install the network service and we're done!

Basic JSpamFilter Configuration is Complete!

Step seven, Cont'd:

The JSpamFilter Configurator asks if you would like to JSpamFilter as a service.

Install JavaService

You should answer "yes".

Step Eight:        [Click here to go back to the top of the page.]
What is the path to your jvm.dll?

Path to jvm.dll

Click "Verify" to determine if this is the correct fully-qualified path to the server jvm.dll.

Step Eight, Cont'd:
If you see this error, it means that the JRE is not where the Configurator thinks it should be.

You may get this error
Please Note!
If you recieve this error message, compare the given value of the full path to the server JRE (i.e., the "server" version of jvm.dll) to the path you noted in the pre-installation checklist in the previous section Part 3 (Pre-Installation Checklist).
JSpamFilter uses environment variables to "guess" where your JRE is located. Sometimes the JVM doesn't report this location correctly.
We've noticed that the environment variable will report that the path is:
C:\Program Files\Java\jre1.5.0_02\jre\bin\server\
When it is actually:
C:\Program Files\Java\jdk1.5.0_02\jre\bin\server\

Step Eight, Cont'd:

Substitute the correct path to the JRE

You may have to reset the path to the jvm.dll

Please Take Note!

NOTE: When you download the installer from Sun Microsystems, make sure you download the Java "Software Development Kit" SDK (formerly called "JDK" or "Java Development Kit") and not just the JRE as the JRE does not include the server version of jvm.dll.

Step Nine:        [Click here to go back to the top of the page.]
The Configurator confirms that it found JSpamFilter.jar

Path to the JSpamFilter Jar File

Step Ten:
The Configurator confirms that it found JSpamFilter.conf

JSpamFilter Jar File Found Successfully

Step Eleven:
The Configurator confirms that it found JavaService.exe

JavaService.exe Found Successfully

Step Twelve:
JavaService is being installed

Installing Service

Step Thirteen:
Woo-hoo! We're Done!

JSpamFilter Installation Complete!

Step Fourteen:
Thank you for using JSpamFilter! We do appreciate it!

Thank You For Using JSpamFilter

Step Fifteen:

Configure your system to start JSpamFilter when the server starts.
Instructions for this are platform-specific:

See Section 13: Platform Specific Installation Instructions.

Previous Section Part 3 (Pre-Installation Checklist) Part 5 (JSpamFilter License and Log Directory) Next Section

JSpamFilter  |  Free Trials  |  About Us  |  Privacy  |  Contact  |  License  |  Site Map

Copyright ModestSoftware 2002 - 2018