README.md 2.26 KB
Newer Older
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# FI printers via Samba

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


## Advantages

-   You can print on WiFi 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. This way, you don’t have to switch configurations.
-   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.
-   This is not the prefered way of printing on fi. (Prefered way is via Kerberos.)


## Pre-requirements

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


### Warning

If you are printing with unauthenticated IPP or Kerberized IPP, you will have to remove client configuration file for CUPS, which is located at `/etc/cups/client.conf`.


## Usage

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

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

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

42
After running the script, you will be prompted for you faculty login(username and password) and for cron instalation if not already installed.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65


### Available printers

Currently available printers:

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

66
67
68
69
#### Currently not supported printers

At the moment copy4b and copy5b are not supported.

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


## Repository structure

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