README.md 2.79 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 this within the cloned repository:
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
38

39
```shell
40
sudo ./install.pl lj2b
41
```
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
69
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
70
71


72
73
74
75
76
77
78
## Tested Distributions

| Distribution | Status  |
|--------------|---------|
| Ubuntu 20.04 | Working |
| ArchLinux    | Working |

Martin Klimeš's avatar
Martin Klimeš committed
79
80
81
82
## Feedback

If you have any question, please contact us at [unix@fi.muni.cz](mailto:unix@fi.muni.cz).

Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
83
84
## Repository structure

85
| File                     | Description                                      |
86
|------------------------- |------------------------------------------------- |
87
| `install.pl`             | main install script                              |
88
| `cron.pl`                | cron script for automatic updates                |
89
90
| `filters`                | folder with filters for CUPS                     |
| `ppds`                   | folder with PPDs for CUPS                        |