volume import

参考信息 › 命令行 Shell 参考指南 › Shell 命令 › 卷管理 › volume import

volume import

将卷导入到应用（应用或单例类卷）或导入全局卷。

语法

vol import <name> <image file> [<prop>=<val>]*
                               [--overwrite[--force]][ -n]
vol import <name> local_ip=<local> remote_ip=<remote>
                     migrating_class=<class> encr_key=<key>
                     [ <prop>=<val> ]* [ --overwrite [ --force]] [ -n ]
vol import <name> --abort

参数

<名称>

要导入的卷的名称。名称的格式如下：

application:[class.]volume－应用用户卷或应用单例类卷

_GLOBAL:volume－全局卷

_GLOBAL_RO:volume－全局只读卷

<image file>

/vol/_impex 文件夹根目录下卷映像的名称或者 http://path 格式的 URL。

压缩的映像文件应使用 .gz 扩展名。如果映像文件没有 .gz 扩展名，则认为该映像未经压缩。如果由网格维护人员执行，该卷映像可能在相对于/vol/_impex 文件夹的子目录内驻留。

<local>

将用于本地网格上的迁移程序应用的 IP 信息。该值具有以下格式：

[_vlan.][<vlan id>.]<ip address> |
                                  _net.<network name>.<ip_address>

<remote>

将用于与远程网格上的迁移程序应用通讯的 IP 信息。该值具有以下格式：

[_vlan.][<vlan id>.]<ip address> | _net.<network name>.<ip_address>

<class>

指定用于建立本地迁移程序应用的组件集。此类可来自目录或应用。如果类是“默认”或未指定的 migrating_class，那么“Filer_Linux_ADMI”将用于进行文件系统级别复制。

<volume>

指定包含要提供给迁移应用的固定加密密钥的卷。只有在两个网格之间迁移时，才需要该参数。

<属性>=<值>

卷参数。可以设置以下参数：

*size: 卷大小（从 URL 导入压缩的卷时，建议使用该参数）。可以指定单位（例如，128M[B]、2G[B]）。如果未指定单位，将假定值以 MB 为单位。使用迁移类导入卷时，必须指定此参数。
*fs: 文件系统类型。使用迁移类导入卷时，必须指定此参数。
*fs options: 用于格式化卷的其他文件系统选项（有关具体说明，请参阅下面的注意）。
*store: 指定创建卷所在的卷存储。可能设置为以下值之一：

local－在本地服务器存储上存储卷

san－在 SAN 上存储卷

*comment: （可选）卷注释
*mirrored: （可选）卷已镜像
*user: （可选）从 URL 导入卷时用于身份验证的用户名。如果不指定，则视为不进行身份验证。
*pwd=-: （可选）从 URL 导入卷时提示输入密码以进行身份验证。如果标准输入不是终端设备，则不会打印提示，而只是从“stdin”取得密码的一个副本（这可以用于批处理操作，用来从文件设置密码）。

--abort

中止卷导入操作。此选项只有在使用迁移类导入卷时有效。

--overwrite

覆盖现有卷。

--force

不提示卷覆盖的确认。

-n

如果添加应用单例类卷，则跳过卷引用是否在类描述符中的验证。

注意：

只有网格维护人员才能导入全局只读卷（即 _GLOBAL_RO:<volume>）。
如果指定 --overwrite 选项，现有卷和要导入的卷必须大小相同。
从 URL 导入压缩的卷时，应指定卷大小。如果未指定卷大小，映像需要下载和解压缩两次－一次为获取解压缩大小，一次为传输实际数据。
如果压缩卷映像，建议指定大小参数，这样就不必将映像文件解压缩两次（一次用于确定实际映像的大小，一次用于完成实际的导入操作）。指定卷大小可减少导入卷所花费的时间。
指定迁移类时，AppLogic 组装应用－迁移程序应用－包括指定的迁移类和 VPN 组件。
以下内容描述分区参数的格式：

- parN.size

指定分区 N 的大小。默认值：(disk_size - total_size_of_partitions_with_size_specified)/ number_of_partitions_with_no_size_specified。

- parN.fs

指定分区 N 的文件系统类型。支持与 fs 属性相同的值，还添加了 lvm 和 Extended。如果值为 Extended，该分区的类型为扩展分区并可以容纳逻辑卷，不能为该分区使用 fs、fs_options、vg 或 lv 属性。要为扩展分区定义逻辑分区，请使用 parN 第二级属性。fs=ext3-snapshot 现在已过时，首选方式是使用 fs=lvm。

默认值：raw

- parN.fs_options

当在分区上创建文件系统时要传递给 mkfs 的选项。默认值：none

- parN.parN

如果将分区指定为 fs=Extended，那么此第二级属性可用于在该扩展磁盘分区上创建逻辑分区。任何第二级属性可用作逻辑分区的第三级属性。

示例：par3.fs=Extended par3.par1.fs=ext3。

- parN.vg

使用 fs=lvm 创建分区，此参数可用于指定该 lvm 分区的卷组。如果未指定 vg，将使用随机字符串。

- parN.<lv_name>.size

大小为 [G、M、T] 字节。默认值：(partition_size- total_size_of_logical_volumes_with_size_specified)/ number_of_logical_volumes_with_no_size_specified

- parN.<lv_name>.fs

指定该逻辑卷的文件系统类型。允许使用的值是 Linux Filer 处理的任何文件系统。

- parN.<lv_name>.fs_options

当在逻辑卷上创建文件系统时要传递给 mkfs 的选项。
为 fs_options 参数指定的值是以空格分隔的列表，它特定于文件系统，且仅当与 fs 参数一起使用时才有效。以下是可用于每个受支持的文件系统的选项：

- ext2 | ext3 | ext4 | swap | reiserfs

* <any option>

由 mkfs.<filesystem> 理解的任何选项。这些选项将直接传递给选中文件系统的 mkfs 工具。

- ext3-snapshot

* vol_group_name

指定要在卷上创建的 LVM 卷组名称的字符串。如果未指定，则会随机生成一个卷组名称。

* data_percentage

用于存储数据的卷百分比。剩余部分卷用于快照。如果未指定，则该卷的 80% 用于数据。

* <any option>

由 mkfs.ext3 理解的任何选项。这些选项将直接传递给 mkfs 工具并将用于数据卷。

- ntfs, ntfs03, ntfs08

* volume_label

卷的卷标签。如果为空，则改为使用 vol_name 属性值。

* active

将新分区创建为活动状态（可启动）。有效值为 yes 和 no。如果省略，在执行 format 时使用默认值 no，而在执行 fscopy 时使用 src 卷类型的默认值。

示例

vol import myapp:myvol myvol.img.gz size=1G

导入应用用户卷。

vol import myapp:myclass.cdrom os.iso size=2G

将操作系统 ISO 映像从 impex 卷导入到应用单例类卷中。

vol import _GLOBAL:my-iso http://mysrv.com/os.iso size=2G

将 ISO 映像从不需要身份验证的 HTTP 服务器导入到全局卷中。

vol import myapp:myvol local_ip=1.2.3.4 remote_ip=2.3.4.5 migrating_class=default

启动导入迁移程序应用，以便用于从运行导出迁移程序应用的远程网格导入卷。

vol import myapp:myvol --abort

中止正在使用迁移程序应用的卷导入操作