IBM Cloud Docs
NetApp ONTAP-SAN

NetApp ONTAP-SAN

为 IBM Cloud Satellite® 集群设置 NetApp ONTAP-SAN 存储器。 您可以使用 Satellite 存储模板来创建存储配置。 将存储器配置分配给集群时,所选存储器提供者的存储器驱动程序将安装在集群中。

必须先部署 NetApp Trident 模板(用于安装必需的操作程序),然后才能使用 NetApp NAS 模板来创建存储配置。

在可以将存储器模板部署到您所在位置的集群之前,请确保通过在控制台中选择 对 Satellite Config 启用集群管理访问权 选项或者在创建集群时包含 --enable-config-admin 选项来设置 Satellite 配置。

不能将 Satellite 存储服务的作用域限定为资源组。 但是,如果要将其他资源 (例如,位置和集群) 限定为资源组,那么需要为帐户中的所有资源添加 Satellite 阅读器和链接管理员角色。

NetApp ONTAP-SAN 存储器的先决条件

在将 NetApp ONTAP-SAN 驱动程序部署到 Satellite 集群之前,请查看以下先决条件。

  1. 必须将后端 ONTAP 集群配置为三叉戟后端。

  2. 您必须具有用于三叉戟的专用存储虚拟机 (SVM)。 由三叉戟创建的卷和 LUN 将在此 SVM 中创建。

  3. 必须将一个或多个聚集分配给 SVM。 您可以通过运行 netapp1::> vserver modify -vs <svm_name> -aggr-list <aggregate(s)_to_be_added> 命令来添加聚集。

  4. 对于 SVM,必须有一个或多个 dataLIFs

  5. 必须在 SVM 上启用 iSCSI 服务。

  6. 必须在 SVM 上设置快照策略。

  7. 创建 Satellite 位置

  8. 创建 Satellite 集群

    • 确保在创建集群时选择 对 Satellite 配置 选项启用集群管理访问权。 如果在创建集群时未对 Satellite 配置启用管理员 (admin) 访问权,那么必须重新创建集群并启用管理员访问权,然后才能部署存储器。
    • 您的集群必须满足 ONTAP-SAN 的需求。 有关更多信息,请参阅 NetApp 文档
    • 除了 ONTAP-SAN 的需求外,您的主机还必须满足 Satellite 主机需求
  9. 将 Satellite 添加到集群组

  10. 在集群上设置 Satellite 配置

在控制台中创建和分配配置

  1. 查看 参数参考

  2. 从 "位置" 控制台,选择要在其中创建存储配置的位置。

  3. 选择 存储器 > 创建存储器配置

  4. 输入配置名称。

  5. 选择存储类型

  6. 选择版本并单击下一步

  7. 如果您选择的 存储器类型 接受定制参数,请在 参数 选项卡上输入这些参数。

  8. 如果您选择的 存储器类型 需要私钥,请在 私钥 选项卡上输入私钥。

  9. 存储类 选项卡上,查看配置所部署的存储类或创建定制存储类。

  10. 分配给服务 选项卡上,选择要将配置分配给的服务。

  11. 单击 完成 以分配存储器配置。

在 CLI 中创建配置

  1. 查看要使用的模板版本的 参数参考

  2. 登录到 IBM Cloud CLI。

    ibmcloud login
    
  3. 列出 Satellite 位置并记下 Managed from 列。

    ibmcloud sat location ls
    
  4. 将 Satellite 位置的 Managed from 区域作为目标。 例如,对于 wdc target us-east。 有关更多信息,请参阅 Satellite 区域

    ibmcloud target -r us-east
    
  5. 如果使用除 default 以外的资源组,请将其作为目标。

    ibmcloud target -g <resource-group>
    
  6. 针对要使用的模板版本,复制以下某个示例命令。 有关该命令的更多信息,请参阅 命令参考 中的 ibmcloud sat storage config create

    用于创建 V 22.04 配置的示例命令。

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-san --template-version 22.04 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"
    

    用于创建 V 22.10 配置的示例命令。

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-san --template-version 22.10 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"
    

    用于创建 V 24.02 配置的示例命令。

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-ontap-san --template-version 24.02 --param "managementLIF=MANAGEMENTLIF"  --param "dataLIF=DATALIF"  --param "svm=SVM"  --param "username=USERNAME"  --param "password=PASSWORD"  --param "limitVolumeSize=LIMITVOLUMESIZE"  --param "limitAggregateUsage=LIMITAGGREGATEUSAGE"
    
  7. 根据要使用的设置定制命令。

  8. 运行命令创建配置。

  9. 验证是否已创建配置。

    ibmcloud sat storage config get --config CONFIG
    

在 API 中创建配置

  1. 生成 API 密钥,然后请求刷新令牌。 有关详细信息,请参阅 使用 API 密钥生成IBM CloudIAM 令牌

  2. 查看要使用的模板版本的 参数参考

  3. 复制以下某个示例请求并替换要使用的变量。

    用于创建 V 22.04 配置的示例请求。

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-ontap-san\", \"storage-template-version\": \"22.04\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
    

    用于创建 V 22.10 配置的示例请求。

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-ontap-san\", \"storage-template-version\": \"22.10\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
    

    用于创建 V 24.02 配置的示例请求。

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-ontap-san\", \"storage-template-version\": \"24.02\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"MANAGEMENTLIF\", { \"entry.name\": \"DATALIF\", { \"entry.name\": \"SVM\", { \"entry.name\": \"LIMITVOLUMESIZE\", { \"entry.name\": \"LIMITAGGREGATEUSAGE\",\"user-secret-parameters\": { \"entry.name\": \"USERNAME\",{ \"entry.name\": \"PASSWORD\",}
    

在 CLI 中创建任务

  1. 列出存储配置,并记下要分配给集群的存储配置。

    ibmcloud sat storage config ls
    
  2. 获取要向其分配存储器的集群,集群组或服务的标识。

    要确保集群已向 Satellite 配置注册或要创建组,请参阅 设置集群以与 Satellite 配置配合使用

    用于列出集群组的示例命令。

    ibmcloud sat group ls
    

    用于列出集群的示例命令。

    ibmcloud oc cluster ls --provider satellite
    

    用于列出 Satellite 服务的示例命令。

    ibmcloud sat service ls --location <location>
    
  3. 将存储器配置分配给先前检索的集群,组或服务。 有关更多信息,请参阅 ibmcloud sat storage assignment create 命令

    用于将配置分配给集群组的示例命令。

    ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAME
    

    用于将配置分配给集群的示例命令。

    ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAME
    

    用于将配置分配给服务集群的示例命令。

    ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME
    
  4. 确认任务已创建。

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)
    

在 API 中创建存储器分配

  1. 复制以下某个示例请求。

    用于将 配置分配给集群的示例请求。

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"
    

    请求 将配置分配给集群组的示例。

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}"
    
  2. 将变量替换为详细信息并运行请求。

  3. 通过列出分配来验证是否已创建分配。

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

在控制台中更新存储器分配

您可以使用 Satellite 控制台 对分配应用最新补丁更新。

  1. Satellite 控制台中的“位置”页面,选择您的位置。

  2. 单击 存储器 选项卡以查看配置。

  3. 单击要更新的配置。

  4. 单击信息 信息 (i) 图标以应用最新修订版或补丁。

  5. 可选: 为存储器分配启用自动补丁更新。 启用自动补丁更新可确保分配始终具有最新的安全修订。

如果启用自动补丁更新,那么仍必须手动应用主要更新。

在 CLI 中手动升级分配

升级分配以使用最新的存储器模板修订版。

  1. 列出 Satellite 存储分配,记录要升级的 Satellite 分配。

    ibmcloud sat storage assignment ls
    
  2. 列出 Satellite 存储模板以查看最新的可用版本。

    ibmcloud sat storage template ls
    
  3. 升级 Satellite 分配。

    用于升级分配的示例命令。

    ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT
    

在 CLI 中为配置和分配启用自动补丁更新

您可以使用 sat storage assignment autopatch enable CLI 为分配启用自动补丁更新。 启用自动补丁更新将自动应用最新的存储模板修订 (补丁)。 您仍必须手动应用主要更新。

  1. 列出 Satellite 存储配置。 记下配置 ID。

    ibmcloud sat storage assignment ls
    
  2. 运行以下某个示例命令以对配置及其关联的分配启用自动补丁更新。 输入您在上一步中获取的配置 ID。

    用于对分配启用自动补丁更新的示例命令。

    ibmcloud sat storage assignment autopatch enable --config CONFIG  (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])
    

    用于对给定配置下的所有存储器分配启用自动补丁更新的示例命令。

    ibmcloud sat storage assignment autopatch enable --config CONFIG --all
    

    用于禁用特定配置下所有分配的自动补丁更新的示例命令。

    ibmcloud sat storage assignment autopatch disable --config CONFIG --all
    

    用于禁用单个分配和特定配置的自动补丁更新的示例命令。

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID
    

    用于对多个分配和特定配置禁用自动补丁更新的示例命令。

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID
    

在 API 中升级配置和分配

您可以使用 /v2/storage/satellite/updateAssignment API 通过新的集群或集群组更新分配。 将 updateConfigVersion 设置为 true 以应用修订更新。

  1. 复制以下示例请求,并替换要更新的集群组和分配的变量。

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}"
    
  2. 运行请求。

  3. 获取分配的详细信息以验证更新。

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

在 API 中为分配启用自动补丁更新

您可以使用 /v2/storage/satellite/setAssignmentAutoupgrade API 为分配启用自动补丁更新。 启用自动补丁更新将自动应用最新的存储模板修订 (补丁)。 您仍必须手动应用主要更新。

  1. 复制以下示例请求,并替换要更新的集群组和分配的变量。

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } }
    
  2. 运行请求。

  3. 获取分配的详细信息以验证升级。

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

参数参考

22.04 参数参考

22.22.04参数参考
显示名称 CLI 选项 Type 描述 必需? 缺省值
管理 LIF managementLIF 配置 管理 LIF 的 IP 地址。 不适用
数据 LIF dataLIF 配置 数据 LIF 的 IP 地址。 不适用
SVM svm 配置 SVM 的名称。 不适用
用户名 username 私钥 用于连接到存储设备的用户名。 不适用
用户密码 password 私钥 用于连接到存储设备的密码。 不适用
限制卷大小 limitVolumeSize 配置 可以请求的最大卷大小(以吉比字节为单位)以及 qtree 父卷大小。 50Gi
限制 AggregateUsage limitAggregateUsage 配置 如果使用率大于此百分比,那么供应将失败。 80%

22.10 参数参考

22.22.10参数参考
显示名称 CLI 选项 Type 描述 必需? 缺省值
管理 LIF managementLIF 配置 管理 LIF 的 IP 地址。 不适用
数据 LIF dataLIF 配置 数据 LIF 的 IP 地址。 不适用
SVM svm 配置 SVM 的名称。 不适用
用户名 username 私钥 用于连接到存储设备的用户名。 不适用
用户密码 password 私钥 用于连接到存储设备的密码。 不适用
限制卷大小 limitVolumeSize 配置 可以请求的最大卷大小(以吉比字节为单位)以及 qtree 父卷大小。 50Gi
限制 AggregateUsage limitAggregateUsage 配置 如果使用率大于此百分比,那么供应将失败。 80%

24.02 参数参考

24.24.02参数参考
显示名称 CLI 选项 Type 描述 必需? 缺省值
管理 LIF managementLIF 配置 管理 LIF 的 IP 地址。 不适用
数据 LIF dataLIF 配置 数据 LIF 的 IP 地址。 不适用
SVM svm 配置 SVM 的名称。 不适用
用户名 username 私钥 用于连接到存储设备的用户名。 不适用
用户密码 password 私钥 用于连接到存储设备的密码。 不适用
限制卷大小 limitVolumeSize 配置 可以请求的最大卷大小(以吉比字节为单位)以及 qtree 父卷大小。 50Gi
限制 AggregateUsage limitAggregateUsage 配置 如果使用率大于此百分比,那么供应将失败。 80%

NetApp ONTAP-SAN 的存储类参考

在部署使用 sat-netapp 存储类的应用程序之前,请查看以下说明。

缺省情况下,sat-netapp-file-gold 存储类不包含任何 QoS 限制 (无限 IOPS)。

要使用 sat-netapp-file-silversat-netapp-file-bronze 存储类,必须在存储控制器上创建相应的 silverbronze QoS 策略组,并定义 QoS 限制。 要在存储系统上创建策略组,请登录到系统 CLI 并运行 netapp1::> qos policy-group create -policy-group <policy_group_name> -vserver <svm_name> [-min-throughput <min_IOPS>] -max-throughput <max_IOPS> 命令。

min-throughput 选项仅在全闪存系统上受支持。 有关创建和管理 QoS 策略组的更多信息,请参阅 ONTAP 9 Storage Management 文档

要使用 加密 存储类,必须在存储系统上使用 NetApp ONTAP 板载密钥管理器或受支持 (现成的) 第三方密钥管理器 (例如 IBM 的 TKLM 密钥管理器) 来启用 NetApp 卷加密 (NVE)。 要启用板载密钥管理器,请运行 netapp1::> security key-manager onboard enable 命令。 有关配置加密的更多信息,请参阅 ONTAP 9 Security and Data Encryption 文档

查看 NetApp ONTAP-SAN 的 Satellite 存储类。 您可以使用 oc describe sc <storage-class-name> 命令在命令行中描述存储类。

netapp-ontap-san version 21.04 参数参考
存储类名 Type 文件系统 IOPs 加密 回收策略
sat-netapp-block-gold 缺省值 ONTAP-SAN ext4 没有 QoS 限制。 已禁用加密。 删除(T)
sat-netapp-block-gold-encrypted ONTAP-SAN ext4 没有 QoS 限制。 已启用加密。 删除(T)
sat-netapp-block-silver ONTAP-SAN ext4 用户定义的 QoS 限制。 已禁用加密。 删除(T)
sat-netapp-block-silver-encrypted ONTAP-SAN ext4 用户定义的 QoS 限制。 已启用加密。 删除(T)
sat-netapp-block-bronze ONTAP-SAN ext4 用户定义的 QoS 限制。 已禁用加密。 删除(T)
sat-netapp-block-bronze-encrypted ONTAP-SAN ext4 用户定义的 QoS 限制。 已启用加密。 删除(T)

获取 NetApp ONTAP-SAN 的帮助和支持

如果迂到 NetApp Trident问题,可以访问 NetApp 支持页面