「vgconvert(8)」-

更改VG元数据格式

命令语法格式

vgconvert position_args [ option_args ]

vgconvert VG …
[ -f|–force ]

[ -M|–metadatatype lvm2|lvm1 ]

[ –labelsector Number ]

[ –bootloaderareasize Size[m|UNIT] ]

[ –pvmetadatacopies 0|1|2 ]

[ –metadatasize Size[m|UNIT] ]

[ –reportformat basic|json ]

[ COMMON_OPTIONS ]

命令描述

命令vgconvert将VG元数据从一种格式转换为另一种格式。 新的元数据格式必须能够放入旧格式提供的空间。

由于不再使用LVM1格式,因此通常不再需要此命令。

命令支持的选项及含义

–bootloaderareasize Size[m|UNIT]
除PV的数据区域外,创建一个指定大小的单独引导加载程序区域。 引导加载程序区域是PV上的保留空间区域,LVM不会从该区域分配任何PE,并且保持不变。 这主要是为了与引导加载程序一起使用来嵌入自己的数据或元数据。 引导加载程序区域的起始始终是对齐的,另请参阅–dataalignment和–dataalignmentoffset选项。 引导加载程序区域大小最终可能会因对齐而最终增加,但它永远不会小于请求的大小。 要查看引导加载程序区域的开始和现有PV的大小,请使用pvs -o +pv_ba_start,pv_ba_size命令。

-f|–force …
覆盖各种检查,确认和保护。

使用时要格外小心。

–labelsector Number
默认情况下,PV在其第二个扇区(sector 1)中标有LVM2标识符。 这使您可以在磁盘起点附近使用不同的扇区(介于0和3之间 – 请参阅源中的LABEL_SCAN_SECTORS)。

小心使用。

–metadatasize Size[m|UNIT]
每个VG元数据区域使用的大致空间量。参数Size可能被四舍五入。

-M|–metadatatype lvm2|lvm1
指定要使用的磁盘上元数据的类型。 lvm2(或只是2)是当前的标准格式。 lvm1(或只是1)是一种可用于访问旧数据的历史格式。

–pvmetadatacopies 0|1|2
在PV上用于”存储VG元数据“的元数据区域的数量。 当2时,VG元数据的一个副本存储在PV的前面,而第二个副本存储在最后。 当1时,VG元数据的一个副本存储在PV的前面(从第5个扇区开始)。 为0时,不会在给定PV上存储VG元数据的副本。 这在包含许多PV的VG中可能很有用(这限制了以后使用vgsplit的能力。)

–reportformat basic|json
覆盖报告的当前输出格式,该格式由lvm.conf中的report/output_format设置全局定义。 basic是包含列和行的原始格式。 如果每个命令有多个报告,则每个报告都以报告名称为前缀进行标识。 json以JSON格式生成报告输出。 有关更多信息,请参阅lvmreport(7)。

用于lvm的公共选项

-y|–yes
不要以交互方式提示确认,但总是假设答案是肯定的。 使用时要格外小心。 (对于自动no,请参阅-qq。)

-v|–verbose …
设置详细级别。 重复1到4次以增加发送到标准输出和标准错误的消息的详细信息。

-t|–test
在测试模式下运行。 命令不会更新元数据。 这是通过禁用所有元数据写入,但仍然将成功返回到调用函数来实现的。 如果工具依赖于读回它认为已更改但尚未更改的元数据,则可能会在多阶段操作中导致异常错误消息。

-q|–quiet …
抑制输出和日志消息。 覆盖–debug和–verbose。 重复一次也可以通过回答“no”来抑制任何提示。

-h|–help
显示帮助信息。

-d|–debug …
设置调试级别。 重复1到6次以增加发送到日志文件和/或syslog(如果已配置)的消息的详细信息。

–version
显示版本信息并退出。

–profile String
选项–commandprofile或–metadataprofile的别名,具体取决于命令。

–longhelp
显示长帮助文本。

–driverloaded y|n
如果设置为no,则该命令不会尝试使用device-mapper。 用于测试和调试。

–config String
配置命令的设置。 这些覆盖lvm.conf设置。参数String使用与lvm.conf相同的格式,或者可以使用section/field语法。 有关config的更多信息,请参阅lvm.conf(5)。

–commandprofile String
用于命令配置的命令配置文件。 有关配置文件的更多信息,请参阅lvm.conf(5)。

命令行参数

VG
VG的名称。关于有效的VG名参考lvm(8)手册。

String
有关String的内容的信息,请参阅选项说明。

Size[UNIT]
参数Size是接受可选单位UNIT的输入数字。 无论大小写如何,输入单位UNIT始终被视为基数两个值,例如 ‘k’和’K’都指1024。默认输入单位由字母指定,后跟|UNIT。

参数UNIT代表其他可能的输入单位:bBsSkKmMgGtTpPeE。 b|B是字节,s|S是512字节的扇区,k|K是千字节,m|M是兆字节,g|G是千兆字节,t|T是太字节,p|P是petabytes,e|E是exabytes。 (这不应该与输出控制–units混淆,大写字母表示1000的倍数。)

相关环境变量

有关lvm使用的环境变量的信息,请参阅lvm(8)。 例如,LVM_VG_NAME通常可以替换所需的VG参数。

相关手册

lvm(8) lvm.conf(5) lvmconfig(8)

pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8) pvresize(8) pvs(8) pvscan(8)

vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgconvert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimportclone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8) vgs(8) vgscan(8) vgsplit(8)

lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvreduce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)

lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeactivate(8) lvmdump(8)

dmeventd(8) lvmetad(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8) cmirrord(8) lvmdbusd(8)

lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)

参考文献

  • man 8 vgconvert, Version 2.02.176-4.1

更新日志

  • 11/29/2018 创建文章