Documentation

Node Discovery

A node is a Linux-based computer running KOS. Different nodes in a device can run different software, including different parts of the KOS stack. For example, one node may run Java while another only runs a browser. Nodes are connected to each other over ethernet and are able to communicate seamlessly, allowing a device to function as a distributed system. Working with embedded development becomes easier when the developer is connected to the device and able to test the software being built. Node discovery lists all the possible devices running KOS in your network and all the devices connected via KOS Studio within your organization.

Node Manager enables you to assign a short name and location to each MAC address in your environment to make installing or running an image even easier.

A short name is a name the user can assign to each discovered node, making a device easier to talk about - If you have three test stands - they might sit at different stations, so the devices could have three different short names

TS: Station 1
TS: Station 2
TS: Station 3

To differentiate nodes even further (imagine all the Raspberry Pis in the world), the node manager allows you to add locations for your nodes. You can choose from available locations or add your own location. In the example above, maybe I have two locations: a lab in the north and a developer hub in the south, but both locations use Station assignments.

In this case, I might create two locations

North Lab	Developer Lab
TS: Station 1	TS: Station 1
TS: Station 2	TS: Station 2
	TS: Station 3
	TS: Station 4

North Lab

Developer Lab

TS: Station 1

TS: Station 2

TS: Station 3

TS: Station 4

Even though the names overlap, it quickly becomes clear which device I am using to run or install an image.

By assigning these names to the MAC address, the node manager will connect to the correct node even if the node’s IP is updated. Node discovery is a powerful tool that eases many of the traditional embedded development hurdles.

Access Node Discovery

Login to KOS Studio.
Select Tools from the top navigation bar.
From the Tools dropdown, select Node Discovery.

Node discovery opens a new window containing a list of all local and organizational nodes.

View local node/s

Login to KOS Studio.
Select Tools from the top navigation bar.
From the Tools dropdown, select Node Discovery.
Node discovery opens a new window containing a list of all local and organizational nodes. Click on the Local Nodes tab to view a list of all local nodes discoverable in the local network. Consider following :
1. The local node list is empty if none of the accessible devices are running KOS (Available in the KOS bootloaders).
2. Node discovery displays connected devices that are running KOS (Available in the KOS bootloaders).

View nodes within the organization

Login to KOS Studio.
Select Tools from the top navigation bar.
From the Tools dropdown, select Node Discovery.
Node discovery opens a new window containing a list of all local and organizational nodes. Click on the “Organization view” tab to view a list of all nodes registered in your organization. Consider following :
1. The organization node list is empty if none of the accessible nodes are running KOS (Available in the KOS bootloaders).
2. Node discovery displays nodes registered via KOS Studio by other users within your organization that have devices running KOS (Available in the KOS bootloaders).

Edit a node

Login to KOS Studio.
Select Tools from the top navigation bar.
From the Tools dropdown, select Node Discovery.
Node discovery opens a new window containing a list of all local and organizational nodes. Select the node to edit from the Local Nodes or Organization View tab.
Click on the edit icon [edit icon] displayed on the right-hand side for the node.
“Edit node name” pop-up is displayed, allowing the user to edit the node information. Consider following :
1. Short Name: The familiar name for the node. The name should be unique within the given location. This field accepts alphanumeric values.
2. IP Address: This is the discovered IP address for the node; this is a non-editable field.
3. MAC Address: This is the discovered MAC address for the node; this is a non-editable field.
4. Location: This represents the node’s location, and the user can provide alphanumeric values.
5. Lock Access: This is an admin-only feature. The locked node is unavailable for editing and deleting.
Once the required information is edited, click on “Update” to update.
Consider the following :
1. Locked nodes are unavailable for editing.

Delete a node

Login to KOS Studio.
Select Tools from the top navigation bar.
From the Tools dropdown, select Node Discovery.
Node discovery opens a new window containing a list of all local and organizational nodes. Select the node to delete from the Local Nodes or Organization View tab.
Click on the Delete icon [Delete icon]; this opens the confirmation pop-up indicating that the node will permanently delete its assigned name and location. Consider following :
1. Locally discovered nodes are not available to delete.
2. Nodes marked as locked are not available to delete.
3. Deleting a node permanently deletes its assigned name and location.
4. If the node is discovered again after deleting, it will have an empty name and location.