Network Scanjet 5 Configuration

This is a very brief set of tips on how to configure your newly-upgraded scanner. This is just going to cover some of the basics unless someone else contributes more. Everything here, and much more, is all well-documented in the documentation and references I have provided.

As the scanner runs FreeBSD, a Unix-like operating system, you will need to use Unix commands and system administration principals. Some of these changes, if not executed correctly, can prevent your scanner from booting up corrrectly (particularly anything in the "rc.conf" and "fstab" files).

You are going to be largely on your own to read the appropriate documentation to figure out how to configure your scanner. If you are not willing to invest some time to learn a little bit about Unix systems, you probably should not install this software, or you should pay someone for support.

That said, I have put together this page on getting started, which is especially targetted for users with little or no Unix experience. It's meant to be just enough to allow them to get their scanner running and encourage them to learn some more on their own.

Look at this as an opportunity to expand your knowledge!

Making Changes

To make changes to the scanner configuration, you will need to connect to it using an SSH client. If you are using a Windows system, I highly recommend using PuTTY, which is freely available.

To log into the scanner, use the default user name "scanjet" and default password "72265385" (which is "scanjet5" on the scanner or telephone keypad). Once logged in, to make changes, you will need to become the "root" user and mount the root filesystem read-write. Use the following commands:

$ su -
# mount -u -rw /

Note that the first character and following space on these lines are the system command prompt -- do not type them in, just what is after them.

I also recommend stopping the main scanner program when you are configuring the scanner:

# sjctl stop

When you are done configuring, you should mount the root filesystem read-only again, restart the main scanner program, and log out:

# mount -u -r /
# sjctl start
# exit
$ exit

Configuring Email

To configure the scanner to be able to send email, you must configure the scanner with a "smarthost", that is, a server that will accept and deliver outgoing email. This is likely your own email server, if you have one, or your Internet provider's if you don't. It is the same server that is configured in your email-reading program for sending mail.

To configure:

# cd /etc/mail
# ee freebsd.submit.mc

Change "[127.0.0.1]" on the last line to your mail server name or IP address. If IP address, it must be in square brackets like the original address, if by name, remove the brackets. Exit and save the changes.

You may, of course, also use the "vi" editor instead of "ee" if you are familiar with it; "ee" is easier for beginners.

Then install the new email configuration and restart the mail-handling service:

# make install-submit-cf
# cd /etc
# sh rc.sendmail restart

Configuring Printers

In order for the "Copy" function to work, you will need to configure one or more printers. At this time, only PCL (not Postscript) printers are supported. You need to configure your printers both in /etc/printcap for the print spooler, and in /usr/local/etc/sjrun.conf for the scanner software. The "lpd" print spooler also needs to be enabled in /etc/rc.conf.

To configure /etc/printcap:

# cd /etc
# ee printcap

Add entries like the following for each printer you are configuring:

lp:\
    :sh:sf:mx#0:rm=192.168.1.1:rp=raw:\
    :sd=/var/spool/output/lpd:lf=/var/log/lpd-errs:\

If you are configuring more than one printer, you will need to assign a different name for each printer (the initial "lp" above) and a different spool directory for each (the "/var/spool/output/lpd" above). Change the IP address as appropriate to match that of your printers. Depending on the printer interface model, the "raw" parameter might or might not be correct. If you are using a multi-port JetDirect print server, use "raw1", "raw2", "raw3", etc., depending on which port your printer is on. Other models may work with settings of "PASS", "text", or "auto".

If you are configuring more than one printer (or you are configuring only one but want to change the name from the default), you will need to configure the scanner software also in /usr/local/etc/sjrun.conf.

To configure /usr/local/etc/sjrun.conf:

# cd /usr/local/etc
# ee sjrun.conf

You will need to create entries like the following (this example is for two printers, adjust as needed):

printer_list="lp|lp2"
printer_lp="Printer 1|Name"
printer_lp2="Printer 2|Name"

where "lp" and "lp2" match the names you assigned in /etc/printcap. The last two settings determine what the printers are called on the LCD display. Read the comments in /usr/local/etc/sjrun.conf.default for more information on these settings.

Lastly, you need to enable lpd by editing /etc/rc.conf:

# cd /etc
# ee rc.conf

Add the following lines to /etc/rc.conf:

lpd_enable="YES"
lpd_flags="-s"

Note that the spool directories specified in /etc/printcap need to be properly created and lpd started before printing will work. The easiest way to do this is to reboot the scanner after making the above changes. To reboot the scanner, you can use the "reboot" command:

# reboot

Mounting a Windows share

If you want to be able to save scans to a Windows fileserver or desktop with filesharing enabled, you will need to edit the filesystem mount table:

# cd /etc
# ee fstab

Add a line like the following at the end of the file, without changing any of the existing lines:

//USERNAME@SERVERNAME/SHARE /smbfs smbfs rw 0 0

Where USERNAME, SERVERNAME, and SHARE are the obvious Windows parameters. Case is unimportant, but uppercase is recommended. If you need to embed a space, use "\S" instead of the space. Exit and save changes.

Create the mountpoint for the file system:

# mkdir /smbfs

Configure Windows networking and authentication:

# ee nsmb.conf

At the end of the file, add the following:

[default]
nbns=WINSSERVER
workgroup=WORKGROUP

[SERVERNAME:USERNAME]
password=PASSWORD

Where WINSSERVER is the DNS name (not Windows name) or IP address of your WINS server. If the fileserver that you will be communicating with is on the same subnet as your scanner, you can leave this one line out.

WORKGROUP should be the windows workgroup or domain name of the server. SERVERNAME and USERNAME should match exactly what you put in the "fstab" file except that here they must be in uppercase. If you used a "\S" there it should be here as well. PASSWORD should be the password for the account being used.

Next, mount the filesystem:

# mount /smbfs

If you get an error message, recheck your work again from the beginning and verify that any server names, addresses, user names, passwords, etc., are correct.

Lastly, set the scanner up to mount the filesystem automatically when it boots. The point at which filesystems are mounted by default is before the network is configured, so it will fail for a network-based filesystem. You can configure it to try the mount again at the end of the boot process as follows:

# cd /etc
#ee rc.local

Add the following line to the file:

mount -a

Then exit and save. This will mount any filesystems that are not yet mounted after the network configuration has been completed.

Defining Users

To be able to email scans or save them to a server, you need to define users. The easiest way is to put them in a simple text file. This file will define the users' email addresses and locations to save files.

For the initial configuration, you will need to tell the scanner where to get the user information from:

# cd /usr/local/etc
# ee sjrun.conf

Put the following line in the file, exit, and save it:

user_source="file|/usr/local/etc/sjrun.user"

Then create the file containing the user information:

# ee sjrun.user

For each user, add one line to the file like the following:

username|emailaddress|pathname

Where "username" is the name that will appear on the control panel, "emailaddress" is the user's email address, and "pathname" is the directory (folder) location to save files to. If you setup an SMB mount as described above, "pathname" should be set to "/smbfs" optionally followed by a path within the share to save into for that user. Be sure to use slashes and not backslashes to separate path components.

Additional Configuration

There are many parameters that can be adjusted in the scanner to change behaviour and the display. These can all be set in the "sjrun.conf" file as shown above when setting up users.

To see the possible settings, default values, and descriptions, view the example configuration file that is installed on the scanner:

# cd /usr/local/etc
# ee sjrun.conf.default

Changes made to this file will have no effect. To make changes, you need to put the appropriate entry in the "sjrun.conf" file.

Further Support

The following are some possible avenues for support:

The author, David Madole, can be emailed at david@madole.net. Please do not regard this as a general scanjet or unix helpdesk unless you are (or wish to be) a consulting client of mine. However, if you have a specific question or think you've found a bug, I'd love to hear from you.

Julian Stacey hosts a web page on Scanjet conversion with useful information. Julian also hosts a mailing list on Scanjet conversion -- subscription information is on his web page.

Much information on necessary topics, such as configuring printing and advanced network on FreeBSD can be found in the FreeBSD Handbook.



Web hosting by
Omd3.com Hosting Services
David S. Madole
2005-03-10 1500 GMT