README.md 2.58 KB
Newer Older
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
1
2
3
4
5
6
7
# FI printers via Samba

Script for installing faculty printers on Linux via Samba print server.


## Advantages

8
9
-   You can print on Wi-Fi using Samba. (With unauthenticated IPP printing you are allowed to only print via Ethernet cable.)
-   You can add a FI printer to your existing CUPS instance (e.g. if you already have your own local printer). This way, you don’t have to switch configurations.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
10
11
12
13
14
15
-   You don’t need to have the same login on your computer as your faculty login.


## Disadvantages

-   Printers have to be installed one by one.
16
-   Password will be stored at `/etc/cups/printers.conf` in plain text format.
17
-   This is not the preferred way of printing on FI. (The preferred way is via Kerberos.)
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
18
19
20
21
22
23
24


## Pre-requirements

-   root access (or sudo)
-   running local [CUPS](https://www.cups.org/) print server
-   Samba client (`smbclient`)
25
-   Cron system and git for automatic updating
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
26
27
28
29


### Warning

30
If you are printing via unauthenticated IPP or Kerberized IPP, you will have to remove the client configuration file for CUPS, which is located at `/etc/cups/client.conf`.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
31
32
33
34


## Usage

35
Usage: `./install.pl {--cron | [--usage] <printer-name>}` , where `<printer-name>` is a valid printer name. If supplied `--usage`, the script will only update the drivers. Passing `--cron` will only prompt user for cron installation.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
36

37
For example, to install the printer `lj2b`, run
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
38

39
40
41
```shell
./install.pl lj2b
```
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
42

43
44
45
Installation script will prompt you for your faculty credentials (the faculty username and the faculty password).

You will be also asked if you want to install cron script for automatic updates if not already installed.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
46

47
You may be prompted for the faculty credentials once again on the first print job, depending on your distribution.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
48

49
### Supported printers
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
50

51
Currently supported printers:
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

-   copy2a
-   copy3a
-   copy4a
-   copy4c
-   copy5c
-   lj2a
-   lj2b
-   lj3a
-   lj-a302
-   lj3b
-   lj4a
-   lj4c
-   lj4p
-   lj5c

68
At the moment, copy4b and copy5b are not supported.
69

70
71
You can find out more information about printing in general
at <https://www.fi.muni.cz/tech/unix/print.html>.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
72
73
74
75


## Repository structure

76
| File                     | Description                                      |
77
|------------------------- |------------------------------------------------- |
78
| `install.pl`             | main install script                              |
79
| `cron.pl`                | cron script for automatic updates                |
80
81
| `filters`                | folder with filters for CUPS                     |
| `ppds`                   | folder with PPDs for CUPS                        |