The image in KOS represents the software stack you will run on the node. It can be run on actual hardware or a simulator provided by KOS Studio. In this Article, we will walk through setting up our first image and running it on the simulator. KOS supports single-node and multi-node devices; for the purpose of this article, we will be working on a single-node device.
In the single-node device, you have a single-board computer running Linux and Java.
We will follow these steps to create an image for the device.
Sr. No |
Step |
Step Description |
1 |
Create an image |
|
2 |
Configure the image created in Step 1 |
|
3 |
Run the configured image on Simulator |
Log in to KOS Studio and switch to the project in which you want to create the image.
Navigate to my images and click on Open Image Manager
On the Image Manager window, click on the Create a new image button in the upper right corner.
On the Create a new image pop-up, provide the following information :
Name: The name of the image should be unique within your organization.
Description: The description of the image.
Click on the Create button. This will create an image with the given name, and it is now listed on the Image Manager.
After completing step 1, KOS Studio creates a blank image, and the user needs to configure different layers in the created image. In this article, we will do a basic configuration of an image. Learn more about image configuration here
Log in to KOS Studio and navigate to my images.
On my Images, select Configure image for the image created in step 1. Note that the icon has a red dot indicating errors the user must address.
Click the ‘Configure’ tab in the Image Configuration window.
KOS Release :
Click the ‘KOS Version’ layer at the bottom.
Click the ‘Configure new release’ button to select the KOS release version.
Select the KOS release from the Release Channel available for your organization.
Select the check boxes for Developer tools, Graphics and Chromium
Click the Create button.
Make sure the radio button for the created release is selected.
The image configuration window also allows for configuring hardware settings, local artifacts, layers, file mappings, and sections, which we will keep as default for now.
Close the ‘Image configuration’ window.
The image can be run with KOS Studio on the My Images page. KOS Studio simulates the hardware for your device according to the hardware profile provided in the image.
To run the image :
Log in to KOS Studio and navigate to my images.
Select the image from My Images that we created in Step 1.
Make sure Simulator run target is selected from the dropdown.
Click on Run Image button to run the image in simulator.
Running Image opens in a new window.
Now you have an image that is able to run on simulator. In the next article we will deploy this image on device.