手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

poweradm(1M)

名称

poweradm - 管理电源管理属性

用法概要

poweradm [-v] get [-a all|smf|platform|current] property ...
poweradm [-v] set property=value ...
poweradm [-v] list
poweradm show
poweradm -?

描述

poweradm 程序用于显示和管理 Solaris 实例中的电源管理设置。

电源管理属性及其值存储在服务管理工具中(请参见 smf(5))。

所有用户都可以运行“用法概要”部分中给出的 listget 以及 show 形式。这些命令允许所有用户查看 Solaris 实例中当前的电源管理设置。

只有属于 "Maintenance and Repair"(维护和修复)RBAC 配置文件的用户和角色才可以执行“用法概要”部分给出的 set 形式的 poweradm。另请参见下文的“附注”部分。

poweradm 支持以下服务属性:

administrative-authority

此属性的值应指定为字符串,可以具有以下值:

  • smf

  • platform

  • none

platform 是缺省值。此属性的意义在于它指定了 Solaris 内核中电源管理的管理控制源。即,此属性指示 Solaris 内核中 time-to-full-capacitytime-to-minimum-responsiveness 设置的来源。只有具有相应特权的 Solaris 用户才可以设置此属性。

administrative-authority 设置为 platform 时,将从平台代码中获取 time-to-full-capacitytime-to-minimum-responsiveness 的值。使用 poweradm 命令在 SMF 中设置这些值不会对内核中的值产生任何影响。poweradm list 命令将指出内核当前使用的是平台值。由于这些值是由平台管理员更改的,因此将在内核中修改它们。此外,用于在 Solaris 内核中启用或禁用电源管理的命令也将来自平台代码。在运行虚拟机的系统上,虚拟机管理程序或虚拟机管理器可以是该属性的源。

administrative-authority 设置为 smf 时,将从 SMF 中获取 time-to-full-capacitytime-to-minimum-responsiveness 的值。由于 SMF 中的这些值是由 Solaris 管理员更改的,因此它们将应用于内核。当 administrative-authority 设置为 smf 时,在平台中设置这些值不会对内核中的值产生任何影响。在这种情况下,poweradm 命令将指出内核当前使用的是来自 SMF 的值。Solaris 管理员更改这些值时,也将在内核中修改这些值。

administrative-authority 设置为 none 时,Solaris 内核中的电源管理处于禁用状态,但电源服务仍将继续运行。将忽略来自平台的任何电源管理指令,也将忽略 SMF 中的设置。仅当 administrative-authority 设置为其他任一值时,Solaris 内核中的电源管理才会使用来自指定源的设置重新启动。

time-to-full-capacity

以微秒为单位指定。

此参数限制系统处于活动状态时允许进行的动态容量调整。

此参数定义系统从任何较低容量/低速响应状态返回到其全部容量(重新置备系统使之可用)允许使用的最大时间,在此时间范围内系统可使用任何或所有 PM 功能来达到其全部容量。

缺省情况下,从平台(例如 i86pc)中获取此值,因为 administrative-authority 的缺省设置为 platform

如果 administrative-authority 设置为 smf,将从电源服务(即 SMF)提供的定义中获取此值。在安装时此值设置为 undefined。如果 Solaris 管理员选择修改此属性,必须选取适合工作负荷或应用程序需要的值。

time-to-minimum-responsiveness

以毫秒为单位指定。

该参数限制系统处于非活动状态时允许进行的动态容量调整。

此参数定义系统返回到其活动状态(即达到满足上述 time-to-full-capacity 限制所需的最小容量)允许使用的时间。

中等大小的值(几秒钟)允许将平台上的硬件组件或子系统置于低速响应的非活动状态;较大的值(例如,30 秒到几分钟)允许将整个系统暂停,如使用挂起到内存技术。

缺省情况下,从平台(例如 i86pc)中获取此值,因为 administrative-authority 的缺省设置为 platform

如果 administrative-authority 设置为 smf,将从电源服务(即 SMF)提供的定义中获取此值。在安装时此值设置为 undefined。如果 Solaris 管理员选择修改此属性,必须选取适合工作负荷或应用程序需要的值。

suspend-enable

缺省情况下,不允许运行 Solaris 的计算机尝试执行挂起操作。将此属性设置为 true 将允许计算机尝试执行挂起操作。administrative-authority 的值不会对此属性产生任何影响。

platform-disabled

无法通过 poweradm 命令更改此属性。可以通过运行 list 子命令来查看 platform-disabled 的值。如果设置为 trueadministrative-authority 设置为 platform,则平台已禁用了电源管理。如果设置为 false,则将通过其他属性的值控制电源管理,如上所述。show 子命令的输出将显示这些属性的值。在运行虚拟机的系统上,虚拟机管理程序或虚拟机管理器可以是 platform-disabled 的源。platform-disabled 的缺省值为 false

选项

支持以下选项。

–?

显示可用子命令和选项的用法概要。

–v

提供详细的输出。可与以下列出的任何子命令结合使用。

子命令

支持以下子命令:

get [–a all|smf|platform|current]

检索指定属性的当前值。–a 选项可用于指示值的源:SMF (smf)、平台 (platform)、内核当前使用的值 (current) 或上述所有项 (all)。缺省情况下,如果没有指定任何源,则会使用 current

administrative-authoritysuspend-enable 属性没有平台值。

set property=value...

将指定的 property 更改为给定 valueadministrative-authoritysuspend-enable 属性会自动同步为内核中的新值。当且仅当 administrative-authority 设置为 smf 时,属性 time-to-full-capacitytime-to-minimum-responsiveness 才会同步到内核。如果使用了 –v 选项,但由于 administrative-authority 未设置为 smf 而无法立即更新内核,将会发出警告消息。

只有属于 "Maintenance and Repair"(维护和修复)RBAC 配置文件的用户和角色才可以执行 set 子命令。

list

列出所有可用的电源管理属性值并指示电源管理是否处于活动状态。

show

输出用户可读的文本,其中指出是由平台还是由 Solaris 实例控制电源管理,电源管理是否已启用,如果启用了电源管理,还提供 time-to-full-capacitytime-to-minimum-responsiveness 的值。

示例

示例 1 设置由平台控制电源管理

以下命令设置由平台控制电源管理。

# poweradm set administrative-authority=platform
示例 2 禁用电源管理

以下命令将禁用电源管理。

# poweradm set administrative-authority=none
示例 3 设置有用参数

以下命令序列将 time-to-full-capacity 设置为 300 微秒,将 time-to-minimum-responsiveness 设置为 500 微秒,并将这些新值通知给 Solaris 实例。

# poweradm set time-to-full-capacity=300
# poweradm set time-to-minimum-responsiveness=500
# poweradm set administrative-authority=smf
示例 4 禁用挂起和恢复

以下命令禁用挂起和恢复。

# poweradm set suspend-enable=false
示例 5 列出电源管理属性

以下命令列出所有可用的电源管理属性。

# poweradm list
示例 6 获取属性值

以下命令显示 time-to-full-capacity 的当前值。

# poweradm get time-to-full-capacity
示例 7 显示平台设置的属性值

以下命令检索由平台设置的 time-to-full-capacity 值。

# poweradm get -a platform time-to-full-capacity

请注意,仅当 administrative-authority 设置为 platform 时,该值才会与当前值相同。请参见上面关于 administrative-authority 属性的说明。

示例 8 显示 Solaris 实例设置的属性值

以下命令检索由 Solaris 实例设置的 time-to-full-capacity 值。

# poweradm get -a smf time-to-full-capacity

请注意,仅当 administrative-authority 设置为 smf 时,该值才会与当前值相同。请参见上面关于 administrative-authority 属性的说明。

示例 9 调用 show 子命令

以下示例命令说明了调用 poweradm show 时可能处于的四种状态。

调用以下命令时平台禁用了电源管理。

# poweradm show
Power management is disabled with the hardware platform as the authority

调用以下命令时 Solaris 管理员禁用了电源管理。

# poweradm show
Power management is disabled with the Solaris instance as the authority

调用以下命令时平台启用了电源管理。

# poweradm show
Power management is enabled with the hardware platform as the authority
time-to-full-capacity 300 microseconds
time-to-minimum-responsiveness 500 milliseconds

调用以下命令时 Solaris 实例启用了电源管理。

# poweradm show
Power management is enabled with the Solaris instance as the authority
time-to-full-capacity 300 microseconds
time-to-minimum-responsiveness 500 milliseconds

退出状态

0

成功完成。

1

出现错误。

2

指定的命令行选项无效。

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
system/kernel/power
接口稳定性
Committed(已确定)

另请参见

attributes(5)smf(5)smf_security(5)

附注

电源服务由服务管理工具 smf(5) 管理,其服务标识符为:

svc:/system/power:default

可由 poweradm 设置的属性在该服务中定义为:

  • active_control/administrative-authority,在上面的 administrative-authority 中进行了介绍。

  • active_config/time-to-full-capacity,在上面的 time-to-full-capacity 中进行了介绍。

  • active_config/time-to-minimum-responsiveness,在上面的 time-to-minimum-responsiveness 中进行了介绍。

  • suspend/suspend-enable,在上面的 suspend-enable 中进行了介绍。

如果服务处于禁用状态,以后不会将任何电源管理设置上载到内核中。只有在下次重新引导之后才会撤消现有设置。禁用所有电源管理的最佳方式是将 administrative-authority 设置为 none

如果先将 administrative-authority 设置为 smf 值,然后再设置 time-to-full-capacitytime-to-minimum-responsiveness,服务将进入维护模式。在这种情况下,先将 administrative-authority 设置为 none 值,然后将 time-to-full-capacitytime-to-minimum-responsiveness 设置为所需值,清除服务,随后将 administrative-authority 设置为 smf

要设置 active_configsuspend 属性组中的属性,需要 solaris.smf.value.power_config 授权。要设置 active_control 属性组中的属性,需要 solaris.smf.value.power_control 授权。这两种授权都属于 "Maintenance and Repair"(维护和修复)配置文件。