Printing from a UNIX application server

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:

Configuring a Tarantella printer on a UNIX application server

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.

Configuring a printer in a single-server array

If your array consists of a single Tarantella server, you run the printer installation script as follows:

  1. Copy install_dir/bin/scripts/prtinstall.en.sh from a Tarantella server to a temporary directory on the application server.
  2. Log in to the application server as root.
  3. Change to the temporary directory.
  4. Run the script by typing:
    sh prtinstall.en.sh
  5. When prompted, type the full DNS name of the Tarantella server.

Configuring a printer in a multiple-server array

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:

  1. Copy install_dir/bin/scripts/prtinstall.en.sh from a Tarantella server to a temporary directory on the application server.
  2. Log in to the application server as root.
  3. Change to the temporary directory.
  4. Run the script by typing:
    sh prtinstall.en.sh --ttahost Tarantella_server_DNS_name --appprinter printer name
  5. Repeat step 4 for each server in the array. The name of each printer (as specified by the --appprinter argument) can be anything you like but it must be unique.

Upgrading from previous versions of Tarantella

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.

Using the Tarantella lp or lpr scripts

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:

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.

Printing to UNIX clients

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.

Printing to Windows clients

When printing to a Windows client, you specify the printer by using either:

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.

Next steps in configuring Tarantella printing

Related topics
  • Introducing Tarantella printing
  • The tarantella print command
  • The prtinstall.en.sh script