SiteManager on Windows
The Windows installer sets SiteManager up as a Windows service. The service starts with the computer, keeps running when nobody is signed in, and is restarted by Windows if it stops.
Requirements
- 64-bit Windows 10 or later.
- Administrator rights to run the installer.
- A computer on the touch network the displays are on.
Installation
- Download SiteManager for Windows.
- Run the installer. Windows asks for administrator approval.
- Choose the install folder. The default is
C:\Program Files\MultiTaction\SiteManager. -
On the Cornerstone user page, enter the Windows user name that runs Canvus and Showcase on this computer. SiteManager writes
screen.xml,config.txtandmt-canvus.iniin this user's profile.The installer suggests the user who last signed in at this computer. That is not always the administrator account that runs the installer, so check the name. Use
DOMAIN\namefor a domain account. The name must not contain quotation marks or percent signs. -
On the Network access page, leave Allow other computers to connect unticked unless people on other computers need SiteManager. Unticked is the default. See Local or network.
- Finish the installation.
When the installer has finished in local mode, its last page says to open http://127.0.0.1:8790/ in a browser on this computer. No login is needed. Continue with First start. The finish page has a box to open SiteManager in your browser. It is ticked only when the service is running.
If you ticked Allow other computers to connect, the last page shows the web address, the TLS fingerprint of the service's certificate and the first-time setup token, which you need to create the first administrator. Write down or copy the fingerprint and the token, then continue with First start.
Note
In network mode the installer waits up to 30 seconds for the service to create its certificate. If it cannot show the token, the finish page tells you how to read it. See Reading the fingerprint and setup token later.
Local or network
The Network access page asks: Allow other computers to connect (HTTPS with logins; adds a Windows Firewall rule).
- Unticked (the default): local mode. The service listens on
127.0.0.1:8790. You open it in a browser on this computer with no login, no certificate and no setup token. The installer adds no firewall rule. - Ticked: network mode. The service listens on port 8790 for other computers. It uses HTTPS with a self-signed certificate, asks for a first-time setup token, requires logins, and the installer adds a Windows Firewall rule.
Opening SiteManager to the network
To switch an installed SiteManager to network mode, run the installer again and tick Allow other computers to connect. To go back, run it again and clear the box. The installer removes the firewall rule when you go back to local mode. Users and tokens you made in network mode are kept, and used again if you tick the box later.
Then follow Opening SiteManager to the network.
What the installer sets up
- The Windows service MultiTaction SiteManager (service name
SiteManager). It runs as the Local System account, starts automatically after the computer has booted, and is restarted after a failure. - In network mode only, one Windows Firewall rule named
SiteManager. It allows inbound connections tositemanagerd.exe, so browsers on other computers can reach the web interface. In local mode the installer adds no rule. - The state directory
C:\ProgramData\MultiTaction\SiteManager. Only SYSTEM and Administrators can read it, because it holds alert credentials and, in network mode, password hashes and the certificate key.
The installer does not add the sitemanager command to your PATH. Run it by its full path, or add the install folder to PATH yourself:
"C:\Program Files\MultiTaction\SiteManager\sitemanager.exe" help
Silent installation
Run the installer with the standard Inno Setup options. These are the useful ones:
| Option | Meaning |
|---|---|
/VERYSILENT |
No windows. |
/CORNERSTONEUSER=name |
The Cornerstone user, on a new installation. On an upgrade the user already stored in the service wins. |
/NETWORK=yes or /NETWORK=no |
Allow other computers to connect (yes, network mode) or not (no, local mode). Without it a new installation is local, and an upgrade keeps the mode it has. With it, the option wins on an upgrade too. |
/DIR="path" |
The install folder. |
/LOG=file |
Write a setup log. |
Setup's exit code does not show a failed service registration or start. A silent installation writes a line that starts with Problem: to the setup log when something went wrong, so always use /LOG=file and check it.
Reading the fingerprint and setup token later
Only a service in network mode has a certificate and a setup token. Open an administrator command prompt and run:
cd "C:\Program Files\MultiTaction\SiteManager"
sitemanagerd.exe --state-dir "C:\ProgramData\MultiTaction\SiteManager" --print-fingerprint
sitemanagerd.exe --state-dir "C:\ProgramData\MultiTaction\SiteManager" --print-setup-token
--print-setup-token prints nothing once the first administrator exists. To write the value to a new file instead of the screen, add --print-to C:\path\to\new-file.txt.
Starting, stopping and changing the service
Use the Windows Services application (service name MultiTaction SiteManager), or an administrator command prompt:
sitemanagerd.exe service stop
sitemanagerd.exe service start
To change the options the service runs with, for example the port, register it again with the new options after the --. The service is updated in place. The --listen option sets the mode: 127.0.0.1:8790 is local mode, and :8790 is network mode.
To change only between local and network, running the installer again is simpler, because it also adds or removes the firewall rule.
sitemanagerd.exe service install -- --cornerstone-user jdoe --listen :8790
sitemanagerd.exe service stop
sitemanagerd.exe service start
Give every option you want to keep, not only the one you change. Paths in these options must be absolute, because the service starts in the Windows system folder. See sitemanagerd reference for the options.
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.
Run the newer installer. It stops the service, replaces the files, updates the service with the options it had and starts it. The site data stays as it is. The installer keeps the mode of the installed service: a service that was open to the network stays open, and a local one stays local. The Network access box starts ticked or unticked to match, and a silent upgrade keeps the mode unless you give /NETWORK=yes or /NETWORK=no. If you disabled the service on purpose, it stays disabled and is not started. The finish page then tells you how to enable it:
sc config SiteManager start= delayed-auto
sitemanagerd.exe service start
Uninstalling SiteManager
Open Settings > Apps > Installed apps (or Control Panel > Programs and Features), select MultiTaction SiteManager and click Uninstall.
The uninstaller stops and removes the service and the firewall rule, if there is one. It then asks whether to delete the site data (status history, alert settings and, if you used network mode, users and certificate) in the state directory. The default answer is No, so a later reinstall finds your site as it was. A silent uninstall always keeps the site data.
To remove the data later, delete the folder C:\ProgramData\MultiTaction\SiteManager. If you moved the state directory with the --state-dir option, the uninstaller never offers to delete it. Delete that folder yourself.