Post Installation Configuration

Note

With Release R36 1.0 (HP 2.1 DP) and later, the filesystem defaults to SSD install. This section can be skipped.

The IGX Orin Developer Kit includes a 500GB solid-state drive (SSD), though this drive is not partitioned or mounted by default. Since a complete installation of Holopack leaves about 40-50GB of storage remaining in the root 64GB, you can optionally configure the SSD as Docker storage to it to avoid filling up the root directory rapidly with Docker image pull operations.

Setting up the SSD Storage

This section outlines the steps to partition and format the drive for use after the initial Holopack installation.

Note

If the developer kit is re-flashed with a new Holopack image, the partition table of the m.2 drive will not be modified and the contents of the partition will be retained. In this case, you can skip the steps described in the Create a Partition section.

However, you should still follow the steps described in the Mount the Partition section to remount the partition.

Create a Partition

Note

This procedure assumes the m.2 drive is identified by the IGX Orin Developer Kit as /dev/nvme0n1. You can check the device name with the following command:

Copy
Copied!
            

$ readlink /dev/disk/by-path/platform-14160000.pcie-pci-0004\:01\:00.0-nvme-1

If this symlink command outputs something other than ../../nvme0n1, replace all instances of nvme0n1 in these instruction with the identifier used by your system.

  1. Create a partition table on the SSD device:

    Copy
    Copied!
                

    sudo parted -a optimal /dev/nvme0n1 mklabel gpt


  2. Create a new primary partition:

    Copy
    Copied!
                

    sudo parted -a optimal /dev/nvme0n1 mkpart primary ext4 0% 100%


  3. Initialize the ext4 filesystem on the new partition:

    Copy
    Copied!
                

    sudo mkfs -t ext4 /dev/nvme0n1p1


Mount the Partition

  1. Create a directory for the mount point. These instructions will use the path /media/m2, but any path can be used.

    Copy
    Copied!
                

    sudo mkdir /media/m2


  2. Determine the UUID of the new partition following output shows that the UUID of the /dev/nvme0n1p1 partition is 7f41ff99-6b67-4e5c-af16-7af409579440:

    Copy
    Copied!
                

    sudo blkid -s UUID -o value /dev/nvme0n1p1 7f41ff99-6b67-4e5c-af16-7af409579440


  3. Add the fstab entry. Using the mount path and the UUID from the previous steps, add the following line to the end of /etc/fstab:

    Copy
    Copied!
                

    *# <file system> <mount point> <type> <options> <dump> <pass>* ... UUID=7f41ff99-6b67-4e5c-af16-7af409579440 /media/m2 ext4 defaults 0 2


  4. Mount the partition. The /etc/fstab entry above will mount the partition automatically at boot time. Use the mount command to mount the partition immediately. Use df to verify the mount.

    Copy
    Copied!
                

    sudo mount -a df -h /dev/nvme0n1p1 Filesystem Size Used Avail Use% Mounted on /dev/nvme0n1p1 458G 73M 435G 1% /media/m2


Setting Up Docker Storage on the SSD

  1. Install Docker and NVIDIA Container Toolkit if they have not been installed on your system.

  2. Create a Docker data directory on the new m.2 SSD partition. This is where Docker will store build cache and container images. These instructions use the path /media/m2/docker-data, but you can use another directory name if preferred.

    Copy
    Copied!
                

    sudo mkdir /media/m2/docker-data


  3. Configure Docker to use the new data root by writing the following to /etc/docker/daemon.json:

    Copy
    Copied!
                

    { "runtimes": { "nvidia": { "path": "/usr/bin/nvidia-container-runtime", "runtimeArgs": [] } }, "default-runtime": "nvidia", "data-root": "/media/m2/docker-data" }


  4. Restart the Docker daemon:

    Copy
    Copied!
                

    sudo systemctl daemon-reload sudo systemctl restart docker


  5. Add the current user to the Docker group so Docker commands can run without sudo.

    Copy
    Copied!
                

    # Create the docker group. sudo groupadd docker # Add your user to the docker group. sudo usermod -aG docker $USER # Activate the changes to groups. Alternatively, reboot or re-login. newgrp docker


  6. Verify that you can run a “hello world” container.

    Copy
    Copied!
                

    docker run hello-world


Before using the HDMI in device of your devkit, you should ensure that it has the latest firmware by first downloading the firmware files from Lontium website.

You will need to register an account and then download the following two files from the NVIDIA section:

  • Lontium_lt6911_flash_update

  • LT6911UXC_1080P_CSI_1Port_RGB_V2_9

  1. First, extract the downloaded files with:

    Copy
    Copied!
                

    unrar e Lontium_lt6911_flash_update.rar unrar e LT6811UXC1080PCSI_1P_RGBV2_9.rar


  2. Next, run the following to power the HDMI in chip and flash it with the firmware file:

    Copy
    Copied!
                

    v4l2-ctl -d /dev/video0 --stream-mmap & sudo ./lontium_lt6911_flash_update 2 0x2b LT6911UXC_1080P_CSI_1Port_RGB_V2_9.bin


Note

If you do not have v4l2-ctl, it can be installed with:

Copy
Copied!
            

sudo apt-get install v4l-utils

© Copyright 2023, NVIDIA. Last updated on Nov 15, 2023.