RPD Engineering

RPD Vaktari Hub

All machines · User manual · v2026.10.08a

01What it is and what it does

RPD Vaktari Hub shows the Vaktari Machine of several machines on a single page. Each machine has a tile, and inside the tile is its whole dashboard, shrunk to fit: the state, the counters, the timeline and everything else.

Vaktari Hub screen with five machines
Fig. 1 · Five machines on one page: two running, one stopped by an error, one stopped without an error and one that is not responding.

The Hub reads no files and calculates nothing. Each tile is a window onto the Vaktari Machine running on that machine's computer, and everything you see in it is explained in the Vaktari Machine manual. This manual only covers what belongs to the Hub itself.

Vaktari HubVaktari Live Counters
What it shows of each machinethe whole Machine dashboard: state, availability, stops, errors and outputthe lot counter and the state, in large figures
What it suits bestfollowing a handful of machines in detail from a computera wall monitor read from a distance, with target alerts
What it needsVaktari Machine running on each machineaccess to each machine's folder

02Opening the Hub

The Hub has no program of its own and no black window: it is a page you open directly.

What has to be running

The Hub only displays. For a tile to have content, Vaktari Machine must be started on that machine's computer, and the computer you are looking from must be able to reach it over the network.

No need to refresh

Each dashboard updates by itself, just as when Machine is opened directly. In addition, the Hub checks every 30 seconds whether each machine responds; when one that was not responding comes back, its tile reloads by itself.

More than one Hub

You can have several Hubs, for example one per type of machine. Each one is a folder with its own machine list and title, and is opened with its own vaktari_hub.html.

03The header

Vaktari Hub header with numbered callouts
Fig. 2 · The header.
1
Brand and module.
2
The title of this Hub. It tells it apart when there is more than one; it is also shown on the browser tab. It is set in the machines file; if there is none, it is not shown.
3
The summary: how many machines are responding, out of the total.
4
Columns How many tiles there are in each row, from 1 to 4. See section 5.
5
Reload all Loads every tile again and checks every machine again.
6
Language Catalan, Spanish, English, Basque, French and Portuguese. It changes the language of the Hub and of every dashboard at once.
7
Theme Dark or Light, also for the Hub and for every dashboard.

The browser remembers the language, the theme and the number of columns.

04The tiles

A Hub tile with numbered callouts
Fig. 3 · A tile: the strip at the top belongs to the Hub, the rest is the machine's dashboard.
1
The connection dot. Green if the machine's computer responds, red if it does not, amber while it is being checked.
2
The name of the machine, as set in the machines file.
3
The address of that machine's Vaktari Machine.
4
The connection, in words: Connected, No response or Checking…
5
Enlarge Opens this machine across the whole window.
6
Reloads this tile only.
7
Opens in a new tab this machine's Vaktari Machine, outside the Hub.
8
The machine's dashboard. It is the real Vaktari Machine, not a picture: you can click on it, change tabs, hover over the timeline or choose a period.
Connected does not mean running The dot and the word Connected say that the machine's computer is responding. Whether the machine is producing or stopped is told by the dashboard inside, with its colour: green when running, red when stopped by an error, amber when stopped without an error.

When a machine does not respond

Tile of a machine that is not responding
Fig. 4 · The red dot, No response and a notice in place of the dashboard.

It means the Hub cannot reach that machine's Vaktari Machine: the computer is off, Machine is not started or the network does not reach it. The other tiles are not affected. Nothing needs doing in the Hub: it tries again every 30 seconds and, when the machine comes back, the tile reloads by itself.

05Enlarging a machine and choosing the columns

Enlarging

A machine enlarged to the whole window
Fig. 5 · A machine enlarged. The button at the top right now says Back to grid.

In the grid, the dashboards are shrunk and the small text is hard to read. Enlarge puts one machine across the whole window, at real size, to look at it calmly or work on it: change tabs, choose dates, export. To go back, use Back to grid or the Esc key.

If what you want is to keep a machine open separately, use the button that opens it in a new tab.

Columns

The Hub with two columns
Fig. 6 · The same Hub with two columns: fewer machines in view, but larger.

With Columns you choose how many tiles there are in each row. The fewer the columns, the larger each dashboard looks and the further you have to scroll to see them all. The number is remembered for each Hub separately.

06Language and theme

The Hub in Catalan and light theme, with every dashboard in the same language and theme
Fig. 7 · Language and theme changed in the Hub: every dashboard follows.

The language and theme you choose in the Hub header are applied to every tile at once, so the whole screen looks the same.

07The machines in the Hub

Which machines are shown, under what name and in what order is set by the file maquines_hub.js, in the same folder as the Hub. It opens with Notepad. Editing it is a job for whoever administers the installation.

window.VAKTARI_HUB_CONFIG = {
  title: "Filling lines",
  columns: 3,
  viewWidth: 1280,
  viewHeight: 800,
  pingSeconds: 30,
  machines: [
    { name: "Line 1", url: "http://192.168.1.41:8761" },
    { name: "Line 2", url: "http://192.168.1.42:8761" },
    { name: "Line 3", url: "http://192.168.1.43:8761" }
  ]
};
LineWhat it is
titlethe title of this Hub, exactly as written. Empty (""), no title is shown.
columnsthe columns it opens with the first time, from 1 to 4. After that, whatever is chosen in the header applies.
viewWidth, viewHeightthe size, in pixels, at which each dashboard is drawn before being shrunk. With a lower value, text looks larger and less content fits.
pingSecondshow often, in seconds, each machine is checked
machinesone line per machine: name is the name shown on the tile and url, the address of its Vaktari Machine
The Hub with no machines defined
Fig. 8 · The Hub when the list is empty or the file cannot be read.

Making another Hub

Copy the whole Hub folder under another name and change its maquines_hub.js: the title and the machine list. The four files in the folder (vaktari_hub.html, maquines_hub.js, i18n_hub.js and vaktari_theme.css) must always stay together.

08The footer

Vaktari Hub footer
Fig. 9 · The footer.

It shows the version of the Hub, in bold. The Vaktari Machine version of each machine is in the footer of its dashboard: to see it, enlarge the tile and scroll to the end. They are two different versions, and if you have to report an issue it is worth noting both.

09Common problems

What happensWhyWhat to do
A tile says No responsethat machine's computer is off, Vaktari Machine is not started on it or the network does not reach itCheck that the machine's computer is on and that Machine is running. The Hub tries again by itself.
Every tile says No responsethe computer you are looking from is not on the machines' network, or the addresses do not work from hereCheck the network. If the Hub was copied from another computer, review the addresses that use localhost.
It says Connected but the tile is blankthe dashboard is still loading, or stopped halfwayClick the tile's reload button. If it stays the same, open it in a new tab to see what it says.
No machines definedthe list is empty, or the machines file has an error and cannot be readCheck maquines_hub.js: commas and quotation marks. See section 7.
I changed the machines file and nothing changesthe browser still has the old fileReload the page with Ctrl + F5.
A tile does not change language or themethat machine has an old Vaktari Machine, which does not understand the Hub's instructionThat machine's Machine has to be updated. Tell whoever did the installation.
The text in the dashboards is too smallthere are too many columns for the size of the screenChoose fewer Columns, or enlarge the machine you want to look at.
Only the top part of each dashboard is visiblethe tile shows a fixed height of the dashboardScroll inside the tile with the mouse wheel, or enlarge it.
The Hub comes up with no colours or layouta file is missing from the folderCheck that the four files listed in section 7 are there.
Two Hubs share language and themethey are browser preferences, common to every HubThis is intended. The columns are remembered for each Hub.

If you have to report an issue, note the version of the Hub and that of the Machine of the affected machine, and take a screenshot of the whole screen.