To print from a UNIX application server, you have to configure a Tarantella printer on the UNIX server. You do this by running the Tarantella printer installation script. If your application server and Tarantella server are the same server, you don't need to configure a printer as Tarantella Setup will have already created a printer. This topic covers:
You configure a Tarantella printer on the application server
that you want to print from by running the Tarantella prtinstall.en.sh
script.
By default, prtinstall.en.sh
creates a printer named
tta_printer
. This redirects print jobs from the
application server to the printer created by Setup on the
Tarantella server (this is also named tta_printer
).
The prtinstall.en.sh
script also installs the Tarantella
lp and lpr replacement scripts, which you use to print.
If your array consists of a single Tarantella server, you run the printer installation script as follows:
install_dir/bin/scripts/prtinstall.en.sh
from
a Tarantella server to a temporary directory on the application server.sh prtinstall.en.sh
If you have an array which consists of two or more Tarantella servers, you have to install a printer for each member of the array. To do this:
install_dir/bin/scripts/prtinstall.en.sh
from
a Tarantella server to a temporary directory on the application server.
sh prtinstall.en.sh --ttahost Tarantella_server_DNS_name --appprinter printer name
--appprinter
argument) can be anything you like
but it must be unique.
If you are upgrading from Tarantella version 3.20 or earlier, your existing configuration will be preserved. These versions of Tarantella do not use distributed printing and so all print jobs are directed through the primary server in the array. If you have more than one Tarantella server in your array and you want to take advantage of distributed printing, you must carry out the configuration described above.
When users print from a UNIX application they use the Tarantella
replacement lp
or lpr
scripts. They can select
which printer they print to by using:
-d printer
argument with the lp
script, or
-P printer
argument with the lpr
script.
If you do not use the -d
and -P
arguments when
printing, the output goes to the client's default printer.
How you specify the printer depends on whether the client device is using Windows or UNIX.
When printing to a UNIX client, you specify the printer by using the name of the printer as it is known to the UNIX lp or lpr system.
The following are examples of print commands for a UNIX client:
/opt/tarantella/bin/lp -d A4-printer filename /opt/tarantella/bin/lpr -P color-printer filename
To be able to specify a printer in this way, you must configure printing for UNIX clients.
When printing to a Windows client, you specify the printer by using either:
\\PRTSERVER\HPLJ5
),
The following are examples of print commands for a Windows client:
/opt/tarantella/bin/lp -d '\\\\PRTSERVER\\HPLJ5' filename /opt/tarantella/bin/lp -d __PRTSERVER_HPLJ5 filename /opt/tarantella/bin/lpr -P label-printer filename /opt/tarantella/bin/lpr -P LPT1: filename
To use a UNC name you must enclose the printer name in quotes and escape every backslash with an extra backslash (see the example above). However, because different UNIX shells process backslashes differently, you may need to experiment with the number of backslashes. For this reason, we recommend that you do not use UNC printer names. By using underscores instead of backslashes (see the example above), you can avoid having to use quotes or escape characters. However, this only works if the first two characters of the printer name are underscores.
Using "user-friendly" names avoids any problems with UNC names.
To be able to use the "user-friendly name" option, you must edit the file
install_dir/etc/data/printernamemap.txt
using a text editor.
This text file contains entries that map "user-friendly" names to printers, for example:
"label-printer"="\\PRTSERVER\HPLJ5"
In the printernamemap.txt
file you use the UNC name of
the printer without having to backslash escape the backslashes.