Scan Guide > Toon Boom Scan User Guide > Chapter 5: Configuring Scanners > Configuring Scanners for Harmony (Linux)
Download Toon Boom DocumentationDownload Documentation

Configuring Scanners for Harmony (Linux)

After you have installed the hardware, you must perform the following tasks, outlined here:

Identify the Name of the Scanner Device Driver
Set Permissions for the Scanner

You must identify the name of the SCSI device that is working with your scanner so that you can configure Harmony to communicate with it.

Device drivers all have names starting with /dev/sg. If your scanner is the only generic SCSI device connected to your system, it is likely that the name of its driver is

If you are uncertain about the device name, you can use the findscanner utility provided with Harmony. Use the findscanner utility to probe your SCSI bus for devices. It will tell you the name of the device being used by scanners attached to your system.

The device name of your scanner will change if you add, remove or swap other generic SCSI devices.

To use the findscanner utility to identify your scanner:

Launch the findscanner utility. While in the bin folder of your Harmony installation, type the following in a terminal or command prompt:


The findscanner utility is installed in /usr/localToonBoomAnimation/harmony_10/ln86_64/bin/

If you have scanners connected to your computer and they are properly installed, the findscanner utility will return information like the following:

/dev/sga type=6: Scanner device RICOH IS450 Vers:1R04
/dev/sgb type=6: Scanner device FUJITSU fi-4750Cdm Vers:0G00

If findscanner cannot find SCSI scanners attached to your computer, it will return a statement like this:

No scsi devices attached

If you get this message, it may indicate that your system could not initialize your SCSI adapter at boot time.

To make sure your SCSI devices are initialized correctly when you boot Linux:

1. Change to the /boot directory and rename the initrd-[version].img file, where [version] represents the version of your kernel. You can run the uname -r command to find out the version of your kernel.

cd /boot

mv initrd-2.4.18-3.img noscsi-initrd-2.4.18-3.img

2. Type the following command:

/sbin/mkinitrd initrd-2.4.18-3.img 2.4.18-3

This command will recreate a new "init ramdisk" image that will load your SCSI driver when your system starts.

3. Reboot your system.

If you want multiple user accounts to be able to access your scanner, you must modify the permissions on the device driver.

To change the permissions on the scanner:

Type the following on a command line:

chmod 666 /dev/sga

/dev/sga must represent the device driver for your scanner.

To set the permissions on the scanner each time you boot:

1. Open /etc/rc.d/rc.local in a text editor.
2. Add the following line:

chmod 666 /dev/sga

3. Save and close the file.