4.4 - Print to PDF

Setting up PDF Printers

Useful For:  Label Printing

Limitations: Does not actually send to printers.

Install the printer

  1. Make a temp folder for the PDFs to be written to:
  2. If the folder /srv/www/tmp/ does not exist
    1. Run the mkdir command to make it
mkdir /srv/www/tmp
  1. Now set that folder world-writable using the chmod command:
chmod 777 /srv/www/tmp/
  1. Make a temp folder for this specific printer
mkdir /srv/www/tmp/pdf1
  1. Now set that folder world-writable using the chmod command:
chmod 777 /srv/www/tmp/pdf1/
  1. You can use Samba to share this folder and then utilize other programs to print the files in the shared folder.


Set up the printer in Convention Master

  1. To intall the CUPS printers in Convention Master go to the console by browsing to http://<your install path>/console/
  1. Click on “Admin – Printing” then “Manage Printers


  1. In the upper right of the "manage printer screen" you can add your printer. If this is not the first printer you have set up, you may need to click the “Add Printer” button first. Do this by setting the following:
    1. Printer Name – This is the name you want to assign the printer.
    2. Method – Choose PDF
    3. Path – <Path to tmp folder> where Path to tmp folder is the path you just created. For example for our example printer the path would be /srv/www/tmp/pdf1/  The trailing slash is very important!
  2. Click Add
  3. Once set up you should see your entries in the Printers table and they should look like this:

Pdf printing

Test the printer

To test the printer functionality, add the printer to a printer pool and then use the Pool testing section. Read the Setting up printer pools section of this manual to perform the tests.


Troubleshooting PDF Printers

  • Check the temp folder: The only way to troubleshoot a print job, is to watch the contents of the temp folder. If the Convention Master system is sending print jobs, you should see temp files appear in that folder.
  • Generate the PDF manually – For this task you will need to know the exact url of the file you are printing. If it’s a badge or label, use the View Reg tool and copy the “badge” url.  Once this is copied run the following command.
php /srv/www/printing/badge_pdf.php –i “url” –o “tmpfolder/file.pdf”

For example

php /srv/www/printing/badge_pdf.php –i “” –o “/srv/www/tmp/pdf1/example.pdf”