Difference between revisions of "IOT-GATE-IMX8PLUS and SBC-IOT-IMX8PLUS: Debian Linux: Installation"

From Compulab Mediawiki
Jump to: navigation, search
 
Line 2: Line 2:
 
This article provides instructions needed to install the Debian Linux live image onto the Compulab IOT-GATE-IMX8PLUS / SBC-IOT-IMX8PLUS internal storage.
 
This article provides instructions needed to install the Debian Linux live image onto the Compulab IOT-GATE-IMX8PLUS / SBC-IOT-IMX8PLUS internal storage.
 
The recommended installation procedure is using a host PC with a Debian-based operating system.
 
The recommended installation procedure is using a host PC with a Debian-based operating system.
 
== Downloading the OS image ==
 
* Download [https://www.compulab.com/products/iot-gateways/iot-gate-imx8plus-industrial-arm-iot-gateway/#devres IOT-GATE-IMX8PLUS and SBC-IOT-IMX8PLUS Debian Linux image] archive.
 
: It's referred to as ''iot-gate-imx8plus_debian-linux_YYYY-MM-DD.zip'' further in the article.
 
 
== Preparing the workstation ==
 
* Obtain a Debian-based workstation with a free USB port.
 
* Obtain a USB flash drive. Any commercially available USB flash drive of 4GB (or larger) may be used for the installation.
 
* Plug the USB flash drive into the host PC. From now we assume the device name of the flash drive on your Linux PC is {{filename|/dev/sdX}}.
 
*
 
  
 
== Preparing Installation Media ==
 
== Preparing Installation Media ==
* Flash the image file to the USB flash drive:
+
Prepare [[IOT-GATE-IMX8PLUS and SBC-IOT-IMX8PLUS: Debian Linux: Preparing Live Media|Debian Linux Live Media]]
<pre>
 
unzip -p ~/path/to/IOT-GATE-IMX8PLUS-debian-linux/images/iot-gate-imx8plus_debian-linux_YYYY-MM-DD.zip | sudo dd of=/dev/sdX bs=1M status=progress conv=fsync
 
</pre>
 
 
 
== Run Debian Linux image ==
 
* Insert the USB flash drive into one of the USB ports. It's recommended to use [[IOT-GATE-IMX8PLUS: Getting Started#Front_panel|USB3.0 port]]
 
* Power on the device and wait for the GRUB menu
 
  
 
== Installing Debian images onto the internal storage ==
 
== Installing Debian images onto the internal storage ==
* In the GRUB menu choose '''Install Linux''' option
+
* Insert the USB flash drive into one of the USB ports. It's recommended to use [[IOT-GATE-IMX8PLUS: Getting Started#Front_panel|USB3.0 port]] located on the front panel
 +
* Power on the device
 +
* Press a key to prevent a possible autoboot and get into the U-Boot command prompt.
 +
* Run a command below:
 +
:<pre>run bsp_bootcmd</pre>
 +
{{Note|''U-Boot 2021.04-compulab-1.5'' version or later runs ''bsp_bootcmd'' by default}}
 +
* Wait for the Linux login prompt
 +
* [[IOT-GATE-IMX8PLUS_and_SBC-IOT-IMX8PLUS:_Debian_Linux:_How-To_Guide#Connection_and_Login|Login]] as '''compulab''' user
 +
* Invoke '''cl-deploy''' utility
 +
:<pre>compulab@compulab-imx8mp:~$ sudo cl-deploy</pre>
 +
* Select '''/dev/mmcblk2''' as a destination device
 
<pre>
 
<pre>
                          GNU GRUB  version 2.04-20
+
Select a destination device
 +
─────────────────────────────────────────────────────────────────────────────────────────
  
  ┌────────────────────────────────────────────────────────────────────────────┐
+
      ┌─────────────────────────────────────────────────────────────────────┐
Boot Linux Image-5.15.5-rt22+g070f2e215360                                │  
+
      │ Available Devices:                                                │
Boot Linux Image-5.15.5+gb1890f1017e3                                     
+
      ┌─────────────────────────────────────────────────────────────────┐
*Install Linux                                                             
+
      │ │                                                                 │ │
Advanced Boot Options                                                     
+
      │ │                     (*) /dev/mmcblk2                          │ │
                                                                         
+
      │ │                                                                 │ │
                                                                         
+
      │ │                                                                 │ │
                                                                         
+
      │ │                                                                 │ │
                                                                         
+
      └─────────────────────────────────────────────────────────────────┘
                                                                         
+
      │                    <  OK >        <Cancel>                        │
                                                                         
+
      └─────────────────────────────────────────────────────────────────────┘
                                                                         
 
                                                                          │  
 
  └────────────────────────────────────────────────────────────────────────────┘
 
 
 
      Use the ▲ and ▼ keys to select which entry is highlighted.         
 
      Press enter to boot the selected OS, `e' to edit the commands     
 
      before booting or `c' for a command-line.                         
 
 
</pre>
 
</pre>
* The installer will start running automatically:
+
* The following warning message will show up.
 
<pre>
 
<pre>
          +--------cl-deploy will get started in 5 seconds-----------+
+
Start Deployment
          | Configuration file /etc/cl-auto.conf parameters:        |
+
─────────────────────────────────────────────────────────────────────────────────────────
          | --------------------------------------------------      |
+
 
          | # Destination is the module inthernal media.            |
+
      ┌──────────────────────────── WARNING ────────────────────────────────┐
          | # Autoinstaller how to:                                 |
+
      │ Src: /dev/sda -> Dst: /dev/mmcblk2                                  │
          | ## cp /usr/share/cl-deploy/cl-auto.conf.sample          |
+
      │                                                                    │
          | /etc/cl-auto.conf                                        |
+
      │ All data on /dev/mmcblk2 will be destroyed                          │
          | ## cl-auto -A                                            |
+
      │                                                                    │
          | DST=/dev/mmcblk2                                         |
+
      │                                                                    │
          | QUIET=Yes                                                |
+
      │                                                                    │
          | UDEV=No                                                  |
+
      │─────────────────────────────────────────────────────────────────────│
          | --------------------------------------------------      |
+
      │                    < Yes  >     <  No  >                        │
          +-----------------------------------------------------91%--+
+
      └─────────────────────────────────────────────────────────────────────┘
          |                <Stop Auto Installer>                   |
 
          +----------------------------------------------------------+
 
 
</pre>
 
</pre>
 +
* Confirm installation onto internal media by choosing '''Yes'''
 +
* Installation will start
 
* When installation is complete, the following message will show up:
 
* When installation is complete, the following message will show up:
 
<pre>
 
<pre>
              +-------------------Success----------------------+
+
Finished with success
              | Remove installation media & Press Enter       |
+
─────────────────────────────────────────────────────────────────────────────────────────
              |                                                |
+
 
              |                                                |
+
      ┌─────────────────────────────────────────────────────────────────────┐
              +------------------------------------------------+
+
      │ Boot media has been deployed on /dev/mmcblk2                        │
              |                <Press Enter>                 |
+
       │                                                                    │
              +------------------------------------------------+
+
      │ Would you like to reboot the device now?                            │
 +
      │                                                                    │
 +
      │                                                                    │
 +
      │                                                                    │
 +
      │─────────────────────────────────────────────────────────────────────│
 +
      │                    <  Yes  >      < No  >                         │
 +
      └─────────────────────────────────────────────────────────────────────┘
 
</pre>
 
</pre>
  
* Remove the USB flash drive from the unit
+
{{Note|The Debian Linux release 3.1 requires updating U-Boot to version 2021.04-compulab-1.5 or later}}
* Press '''Enter''' to reboot the unit
+
* Press '''No''' if you want to proceed to [[IOT-GATE-IMX8PLUS_and_SBC-IOT-IMX8PLUS:_U-Boot:_Installation#Running_U-Boot_Firmware_installation| U-Boot installation]]
 +
* Alternatively press '''Yes''' to reboot the device, unplug installation media
 +
 
  
 
[[Category:Linux]]
 
[[Category:Linux]]

Latest revision as of 10:44, 6 March 2024

Overview

This article provides instructions needed to install the Debian Linux live image onto the Compulab IOT-GATE-IMX8PLUS / SBC-IOT-IMX8PLUS internal storage. The recommended installation procedure is using a host PC with a Debian-based operating system.

Preparing Installation Media

Prepare Debian Linux Live Media

Installing Debian images onto the internal storage

  • Insert the USB flash drive into one of the USB ports. It's recommended to use USB3.0 port located on the front panel
  • Power on the device
  • Press a key to prevent a possible autoboot and get into the U-Boot command prompt.
  • Run a command below:
run bsp_bootcmd
Admolition note.png U-Boot 2021.04-compulab-1.5 version or later runs bsp_bootcmd by default
  • Wait for the Linux login prompt
  • Login as compulab user
  • Invoke cl-deploy utility
compulab@compulab-imx8mp:~$ sudo cl-deploy
  • Select /dev/mmcblk2 as a destination device
Select a destination device
─────────────────────────────────────────────────────────────────────────────────────────

       ┌─────────────────────────────────────────────────────────────────────┐
       │  Available Devices:                                                 │
       │ ┌─────────────────────────────────────────────────────────────────┐ │
       │ │                                                                 │ │
       │ │                      (*) /dev/mmcblk2                           │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ └─────────────────────────────────────────────────────────────────┘ │
       │                     <  OK  >        <Cancel>                        │
       └─────────────────────────────────────────────────────────────────────┘
  • The following warning message will show up.
Start Deployment
─────────────────────────────────────────────────────────────────────────────────────────

       ┌──────────────────────────── WARNING ────────────────────────────────┐
       │ Src: /dev/sda -> Dst: /dev/mmcblk2                                  │
       │                                                                     │
       │ All data on /dev/mmcblk2 will be destroyed                          │
       │                                                                     │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                     <  Yes  >      <  No  >                         │
       └─────────────────────────────────────────────────────────────────────┘
  • Confirm installation onto internal media by choosing Yes
  • Installation will start
  • When installation is complete, the following message will show up:
Finished with success
─────────────────────────────────────────────────────────────────────────────────────────

       ┌─────────────────────────────────────────────────────────────────────┐
       │ Boot media has been deployed on /dev/mmcblk2                        │
       │                                                                     │
       │ Would you like to reboot the device now?                            │
       │                                                                     │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                     <  Yes  >      <  No  >                         │
       └─────────────────────────────────────────────────────────────────────┘


Admolition note.png The Debian Linux release 3.1 requires updating U-Boot to version 2021.04-compulab-1.5 or later
  • Press No if you want to proceed to U-Boot installation
  • Alternatively press Yes to reboot the device, unplug installation media