The following steps should be followed to install TurboPrint on your Linux workstation and to setup your printer.
Please follow the same instructions if you want to install TurboPrint as an update over an already installed previous version. Your saved settings will not be deleted.
xhost +
su root
export DISPLAY=:0.0
The commands "xhost +" (give other users access to the X display)
and "export DISPLAY=:0.0" (set the X display environment variable)
make sure that programs can open windows on the X display after
switching to root. After entering "su root" (switch to root
login) please enter the password for root.
After installation you can go back to normal login by entering
exit
If you installed TurboPrint as an RPM package, please
start the printer setup tool "xtpsetup" to choose a printer
driver. Continue with reading
registering TurboPrint.
cd turboprint-1.xx
where "xx" stands for the current TurboPrint version, e.g. "1.60".
./setup
Depending wether the X display is open the installation program will run in
a window or on the shell. For the GUI version please continue with the
next step.
In the shell version you will be asked if the installation paths are
correct. Type "y" to continue installation.
The installation script will display if packages that are needed for file format conversion are missing. This isn't a problem now - you can add them later with the installation program or packet manager that came with your Linux distribution.
Finally please execute xtpsetup to install printer drivers, then
continue reading here.
The setup window will inform you where the program files will be installed and which printer spooler is used. Normally, you should not have to change anything. In certain cases the printer spooler - i.e. LPR(ng) or CUPS - is not recognized correctly, so you will have to change this setting.
By clicking "Advanced Settings" the installation directories for system files will be displayed. The default settings are suitable for most Linux distributions. Only experienced users should make changes here!
In this directory executables will be stored, e.g. the xtpsetup and xtpconfig menues.
Only used by LPR(ng) printer spooler. Files will be stored here before printing.
Short help documents which you can view from shell with the "man" command. Enter "man turboprint" to get an overview of help documents for TurboPrint.
Log files which TurboPrint creates during printing (turboprint.log,
turboprint_lpr.log, turboprint_cups.log). These may be
helpful for solving printing problems.
Directory for temporary files which are used during printing.
In this directory all PPD files (printer description files) are stored. Only used if CUPS is installed as printer spooler.
Directory with "filters" that convert between file formats.
Please read the sections titled
"Checking shared libraries" and
"Checking filter programs". They contain a list of the packages
that have been found on your computer.
If you see lines marked with "not found" you should add these
packages with your Linux package manager. Packages with the comment
"not found (option)" are required only if you want to print
certain file formats.
Now you can continue with "OK".
A window with further settings will appear:
Here you can select the WEB browser that will display the TurboPrint online manual. You can either choose an entry from the list or enter the browser name manually.
Note: The WEB browser must be installed on your system! You can use the "Help" button on this window to check if the browser can be started.
Shows information on your TurboPrint license. During installation
"*** not registered ***" will be displayed until you have
installed your license keyfile (see below).
If you have already purchased a license keyfile, you can install it
now. A file selection window will open where you can select the
license keyfile. If it is stored on a floppy disk you may have to
mount the disk first (enter "mount /floppy" in a shell
window).
After you have chosen the keyfile, press "OK" return to the installation window. Your name should now be visible in the "registration info" field.
Then choose "OK" - the installation of TurboPrint is complete.
If you choose "OK" you will switch to TurboPrint's printer
setup program xtpsetup. Here you can set up your printer drivers.
The xtpsetup window looks like this except that the configuration list will be empty at first:
You may change the printer port if necessary. /dev/lp0
is the parallel port and should be correct if the printer is connected
via parallel cable.
For USB printers, your Linux distribution must support USB properly.
Device names of USB printers are different with some Linux distributions.
For SuSE Linux, the first USB printer will have the device name
/dev/usblp0.
Leave the Edit Printer dialog with the "Ok" button.
After a few seconds, the printer should start to print the test page which should look as follows:
If nothing happens or only text is printed, please read the next chapter, Troubleshooting.
If you can't get proper output with TurboPrint, you should try a few things before sending a bug report (see how to submit a bug report).
First please try to print the test page from the installation directory:
lpr -Ptp0 testpage-a4.ps
tp0 must be replaced by the actual short name of the printer.
If everything is okay, your printer should soon start printing the test page. If you get an error message from lpr, please see the section Problems with lpr.
To see how testpage-a4.ps looks, you can enter
gs testpage-a4.ps
If that fails, you must install the ghostscript package first.
If nothing happens or you get an error message, you can execute the print job manually (bypass the lp print spooler):
turboprint -Ptp0 testpage-a4.ps output.prn
This converts the document "testpage-a4.ps" to the printer file "output.prn" using the configuration of the printer queue "tp0".
You should at least get some messages. If everything seems okay and output.prn contains data, you can send it to the printer by entering
cat output.prn >/dev/lp0
where /dev/lp0 must be replaced by the actual device that the printer is connected to.
If that works as well, turboprint is correctly installed but there is some problem with lpr.
Especially the configuration of the newer LPRng printer spooler which is pre-installed on RedHat, Caldera and Mandrake distributions can be very tricky.
However, a debugging tool that checks the printcap file and the spool directories is included with LPRng. Just start it with
checkpc
It will list anything wrong or suspicious within the printcap file or the spool directories. With
checkpc -f
wrong access permissions in the spool directories can be fixed.
If you install the CUPS printing system after the installation of TurboPrint, you have to execute the TurboPrint installation program once again.
If there are still printing problems, you can check your setup also from the CUPS WEB browser interface. Please enter http://localhost:631/ in your WEB browser. The printers that were set up from TurboPrint should be visible in the CUPS WEB interface. You can now e.g. print the CUPS test page and check if print jobs are processed or "hang" in the job queue.
When sending a bug report (see
how to submit a bug report), please include
the file /var/log/turboprint_cups.log in your e-mail.