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 6 of 8

Connect the devices

This step, to be done after the first run in the browser (step 5), connects to BiblioViva the circulation desk computer and, if needed, the other computers, tablets and phones, and gives the staff the accounts to sign in. The circulation desk computer takes about 10 minutes; every other device about 5 minutes.

  • Raspberry Pi with Tailscale

Requirements

  • The school's Tailscale account, the one opened at step 3 (the address it signs in with and, if needed, the person who knows it).
  • The name of the school's network ending in .ts.net, noted down at step 3.
  • The passwords of the BiblioViva accounts, noted down at the end of step 5.

Procedure

Install Tailscale

On every device that must use BiblioViva the Tailscale application must be installed, signed in to the school's account. The computer used for the first run (step 5) already has it: for that one, go on to the next section.

  1. Open the download page for the device's system: Windows, macOS, Linux, Android, iPhone and iPad. For a Chromebook see the page Download. [VERIFY: the Tailscale page for ChromeOS]
  2. Install the application following the instructions on the page.
  3. Open the application and sign in with the school's Tailscale account, the same as at step 3. [VERIFY: the text of the application's sign-in button, different on Windows, macOS and Linux]

The desk computer

  1. If Tailscale is not already installed on this computer, install it as described above.

  2. Open in the browser the address https://biblioviva.<tailnet>.ts.net, replacing <tailnet> with the name noted down at step 3 (the name can also be read on the "DNS" page of the Tailscale console). The Log in page of BiblioViva opens, with the browser's padlock.

    The BiblioViva login page
    Figure 1. The BiblioViva login page

  3. Add the address to the browser's bookmarks.

Other computers, tablets and phones

For every other device that must use BiblioViva:

  1. Install Tailscale as described above.
  2. Open in the browser the address https://biblioviva.<tailnet>.ts.net.
  3. Add the address to the bookmarks.

Install BiblioViva as an app on the phone (optional)

A phone with Tailscale can have BiblioViva as an application with its own icon. It is not needed to work at the circulation desk, where the USB barcode scanner is the normal tool.

  1. Open the address https://biblioviva.<tailnet>.ts.net in the phone's browser and sign in.
  2. In the Dashboard press Install in the Add to the Home screen panel. If the panel does not appear, open the browser's menu and choose "Install app" or "Add to Home screen", depending on the browser. [VERIFY: the name of the menu entry in the Android and iPhone browser]
  3. Confirm the proposed name. The BiblioViva icon appears among the phone's applications.
The phone browser's menu with the entry to install BiblioViva
Figure 2. The phone browser's menu with the entry to install BiblioViva

The staff accounts

The devices of both ways use the same accounts: one per role, shared, each with only the work of its role. The accounts and the passwords are those chosen or generated at step 5; the table is in the section Passwords of that step.

  1. Give each colleague in person the password of the account of their role, by voice or on a sheet of paper. Do not send it by email or in a chat.
  2. Sign in with the account of the role: on the Log in page write the Username and the Password, then press Log in.

To change a password later, see the possible problems of the step First run.

Check before going on

  • On the desk computer the address https://biblioviva.<tailnet>.ts.net opens the Log in page with the padlock.
  • With the username admin and its password one signs in and the start page of BiblioViva opens.
  • Every other device has the Tailscale application signed in and opens the same address.

If the address does not open, see the possible problems below and Common problems.

Possible problems

A–Z index