使用命令行安装#

SDK 管理器支持在纯无图形环境（Docker、PuTTY、Ubuntu Server 等）中运行命令行安装。不再需要任何图形环境即可通过命令行进行安装。

要从 Linux 中的终端运行 NVIDIA SDK 管理器，请执行以下操作

  1. 在您的主机上下载并运行 SDK 管理器。

  2. 从终端启动 SDK 管理器，使用以下参数从命令行运行安装。

通用参数#

参数

描述

 
-h, --help

显示此使用指南。

 
--ver

输出已安装的 SDK 管理器客户端的版本。

 
--query interactive | non-interactive

可选。打印用户可用的所有选项。

  • interactive – 通过询问会话流程获取安装命令。

  • non-interactive – 打印用户可用的所有选项。

默认值为 non-interactive。

示例

--query interactive --logintype devzone

--query non-interactive --product Jetson

--query --non-interactive --product DOCA --version 2.2.0

--query --non-interactive --product Switch --action uninstall

--show-all-versions

打印用户可用的所有产品版本。如果未设置，SDK 管理器将仅列出主要产品版本。

 
--export-logs [folder_path]

在安装/卸载会话完成后，将日志文件导出到 folder_path。如果未设置 folder_path，日志将导出到下载文件夹。

 
--exit-on-finish

在安装/卸载会话完成后自动退出 SDK 管理器，无需用户输入。适用于脚本/自动化用法。

 
--user user_email

设置用于登录的用户电子邮件。仅对拥有 partners.nvidia.com 帐户的 NVONLINE 用户有效。

 
--password string

设置用户登录密码。仅对拥有 partners.nvidia.com 帐户的 NVONLINE 用户有效。

 
--login-type devzone | nvonline | offline

设置登录服务器 (devzone 或 nvonline)。

默认值为 devzone。

offline 选项应与 --download-folder 一起使用。如果未设置 --download-folder，SDK 管理器将从默认下载文件夹加载产品信息。示例

--login-type offline --download-folder /my-mounted-drive/Shared/nvidia/sdk-manager-download-folder

--stay-logged-in true | false

保持用户帐户在下次运行会话中处于登录状态。默认值为 true。运行 --stay-logged-in false 以禁用此选项。

 
--logout

从 SDK 管理器注销用户帐户。

 
--download-folder folder_path

此选项允许您设置下载文件的文件夹路径。

示例

--download-folder /my-mounted-drive/Shared/nvidia/sdk-manager

如果未设置 --download-folder，SDK 管理器将使用默认文件夹：${HOME}/Downloads/nvidia/sdkm_downloads。

 
--archived-versions

使用此选项仅显示未在标准运行中显示的存档 SDK 版本。

 
--cli

启用 SDK 管理器在 CLI 模式下运行。如果您想在无人值守模式下运行它，您将需要提供更多定义为可选的参数。您也可以使用 --response-file 选项来提供运行无人值守所需的所有参数。

 
--action install | uninstall |
downloadonly

这允许 SDK 管理器在会话中运行安装、卸载或下载操作。此选项应与下表“附加参数”中的其他选项一起使用。

 
--settings

在终端中配置 SDK 管理器设置。这支持配置 SDK 管理器设置 UI 中的参数，例如代理设置、并发下载和隐私设置。

 
--sudo-password string

设置 sudo 密码以跳过身份验证提示。

请注意，密码以明文形式显示，并在终端窗口中可见。

 
--collect-usage-data enable | disable

启用或禁用使用情况数据的收集，并将其发送到 SDK 管理器服务器。

 
--check-for-updates

检查 SDK 管理器客户端的更新。默认值为 true。

运行 --check-for-updates false 以禁用此选项。

 
--list-connected all | Jetson | DOCA |
Holoscan

列出连接设备的信息。默认值为 all。这也支持仅列出特定产品的相关设备。

 
--extra-configs

使用额外的配置来覆盖安装/卸载的软件和硬件数据。

这可以用于支持第三方载板、自定义软件包等的安装。

安装/卸载的附加参数#

参数

描述

 
--product DRIVE | Jetson | Holoscan | DOCA | Switch | ARC-OTA

设置要在命令行模式下安装的产品。

 
--version string

设置产品版本。--version 的值可以是产品版本、版本、目标类型和内部版本号的组合，以“_”分隔。使用 cli 或 --query 获取可用的版本值。

DRIVE 示例

--version 6.0.6

Jetson 示例

--version 6.1

Holoscan 示例

--version IGPU_1.2

DOCA 示例

--version 2.2.0

以太网交换机示例

--version 4.7.11

ARC-OTA 示例

--version A1.5

RAPIDS 示例

--version 24.08

--target-os string

设置目标硬件操作系统。

示例

--target-os Linux

--host

设置此参数后，将选择主机组件。

 
--target target_id

使用此参数选择特定的目标硬件。

DRIVE 示例

--target DRIVE_AGX_ORIN_DEVKITS

Jetson 示例

--target JETSON_AGX_ORIN_TARGETS

Holoscan 示例

--target CLARA_AGX_DEVKIT_TARGETS

DOCA 示例

--target BLUEFIELD3_DPU_TARGETS

以太网交换机 示例

--target SWITCH_5XXX_TARGETS

ARC-OTA 示例

--target GNB_TARGETS

--flash all | a | b | ab | skip

可选地设置是否刷写目标设备。如果未设置此选项，SDK 管理器将跳过刷写。

 
--usb-port usb_port_id

如果连接了多个板卡，请选择 USB 端口。usb_port_id 可以从 --list-connected 命令中检索。

Jetson 示例：--usb-port 1-2.4

 
--serial-port serial_port_name

如果连接了多个串行设备，请选择串行端口名称。

ARC 示例：--serial-port /dev/ttyUSB1

 
--additional-sdk additional_sdk_title

指定要安装的其他 SDK。允许多个条目。

可用的 additional_sdk_title 可以从 --cli 命令中检索。

 
--select section_title | group_title

选择安装列表中的指定部分或组。允许多个条目。

可用的 section_title 和 group_title 可以从 --cli 命令中检索。

 
--deselect section_title | group_title

从安装列表中取消选择指定的部分或组。允许多个条目。

可用的 section_title 和 group_title 可以从 --cli 命令中检索。

 
--licenses accept | reject

设置此选项以接受 NVIDIA 软件许可的条款和条件。

如果未设置此选项，SDK 管理器将提示您查看并确认许可页面。

 
--target-image-folder folder_path

此选项允许您设置刷写的目标硬件映像的主机位置。

如果未设置此文件夹，SDK 管理器将使用默认文件夹：${HOME}/nvidia/nvidia_sdk/

 
--export-response-file folder_path

根据用户的选择创建响应文件，并在会话成功完成之前将响应文件导出到 folder_path。如果未设置 folder_path，则将在下载文件夹下创建响应文件。主机 sudo 密码不会保存到响应文件中。您可以手动将其添加到响应文件中，或使用 --sudo-password 命令行选项跳过 sudo 提示符。

 
--auto

此选项使用默认值自动完成所有提示。

这只能在 --cli 模式下使用。

运行交互式命令行#

您现在只需使用 --cli 选项运行 SDK 管理器，即可完成特定 SDK 的完整安装和卸载流程。此选项提供有关如何通过交互式查询进行所需操作或选择的说明，然后根据您的选择结果执行完整的命令行。

$ sdkmanager --cli

  1. 首先，系统会要求您从可用选项中选择登录类型以完成登录。

    ../_images/cli-interactive-login-type.png

    请参阅登录 NVIDIA 服务器以完成登录后再继续。

  2. 登录 NVIDIA 服务器后，系统会询问您一系列交互式查询，以确认安装特定产品 SDK 所需的安装选项。

    ../_images/cli-interactive-queries.png

    注意

    在您最终确认所有选择之前，您可以按 <ESC> 键一直返回到此部分，以重新选择特定查询。

  3. 确认安装选项后，SDK 管理器将打印要运行的完整命令行。您可以单击 <Enter> 开始安装，或单击空格键停止计时器，以安装 SDK 或退出 SDK 管理器。

    ../_images/cli-interactive-full-command.png

  4. 请参阅查看许可并选择组件以完成安装会话的其余步骤。

查询可用命令行#

注意

本节介绍如何使用 --query 命令创建由 SDK 管理器执行的命令行。请参阅运行交互式命令行以了解完整的安装流程。

  1. 运行带有以下选项的 SDK 管理器，以打印用户可用的所有选项。对于来自 developer.nvidia.com 的用户

    $ sdkmanager --query non-interactive --login-type devzone

    注意

    请参阅登录 NVIDIA 服务器以在继续之前完成您的 NVIDIA 开发者登录。

对于来自 partners.nvidia.com 的用户

$ sdkmanager --query --user john.doe@example.com --login-type nvonline

这将输出您的用户帐户所有可用 SDK 的完整命令选项列表。

  1. 您还可以运行交互式查询，以从一组询问步骤中打印可用选项。对于来自 developer.nvidia.com 的用户

$ sdkmanager --query interactive --login-type devzone
../_images/cli-queries.png

对于来自 partners.nvidia.com 的用户

$ sdkmanager --query interactive --user john.doe@example.com --login-type nvonline

  1. 请参阅通用参数和安装/卸载的附加参数中的语法参数，然后使用您自己的自定义命令运行 SDK 管理器。

登录 NVIDIA 服务器#

您可以使用以下任何选项登录 NVIDIA 服务器

  • 交互式命令行

  • 使用 --login-type [server] 运行命令

    为您的帐户类型和安装选择适当的登录服务器。

../_images/cli-interactive-login-devzone.png

有两种方法可以登录 NVIDIA 开发者服务器。

  1. 浏览器登录选项:

  • 从浏览器打开生成的 URL。浏览器可以在与 SDK 管理器应用程序相同或不同的主机上运行。

  • 在浏览器中，单击提交以确认设备登录。

  • 输入您的电子邮件地址，然后单击继续。

  • 在 SDK 管理器登录页面上，输入您的 NVIDIA 开发者帐户凭据，然后单击登录。

  • 完成后，SDK 管理器将启动。

  1. QR 码登录选项:

  • 当出现 QR 码图像时，通过不同设备上的相机应用程序扫描代码。

  • 在该设备上输入您的 NVIDIA 开发者帐户凭据。

  • 完成后，SDK 管理器将启动。

  • NVONLINE - partners.nvidia.com

    ../_images/cli-interactive-login-nvonline.png

    输入您的 NVONLINE 帐户凭据，然后单击登录。

  • 离线 - 安装先前已下载并可从本地文件夹或挂载驱动器访问的 SDK。有关更多信息，请参阅离线安装。

注意

SDK 管理器将使您保持当前用户帐户的登录状态，以便您无需第二次登录。要从当前帐户注销，请使用 --logout 选项。

查看许可并选择组件#

  1. 要查看许可，您可以使用箭头键或鼠标上下滚动内容。

  2. 要确认您的答案，请使用 Tab 键在是或否选项之间切换，然后按 Enter 键。您也可以使用鼠标单击来确认选项。

  3. 您必须逐个查看并接受所有许可才能继续下一步。如果您想绕过许可查看，请使用以下命令选项运行

    --license accept
    ../_images/cli-interactive-licenses-review.png

  4. 在组件选择屏幕中，SDK 管理器允许您选择要安装的部分或组。

    ../_images/cli-interactive-select-options.png

    您可以使用以下键列表进行选择

    键

    描述

    Enter

    开始安装

    Tab

    切换窗口焦点

    上/下

    更改选定项目

    左/右

    展开/折叠选定项目

    空格

    选中/取消选中选定项目

安装#

  1. 在安装开始之前，SDK 管理器会提示您输入 sudo 密码。

    ../_images/cli-sudo-prompt.01.png

  2. 显示屏显示软件下载和安装的进度。

    ../_images/cli-install-progress.01.png

  3. 您可以在安装面板和终端面板之间切换。终端面板显示有关下载和安装的详细信息，并突出显示任何错误。

响应文件#

您可以使用响应文件在自动化和无人值守会话中运行 SDK 管理器。这将自动为您的命令行安装设置命令行选项和参数。

示例可以在以下位置找到

  • Jetson 用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_jetson.ini

  • 以太网交换机用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_ethernet_switch.ini

  • ARC-OTA 用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_arc.ini

  • Holoscan 用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_holoscan.ini

  • RAPIDS 用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_rapids.ini

  • DOCA 用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_doca.ini

  • DRIVE 用户（在此处下载）

    /opt/nvidia/sdkmanager/sdkm_responsefile_sample_drive.ini
../_images/cli-response-file.2.png

要使用响应文件运行 SDK 管理器，请执行以下操作

  1. 将示例文件复制到您选择的位置，并启用编辑。

  2. 根据需要编辑参数和值。

  3. 使用 --responsefile 选项运行 SDK 管理器。例如

    $ sdkmanager --cli install --responsefile <response_file_path>

示例#

../_images/cli-example.01.png

例如，Jetson 6.0（包括 DeepStream、Rivermax 和 Holoscan 作为附加 SDK）示例将是

sdkmanager --cli --action install --login-type devzone --product Jetson --target-os Linux --version 6.0 --show-all-versions --host --target JETSON_AGX_ORIN_TARGETS --additional-sdk 'Holoscan 2.5' --additional-sdk 'DeepStream 7.0' --additional-sdk 'Rivermax 1.41' --flash

对于以太网交换机 4.7.11 示例，请使用以下命令

sdkmanager --cli --action install --login-type devzone --product 'Ethernet Switch' --target-os Linux --version 4.7.11 --host --target SWITCH_5XXX_TARGETS --flash

对于 ARC-OTA 1.5 示例（包括 AI 框架），请使用以下命令

sdkmanager --cli --action install --login-type devzone --product ARC-OTA --target-os Linux --version A1.5 --target SUPERMICRO_GH_MGX_TARGET --additional-sdk 'AI Frameworks 24.1'

对于 RAPIDS 24.08 示例，请使用以下命令

sdkmanager --cli --action install --login-type devzone --product 'Data Science' --target-os Linux --version 24.08 --host

对于 HoloPack 1.2 示例，请使用以下命令

sdkmanager --cli --action install --login-type devzone --product Holoscan --target-os Linux --version IGPU_1.2 --show-all-versions --host --target CLARA_AGX_DEVKIT_TARGETS --flash

对于 DOCA 2.2.0 示例，请使用以下命令

sdkmanager --cli --action install --login-type devzone --product DOCA --target-os Linux --version 2.2.0 --host --target BLUEFIELD3_DPU_TARGETS --additional-sdk 'Rivermax 1.31' --select 'BlueField OS' --select 'DOCA Software Package' --deselect 'Development Container on Host' --deselect 'Development Container on Target' --flash

要通过命令行安装 DRIVE OS 6.0.6 Linux，请使用以下命令

sdkmanager --cli --action install --login-type devzone --product DRIVE --target-os Linux --version 6.0.6 --host --target DRIVE_AGX_ORIN_DEVKITS --select 'DRIVE OS Linux (custom GDM Desktop)' --flash
在本页中