Rebuilding the File System from ubuntu-base and Local Mirror

Steps to rebuild a filesystem from ubuntu-base

1. Install the driveos-oobe-desktop-rfs SDK package to install its manifest file driveos-${FS_VARIANT}*MANIFEST.json.

   $ sudo -E dpkg -i ./nv-driveos-linux-driveos-oobe-desktop-ubuntu-20.04-rfs-*_amd64.deb

   Here, ${FS_VARIANT} is the name of filesystem variant, e.g. oobe-desktop.

   For an example to rebuild driveos-oobe-desktop-rfs, please refer to Example: Steps to rebuild driveos-oobe-desktop-rfs filesystem from ubuntu-base below.
2. Install Canonical ubuntu-base and arm64 Debian SDK packages:

   $ sudo -E dpkg -i ./nv-driveos-linux-ubuntu-20.04-arm64-debians-<release>-<GCID>_<release>-<GCID>_amd64.deb ./nv-driveos-linux-ubuntu-20.04-base-<release>-<GCID>_<release>-<GCID>_amd64.deb

3. Install NVIDIA Mellanox and Docker arm64 Debian packages:

   $ sudo -E dpkg -i ./nv-driveos-linux-mlnx-docker-arm64-debians--<release>-<GCID>_<release>-<GCID>_amd64.deb

4. Copy the NVIDIA CUDA, cuDNN, TensorRT and DriveWorks arm64 Debian packages to $NV_WORKSPACE/drive-linux/filesystem/contents/debians/nvidia/.
5. Import CUDA bits exported variables by sourcing versions using cmd below:

   $ source ${NVWORKSPACE}/drive-linux/filesystem/contents/debians/versions.conf

6. Build the final filesystem starting from ubuntu-base:

   $ sudo -E /opt/nvidia/driveos/common/filesystems/build-fs/17/bin/build_fs.py -w ${NV_WORKSPACE}/ -i ${NV_WORKSPACE}/drive-linux/filesystem/targetfs-images/driveos-${FS_VARIANT}-ubuntu-20.04-rfs.MANIFEST.json -o $PWD/output/

Example: Steps to rebuild driveos-oobe-desktop-rfs filesystem from ubuntu-base

Rebuilding a Filesystem from ubuntu-base Using NVIDIA DRIVE OS Core CopyTarget YAML Manifests

This section provides instructions rebuild the Linux RFS using the DRIVE OS Core CopyTarget YAML manifests from ${NV_WORKSPACE}/drive-linux/filesystem/copytarget/manifest/*.yaml to copy the Core files instead of obtaining them from the NVIDIA DRIVE OS Core Debian packages.

This is useful when you have modified the Core files on your host and want to copy them to the filesystem without rebuilding the NVIDIA DRIVE OS Core Debian packages.

Note: If you instead wish to add additional files to an already available filesystem, follow the instructions in How to Add a Single Debian Package and a Single File to the Linux Filesystem.

1. Install the rfs SDK package to install its manifest file driveos-${FS_VARIANT}*MANIFEST.json.

   $ sudo -E dpkg -i
                 ./nv-driveos-linux-driveos-${FS_VARIANT}-ubuntu-20.04-rfs-*_amd64.deb

   Here, ${FS_VARIANT} is the name of filesystem variant, e.g. oobe-desktop.

   For an example to rebuild driveos-oobe-desktop-rfs, please refer to Example: Rebuilding driveos-oobe-desktop-rfs Filesystem from ubuntu-base Using NVIDIA DRIVE OS Core CopyTarget YAML Manifests below.

2. Install Canonical ubuntu-base and arm64 Debian SDK packages:

   $ sudo -E dpkg -i ./nv-driveos-linux-ubuntu-20.04-arm64-debians-*_amd64.deb
                 ./nv-driveos-linux-ubuntu-20.04-base-*_amd64.deb

3. Install NVIDIA Mellanox and Docker arm64 Debian packages:

   $ sudo -E dpkg -i
             ./nv-driveos-linux-mlnx-docker-arm64-debians-*_amd64.deb

4. Copy the NVIDIA CUDA, cuDNN, TensorRT and DriveWorks arm64 Debian packages to $NV_WORKSPACE/drive-linux/filesystem/contents/debians/nvidia/.

5. Import CUDA bits exported variables by sourcing versions using cmd below:

   $ set -a
   $ source
                 ${NV_WORKSPACE}/drive-linux/filesystem/contents/debians/versions.conf
   $ set +a

6. Update ${NV_WORKSPACE}/drive-linux/filesystem/targetfs-images/driveos-${FS_NAME}-ubuntu-20.04-rfs.MANIFEST.json to remove DRIVE OS Core Debian packages.

   $ sed -i
                 '/nv-driveos-linux-\(aurix\|core\|firmware\|headers\|kernel-modules\|libraries\|oobe\|samples\|security\|tools\).*/d'
                 ${NV_WORKSPACE}/drive-linux/filesystem/targetfs-images/driveos-${FS_VARIANT}-ubuntu-20.04-rfs.MANIFEST.json

7. Update ${NV_WORKSPACE}/drive-linux/filesystem/targetfs-images/driveos-${FS_NAME}-ubuntu-20.04-rfs.MANIFEST.json to use the DRIVE OS Core CopyTarget YAML manifests. You may update the “CopyTarget” key in the Build-FS manifest manually to include the YAML manifests from ${NV_WORKSPACE}/drive-linux/filesystem/copytarget/manifest/*.yaml or use the following singlecommand (note that this is one single command that can be pasted into your bash terminal):

   python3 -B - << END
   import json
   from collections import OrderedDict
   bkConfig = OrderedDict()
   manifest="${NV_WORKSPACE}/drive-linux/filesystem/targetfs-images/driveos-${FS_VARIANT}-ubuntu-20.04-rfs.MANIFEST.json"
   with open(manifest) as f:
       data = f.read()
   bkConfig = json.loads(data, object_pairs_hook=OrderedDict)
   bkConfig["CopyTargets"] = [
       "\${COPYTARGETYAML_DIR}/copytarget-configs.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-aurix.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-aurix.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-firmware.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-headers.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-kernel-modules.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-libraries.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-samples.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-security.yaml",
       "\${COPYTARGETYAML_DIR}/copytarget-tools.yaml"
   ]
   with open(manifest, 'w') as f:
       f.write(json.dumps(bkConfig, indent=4, sort_keys=False))
   END
   

8. Build the final filesystem starting from ubuntu-base:

   $ sudo -E /opt/nvidia/driveos/common/filesystems/build-fs/17/bin/build_fs.py -w ${NV_WORKSPACE}/ -i ${NV_WORKSPACE}/drive-linux/filesystem/targetfs-images/driveos-${FS_VARIANT}-ubuntu-20.04-rfs.MANIFEST.json -o $PWD/output/

Example: Rebuilding driveos-oobe-desktop-rfs Filesystem from ubuntu-base Using NVIDIA DRIVE OS Core CopyTarget YAML Manifests

This section provides an example to rebuild the Linux OOBE Desktop RFS using the DRIVE OS Core CopyTarget YAML manifests from ${NV_WORKSPACE}/drive-linux/filesystem/copytarget/manifest/*.yaml to copy the Core files instead of obtaining them from the NVIDIA DRIVE OS Core Debian packages.

This is useful when you have modified the Core files on your host and want to copy them to the filesystem without rebuilding the NVIDIA DRIVE OS Core Debian packages.