WolframOS Setup: Difference between revisions

From Knowledge Base
mNo edit summary
Tag: Manual revert
No edit summary
 
(11 intermediate revisions by 2 users not shown)
Line 2: Line 2:


=== Verify box contents ===
=== Verify box contents ===
 
<gallery>
* Industrial computer
File:IPC.jpg|IPC (model may vary)
* Power supply
File:Power supply.jpg|Power supply
* Ethernet cable
File:Ethernet cable.png|Ethernet cable (color may vary)
</gallery>


=== Install hardware ===
=== Install hardware ===
Line 14: Line 15:
# The IPC should begin booting and appear on the network.
# The IPC should begin booting and appear on the network.


== Network requirements ==
== Networking ==
 
=== Firewall configuration ===


=== Local network traffic ===
==== 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 '''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.


Line 25: Line 28:
* 8711/tcp – Inspection HTTPS
* 8711/tcp – Inspection HTTPS
* 8720/tcp – OnTakt
* 8720/tcp – OnTakt
* 38733/udp – [[WolframOS Network Scanner|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.
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 ===
==== 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:
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 ===
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 ==
== First-time setup ==
Line 39: Line 51:


# Get the IP address of the device from your router or IT department. Ideally, this address will be statically assigned so it never changes.
# Get the IP address of the device from your router or IT department. Ideally, this address will be statically assigned so it never changes.
# Go to this IP address in a browser.
# Go to that IP address in a browser.
# Switch to the Settings tab at the top.
# Switch to the Settings tab at the top.
# Apply the provided license key in Options → Advanced → Upload new license key. This will allow downloading software.
# Apply the provided license key in Options → Advanced → Upload new license key. This will allow downloading software.
# 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.