Table of contents
Running Noojee Fax
- Running Noojee Fax
Generally you will want to run Noojee Fax as a daemon. You can however run Noojee Fax from the command line for testing purposes (and we do recommend this for initial testing).
Assuming that the Java 5 executable is on your path you can start Noojee Fax with the following command from /usr/lib/noojeefax:
java -jar Noojee Fax.jar
alternatively you can run
To run Noojee fax in the background use:
To run Noojee fax as a daemon see the section Running Noojee Fax as a Daemon.
The above command needs to be run from the directory where the Noojee Fax jar (normally /usr/lib/noojeefax) is located, otherwise it won't find the Noojee Fax.xml and the log4j.xml configuration files.
Co-existing with Sendmail (and other mail servers)
If you are running Noojee Fax's built in SMTP Gateway and have another SMTP server running on the same server as Noojee Fax then you may need to start Noojee Fax on an alternate IP address or Port (you still need to run Noojee Fax as a daemon). In this case you can start Noojee Fax as follows:
java -jar Noojee Fax <listen Host> <listen port>
where <listen Host> is the IP address for Noojee Fax to listen on and <listen port> is the port number for Noojee Fax to listen on. Generally we recommend that you run Noojee Fax on an alternate port as follows:
java -jar Noojee Fax 0.0.0.0 26
The above command will force Noojee Fax to listen on port 26 on all IP addresses.
Note: if you wish Noojee Fax to use port 25 in conjunction with another mail server you may also have to reconfigure your mail server to only listen on a specific IP address as most mail servers will by default listen on all available IP addresses.
If you receive a 'BindException' on start-up then Noojee Fax has a conflict with either another mail server or you have two instances of Noojee Fax running.
Running Noojee Fax as a Daemon
Regardless of the how you configure Noojee Fax (standalone or co-existing with sendmail) you will want to run Noojee Fax as a daemon.
A daemon process is a process which runs in the background and which is started automatically each time the system is booted.
The method you use to run Noojee Fax as a daemon will depend on the Linux Distribution.
For Redhat link the noojeefax.sh script into:
Red Hat and Red Hat-based distributions include an RPM, SYSVINIT, that includes a short bit of documentation named SYSVINITFILES. This document briefly explains the structure of such scripts.
Note: to install a scripts you need to place it in the right directory and run the CHKCONFIG utility to create the additional symlinks Red Hat requires.
Alternatively you can use inittab
Mainly for testing purposes you can also force Noojee Fax to run as a background task from the console by using:
of course when you next reboot Noojee Fax will NOT automatically be restarted.
You can also put an entry in ????
Once you have started Noojee Fax check the log file in logs/noojeefax.log (under the noojeefax install directory).