Printer Configuration with Overlays

The steps you should take to install a printer using overlays are as follows:

Use the multipage overlay script which should be in /u/ccdev/binl/overlay_filter.
Copy that script and the epsi file to /etc/cups/interfaces/ on the machine you are setting up the printer on
Rename the script to something meaningful in terms of printer names eg. invoice_printer
You'll need to modify the FILTER variable in the script to use the epsi file that you copied
The default script is set up for a postscript printer. For a PCL compatible printer (HP LaserJet) you have to change a line near the end of the script to read
```
gs -sDEVICE=ljet4 ...... (leave the other options as you found them)
```
Add the System (Linux) Printer as necessary. Instructions should be in InstallingPrinter.
Now that printer is in it should show up in lpstat and show as enabled, if not try reloading cups

Overlays

If you wish to use an overlay in with your printer, the following needs to be done.

This is only applicable for CUPS, but the config is similar on older unix systems.

Copy the script that performs the overlay, into cups's interface directory, and make sure its name is identical to the printers name

       /etc/cups/interfaces/

Make sure the script is executable by the cupsd, its probably best to make it executable by everyone, but only editable by root.

      chmod 755 /etc/cups/interfaces/printer-name

Run the script with some test data and verify the results

      /etc/cups/interfaces/printer-name < data.txt

Once the script itself has been confirmed to work, then control should now print data with this overlay.

Ensure that the name, permissions and ownership of the file are correct. Specially on SAAS server, the company directories have been specially set up so that each company can only enter their own company directory. In this case place the .epsi file in /etc/cups/interfaces/
If there is a file in the ppd directory with the same name, delete it
```
rm /etc/cups/ppd/<system-printer-name>
```
Did you restart cups after adding the overlay?
Remember, the script will be run as the lp user. Make sure you use check the script will be calling the correct programs. One program of note is pstops . Make sure you use the full path when referring to other programs.
Run Away, and never come back.
Refer to above statement.