WolframOS Networking: Difference between revisions

Latest revision as of 16:19, 21 August 2024

Web interface configuration

Requires OnTakt Daemon version 0.5.0 or newer.

Visit the services landing page by visiting the IP address of the OnTakt server, or by clicking Services from the user menu inside OnTakt or Inspection.
Switch to the System tab at the top.
Scroll down to the "Network configuration" section.
Toggle "Use static IPv4 address" on or off. If enabling static IP configuration, fill in the following fields:
- Static IP address to use
- Subnet mask (from the router's settings)
- Default gateway (router's IP address)
- DNS servers: enter at least one
Click Save.

USB drive configuration

Requires OnTakt Daemon version 1.0.6 or newer.

For situations where the web interface is not accessible, such as if the IP and MAC addresses of the OnTakt PC are unknown, it is possible to read the current network information and set a new network configuration by placing files on a USB flash drive and rebooting.

These files use the TOML format and can be viewed and edited with any text editor, such as Notepad on Windows or TextEdit on macOS.

Getting the current network information

Place a file named read_network.otd.toml on a flash drive (not inside any folders) and insert it into the OnTakt PC, then reboot it.

Once the OnTakt PC has booted, remove the flash drive and open the same file on another computer. It will contain the current network information for each interface.

Changing network settings

Place a file named write_network.otd.toml on a flash drive (not inside any folders) with one of the following contents and insert it into the OnTakt PC, then reboot it. Settings will be applied to all interfaces.

In these examples, lines starting with # are comments and will be ignored by the software. Settings are case-sensitive.

Enable static IP

Static = true

# The IP address to use
IPv4Address = "xxx.xxx.xxx.xxx"

# Depends on the router's settings
SubnetMask = "255.255.255.0"

# IP address of the router
DefaultGateway = "yyy.yyy.yyy.yyy"

# At least one DNS server must be specified
DNSServers = ["a.b.c.d", "e.f.g.h"]

Disable static IP and use DHCP

Static = false

@@ Line 16: / Line 16: @@
 For situations where the web interface is not accessible, such as if the IP and MAC addresses of the OnTakt PC are unknown, it is possible to read the current network information and set a new network configuration by placing files on a USB flash drive and rebooting.
+These files use the [https://toml.io/ TOML] format and can be viewed and edited with any text editor, such as Notepad on Windows or TextEdit on macOS.
 === Getting the current network information ===
 Place a file named <code>read_network.otd.toml</code> on a flash drive (not inside any folders) and insert it into the OnTakt PC, then reboot it.
-Once the OnTakt PC has booted, remove the flash drive and open the same file on another computer. It will contain the current network information in this format:<syntaxhighlight lang="toml">
+Once the OnTakt PC has booted, remove the flash drive and open the same file on another computer. It will contain the current network information for each interface.
-# Primary MAC address
-MacAddress = "..."
-# Primary IPv4 address
-IPv4Address = "..."
-# Primary IPv6 address.
-# Note that IPv6 is not currently supported, and
-# this is provided for debugging purposes only.
-IPv6Address = "..."
-# Broadcast address.
-# This is provided for debugging subnet settings.
-BroadcastAddress = "..."
-# MAC addresses of all network interfaces,
-# including any that are offline.
-MacAddresses = ["...", "..."]
-</syntaxhighlight>Lines starting with <code>#</code> are comments added here for illustrative purposes and may not be included in the file.
 === Changing network settings ===
-Place a file named <code>write_network.otd.toml</code> on a flash drive (not inside any folders) with one of the following contents and insert it into the OnTakt PC, then reboot it.
+Place a file named <code>write_network.otd.toml</code> on a flash drive (not inside any folders) with one of the following contents and insert it into the OnTakt PC, then reboot it. Settings will be applied to all interfaces.
-In these examples, lines starting with <code>#</code> are comments will be ignored by the software. Settings are case-sensitive.
+In these examples, lines starting with <code>#</code> are comments and will be ignored by the software. Settings are case-sensitive.
 ==== Enable static IP ====
@@ Line 71: / Line 52: @@
 </syntaxhighlight>
 [[Category:WolframOS User Guide]]
+{{DEFAULTSORT:Networking}}