Installer Image for Fleet Installations

For installation on bare metal (64-bit Intel/AMD CPU) an installer image can be created in Altair IoT Studio. This installer image can be used for all Assets of the Fleet.

The image contains the OS, K3s and scripts to create a new cluster on the cloud and install the ECP Management Service at first boot. Each new Asset of the Fleet will automatically show up in Altair IoT Studio.

The following requirements must be met:
  • The hardware device must be connected to the internet.
  • Access to DNS and, optional, NTP
  • Required outbound ports: 443 (https), 8883 (mqtts)
  • Optional outbound ports: 1883 (mqtt)
  • Optional inbound ports: 8080, 8888 (REST API via http)
Note: Only available for intel based CPU (amd64)
The installer image needs the Client ID and Client Secret of an App (see Apps) with the "cluster" scope and role Root as Policies. It is recommended to create a new App specifically for this purpose.


Figure 1.

Follow the steps below to create a new installer image.

  1. From the menu on the left, click Edge Ops > Images.
  2. Click New ECP Image in the upper right corner.
  3. Select the desired software option from the drop-down menu, fill in the public SSh key(s) (each on a new line) for local access to the cluster (username: Altair) and add the Fleet identifier. If an existing Fleet identifier is reused any Asset flashed from this installer image will be added to that Fleet.


    Figure 2.
    Once the installer image has been created (this takes a few minutes) it will be available to download.
  4. Use either the pre-installed "disk imaging" utility on your computer or download balenaEtcher to flash the downloaded image onto a USB drive (minimum size 2GB).
    Note: The USB drive should now be used to boot the asset (gateway).
    When the installation process finishes the gateway will power off. An 8 character password for local SSH access is randomly generated and saved to the /root/crypt_passwords.txt file on the USB drive. This can be used in addition to the SSH key.
  5. Power on the gateway to bring the asset online in Altair IoT Studio.
    Note: Each Asset in EdgeOps Fleet Management is represented in AnythingDB automatically, so you can interact with it. For every Asset you provision, you will find a corresponding record in the Cluster category.

Create an SSH Key on Ubuntu

  1. To get the SSH Public Key run the following commands:
    ssh-keygen
    Output:
    Output
    Generating public/private rsa key pair.
    Enter file in which to save the key (/your_home/.ssh/id_rsa)
  2. Click Enter to save the key pair under the directory .ssh/.
    Output
    Enter passphrase (empty for no passphrase):
    The following information will appear:
    OutputYour 
    identification has been saved in /your_home/.ssh/id_rsa
    Your public key has been saved in /your_home/.ssh/id_rsa.pub
    The key fingerprint is:
    SHA256:/hk7MJ5n5aiqdfTVUZr+2Qt+qCiS7BIm5Iv0dxrc3ks user@host
    The key's randomart image is:
    +---[RSA 3072]----+
    |                .|
    |               + |
    |              +  |
    | .           o . |
    |o       S   . o  |
    | + o. .oo. ..  .o|
    |o = oooooEo+ ...o|
    |.. o *o+=.*+o....|
    |    =+=ooB=o.... |
    +----[SHA256]-----+
  3. To get your public ssh key, run the following command:
    cat ~/.ssh/id_rsa.pub 
    Output:
    Outputssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCqql6MzstZYh1TmWWv11q5O3pISj2ZFl9HgH1JLknLLx44+tXfJ7mIrKN
    xOOwxIxvcBF8PXSYvobFYEZjGIVCEAjrUzLiIxbyCoxVyle7Q+bqgZ8SeeM8wzytsY+dVGcBxF6N4JS+zVk5eMc
    V385gG3Y6ON3EG112n6d+SMXY0OEBIcO6x+PnUSGHrSgpBgX7Ks1r7xqFa7heJLLt2wWwkARptX7udSq05paBhc
    pB0pHtA1Rfz3K2B+ZVIpSDfki9UVKzT8JUmwW6NNzSgxUfQHGwnW7kj4jp4AT0VZk3ADw497M2G/12N0PPB5Cnh
    Hf7ovgy6nL1ikrygTKRFmNZISvAcywB9GVqNAVE+ZHDSCuURNsAInVzgYo9xgJDW8wUw2o8U77+xiFxgI5QSZX3
    Iq7YLMgeksaO4rBJEa54k8m5wEiEE1nUhLuJ0X/vh2xPff6SQ1BL
    /zkOhvJCACK6Vb15mDOeCSq54Cr7kvS46itMosi
    /uS66+PujOO+xt/2FWYepz6ZlN70bRly57Q06J+ZJoc9FfBCbCyYH7U
    /ASsmY095ywPsBo1XQ9PqhnN1
    /YOorJ068foQDNVpm146mUpILVxmq41Cj55YKHEazXGsdBIbXWhcrRf4G2fJLRcGUr9q8
    /lERo9oxRm5JFX6TCmj6kmiFqv+Ow9gI0x8GvaQ== demo@test

Software Update

When a software update becomes available for an Asset created from an installer image, it will be shown on the Edge Ops > Fleet Management > Asset Overview and Details panes.

Clicking the Update Now button will install the update. Note that this process can take up to 15 minutes for large OS updates.


Figure 3.