导入引导映像

IBM Power Virtual Server 于 IBM 数据中心

IBM Power Virtual Server私有云于客户所在地

您可以使用 IBM® Power® Virtual Server CLI 或控制台来导入定制引导映像。所有数据中心都使用 层 0，层 1，层 3 和 固定 IOP 存储类型。创建卷后，无法更改存储类型。虚拟机 (VM) 可以拥有多种存储类型的磁盘。大型引导映像需要时间才能成功导入。您在接收确认消息时可能会迂到延迟。

图像导入需要基于散列的消息验证码 (HMAC) 密钥（访问、密文），才能访问您的 IBM Cloud Object Storage 存储桶。要生成 HMAC 密钥，请参阅使用 IBM COS HMAC 凭据。

IBM® Power® Virtual Server 作业功能在云帐户的多个工作空间中跟踪长时间运行的异步操作，例如 VM 捕获，映像导出和映像导入。

作为此作业功能的一部分，提供了以下 API 和 CLI:

用于映像导入的 API- 从已存储在 IBM COS 中的可用映像创建新映像。
CLI 命令- ibmcloud pi image import。
CLI 命令 ibmcloud pi jobs。

Power Virtual Server VM 捕获，映像导出和映像导入功能限制为每个 Power Virtual Server 工作空间一次只能执行一项操作。如果成功提交其中一个操作，那么在完成先前的操作之前，无法提交另一个新操作 (VM 捕获，映像导出和映像导入)。

使用 Power Virtual Server API 导入引导映像

要导入启动映像，可以使用从存储在 IBM COS 中的可用映像创建新映像主题中列出的 API。

要导入自定义的 SAP HANA 或 SAP NetWeaver 映像，请指定以下映像详细信息：

      "importDetails":{
         "licenseType":"byol",
   "product":"Hana",
         "vendor":"SAP"
      }

使用 Power Virtual Server CLI 导入引导映像

完成以下步骤以使用 Power Virtual Server CLI 导入引导映像。有关详细信息，请参阅 Power Virtual Server CLI 参考。

要从 IBM Cloud Object Storage 导入自定义映像，请使用 ibmcloud pi image-import 命令。
使用 ibmcloud pi images 命令查找新导入的映像。
```
shell
ibmcloud pi images [--long] [--json]
```
要导入自定义的 SAP HANA 或 SAP NetWeaver 映像，请使用 -d, --import-details strings 命令。

使用 Power Virtual Server 用户界面来导入引导映像

完成以下步骤以使用 Power Virtual Server 用户界面导入引导映像。

图像文件名 字段支持以下格式: .ova，.ova.gz，.tar，.tar.gz 和 .tgz。

单击 引导映像，然后单击 导入映像。

如果要导入定制的 SAP HANA 或 SAP NetWeaver 映像，那么必须选中自我认证复选框。
单击“导入图像”后，输入所有必要信息。请参阅页面末尾的表，以完成导入引导映像所需的字段。

选择 使用校验和文件验证导入切换按钮，根据校验和文件验证导入文件。您可以在将映像文件导出到 IBM Cloud Object Storage 存储桶时生成校验和文件。校验和文件和导入图像必须放在同一个文件桶中。校验和文件名基于导入的图像文件名，文件扩展名为 .sha256。有关生成校验和文件的详细信息，请参阅使用 Power Virtual Server 用户界面捕获和导出虚拟机。

如果您要创建自己的图像，可以创建一个校验和图像，并将其与您自己的图像放在同一个存储桶中。生成校验和图像的方法之一是使用 shasum -a 256 <filename> 或 sha256sum <filename> 命令。

根据校验和文件验证导入文件可能会增加图像导入过程的时间。
在 引导映像中查找新上载的引导映像。
返回到 虚拟服务器实例，并供应新的 Power Virtual Server 虚拟服务实例。单击相应引导映像磁贴中的箭头以查看定制引导映像。

启动图像选项
字段	描述
目录映像名称	输入您希望导入的映像显示在映像名称目录中的名称。
存储类型	选择是要 Tier 1 (基于 NVMe 的 Flash Storage) 还是 Tier 3 (SSD Flash Storage) 作为存储类型。 VM 不能同时具有来自 Tier 1 和 Tier 3 存储类型的磁盘。
存储池	根据您选择的存储池放置选项 (自动选择，亲缘关系或反亲缘关系)，将一个或多个定制映像存储卷放置在存储池中。使用此映像部署的任何 VM 的引导卷将部署在同一存储池中。有关存储卷的更多信息，请参阅添加和管理存储卷。
自动选择池	选择此选项以在具有足够容量的池中自动创建存储卷。
亲缘关系	使用此选项可根据帐户中的现有 PVM 实例 (VM) 或存储卷来标识必须用于放置引导卷的存储池。定制映像存储卷放置在亲缘关系对象所在的同一存储池中。如果使用 PVM 实例作为亲缘关系对象，那么选择用于放置引导卷的存储池将基于 PVM 实例的根 (引导) 卷。
反亲缘关系	使用此选项可根据帐户中的一个或多个现有 PVM 实例 (VM) 或存储卷来标识要从选择中排除以放置引导卷的一个或多个存储池。选择存储池以创建定制映像存储卷时，将选择反亲缘关系对象列表所在的存储池。如果使用 PVM 实例作为反亲缘关系对象，那么将根据您指定的每个 PVM 实例的根 (引导) 卷来排除存储池。
源详细信息 (云存储器)	使用以下字段来设置云存储器详细信息。
区域	针对区域选择 us-east，us-south，ca-tor，eu-de，eu-es，eu-gb，au-syd，jp-tok 和 jp-osa。
图像文件名	输入图像的文件名。图像文件名不得包含空格。支持的文件格式为 `tar` 和 `ova`。您可以使用 `gzip` 来压缩图像文件。受支持的文件扩展名为 `.ova`，`.ova.gz`，`.tar`，`.tar.gz` 和 `.tgz`。您必须使用专用端点域。例如，`Aix_7200-03-02-1846_cldrdy_112018.gz`。
存储区名称	可以使用子文件夹并将其指定为 `bucketName/optional/folders`。如果可选文件夹不存在，那么将自动创建这些文件夹。要标识存储区名称，请选择 “菜单”图标 !["菜单" 图标](../icons/icon_hamburger.svg ""菜单" 图标") > 资源列表> 存储器> Cloud Object Storage 名称> 存储区。
Cloud Object Storage 访问密钥	要标识访问密钥，请选择 “菜单”图标 !["菜单" 图标](../icons/icon_hamburger.svg ""菜单" 图标") > 资源列表> 存储器> Cloud Object Storage 名称> 服务凭证> 查看凭证。复制 `access_key_id` 值并将其粘贴到此字段中。
Cloud Object Storage 私钥	要标识密钥，请选择 “菜单”图标 !["菜单" 图标](../icons/icon_hamburger.svg ""菜单" 图标") > 资源列表> 存储器> Cloud Object Storage 名称> 服务凭证> 查看凭证。复制 `secret_access_key` 值并将其粘贴到此字段中。

如果您希望稍后下载映像，请转至 IBM Cloud 仪表板用户界面中的 资源列表，并访问 Cloud Object Storage 工作空间。在存储图像的存储桶中，选择要下载的图像文件，然后选择下载对象。有关 Cloud Object Storage CLI 命令的更多信息，请参阅下载对象。