4 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::

     4 Follow this guide to set up CUPS virtual printers to be able to print webpages and pictures/files (PDF, PNG, JPG, PS) to one of labfolder's logbooks, thus, creating a new entry with an attachment. If you are an admin of the labfolder VM read the section :ref:`section_cups_admin`. Users of labfolder read the section :ref:`section_cups_user`.

     5 

     6 

     7 .. _section_cups_admin:

     8 

     9 Set up CUPS as labfolder admin

    10 ------------------------------

    11 

    12 First, you need to install CUPS on the virtual machine that runs labfolder::

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

    16 Next, configure ``/etc/cups/cupsd.conf``::

    23 	ServerAdmin weiher@fhi-berlin.mpg.de

    31 	ServerAdmin <name>@fhi-berlin.mpg.de

    88 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::

    96 Change the *Server Admin*'s e-mail address and the server that shall be listened to (see the ``Listen`` statement). Set `FileDevice Yes` in ``/etc/cups/cups-files.conf``. Now, create a directory where all printers will go, e.g. ``/usr/local/labfolder/printers``.

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

    98 Get the package for creating new printers from git::

    92 Adapt rights and ownership of lplisten and prnt::

   100 	labfolder@lftest:~$ git clone https://github.molgen.mpg.de/weiher/cupsPrinters

   101 	labfolder@lftest:~$ ls

   102 	cupsPrinters  labfolder

    94 	$ chmod 744 lplisten

   104 The only file you need to adapt is ``newPrinter.sh``. It is not a must but it is suggested to name the printers like the projects. For example, the FEL projects *operating* and *installation* could be placed at ``.../printers/FEL/operating`` and ``.../printers/FEL/installation``. Execute the script with sudo rights::

    95 	$ chmod 666 prnt

    96 	$ chown lp:lpadmin lplisten prnt

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

   106 	labfolder@lftest:~/cupsPrinters$ sudo ./newPrinter.sh

   100 	lpadmin:x:115:labfolder

   108 To prevent ``DENIED`` errors from apparmor install and set the following and restart the CUPS server::

   102 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:

   110 	$ sudo apt-get install apparmor-utils apparmor-profiles

   111 	$ sudo aa-complain cupsd

   112 	$ sudo service cups restart

   104 .. image:: _static/cups_print_operating.png

   114 In case you need to debug some logfiles can be found here: */var/log/syslog*, */var/log/cups/error_log* and */var/log/cups/acces_log*

   105    :width: 100 %

   106    :align: center

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

   116 One last change is that you need to once add a user named *Printer Print* (firstname lastname) to the labfolder database. This can be done manually inside the DB by this command::

   110 	sudo apt-get install apparmor-utils apparmor-profiles

   118 	$ mysql -u root -p

   111 	sudo aa-complain cupsd

   119 	Enter password:

   120 	...

   121 	mysql> use labfolder;

   122 	mysql> INSERT INTO user (email, password, firstname, lastname, signupTimestamp, maxStorage) VALUES ('printer@fhi-berlin.mpg.de', '91a13f2aba4a35b00c35dfacadd1d75f4a5171dfa7a465fca9c40e6b007ce982', 'Printer', 'Print', '2018-03-21 10:54:00', '10000000');

   115 	$ service cupsd restart

   125 .. _section_cups_user:

   117 Start the lplisten script in the background::

   127 Printing to labfolder projects

   118 

   128 ------------------------------

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