OnTakt Daemon: Difference between revisions

From Knowledge Base
(Redirected page to Category:OnTakt Daemon)
Tags: New redirect Visual edit
Line 1: Line 1:
The OnTakt Daemon (process name <code>ontaktd</code>) is responsible for running applications such as OnTakt and Inspection, managing system settings and updates, and providing a landing page.
#REDIRECT [[:Category:OnTakt Daemon]]
 
[[OnTakt Daemon Changelog|Changelog]]
 
== 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 application that is available. Whether the application links open in the current tab or a new tab can be customized.
 
=== HTTPS links ===
Some applications make use of browser features that are only available on pages loaded with HTTPS. These applications have a separate lock icon on their tile. Clicking this lock icon will open the application with HTTPS. The first time you do this, you may have to bypass a browser warning. This warning appears because the server is not hosted on the internet, so it does not have a publicly-verified HTTPS certificate, but your connection to the server will still be encrypted.
 
=== Custom links ===
This page is also capable of showing custom links organized into sections. To add links:
 
# Click "Customize" at the top right of the landing page.
# For each section you want to add:
## Under "Custom links" click "New section".
## Enter a name for the new section.
## For each link you want to add to this section:
### Click "Add link".
### Enter the display name and target URL of the link.
### 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.
### 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.
### 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.
### Click OK to save the link.
# 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.
# To edit a link, click the pencil icon in its row.
# To delete a link, click the trash can icon in its row.
# To delete an entire section, click its "delete" button.
# 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:
 
# Click "Customize" at the top right of the landing page
# Click "Export" at the top or bottom of the page
# Choose where to save the file when prompted
 
To import settings later:
 
# Click "Customize" again
# This time choose "Import"
# Select a previously exported file
# Make sure everything looks correct
# 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 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.
 
=== Application management ===
Clicking "check for updates" will check for new versions of all installed applications 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.
 
To install application updates without an internet connection, click "Load update from media" instead. Read more about [[OnTakt Daemon#Offline updates|offline updates]] below.
 
After a new installation, buttons are shown to install each supported application. Clicking these will download and install the application. If a license has not been applied yet, this will not be possible.
 
For applications that have not yet been installed, the following buttons are available:
 
* Install
 
For applications that are installed but not running, the following buttons are available:
 
* Start
* Uninstall
* Update
* Logs
* Back Up
* Restore
 
For applications that are installed and running, the following buttons are available:
 
* Stop
* Restart
* Update
* Logs
* Back Up
* Restore
 
==== Application action explanations ====
* '''Install''' will download and install the application. This will fail if a license has not been applied yet.
* '''Start''' or '''Stop''' will start running or stop running an installed application.
* The '''Restart''' drop-down allows you to restart individual services of an application, or click the main Restart button to restart the entire application.
* '''Uninstall''' will move application data to a hidden location and then uninstall the application. Once this has been done, the data is only recoverable from an external backup or by a Wolfram Manufacturing service technician.
* '''Update''' will check for and then install any available updates to application services and then restart the application (or start it if it is not already running). This requires an internet connection, but [[OnTakt Daemon#Offline updates|offline updates]] are possible via a different method.
* The '''Logs''' drop-down allows you to view logs from individual services of an application, or click the main Logs button to show a combined log from all services of the application.
* '''Back Up''' will create a backup of the application's database onto an external USB flash drive. To select which flash drive to use, choose it from the "destination device" drop-down in the "Backups" section of the page and click Save.
* '''Restore''' allows restoring a backup from an external USB flash drive. If restoration fails, ensure no web browsers are accessing the application, then restart the application and try again.
 
The component versions reported by the application are also shown here, as well as the latest versions if updates are available. Note that the application 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 application versions is the "versions" option in the user menu after logging into an individual application.
 
=== 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. All applications will be restarted automatically, but it may take a second restart to fully sync changes between applications.
 
=== Backups ===
If a USB flash drive is left plugged into the OnTakt server, choose it here and enable automatic backups to backup all applications to the drive once every week.
 
Clicking "Save" saves the selected USB device and automatic backup preference.
 
Clicking "Save & Run" saves the selected USB device and automatic backup preference and then runs a backup of all installed applications to the selected USB device.
 
=== Network configuration ===
If the OnTakt server is not connected to a router with DHCP enabled, you can set a static IP configuration here.
 
To use a static IP address:
 
# Switch on "Use static IP address"
# Enter the following information:
## IP address it should use
## The network's subnet mask (usually 255.255.255.0)
## The default gateway (usually the router's IP address)
## One or two DNS servers to use (usually the router's IP address)
# Click Save
 
To add additional DNS servers, fill in the empty field and click Save for each server you want to add. To remove a DNS server, clear its text field and click Save.
 
To revert to using DHCP, switch off "Use static IP address" and click Save.
=== 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.
 
To use the operating system's default NTP server via the internet, clear this box and click Save.
 
== Offline updates ==
Offline updates can be performed by placing offline update packages on a USB flash drive and plugging it into the server PC then following the instructions depending on the type of update to install:
 
=== System/Daemon ===
Daemon updates are distributed as <code>.odup</code> (Offline Daemon Update Package) files, which are around 6 MB in size. Contact Wolfram Manufacturing to obtain an update file if you believe one is necessary.
 
To update the daemon or install other system packages, click "Update from media" in the "System information" section. Select the USB drive and file from the list and then click Install.
 
=== Applications ===
Application updates are distributed as <code>.oappup</code> (Offline APPlication Update Package) files, which are around 800 MB in size and contain updated versions of all services that make up a single application. Contact Wolfram Manufacturing to obtain an update file if you believe one is necessary.
 
To update applications with an offline update package, click "Load update from media" in the "Application management" section. For each update file, select the USB drive and file from the list and then click Install. Once an application update has been installed, click Restart under that application to apply the update.


[[Category:OnTakt]]
[[Category:OnTakt]]
{{DEFAULTSORT:Daemon}}
{{DEFAULTSORT:Daemon}}

Revision as of 17:41, 14 March 2023