OnTakt Daemon

From Knowledge Base
Revision as of 14:32, 22 February 2023 by Andy (talk | contribs)

The OnTakt Daemon (process name ontaktd) is responsible for running services such as OnTakt and Inspection, managing system settings and updates, and providing a landing page.

Changelog

Services landing page

The landing page, accessible by visiting the server's IP address in a web browser, shows tiles across the top for each Wolfram Manufacturing service that is available. Clicking these tiles will open the services. Whether the service links open in the current tab or a new tab can be customized.

Custom links

This page is also capable of showing custom links organized into sections. To add links:

  1. Click "Customize" at the top right of the landing page.
  2. For each section you want to add:
    1. Under "Custom services" click "New section".
    2. Enter a name for the new section.
    3. For each link you want to add to this section:
      1. Click "Add link".
      2. Enter the display name and target URL of the service.
      3. Turn on "open in new tab/window" if you would like the link to open in a new tab when clicked, otherwise leave it off and the link will open in the tab showing the landing page.
      4. Turn on "enable ping" if you would like the link to be color-coded based on whether it is reachable from the current browser. This can indicate whether a VPN connection is necessary, whether the link target is down, etc.
      5. If you would like, upload a small icon to display next to the link name in the list. Icons are limited to 100 KB each.
      6. Click OK to save the link.
  3. You can rearrange links in a section by clicking the up and down arrow buttons, and you can rearrange sections by clicking the "move up" and "move down" buttons.
  4. To edit a link, click the pencil icon in its row.
  5. To delete a link, click the trash can icon in its row.
  6. To delete an entire section, click its "delete" button.
  7. Click "Save" on the right side of the page when you are done. To cancel all current changes, click "discard" instead.

Export/Import settings

Requires OnTakt Daemon version 0.5.8 or newer

To export your landing page customizations as a backup or to copy them to another OnTakt instance:

  1. Click "Customize" at the top right of the landing page
  2. Click "Export" at the top or bottom of the page
  3. Choose where to save the file when prompted

To import settings later:

  1. Click "Customize" again
  2. This time choose "Import"
  3. Select a previously exported file
  4. Make sure everything looks correct
  5. Click "Save" to apply the imported settings

System management

System information

This panel shows the current utilization of system resources (disk, memory, swap space, CPU time), as well as uptime of the operating system and daemon process. If any resource becomes overused for an extended period of time, contact Wolfram Manufacturing for help.

Network

This panel shows whether the daemon process is able to connect to our server at https://central.ontakt.live/. If this shows offline but the device should be online, check that firewall rules are not blocking this traffic.

System control

This panel allows you to shut down or restart the OnTakt server hardware. Clicking either of these options will schedule the task for one minute in the future, and they can be cancelled during this minute.

Clicking "view daemon service log file" can allow you to diagnose issues with the OnTakt Daemon, and view which IP addresses are accessing it.

The "update" button will check for and install operating system updates, including updates to the daemon itself. This automatically runs every week, so manual system updates are rarely needed.

Service management

Clicking "check for updates" will check for new versions of all installed services and display them. This happens automatically every week, and the number of available updates will appear as a badge on the system tab if any are found.

After a new installation, buttons are shown to install each supported service. Clicking these will download and install the service. If a license has not been applied yet, this will not be possible.

Once a service has been installed, more options for it will be shown here:

  • "Start" or "Stop" will start running or stop running the service
  • "Restart" will restart the service
  • "Update" will check for and then install any available updates to service components, then restart the service (or start it if it is not already running)
  • The "logs" dropdown allows you to view service logs. Clicking the main "logs" button will show a combined log from all components. Clicking the dropdown arrow allows you to select an individual component.
  • "Back up" will create a backup of the service's database onto an external USB flash drive.
  • "Restore" allows restoring a backup from an external USB flash drive. If restoration fails, ensure no web browsers are accessing the service, then restart the service and try again.

The component versions reported by the service are also shown here, as well as the latest versions if updates are available. Note that the service must report these versions, so they may be slightly outdated for up to an hour after installing an update. The most accurate place to check service versions is the "versions" option in the user menu after logging into an individual service.

License

This panel shows information about the current license if one has been activated. To apply a new license, choose the file from your computer and click "activate" here. Services may need to be restarted for a new license to fully take effect.

Backups

If a USB flash drive is left plugged into the OnTakt server, choose it here and enable automatic backups to backup all services to the drive once every week.

NTP server

If the OnTakt server cannot reach the internet, you can specify a local NTP server address here to keep the clock synchronized. This is important for ensuring that timestamps of parts, inspections, etc. are accurate.

Network configuration

If the OnTakt server is not connected to a router with DHCP enabled, you can set a static IP configuration here by enabling "use static IP address" and then entering the IP address it should take, the network's subnet mask and default gateway, and one or two DNS servers to use.