How to Install the Updater Service (version 23)

The 'Canary Updater' service is responsible for downloading and updating nodes with template configs published from the Central Admin. Currently, the process for installing the updater service is a manual one. The updater can run on either Windows (Windows 10/Server 2012 or newer) or Linux (Ubuntu and Raspbian have been tested). It will need to be installed on the historian machine as well as any node that will be collecting data. Similar to the Central Admin, the updater service also requires .NET 6.0 Framework.

1. Download and install the .NET 6.0 Framework apps, if necessary.
   • Windows - Hosting Bundle
   • Linux - Package Manager Instructions (then follow Microsoft's guidelines for which Linux package to install)

2. Create a 'Canary' folder in the following directory if it does not already exist

   • Windows - C:\Program Files\

   • Linux - /opt/

3. Copy and paste the 'Updater' folder, provided by Canary Support, to the Windows/Linux machine within the Canary folder defined above

4. Register the 'CanaryUpdater.exe' (Windows) or 'CanaryUpdater.dll' (Linux).

   • Windows -

     "C:\Program Files\Canary\Updater\CanaryUpdater.exe" -register

      

   • Linux -

     sudo dotnet /opt/Canary/Updater/CanaryUpdater.dll -register

      

5. Start the 'Canary Updater' service.
   *If installing the Updater service on the same machine as the Central Admin machine, ignore steps 6 and 7.

   ---

6. Edit the C:\ProgramData\Canary\Node\node.json file (Windows) or /etc/opt/Canary/Node/node.json (Linux) and modify the 'CentralAdminEndpoint' by pointing it to the Central Admin machine. The default value is 'localhost'. 

7. Restart the 'Canary Updater' service.