Printing via CUPS and attaching files to labfolder logbooks

===========================================================

If you want to print a webpage as PDF and send it to onf of labfolder's logbooks you could create a CUPS printer for each logbook that uses the labfolder API to attach this PDF to a newly created entry. First, you need to install CUPS on the virtual machine that runs labfolder::

	sudo apt-get install cups cups-client cups-bsd

Next, you need to configure ``/etc/cups/cupsd.conf``. This is how it looks like on *lftest*::

	# Sample configuration file for the CUPS scheduler.  See "man cupsd.conf" for a

	# complete description of this file.

	# Log general information in error_log - change "warn" to "debug"

	# for troubleshooting...

	LogLevel debug

	# Deactivate CUPS' internal logrotating, as we provide a better one, especially

	# LogLevel debug2 gets usable now

	MaxLogSize 0

	# Administrator user group...

	SystemGroup lpadmin

	ServerAdmin weiher@fhi-berlin.mpg.de

	HostNameLookups On

	ServerAlias *

	# Only listen for connections from the local machine.

	Listen lftest.rz-berlin.mpg.de:631

	Listen /var/run/cups/cups.sock

	# Show shared printers on the local network.

	Browsing Off

	BrowseOrder allow,deny

	BrowseAllow all

	BrowseLocalProtocols CUPS dnssd

	BrowseAddress @LOCAL

	# Default authentication type, when authentication is required...

	DefaultAuthType Basic

	# Web interface setting...

	WebInterface Yes

	# Restrict access to the server...

	<Location />

	  Satisfy All

	  Allow localhost

	  Allow 141.14.*

	  Allow 172.16.*

	  Allow 192.*

	  Allow all

	  # Allow shared printing and remote administration...

	  Order allow,deny

	  Allow all

	</Location>

	# Restrict access to the admin pages...

	<Location /admin>

	  Order deny,allow

	  Satisfy All

	  AuthType Basic

	  Require user @SYSTEM

	  Deny All

	  Allow localhost

	  Allow 141.14.*

	  Allow 172.16.*

	</Location>

	# Restrict access to configuration files...

	<Location /admin/conf>

	  Order deny,allow

	  AuthType Default

	  Require user @SYSTEM

	  Satisfy All

	  Require user root

	  Deny All

	  Allow 127.0.0.1

	  Allow 141.14.*

	  Allow 172.16.*

	</Location>

	# Set the default printer/job policies...

	<Policy default>

	  ... # probably as in the original

	</Policy>

Now, you need to create a file system that will hold all CUPS printers, For example, the printers belonging to the logbooks *FEL/operating* and *FEL/installation* could be put in ``/usr/local/labfolder/printers/FEL``. Copy the lplisten script from the git repository ``https://github.molgen.mpg.de/weiher/elog2labfolder.git`` to ``/usr/local/labfolder/printers/FEL/operating`` and to ``.../FEL/installation``. Also, create a pipe that redirects the printer input to the lplisten script::

	/usr/local/labfolder/printers/FEL/operating$ mkfifo prnt

Adapt rights and ownership of lplisten and prnt::

	$ chmod 744 lplisten

	$ chmod 666 prnt

	$ chown lp:lpadmin lplisten prnt

Add the labfolder user to the lpadmin group in /etc/group::

	lpadmin:x:115:labfolder

Now, create the CUPS printers via the web interface at ``http://lftest.rz-berlin.mpg.de:631/`` (as configured in cupsd.conf). For example, the *operating* printer points at ``FEL/operating/prnt``. The ready configured printer looks like this in the web interface:

.. image:: _static/cups_print_operating.png

   :width: 100 %

   :align: center

To prevent ``DENIED`` errors from apparmor install and set the following::

	sudo apt-get install apparmor-utils apparmor-profiles

	sudo aa-complain cupsd

Restart the CUPS server::

	$ service cupsd restart

Start the lplisten script in the background::

	/usr/local/labfolder/printers/FEL/operating$ ./lplisten &

The last thing you need to do is to set up a printer *operating* on your local machine. In Ubuntu Gnome hit Alt+F2 keys and enter ``system-config-printer``. In this printer config interface add a new printer *operating* as follows:

.. image:: _static/create_local_printer01.png

   :width: 70 %

   :align: center