README.md 2.42 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
# 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.
16
-   Password will be stored at `/etc/cups/printers.conf` in plain text format.
Martin Klimeš's avatar
Martin Klimeš committed
17
-   This is not the preferred way of printing on FI. (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 for automatic update
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
26
27
28
29
30
31
32
33
34


### 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
35
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
36
37

For example, to install 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

Martin Klimeš's avatar
Martin Klimeš committed
43
After running the script, you will be prompted for you faculty login(username and password) and for cron installation if not already installed.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
44

Martin Klimeš's avatar
Martin Klimeš committed
45
You may be prompted for faculty login once again on the first print job depending on your distribution.
Martin Klimes (k11m1)'s avatar
Martin Klimes (k11m1) committed
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
-   copy4c
-   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                        |