WolframOS Setup: Difference between revisions

From Knowledge Base
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 3: Line 3:
=== Verify box contents ===
=== Verify box contents ===
<gallery>
<gallery>
File:IPC.jpg|IPC
File:IPC.jpg|IPC (model may vary)
File:Power supply.jpg|Power supply
File:Power supply.jpg|Power supply
File:Ethernet cable.png|Ethernet cable (color may vary)
File:Ethernet cable.png|Ethernet cable (color may vary)
Line 35: Line 35:
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:
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:


* us.archive.ubuntu.com: 80/tcp and 443/tcp
* central.ontakt.live: 443/tcp
* central.ontakt.live: 443/tcp
* pkg.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
* download.docker.com: 443/tcp


=== Setting a static IP address ===
=== 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.
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.


# Connect a monitor and keyboard to the system.
Static IP settings can be changed from the system (or network) tab of the web interface.
# From the local console:
#* To set a static IP, run <code>sudo set-static-ip <nowiki><address> <subnet mask> <default gateway> <dns1> [... dnsN]</nowiki></code>. For example, <code>sudo set-static-ip 10.0.0.2 255.0.0.0 10.0.0.1 10.0.0.1</code>.
#* To undo this, run <code>sudo clear-static-ip</code>.
#* To view the current configuration, run <code>sudo get-static-ip</code>.
 
Static IP settings can also be changed from the system tab of the web interface.


== First-time setup ==
== First-time setup ==
Line 59: Line 56:
# After the key is applied, click the Install button under OnTakt.
# After the key is applied, click the Install button under OnTakt.
# After installation is completed, return to the Services page and launch OnTakt.
# After installation is completed, return to the Services page and launch OnTakt.
<html>
<div style="position: relative; padding-bottom: 64.86486486486486%; height: 0;"><iframe src="https://www.loom.com/embed/ae891999ba4d41bd8e7f88c790fcebb2?sid=c9b0ce48-19df-43a9-a497-3bc25067ddf0" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
</html>
[[Category:OnTakt]]
[[Category:OnTakt]]
{{DEFAULTSORT:Setup}}
[[Category:Inspection]]
[[Category:WolframOS]]

Latest revision as of 18:08, 6 November 2024

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
  • download.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.

Static IP settings can be changed from the system (or network) 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.