WolframOS Setup

From Knowledge Base
Revision as of 16:44, 20 February 2024 by Andy (talk | contribs)

Unboxing

Verify box contents

Install hardware

  1. Place the IPC in a safe location.
  2. Connect the Ethernet cable to a router or working Ethernet jack.
  3. Connect the power cable to the wall and the IPC.
  4. The IPC should begin booting and appear on the network.

Networking

Firewall configuration

Local network traffic

The OnTakt server needs outgoing access to each machine control it will read data from. The specific port used for a machine depends on the control type and is usually even configurable on the control. The port should be specified in the machine’s URL in OnTakt.

The OnTakt server needs incoming access from the PCs that will access its web interface on the following ports:

  • 80/tcp – Homepage
  • 8710/tcp – Inspection HTTP
  • 8711/tcp – Inspection HTTPS
  • 8720/tcp – OnTakt
  • 38733/udp – WOLF-SYNC

For mDNS discovery, it will need outgoing access on 5353/udp to 224.0.0.251 (IPv4) and/or ff02::fb (IPv6) as well as incoming access on that same port from the PCs that will access its web interface.

Internet traffic

An internet connection is not required to run or use OnTakt. However, it makes applying updates much easier. If you would like to allow the OnTakt server to access the internet but limit what it can connect to, set up a firewall rule that allows outgoing access to only the following hosts:

  • central.ontakt.live: 443/tcp
  • pkg.central.ontakt.live: 443/tcp
  • us.archive.ubuntu.com: 80/tcp and 443/tcp
  • registry-1.docker.io: 443/tcp
  • production.cloudflare.docker.com: 443/tcp

Setting a static IP address

By default, the OnTakt system will use DHCP to configure networking. If you are operating in an environment without a DHCP server or router, this will not work, and a static IP address must be configured.

  1. Connect a monitor and keyboard to the system.
  2. From the local console:
    • To set a static IP, run sudo set-static-ip <address> <subnet mask> <default gateway> <dns1> [... dnsN]. For example, sudo set-static-ip 10.0.0.2 255.0.0.0 10.0.0.1 10.0.0.1.
    • To undo this, run sudo clear-static-ip.
    • To view the current configuration, run sudo get-static-ip.

Static IP settings can also be changed from the system tab of the web interface.

First-time setup

The IPC must be provisioned and connected to the network first.

  1. Get the IP address of the device from your router or IT department. Ideally, this address will be statically assigned so it never changes.
  2. Go to that IP address in a browser.
  3. Switch to the Settings tab at the top.
  4. Apply the provided license key in Options → Advanced → Upload new license key. This will allow downloading software.
  5. After the key is applied, click the Install button under OnTakt.
  6. After installation is completed, return to the Services page and launch OnTakt.