BiblioViva Documentation
SearchCtrl K
ITEN
  1. 1 · Prepare the computer
  2. 2 · Connect to the computer
  3. 3 · Prepare the network
  4. 4 · Install BiblioViva
  5. 5 · First run
  6. 6 · Connect the devices
  7. 7 · Test the scanner and the printer
  8. 8 · Backups
Step 3 of 8

Prepare the network

This step prepares what is needed outside the BiblioViva computer so that the school's other devices can reach it: with Tailscale a school account and an access key, with the local network an address that does not change. It takes about 15 minutes with Tailscale and about 10 minutes with the local network, plus the wait for whoever manages the school's network. The choice between the two ways is explained in Choose the network.

  • Raspberry Pi with the local network

Requirements

  • The name of the person (or the company) who manages the school's network and router.
  • The BiblioViva computer, with the name biblioviva given at step 1, connected to the school's network.

Procedure

  1. Ask whoever manages the school's network to reserve an address for the computer biblioviva, that is, to make the router always assign it the same address. It is called "DHCP reservation" or "reserved address" (see the glossary). Without this reservation the address can change when the computer restarts, and the bookmarks stop working.
  2. Give whoever manages the network the computer's name (biblioviva). If the router also asks for the physical (MAC) address, the person finds it in the list of devices connected to the router.
  3. Write down the reserved address that the person communicates (for example 192.168.1.50): it is needed to open BiblioViva from the computers where the name biblioviva.local does not work.
  4. Ask that port 8080 not be blocked between the desk computers and the BiblioViva computer. In a home network or a small school's network it normally is not; it can be in a network with filters or with separate networks for the cabled connection and for Wi-Fi.

Note. The name biblioviva.local usually works from the computers of the same network and can be used in place of the address; the check is at step 6. On a PC with Debian or Ubuntu the installation program of step 4 adds the necessary service (avahi-daemon) when it is missing; the Raspberry Pi answers to that name by itself.

Note. With the local network the camera, the installation of the application on the phone and use from outside the school do not work. The USB barcode scanner and the rest of BiblioViva work normally. The complete comparison is in Choose the network; the way can be changed later.

Check before going on

  • Whoever manages the network has confirmed that the address is reserved for the computer biblioviva.
  • The address (for example 192.168.1.50) is written down.
  • The person who manages the network knows that port 8080 must stay open.

If the reservation cannot be obtained right away, it is possible to go on: BiblioViva works anyway, but the address might change at the computer's first restart, and the search described at step 6 has to be redone.

Possible problems

A–Z index