Network Scan Drivers

User's Guide

September 2008 www.lexmark.com

Lexmark and Lexmark with diamond design are trademarks of Lexmark International, Inc., registered in the United States and/or other countries.All other trademarks are the property of their respective owners.

© 2008 Lexmark International, Inc.All rights reserved.740 West New Circle RoadLexington, Kentucky 40550

Edition noticeSeptember 2008The following paragraph does not apply to any country where such provisions are inconsistent with local law: LEXMARK INTERNATIONAL,INC., PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions; therefore, this statement may not apply to you.This publication could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; thesechanges will be incorporated in later editions. Improvements or changes in the products or the programs described may be made at any time.References in this publication to products, programs, or services do not imply that the manufacturer intends to make these available in all countriesin which it operates. Any reference to a product, program, or service is not intended to state or imply that only that product, program, or servicemay be used. Any functionally equivalent product, program, or service that does not infringe any existing intellectual property right may be usedinstead. Evaluation and verification of operation in conjunction with other products, programs, or services, except those expressly designated bythe manufacturer, are the user’s responsibility.For Lexmark technical support, visit support.lexmark.com.For information on supplies and downloads, visit www.lexmark.com.If you don't have access to the Internet, you can contact Lexmark by mail:Lexmark International, Inc.Bldg 004-2/CSC740 New Circle Road NWLexington, KY 40550USA© 2008 Lexmark International, Inc.All rights reserved.

UNITED STATES GOVERNMENT RIGHTSThis software and any accompanying documentation provided under this agreement are commercial computer software and documentationdeveloped exclusively at private expense.

TrademarksLexmark and Lexmark with diamond design are trademarks of Lexmark International, Inc., registered in the United States and/or other countries.All other trademarks are the property of their respective owners.

ContentsEdition notice......................................................................................2

Introduction to the network scan driver......................................5Installing the network scan driver...................................................................................................................................5

System requirements .......................................................................................................................................................................5Supported operating systems.......................................................................................................................................................5Installing on Red Hat, Red Flag, Linpus, or SUSE Linux ........................................................................................................5Installing on Debian, Linspire, or Ubuntu Linux .....................................................................................................................6

Using the network scan driver..........................................................................................................................................6

Removing the network scan driver.................................................................................................................................6

How Do I...?..........................................................................................7Scan using XSane...................................................................................................................................................................7

Scan using OpenOffice.org.................................................................................................................................................7

Scan using GIMP.....................................................................................................................................................................7

Scan using the command line...........................................................................................................................................8

Scan multiple pages..............................................................................................................................................................8

Scan both sides of the page............................................................................................................................................10

Import all scanned pages at once..................................................................................................................................11

Adjust the scan settings using XSane and OpenOffice.org .................................................................................11

Adjust the scan settings using scanimage.................................................................................................................13

Set default scan options....................................................................................................................................................15

Check to see if the network scan driver is installed................................................................................................15

Cancel a scan.........................................................................................................................................................................16

Troubleshooting...............................................................................17The printer scans the page, but nothing happens on the host computer.....................................................17

The printer starts scanning, but suddenly stops or prints a “Profile scan failed” page..............................17Disable any firewall ........................................................................................................................................................................ 17Open the required scanning ports (tcp: 9751-9760).......................................................................................................... 17Accept the device certificate ...................................................................................................................................................... 18Enter a scan profile login.............................................................................................................................................................. 18

When scanning from the ADF, only one page is imported to the application.............................................18

When scanning from the ADF, the profile is posted between each page......................................................19

My printer is not compatible...........................................................................................................................................19

SANE does not recognize the network scan driver.................................................................................................19

Contents

3

I want to change the display language of my application...................................................................................19

XSane displays garbage characters in the scan options.......................................................................................19

Index...................................................................................................21

Contents

4

Introduction to the network scan driverThe network scan driver provides a SANE (Scanner Access Now Easy) interface to allow scanning from a network-basedprinter.

Installing the network scan driver

System requirementsBefore installing the network scan driver, make sure:

• You are logged on with root user authority.

• You have 62MB of free disk space available for a complete installation.

• You have SANE and/or SANE back ends installed on your server.

• The host computer is properly configured to communicate with a supported network printer over TCP/IP.

• Your printer has an internal network card and can communicate via an IPv4 network. External network adaptersare not supported.

Supported operating systemsMake sure you are running any of the following Linux distributions:

• Debian GNU/Linux

• Linspire Linux

• Red Hat Enterprise Linux

• SUSE Linux

• Ubuntu Linux

• Red Flag Linux

• Linpus Linux

Note: For specific supported operating system versions, see the Web site for your operating system, or see thefile /usr/lexscan/docs/supported-platforms.txt after installation.

Installing on Red Hat, Red Flag, Linpus, or SUSE Linux1 Read “System requirements” on page 5.

2 Download the driver:

a Go to www.lexmark.com.

b Select Driver Finder from the Drivers & Downloads drop-down list.

c Choose the Linux distribution running on your host computer.

d Select network-scan-linux-glibc2-x86.rpm and download it to your computer.

3 Save the downloaded package in any directory.

4 Install the package file:

rpm -ivh network-scan-linux-glibc2-x86.rpm

Introduction to the network scan driver

5

Installing on Debian, Linspire, or Ubuntu Linux1 Read “System requirements” on page 5.

2 Download the driver:

a Go to www.lexmark.com.

b Select Driver Finder from the Drivers & Downloads drop-down list.

c Choose the Linux distribution running on your host computer.

d Select network-scan-linux-glibc2-x86.deb and download it to your computer.

3 Save the downloaded package in any directory.

4 Install the package file:

dpkg -i network-scan-linux-glibc2-x86.deb

Using the network scan driverTo use the network scan driver, you must open a SANE-compliant application, such as XSane or scanadf. From withinthe application, select the network printer and the settings to use for the scan. The host computer searches for anopen port to establish a connection. Once port 443 is found open, the printer validates the device security certificate.If the printer requires authentication, the printer validates the user name and password from the host. The applicationsubmits the settings and information about the host computer to the selected printer as a profile. From the printercontrol panel, select your profile. Once the scan is done, the image is displayed or saved by the application.

Removing the network scan driver1 In the command line, type rpm -e lexmark-network-scan ( if you are running Red Hat or SUSE Linux) ordpkg -r lexmark-network-scan (if you are running Debian GNU/Linux or Linspire Linux.).

2 Remove the lexmark_nscan entry from the /etc/sane.d/dll.conf file.

Introduction to the network scan driver

6

How Do I...?

Scan using XSane1 In the command line, type xsane. The XSane main window appears.

2 From the menu bar, choose Window Show standard options.

3 Specify the IP address of your printer.

4 If necessary, adjust other scan settings. For more information, see “Adjust the scan settings using XSane andOpenOffice.org ” on page 11.

5 From the XSane main window, click Scan.

6 Place the document to be scanned in the ADF or on the scanner glass.

7 From the printer, choose your profile. For more information, see the documentation that came with your printer.

Scan using OpenOffice.org1 Start OpenOffice.org.

2 From the menu bar, choose Insert Picture Scan Select Source... or Insert Graphics Scan SelectSource....

3 From Options, choose ip-address.

4 Specify the IP address of your printer in the ip-address field.

5 Choose other options, if necessary, and select OK.

6 From the menu bar, choose Insert Picture Scan Request... or Insert Graphics Scan Request....

7 Place your document in the ADF or on the scanner glass.

8 From the printer, choose your profile. For more information, see the documentation that came with your printer.

Scan using GIMPGNU Image Manipulation Program (GIMP) is the standard paint program for UNIX/Linux systems. It supports scanningby using existing scanning tools (xscanimage and XSane) used as plug-ins. The GIMP plug-in function allowsxscanimage and XSane to provide the scanned image back to the program.

Note: The GIMP plug-in that ships with your OS should already be installed.

1 Start GIMP.

2 From the menu, choose File Acquire XSane device or xscanimage:device. The XSane or scanimage windowappears.

3 From the menu bar, choose Window Show standard options.

4 Specify the IP address of your printer.

How Do I...?

7

5 If necessary, adjust other scan settings. For more information, see “Adjust the scan settings using XSane andOpenOffice.org ” on page 11.

6 From the XSane main window, click Scan.

7 Place the document to be scanned in the ADF or on the scanner glass.

8 From the device, choose your profile. For more information, see the documentation that came with your printer.

Scan using the command line1 From the command line, type scanimage --ip-address=<printers_ipaddress>> /tmp/scan.pnm.

2 Adjust the scan settings, if necessary. For more information, see “Adjust the scan settings using scanimage” onpage 13.

Note: If an Assertion 'c->xlib.lock' failed error occurs using openSUSE 10.3, refer tohttp://en.opensuse.org/Xlib.lock for troubleshooting information.

Scan multiple pagesThe default paper source for scanning is the ADF. If there are no documents loaded in the ADF, the printer will scanfrom the scanner glass.

Depending on the application you are running, you can scan multiple pages in several ways.

Application Method

scanimage From the command line, typescanimage -b --source=”Multiple Pages” --ip-address=<printers_ipaddress>

scanadf From the command line, typescanadf --source=”Multiple Pages” --ip-address=<printers_ipaddress>

How Do I...?

8

Application Method

OpenOffice.org 1 Start OpenOffice.org.

2 From the menu, choose Insert Picture Scan SelectSource or Insert Graphics Scan Select Source.

3 From Options, choose ip-address.

4 Specify the IP address of the printer in the ip-address field.

5 From Options, choose Image Settings source.

6 From the drop-down menu, choose Multiple Pages.

7 Click OK.

8 From the OpenOffice.org menu, choose Insert Picture Scan Request or Insert Graphics Scan

Request. The printer scans all pages. Then, the first pageis imported into your document.

9 From the OpenOffice.org menu, choose Insert Picture Scan Request or Insert Graphics Scan

Request to import the second page, or until all the pagesare imported into your document.

XSane 1 From the command line, type xsane.

2 From the XSane main window, choose Multiple Pages.

3 From the menu bar, choose Window Show standardoptions.

4 Specify the IP address of your printer.

5 From the XSane main window, click Scan. The first pageof your document appears.

6 Click Scan until all the pages of your document appear.

To have all the pages appear at once (XSane .99 andlater)

1 From the XSane main window, specify the number ofpages you want scanned using the spin box in XSaneoptions.

2 Click Scan.If you specify a number that is smaller than the number ofpages placed in the ADF, only the number of pagesspecified are scanned. You must click Scan again to scanthe remaining pages.

To have all the pages appear at once (XSaneversions earlier than .99)

1 From the XSane main window, choose Preferences Setup.

2 Click the Enhancement Tab.

3 From the ADF Modus drop-down menu, choose ScanMultiple Page.

4 Scan your document.

How Do I...?

9

Scan both sides of the pageNotes:

• You must have a duplex scanner.

• You must use the ADF.

Depending on the application you are running, you can scan both sides of the page in several ways.

Application Method

scanimage In the command line, typescanimage -b --scan-both-sides=yes --ip-address=<printers_ipaddress>

scanadf In the command line, typescanadf --scan-both-sides=yes --ip-address=<printers_ipaddress>

OpenOffice.org 1 Start OpenOffice.org.

2 From the OpenOffice.org menu, choose Insert Picture Scan Select Source... or Insert Graphics

Scan Select Source....3 From Options, choose ip-address.

4 Specify the IP address of your printer in the ip-addressfield.

5 From Options, choose Image Settings source.

6 From the drop-down menu, choose Multiple Pages.

7 From Options, choose Image Settings scan-both-sides.

8 Click the checkbox beside scan-both-sides.

9 Click OK.

10 From the OpenOffice.org menu, choose Insert Picture Scan Request... or Insert Graphics Scan

Request.... The printer scans all pages. Then, the first pageis imported into your document.

11 From the OpenOffice.org menu, choose Insert Picture Scan Request... or Insert Graphics Scan

Request... to import the second page, or until all thepages are imported into your document.

How Do I...?

10

Application Method

XSane 1 In the command line, type xsane.

2 From the XSane main window, choose Multiple Pages.

3 From the menu bar, choose Windows Show standardoptions.

4 Specify the IP address of your printer.

5 Make sure that the checkbox beside Scan both sides isselected.

6 Click Scan. The first page of your document appears.

7 Click Scan until all the pages of your document appear.To have all the pages appear at once:

1 From the XSane main window, choose Preferences Setup.

2 Click the Enhancement Tab.

3 From the ADF Modus drop-down menu, choose ScanMultiple Page.

4 Scan your document.

Import all scanned pages at onceNote: You should be running XSane to import all scanned pages at once.

1 From the XSane main window, choose Preferences Setup.

2 Click the Enhancement Tab.

3 From the ADF Modus drop-down menu, choose Multiple Pages.

4 Scan your document. For more information, see “Scan multiple pages” on page 8.

Adjust the scan settings using XSane andOpenOffice.orgDepending on the application you are running, do either of the following to access the scan options:

• From the menu bar of the XSane main window, click Window Show standard options or Window Showadvanced options.

• From the OpenOffice.org menu, click Insert Picture Scan Select Source or Insert Graphics Scan Select Source.

Choose To

IP Address Specify the IP address of the scanner.

User Name Specify the user name.

How Do I...?

11

Choose To

Profile Name Specify a profile name that will be posted to the printer.The Profile Name should be unique within a user name.However, a profile name can be used more than onceprovided that it is being used by different user names.

Content Type Select the kind of document being scanned.

Resolution Select the scan resolution.

All the resolutions of all the printers are displayed asoptions. Make sure that the resolution you select issupported by the printer you will scan to.

Color depth Select the color depth.

Note: Color depth appears on the XSane main window.

Original Size Specify the size of the document being scanned.All the document sizes of all the printers are displayed asoptions. Make sure that the option you select is supportedby the device you will scan to.

Scan both sides Perform a duplex scan. Make sure that the selected devicehas a duplex scanner.

Orientation Select portrait or landscape.

Brightness Select the brightness from 1–9.

Contrast Select the contrast from 0–5.

Scan Source Specify if you are scanning a single-sheet or amultiple-page document.

Note: Scan Source appears on the XSane main window.

Negative Image Specify if you want to invert pixel values.

Background Removal Remove the smudges and light background shading oncolor documents being scanned.

Color Dropout Specify the color you want to remove.

Color Dropout Threshold Select the color dropout quality from 0–254.

Mirror Image Produce a mirror image of the scanned document.

Note: Your printer may not support all the options. To check, see the documentation that came with your printer.

How Do I...?

12

Adjust the scan settings using scanimageThe scanimage application is a command-line-only application that uses the first scanner found and the scan settingdefaults. The command initiates the scan and stores the image in a PXM or TIFF format. You can provide commandline options to specify the scan settings.

Command Option Values Function

ip-address IP address of the printer Specify the IP address of theprinter.

user-name User Name Specify the user name.

profile-name Profile Name Specify a profile name that will beposted to the printer. The ProfileName should be unique within auser name. However, a profilename can be used more than onceprovided that it is being used bydifferent user names.

content-type Text

Text/Graphics

Photo

Select the kind of document beingscanned.

scan-resolution 75

150

200

300

400

600

Select the scan resolution. All theresolutions of all the printers aredisplayed as options. Make surethat the resolution you select issupported by the printer you willscan to.

mode 1-bit Black & White

8-bit Grayscale

24-bit Color

Select the color depth.

How Do I...?

13

Command Option Values Function

original-size Letter

Executive

Legal

A3

A4

A5

A6

B4

B5

JIS-B5

Tabloid

Oficio (Mexico)

Folio

Statement

Universal

Custom Scan Size

ID Card

3x5 Photo

4x6 Photo

Business Card

Book Original

Auto Size

Mixed Size

Specify the size of the documentbeing scanned. All the documentsizes of all the printers aredisplayed as options. Make surethat the option you select issupported by the printer you willscan to.

scan-both-sides no

yes

Perform a duplex scan. Make surethat the selected device has aduplex scanner.

orientation portrait

landscape

Select portrait or landscape.

brightness 1–9 Select the brightness from 1–9.

contrast 0–5 Select the contrast from 0–5.

source Single Page

Multiple Pages

Specify if you are scanning asingle-sheet or a multiple-pagedocument.

negative-image false

true

Specify if you want to invert pixelvalues.

background-removal -4–+4 Remove the smudges and lightbackground shading whenscanning color documents.

How Do I...?

14

Command Option Values Function

color-dropout None

Red

Green

Blue

Specify the color you want toremove.

color-dropout-threshold 0–254 Select the color dropout qualityfrom 0–254.

mirror-image false

true

Produce a mirror image of thescanned document.

For example, to initiate a scan given these settings:

IP address 192.168.1.10

Profile name Application

Size of original document Legal

From the command line, typescanimage --ip-address=192.168.1.10 --profile-name=Applicationoriginal-size=Legal > /tmp/image.pxm.

Notes:

• You can also type scanimage --help to get a list of options.

• Your printer may not support all the options. To check, see the documentation that came with your printer.

Set default scan optionsAll default scan options are stored in the scan driver configuration file, /etc/sane.d/lexmark_nscan.conf. Changingthe values in the scan driver configuration file updates the default settings. The settings are reflected in theapplication.

XSane stores the most recently used scan settings in the ${HOME}/.sane/xsane directory. In order for XSane to reflectthe changes you made in the scan driver configuration file:

1 From the menu bar, choose File Quit.

2 In the command line, type rm -f ${HOME}/.sane/xsane/*.drc.

3 Restart XSane.

Check to see if the network scan driver is installedThe network scan driver will only be found if it has been installed and added to the dll.conf file, and the device file ispresent.

To list the currently available device, type scanimage -L in the command line.

Once the device is found, device 'lexmark_nscan:/usr/lexscan/scanner' is a LexmarkNetwork Scan Driver is displayed on the console.

How Do I...?

15

Cancel a scanAfter initiating a scan, do one of the following to cancel it:

• From the dialog that appears on the computer screen, select Cancel Scan Profile.

• From the menu bar, choose File Quit.

• From the printer, cancel the scan job. Then, cancel the scan from the status window. For more information onhow to cancel a scan job, see the documentation that came with your printer.

How Do I...?

16

Troubleshooting

The printer scans the page, but nothing happens onthe host computer.The IP address of the computer that submits the profile is provided to the printer. This IP address will be the addressthat is currently assigned to your computer's host name. A problem occurs when this IP address does not match theIP address that is assigned to your network interface.

To see if this is the problem, try the following:

1 In the command line, type hostname. The host name of the computer appears.

2 In the command line, type ping <computers_hostname>.

3 Type /usr/lexscan/bin/lsinet in the command line and make sure that the IP address listed matchesthe IP address provided by step 2.

If the two IP addresses do not match, you can either correct your /etc/hosts or DNS entries so that they match orupdate the SANE driver configuration file and specify the appropriate network interface to use. For more informationon how to correct your /etc/hosts or DNS entries, see the documentation that came with your operating system.

If the problem is not resolved, see “The printer starts scanning, but suddenly stops or prints a “Profile scan failed”page” on page 17.

The printer starts scanning, but suddenly stops orprints a “Profile scan failed” pageThe IP address of the computer that submits the profile is provided to the printer. The submitting computer thenopens a network port and listens for incoming connections from the printer. The computer starts with network porttcp:9751 and progresses to tcp:9752 and so on until it finds an open port. When the printer starts scanning, it triesto open a network connection back to the submitting computer. The submitting computer cannot establish aconnection or cancels the scan job if it has a firewall enabled, did not accept the device certificate authentication, orcanceled the scan profile login process.

DISABLE ANY FIREWALL

To determine how to disable or enable your firewall, see the documentation that came with your operating system.

OPEN THE REQUIRED SCANNING PORTS (TCP: 9751-9760)For most Linux distributions, you can open specific ports with the iptables command. For example, type #iptables -I INPUT -p tcp --dport 9751:9760 -j ACCEPT -i eth0 from the command line.

Troubleshooting

17

ACCEPT THE DEVICE CERTIFICATE

If there was an error verifying a security certificate before completing a scan, you need to accept the certificate toproceed with the scanning. You may accept the certificate for a single scan attempt or for all future scan attempts.

ENTER A SCAN PROFILE LOGIN

If a 401 Unauthorized Error is received when attempting to send a scan profile to the device, you need toenter a valid user name and password combination. You may enter the valid user name and password combinationfor a single operation or for all future operations.

When scanning from the ADF, only one page isimported to the application.Depending on the application you are running, there are two reasons why this occurs:

• If you are running OpenOffice.org, the source is set to Single Page.

• If you are running XSane, the ADF Modus (located in the XSane setup window) is set to (none) or Scan MultiplePage, but the source (located in the XSane main window) is set to Single Page.

If you are running OpenOffice.org:

1 From the OpenOffice.org menu, choose Insert Picture Scan Select Source... or Insert Graphics Scan Select Source.... The back end appears.

2 Under Options, choose Image Settings source.

3 From the drop-down menu, choose Multiple Pages.

4 Click OK.

5 From the OpenOffice.org menu, choose Insert Picture Scan Request... or Insert Graphics ScanRequest....

All the pages are scanned. The first page is imported to the application.

6 To import the second page, choose Insert Picture Scan Request... from the OpenOffice.org menu.

7 Repeat step 6 until all the pages are imported to the application.

If you are running XSane:

1 From the drop-down menu next to the scanner icon, choose Multiple Pages.

The pages are scanned, and the first scanned page appears.

2 To display the second page, select Scan.

3 Repeat step 2 until all the pages appear.

Note: To import all the pages at once, “Import all scanned pages at once” on page 11.

Troubleshooting

18

When scanning from the ADF, the profile is postedbetween each page.Depending on the application you are running, there are two reasons why this occurs:

• If you are running scanadf, the source is set to Single Page.

• If you are running XSane, the ADF Modus (located in the XSane setup window) is set to Multiple Pages, but thesource setting (located in the XSane main window) is set to Single Page.

If you are running scanadf, type:

scanadf --source=”Multiple Pages” --ip-address=<printers_ip_address>; or

scanimage -b --source=”Multiple Pages” --ip-address=<printer_ip_address>

If you are running XSane:

In the XSane main window, choose Multiple Pages from the drop-down menu next to the scanner icon.

My printer is not compatible.The device you are using is not a multifunction printer, or it is an older model that the network scan driver does notsupport. For more information, see the documentation that came with your printer.

SANE does not recognize the network scan driver.The possible causes of this problem are:

• The scan driver is not installed in the /usr/lib/sane directories.

• The scan driver device file does not exist.

• The scan driver is not listed in the /etc/sane.d/dll.conf file.

Make sure your SANE installation is using the directory structure /usr/lib/sane and /etc/sane.d/.

For some SANE installations, you may need to set the LD_LIBRARY_PATH. In the command line, type exportLD_LIBRARY_PATH=/usr/lib.

Verify that 'lexmark_nscan' is listed in the /etc/sane.d/dll.conf file and not commented out.

I want to change the display language of myapplication.Currently, only XSane supports languages other than English. If you are running XSane, make sure your locale is setcorrectly. For details on setting your locale, see the documentation that came with your operating system.

XSane displays garbage characters in the scanoptions.Run XSane version .90 or higher, which supports more languages than its earlier versions.

Troubleshooting

19

If you are running Linpus, it is necessary to upgrade XSane so that it will work correctly with non-English languages.

Troubleshooting

20

IndexAadjusting scan settings

using OpenOffice.org 11using scanimage 13using the command line 13using XSane 11

Ccancelling a scan 16checking if the scan driver isinstalled 15

Iimporting scanned pages 11installing on Linspire Linux 6installing on Ubuntu Linux 6

Nnetwork scan driver

installation requirements 5installing on Debian GNU/Linux 6installing on Linpus Linux 5installing on Red Flag Linux 5installing on RedHat Linux 5installing on SUSE Linux 5introduction 5uninstalling 6

Sscan settings

OpenOffice.org Writer 11XSane 11

scanning 7both sides of the page 10cancelling a scan 16multiple pages 8using GIMP 7using OpenOffice.org 7using the command line 8using XSane 7

setting default values 15supported operating systems 5

Ttroubleshooting 17

Uusing the network scan driver 6

Index

21