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 集群之前,请查看以下先决条件。
-
必须将后端 ONTAP 集群配置为三叉戟后端。
-
您必须具有用于三叉戟的专用存储虚拟机 (SVM)。 由三叉戟创建的卷和 LUN 将在此 SVM 中创建。
-
必须将一个或多个聚集分配给 SVM。 您可以通过运行
netapp1::> vserver modify -vs <svm_name> -aggr-list <aggregate(s)_to_be_added>
命令来添加聚集。 -
对于 SVM,必须有一个或多个
dataLIFs
。 -
必须在 SVM 上启用 iSCSI 服务。
-
必须在 SVM 上设置快照策略。
-
- 确保在创建集群时选择 对 Satellite 配置 选项启用集群管理访问权。 如果在创建集群时未对 Satellite 配置启用管理员 (admin) 访问权,那么必须重新创建集群并启用管理员访问权,然后才能部署存储器。
- 您的集群必须满足 ONTAP-SAN 的需求。 有关更多信息,请参阅 NetApp 文档。
- 除了 ONTAP-SAN 的需求外,您的主机还必须满足 Satellite 主机需求。
在控制台中创建和分配配置
-
查看 参数参考。
-
从 "位置" 控制台,选择要在其中创建存储配置的位置。
-
选择 存储器 > 创建存储器配置
-
输入配置名称。
-
选择存储类型。
-
选择版本并单击下一步
-
如果您选择的 存储器类型 接受定制参数,请在 参数 选项卡上输入这些参数。
-
如果您选择的 存储器类型 需要私钥,请在 私钥 选项卡上输入私钥。
-
在 存储类 选项卡上,查看配置所部署的存储类或创建定制存储类。
-
在 分配给服务 选项卡上,选择要将配置分配给的服务。
-
单击 完成 以分配存储器配置。
在 CLI 中创建配置
-
查看要使用的模板版本的 参数参考。
-
登录到 IBM Cloud CLI。
ibmcloud login
-
列出 Satellite 位置并记下
Managed from
列。ibmcloud sat location ls
-
将 Satellite 位置的
Managed from
区域作为目标。 例如,对于wdc
targetus-east
。 有关更多信息,请参阅 Satellite 区域。ibmcloud target -r us-east
-
如果使用除
default
以外的资源组,请将其作为目标。ibmcloud target -g <resource-group>
-
针对要使用的模板版本,复制以下某个示例命令。 有关该命令的更多信息,请参阅 命令参考 中的
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"
-
根据要使用的设置定制命令。
-
运行命令创建配置。
-
验证是否已创建配置。
ibmcloud sat storage config get --config CONFIG
在 API 中创建配置
-
生成 API 密钥,然后请求刷新令牌。 有关详细信息,请参阅 使用 API 密钥生成IBM CloudIAM 令牌。
-
查看要使用的模板版本的 参数参考。
-
复制以下某个示例请求并替换要使用的变量。
用于创建 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 中创建任务
-
列出存储配置,并记下要分配给集群的存储配置。
ibmcloud sat storage config ls
-
获取要向其分配存储器的集群,集群组或服务的标识。
要确保集群已向 Satellite 配置注册或要创建组,请参阅 设置集群以与 Satellite 配置配合使用。
用于列出集群组的示例命令。
ibmcloud sat group ls
用于列出集群的示例命令。
ibmcloud oc cluster ls --provider satellite
用于列出 Satellite 服务的示例命令。
ibmcloud sat service ls --location <location>
-
将存储器配置分配给先前检索的集群,组或服务。 有关更多信息,请参阅
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
-
确认任务已创建。
ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)
在 API 中创建存储器分配
-
复制以下某个示例请求。
用于将 配置分配给集群的示例请求。
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\"}"
-
将变量替换为详细信息并运行请求。
-
通过列出分配来验证是否已创建分配。
curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
在控制台中更新存储器分配
您可以使用 Satellite 控制台 对分配应用最新补丁更新。
-
从 Satellite 控制台中的“位置”页面,选择您的位置。
-
单击 存储器 选项卡以查看配置。
-
单击要更新的配置。
-
单击信息 信息 (i) 图标以应用最新修订版或补丁。
-
可选: 为存储器分配启用自动补丁更新。 启用自动补丁更新可确保分配始终具有最新的安全修订。
如果启用自动补丁更新,那么仍必须手动应用主要更新。
在 CLI 中手动升级分配
升级分配以使用最新的存储器模板修订版。
-
列出 Satellite 存储分配,记录要升级的 Satellite 分配。
ibmcloud sat storage assignment ls
-
列出 Satellite 存储模板以查看最新的可用版本。
ibmcloud sat storage template ls
-
升级 Satellite 分配。
用于升级分配的示例命令。
ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT
在 CLI 中为配置和分配启用自动补丁更新
您可以使用 sat storage assignment autopatch enable
CLI 为分配启用自动补丁更新。 启用自动补丁更新将自动应用最新的存储模板修订 (补丁)。 您仍必须手动应用主要更新。
-
列出 Satellite 存储配置。 记下配置 ID。
ibmcloud sat storage assignment ls
-
运行以下某个示例命令以对配置及其关联的分配启用自动补丁更新。 输入您在上一步中获取的配置 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
以应用修订更新。
-
复制以下示例请求,并替换要更新的集群组和分配的变量。
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\"}"
-
运行请求。
-
获取分配的详细信息以验证更新。
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 为分配启用自动补丁更新。 启用自动补丁更新将自动应用最新的存储模板修订 (补丁)。 您仍必须手动应用主要更新。
-
复制以下示例请求,并替换要更新的集群组和分配的变量。
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", ...], } }
-
运行请求。
-
获取分配的详细信息以验证升级。
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 参数参考
显示名称 | CLI 选项 | Type | 描述 | 必需? | 缺省值 |
---|---|---|---|---|---|
管理 LIF | managementLIF |
配置 | 管理 LIF 的 IP 地址。 | 是 | 不适用 |
数据 LIF | dataLIF |
配置 | 数据 LIF 的 IP 地址。 | 是 | 不适用 |
SVM | svm |
配置 | SVM 的名称。 | 是 | 不适用 |
用户名 | username |
私钥 | 用于连接到存储设备的用户名。 | 是 | 不适用 |
用户密码 | password |
私钥 | 用于连接到存储设备的密码。 | 是 | 不适用 |
限制卷大小 | limitVolumeSize |
配置 | 可以请求的最大卷大小(以吉比字节为单位)以及 qtree 父卷大小。 | 是 | 50Gi |
限制 AggregateUsage | limitAggregateUsage |
配置 | 如果使用率大于此百分比,那么供应将失败。 | 是 | 80% |
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 参数参考
显示名称 | 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-silver
和 sat-netapp-file-bronze
存储类,必须在存储控制器上创建相应的 silver
和 bronze
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>
命令在命令行中描述存储类。
存储类名 | 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 支持页面。