chwpar 命令
用途
更改 工作负载分区的特征。
语法
/usr/sbin/chwpar [-] [-b 引导集标识 [, bootset id , ...] [B [属性=值 ...]] ... [-一个] [-c] [-d 目录] [-D 属性=值 ...] ... [-F] [- 主机名] [-我] [-我 属性=值 ...] ... [-n 新名称] [-H [-M 属性=值 ...] [(N) 属性=值 ...] ... [-] [-R 属性=值 ...] [-S 属性[+ |-] =值...] [乌 用户脚本] [-x ] [-U [UUID]] [ - ] [-X 属性 = 值 ...]wparname
/usr/sbin/chwpar -K [-A] [-b ] [-B bootset=bootset id] [-c] [-D devname=devicepathname ] ... [-F] [-i] [-I rtdest=destination rtgateway=gateway [attribute=value ...]] ... [-M attribute=value ...] [-N address=A.B.C.D] ... [-R [attribute ...]] [-S] [-u] [-x ] [ -v ] [-X kext=value ...]wparname
- 不能超过 25 字节。
- 不能包含空格或任何下列符号
= : / ! ; ` ' " < > ~ & ( ) * + [ ] , . ^ 0 { } | \ - 不能以“-”或“0”开头。
描述
chwpar 命令修改由 wparname 参数指定的 工作负载分区 的配置选项。 您可以更改 工作负载分区 是否正在运行的大多数选项。 检测到并不允许对正在运行的 工作负载分区 进行某些更改 (请参阅 -d 和 -n 选项)。 其他更改 (例如,取消导出繁忙设备或除去已安装的文件系统) 可能会在正在运行的 工作负载分区上生成错误,但您可以进行这些更改。
使用 -K 标志从 工作负载分区的配置中除去特征。 对于具有缺省选项的属性,除去属性值能够恢复选项的缺省设置。
WPAR 不支持所有类型的 CD ROM 设备。 它仅支持使用 FCP(子类类型)的 CSI CD ROM 设备。 但是,不支持电子集成驱动器 (IDE)、串行 ATA (SATA) 和(从 Virtual I/O Server 导出的)虚拟设备。
标志
- -a
- 如果需要,自动解决发生冲突的静态设置。 可解析的设置是主机名和网络配置。
- -A
- 通过将 工作负载分区 的 自动 属性值设置为 是,配置要在系统引导时通过 /etc/rc.wpars 命令启动的 工作负载分区 。 当指定带有 -K 标志的 -A 标志时, auto 属性值将设置为 no。 -A 标志在全局系统下次引导时生效。 -A 标志对于应用程序 工作负载分区无效。
- -b bootset id [, bootset id , ...]
- 配置 工作负载分区的引导列表。 引导列表确定下次启动 工作负载分区 时使用的引导集。 必须至少指定一个引导集标识。 如果未配置引导列表,那么将使用先前使用的同一引导集来启动 工作负载分区 。 如果配置了多个引导集标识,并且从第一个引导集开始失败,那么列出的第二个引导集将用于启动 工作负载分区,依此类推。
- -B {{devname=device name | devid=device identifier} [bootset=bootset id] | [bootset=bootset id] [vg=volume group name]}
- 为 工作负载分区创建备用引导集。 备用引导集是 RootVG WPAR 当前 rootvg 或非 RootVG WPAR 的 WPAR 文件系统的克隆。 RootVG 工作负载分区 的有效属性为 :devname 或 devid 以及 bootset。 bootset 和 VG 属性non-RootVG 工作负载分区有效。
- devname=device name
- 指定存储设备的逻辑设备短名称以克隆当前 rootvg。
- devid=device identifier
- 指定磁盘类型设备的唯一设备标志以克隆当前 rootvg。
- bootset=bootset id
- 指定分配给新备用引导集的整数标识。 有效值在范围 0-8 中。 如果未指定引导集标识,那么将使用下一个可用标识。
- vg=volume group name
- 指定卷组的名称,以在非 RootVG WPAR 上创建备用引导集文件系统。 如果未指定卷组,将在当前活动 WPAR 文件系统所在的卷组上创建文件系统。
- -c
- 针对检查点启用了 工作负载分区 。注: 为检查点启用 工作负载分区 的功能取决于其他软件。
- -d 目录
- 更改 工作负载分区的基本目录。 -d 标志不能在正在运行的 工作负载分区上使用。 此标志对于应用程序 工作负载分区无效。 如果定义了备用引导集,那么无法更改 工作负载分区 的基本目录。
- -D {设备名=设备名 | 德维德=设备标识}[rootvg=是 | 不] [设备类型=[克隆 | 伪 | 适配器 |磁盘 | 光盘 | 磁带]]
- 配置每次系统启动时将全局设备导出或虚拟化到 工作负载分区 中。 可以指定多个
-D 标志来分配多个设备。 使用空格分隔 attribute=value。 可以为
-D 标志指定下列属性:
- devname=device name
- 指定要分配给工作负载分区的设备名称。 对于伪类型和克隆类型的设备,这是设备的完整路径(即,/dev/pty10)。 对于存储器类型的设备,它是逻辑设备的短名称。
- devid=device identifier
- 指定要分配给工作负载分区的磁盘类型设备的唯一设备标识。 此属性仅适用于磁盘、CD-ROM 或磁带类型的设备。
- rootvg= [yes | no]
- 用于指示是否将指定的磁盘设备用作 rootvg 工作负载分区 设备。 如果未指定 rootvg 属性,那么该命令将使用缺省值 no。
- devtype=[ clone | pseudo | adapter | disk | cdrom | tape]
- 指定要分配给 工作负载分区的设备的设备类型。
- -f
- 禁止由于设置无效而发生的错误。
- -h 主机名
- 修改 工作负载分区的内核主机名。
- -H 体系结构
- 更改或除去工作负载分区的体系结构。 有效体系结构值为: [
pwr4|ppc970|pwr5|pwr6|pwr7|pwr8]。 特殊值none将禁用工作负载分区体系结构的兼容性。 无法在运行的工作负载分区上使用 -H 标志。注: -H 标志与 -K 标志一起有效。
- -i
- 对 工作负载分区启用特定于 WPAR的路由。 当在正在运行的 工作负载分区上启用特定于 WPAR的路由时,使用带有 mkwpar的 -I 标志配置的任何显式路由表条目。 wparexec或 chwpar 命令将添加到 工作负载分区的路由表中。 在启用了特定路由 "WPAR的 "工作量分区上运行 "chwpar '-i命令,会刷新 "工作量分区的路由表。 例如,可在全局路由清仓后使用 -i 标志来恢复路由表。 可以将 -i 标志与 -K 标志配合使用,以禁用 工作负载分区的 WPAR特定路由。 有关 -i 标志的更多信息,请参阅 mkwpar 命令的 -i 标志的描述。
- -I 属性=value ...
- 修改显式路由表条目。 这些条目是根据 rtdest、rtgateway 和
rtinterface(如果指定)属性的组合来进行匹配的。 如果发现匹配条目,那么会使用余下属性来更新路由表条目。 如果找不到匹配项,那么将在 工作负载分区 路由表中创建新条目。 有关 -I
标志的更多信息,请参阅 mkwpar 命令的
-i 标志和 -I 标志的描述。 但是,与 mkwpar 命令或 wparexec 命令不同, 将 -I 标志与 chwpar 命令配合使用不会更改是启用还是禁用特定于 WPAR的路由。 使用 -i 标志 (带或不带 -K 标志) 来禁用或启用特定于 WPAR的路由。可使用 -I 标志来指定下列属性:
- rtdest=目标
- (必需)标识将路由引导至的主机或网络。 可使用符号名称或数字地址来指定该值。 可使用关键字 default 来指定缺省路由。 有关 rtdest 属性的更多信息,请参阅 route 命令的 Destination 参数。
- rtgateway=网关
- (必需)标识包被发送至的网关。 可使用符号名称或数字地址来指定该值。
- rtnetmask = A.B.C.D
- 指定目标地址的网络掩码。
- rtprefixlen = n
- 指定目标前缀的长度,即网络掩码中的位数。 该值必须是正整数。
- rttype= {网络|主机}
- 强制 rtdest 属性解释为指定类型。
- rtinterface=如果
- 指定要与路由相关联的接口(如
en0),以便选择该路由时使用该接口发送包。 - rtfamily= {inet|inet6}
- 指定地址系列。 有关 rtfamily 标志的参数的信息,请参阅 ../r_commands/route.html route 命令的参数部分。
- -M dev=devicepath directory=dir vfs=type [mountopts = mountopts]
- 指定可从工作负载分区访问的 namefs (vfs=namefs) 安装。 可指定多个 M 标志。 此处允许的唯一工作负载分区安装形式为:namefs。
指定由 dev 属性指定的全局目录安装在工作负载分区的文件系统结构的 directory 属性所指定的目录中。 适用于 namefs 安装的唯一一个其他属性是 mountopts。 如果 B 在 chwpar 命令中使用 -M 标志,那么无法映射工作负载分区中的现有目录。 namefs 安装还可以与 rootvg 工作负载分区一起使用。 在这种情况下,savewpar 命令将不会保存安装的内容。 可将 M 标志与 K 标志一起使用以从工作负载分区移除 namefs 安装,但是无法移除工作负载分区的 /, /var, /opt, /usr, /tmp, /proc or /etc/objrepos/wboot 文件系统。
- -K
- 从 工作负载分区的配置中删除指定的属性。 可以将 -K 标志与以下标志一起使用:
- -A
- 将 工作负载分区 的常规 auto 选项值更改为 no。 导致在运行 /etc/rc.wpars 命令时不启动 工作负载分区 。 此标志对于应用程序 工作负载分区无效。
- -b
- 删除当前配置的引导列表。
- -B bootset=bootset id
- 从 工作负载分区中删除指定的备用引导集。
- -c
- 对检查点禁用了 工作负载分区 。
- - D [devname= 设备名称 | devid= 设备标识符]
- 除去涉及已导出设备的显示项,这会导出先前未导出的设备,或者除去先前导出的设备。 此标志对应用程序工作负载分区无效。可以为 -D 标志指定下列属性:
- devname=device name
- 指定要分配给工作负载分区的设备名称。 对于伪类型和克隆类型的设备,这是设备的完整路径(即,/dev/pty10)。 对于存储器类型的设备,它是逻辑设备的短名称。
- devid=device identifier
- 指定要分配给工作负载分区的磁盘类型设备的唯一设备标识。 此属性仅适用于磁盘、CD-ROM 或磁带类型的设备。 使用 devid 属性时,必须同时指定 devtype 属性。
- -X [kext=/path/to/extension|ALL]
- 为已导出内核扩展除去显式条目。 除去内核扩展将防止在工作负载分区内将其装入。 如果在工作负载分区内装入了内核扩展,那么该内核扩展将不被卸载。 要完整地对工作负载分区中的内核扩展取消导出,将需要重新启动工作负载分区。 此标志对应用程序工作负载分区无效。 必须指定以下属性:
- kext=/path/to/extension|ALL
- 指定要除去的内核扩展。 此项必须与工作负载分区的配置文件内的值匹配。 此项必须为标准路径或 ALL(如果先前已使用 kext=ALL)。
- -i
- 对 工作负载分区禁用特定于 WPAR的路由。 使用带有 mkwpar, wparexec的 -I 标志提供的任何显式路由表伪指令。 或者在 工作负载分区的配置中维护 chwpar 命令 (但不活动)。 下次启用特定于 WPAR的路由时,将自动创建显式条目。
- -我 符=目的地 Rtgateway=网关 [属性=值 ...]
- 从 工作负载分区的路由表中除去显式条目。 必须至少指定 rtdest 属性和 rtgateway 属性来标识要删除的条目。
- -N 地址=A.B.C.D
- 从 工作负载分区的配置中除去指定的 IPv4 地址。
- - N 地址6= S :T :U: V: W: X: Y: Z
- 从 工作负载分区的配置中除去指定的 IPv6 地址。
- -R [属性 ...]
- 从 工作负载分区的资源控制配置中除去特定字段。 -R
标志可以将每个字段恢复为其缺省状态。 对于 totalProcesses 之类的字段,缺省状态为
unlimited。 可将以下属性恢复为缺省处理:
- rset
- shares_CPU
- CPU
- shares_memory
- 内存
- procVirtMem
- totalVirtMem
- totalProcesses
- totalThreads
- totalPTYs
- totalLargePages
- pct_msgIDs
- pct_semIDs
- pct_shmIDs
- pct_pinMem
- -S
- 将 工作负载分区 的安全设置复原为缺省值。
- -U
- 对管理事件禁用用户脚本的插图编号。 (未删除脚本本身。)
- -x
- 不允许访问跨 WPAR 信标和共享的内存分段。
- M 目录 = 目录
- 从工作负载分区移除由目录属性指定的 namefs 安装。注: /, /var, /opt ,/usr , /tmp, /proc, 或者无法除去工作负载分区的 /etc/objrepos/wboot 文件系统。
- -n 新名称
- 工作负载分区的新名称。 不要为正在运行的 工作负载分区指定 -n 标志。
- -N 属性=value ...
- 修改网络配置属性。 根据 address 或 address6 属性来匹配条目。 必须为每个条目指定一个 -N 标志。 也可以指定多个 -N 标志来重新配置多个 IP 地址。 可修改下列网络配置属性:
- interface=if 或 interface=namemappedif
- 地址=A.B.C.D
- netmask= A.B.C.D
- 广播= A.B.C.D
- 地址 6 = S : T : U : V : W : X : Y : Z
- 前缀长度 = n
prefixlen 属性的值的范围是 0 到 128。
名称映射的接口在 /etc/wpars/devmap 文件中。 可指定名称映射的接口与系统接口之间的映射,如下所示:# The comments start with '#' # Each line contains a pair of name-mapped interface # and real interface separated by tab or blank spaces. foo en0 goo en1 soo en2
- -P
- 以交互方式设置 工作负载分区中 root 用户的密码。 此标志对于应用程序 工作负载分区无效。
- -R 属性=value ...
- 允许修改资源控制属性。 大多数资源控件与 工作负载管理器使用的资源控件相似。 您可以指定下列属性:
- 活动 = 是 | 否
- 如果指定 yes,那么此属性允许保留资源控制定义,但是它们会显示为不活动。 如果指定 no,那么性能指标 (例如处理器和内存使用率) 可能无法通过命令 (例如 topas 和 wlmstat 命令) 提供。 工作负载分区的内部和外部。
- rset = rset
- 配置 工作负载分区 以使用由 mkrset 命令创建的资源集。
- 共享CPU = n
- 指定可用于 工作负载分区的处理器共享数。 请参阅 工作负载管理器 共享文件。
- CPU=m%-SM% ,HM%
- 指定 工作负载分区的进程的处理器限制百分比。 请参阅 工作负载管理器 限制文件。
- 共享内存= n
- 指定可用于 工作负载分区的内存共享数。 请参阅 工作负载管理器 共享文件。
- memory=m%-SM% ,HM%
- 指定 工作负载分区的进程的内存限制百分比。 请参阅 工作负载管理器 限制文件。
- procVirtMem=n[M|MB|G|GB|T|TB]]
- 指定单个进程可消耗的最大虚拟内存量。 超过指定限制的线程将被终止。 有效单位是兆字节(M 或 MB)、千兆字节(G 或 GB)和太字节(T 或 TB)。 允许的最小限制为 1MB。 可指定的最大限制为 8796093022207M、8589934591G 或 8388607T。 如果将该值设置为 -1(无单位),那么该限制将被禁用。 请参阅 工作负载分区 限制文件。
- totalVirtMem=n[M|MB|G|GB|T|TB]
- 指定 WPAR 总共可消耗的最大虚拟内存量。 超过所指定限制的进程将终止。 有效范围和单位与 procVirtMem 的相同。 如果该值设置为 -1(无单位),那么该限制将被禁用。 请参阅 工作负载分区 限制文件。
- 进程总数=n
- 指定 工作负载分区中允许的进程总数。 请参阅 工作负载分区 限制文件。
- 共计=n
- 指定 工作负载分区中允许的伪终端总数。 请参阅『pty 特殊文件』。
- 大页面总数=n
- 指定 工作负载分区允许的大页面数。 请参阅『大页』。
- pct_msgIDs = n %
- 指定 工作负载分区中允许的系统最大消息队列标识数的百分比。 请参阅『消息队列内核服务』。
- pct_semIDs = n %
- 指定 工作负载分区中允许的系统最大信号量标识数的百分比。
- pct_shmIDs = n %
- 指定 工作负载分区中允许的系统最大共享内存标识数的百分比。 请参阅 共享内存 (Shared Memory)。
- pct_pinMem = n %
- 指定可以分配给 工作负载分区的系统最大固定内存百分比。 请参阅『支持插入内存』。
- 线程总数=n
- 指定 工作负载分区中允许的线程总数。
- -S 属性[+ |-] =value...
- 修改 工作负载分区的安全设置。 可以仅指定以下某种格式的安全性更改:
- secfile= secAttrsFile
- 将 工作负载分区 的特权设置为指定文件中列出的特权。
- privs=priv , priv , ...
- 将 工作负载分区 的特权设置为指定的特权列表。
- privs + =priv , priv , ...
- 将指定的特权列表添加到 工作负载分区的特权集。
- privs-=priv , priv , ...
- 从 工作负载分区的特权集中除去指定的特权列表。
重要信息: 当 工作负载分区 处于活动状态时,请勿更改安全设置。
- -u 用户脚本
- 更改要在 工作负载分区 管理事件上运行的用户脚本的路径。 如果未配置用户脚本,那么指定脚本将被添加到配置中。 RBAC 用户无法对其他人拥有的 WPAR 运行此标志。
- -U [工作负载分区 UUID]
- 更改工作负载分区 UUID。 如果未提供,那么会自动生成新的 UUID。
- -v
- 启用冗余输出。
- -x
- 允许访问跨 WPAR 信标和共享的内存分段。
- -X [exportfile= /path/to/file | [kext= [/path/to/extension | ALL]] [local= yes|no] [major= yes|no]
- 对导出将允许在工作负载分区内装入的内核扩展进行配置。 可指定多个
-X 标志以分配多个内核扩展。 请使用空格隔开 attribute=value。 此标志对应用程序工作负载分区无效。 可指定 -X 标志的以下属性:
- exportfile=/path/to/file
- 指定将导出的包含有效扩展节的文件。 扩展节应该至少包含 kext 属性。 还可以在该节中指定 local 和 major 属性,在下面对它们进行了描述。 exportfile 属性与 kext 属性互斥。 它还与 local 和 major 属性互斥,因为可以在 exportfile 中为每个扩展节指定这些属性。 这是可由用户创建以配合 exportfile=/path/to/file(对于 mkwpar 和 chwpar)使用的文件。 它可包含多个扩展节。 对于每个扩展节,kext 属性是必需的。 本地值和主值都是可选的,因为它们都具有缺省值 no。 exportfile 将类似于以下内容:
extension: major = "yes" local = "no" kext = "/usr/lib/drivers/ldterm"- kext=/path/to/extension
- 指定将导出的内核扩展。 这是位于全局系统的文件系统中的内核扩展。 还可以指定关键字 ALL。 这将允许工作负载分区装入任何扩展。 指定 ALL 时, local 和 major 属性限制为 local= yes 和 major= no。 可以指定其他 -X 标志以覆盖受限的 local 和 major 值。 kext 属性与 exportfile 属性相互排斥。
- local=yes|no
- 指定 local=yes 将使内核扩展的实例仅对于正在装入该内核扩展的工作负载分区为可访问。 指定 local=no 将共享全局系统中装入的内核扩展的实例。 缺省情况下,local=no。
- major=yes|no
- 此属性仅应该用于具有相关联主设备的内核扩展。 缺省情况下,major=no。
- recalc=yes
- 此属性可用来重新计算内核扩展的校验和。
参数
| 项 | 描述 |
|---|---|
| wparname | 要更改的系统或应用程序 工作负载分区 的名称。 wparname 参数必须是命令行上的最后一个参数。 |
安全性
访问控制
只有 root 用户才能运行该命令。
RBAC 用户注意: 此命令可以执行特权操作。 只有特权用户才能执行特权限定的操作。 有关权限与特权的更多信息,请参阅安全性中的“特权限定的命令数据库”。 有关与该命令相关联的特权和权限的列表,请参阅 lssecattr 命令或 getcmdattr 子命令。
示例
- 修改调用的 工作负载分区 的主机名roy,请输入以下命令:
chwpar -h roy.com roy - 从调用的 工作负载分区 中除去网络地址dale,请输入以下命令:
chwpar -K -N address=219.81.45.65 dale - 在调用的 工作负载分区 中禁用资源控制wayne同时保留设置以供将来使用,请输入以下命令:
chwpar -R active=no wayne - 要将工作负载分区的 bootlist 属性修改为 bootset 1、bootset 2 和 bootset 3 的有序列表,请输入以下命令:
chwpar -b bootlist=1,2,3 <wpar name> - 要对 RootVG 工作负载分区创建由 hdisk3
和 hdisk4 组成的 bootset,请输入以下命令:
chwpar -B devname=hdisk3 -B devname=hdisk4 <wpar name> - 要为 RootVG 工作负载分区创建由 hdisk3
和 hdisk4 组成的 bootset 标识为 3 的 bootset,请输入以下命令:
chwpar -B devname=hdisk3 bootset=3 -B devname=hdisk4 bootset=3 <wpar name> - 要对非 RootVG 工作负载分区创建 bootset,请输入以下命令:
chwpar -B <wpar name> - 要为非 RootVG 工作负载分区在特定卷组上创建 bootset,请输入以下命令:
chwpar -B vg=<volume group> <wpar name> - 要为非 RootVG 工作负载分区在特定卷组上创建 bootset 标识为 5 的 bootset,请输入以下命令:
chwpar -B bootset=5 vg=<volume group> <wpar name> - 要从工作负载分区移除其 bootset 标识为 3 的 bootset,请输入以下命令:
chwpar -K -B bootset=3 <wpar name> - 要从 工作负载分区中取消导出设备,请输入以下命令:
chwpar -K -D devname=hdisk1 <wpar name> - 要导出设备,请输入以下命令:
chwpar -D devname=hdisk1 devtype=disk <wpar name> - 要从以下位置重命名 工作负载分区 :moore至hart,请输入以下命令:
chwpar -n hart moore - 要将适配器 fcs2 添加到名为“roy”的工作负载分区,请输入以下命令:
chwpar -D devname=fcs2 roy - 要从名为“roy”的工作负载分区中除去适配器 fcs2,请输入以下命令:
chwpar -K -D devname=fcs2 roy
文件
| 项 | 描述 |
|---|---|
| /etc/wpars/devexports | 工作负载分区的缺省设备导出控制文件。 |