SiteManager on Linux
SiteManager for Linux is a Debian package for Ubuntu 24.04 on 64-bit Intel or AMD processors. It installs a systemd service, so SiteManager starts with the computer. The package is built for the MT Wall Image.
Installation
- Download SiteManager for Linux. The file name starts with
sitemanager-and ends with.deb. -
Install the package with
apt. Use the real file name:sudo apt install ./sitemanager-<version>.deb
The package installs:
/usr/bin/sitemanagerd, the service;/usr/bin/sitemanager, the command line;- the systemd unit
sitemanagerd.service; /etc/default/sitemanager, where you set the service's options.
On a first installation the package enables the service and starts it. The service listens on this computer only (local mode), so the package prints:
SiteManager: http://127.0.0.1:8790/ (this computer only, no login needed)
SiteManager: to let other computers connect, add --listen :8790 to SITEMANAGER_ARGS in /etc/default/sitemanager and run: sudo systemctl restart sitemanagerd
Open that address in a browser on this computer and continue with First start. There is no setup token, fingerprint or login in local mode. To let other computers connect, see Opening SiteManager to the network.
The package recommends x11-xserver-utils. SiteManager uses xrandr from it to detect the video outputs of the wall computer.
Reading the fingerprint and setup token later
Only a service in network mode has a certificate and a setup token.
sudo sitemanagerd --state-dir /var/lib/sitemanager --print-fingerprint
sudo sitemanagerd --state-dir /var/lib/sitemanager --print-setup-token
sudo journalctl -u sitemanagerd
--print-setup-token prints nothing once the first administrator exists. The token is also in the file /var/lib/sitemanager/setup-token until the setup is done.
The service
The service runs as root because it writes the Cornerstone user's screen.xml, config.txt and mt-canvus.ini, and gives new files to that user. The systemd unit limits what it can do: it can write only to its state directory and to /home, it cannot gain new privileges, and its capabilities are restricted.
Manage it with the usual systemd commands:
sudo systemctl status sitemanagerd
sudo systemctl restart sitemanagerd
sudo journalctl -u sitemanagerd -f
Changing the service options
The options live in /etc/default/sitemanager, in the variable SITEMANAGER_ARGS. The package ships it as:
SITEMANAGER_ARGS="--cornerstone-user multi"
multi is the user of the MT Wall Image. Change it if Canvus runs as another user. The unit passes no --listen, so the service uses its default, 127.0.0.1:8790, which is local mode. Add a --listen option here to change the port or to open SiteManager to the network. The value is split on spaces only. Quotation marks do not work, so a path with a space in it cannot be given here.
After every change, restart the service:
sudo systemctl restart sitemanagerd
The file is a configuration file of the package, so your edits survive an upgrade. See sitemanagerd reference for all options.
Opening SiteManager to the network
The address in --listen decides the mode. 127.0.0.1:8790 (the default), localhost:8790 and [::1]:8790 are local mode. Any other address, such as :8790, is network mode.
-
Edit
/etc/default/sitemanagerso that the variable reads:SITEMANAGER_ARGS="--cornerstone-user multi --listen :8790" -
Restart the service:
sudo systemctl restart sitemanagerd -
Continue with Opening SiteManager to the network. Get the fingerprint and the setup token as shown in Reading the fingerprint and setup token later.
The package does not change your firewall. See Ports and firewall.
To go back to local mode, remove --listen :8790 and restart the service.
If the Cornerstone user's home is not under /home
The service can write only below /home and its own state directory. If the Cornerstone user's home is somewhere else, for example /data/multi, allow that path with a systemd drop-in:
sudo systemctl edit sitemanagerd
In the editor, enter:
[Service]
ReadWritePaths=/data/multi
Save, then run sudo systemctl daemon-reload && sudo systemctl restart sitemanagerd.
Updating
Upgrade every SiteManager on a site first
Securing a display locks out older SiteManager versions, SiteManager 2.x and other tools until it is released. Upgrade every SiteManager on a site before securing displays. See Secure your displays.
Install the newer package over the old one:
sudo apt install ./sitemanager-<new version>.deb
The package restarts the service if it was running or enabled. A service you disabled stays disabled and stopped, and the installer prints how to enable it. The site, users, certificate and history in /var/lib/sitemanager stay as they are. The package does not change /etc/default/sitemanager, so a SiteManager open to the network stays open, and a local one stays local.
Uninstalling SiteManager
sudo apt remove sitemanager
This stops and disables the service and removes the programs. It keeps the site data in /var/lib/sitemanager (site, history and alert settings, and in network mode users and certificate). sudo apt purge sitemanager removes the options file /etc/default/sitemanager as well, but it still keeps the site data and tells you where it is.
To delete the site data too, run:
sudo rm -r /var/lib/sitemanager