Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ldmpower (8)

Name

ldmpower - consumption information

Synopsis

ldmpower [-ehiprstvx | -o hours | -m minutes] [-c resource] [-l ldom[,ldom[,...]]]
[interval [count]]

Description

ldmpower(8)                  System Administration                 ldmpower(8)



NAME
       ldmpower - show per-domain, power-consumption information

SYNOPSIS
       ldmpower [-ehiprstvx | -o hours | -m minutes] [-c resource] [-l ldom[,ldom[,...]]]
         [interval [count]]

DESCRIPTION
       The  ldmpower  command  shows  the  power-consumption data in watts for
       domains. By default, it shows the processor power that is  consumed  by
       each  running domain. You can use options to view memory power consump-
       tion and the power consumption of the entire system divided  among  the
       running  domains.  The  per-domain system power consumption is extrapo-
       lated from the per-domain processor and memory power consumption.


       When specified with no options, the ldmpower command shows the  average
       power  consumption  during the last 15, 30, and 60 seconds. The command
       can also show the most recent power-consumption data. For a longer his-
       tory,  the  command  can show up to 60 one-minute averages covering the
       last hour and 336 one-hour averages covering the last 14 days.


       To run this command as a non-privileged user, you must be assigned  the
       LDoms Power Mgmt Observability rights profile. If you already have been
       assigned the LDoms Management or LDoms Review rights profile, you auto-
       matically have permission to run the ldmpower command.


       This  command  is  not  supported  on Fujitsu M10 platforms and Fujitsu
       SPARC M12 platforms.


       When the ldmd/pm_enabled SMF property is set to  false,  which  is  the
       default  value,  running  the ldmpower command fails with the following
       error:

         Failed to connect to the ldmpower server: Connection refused



       The ldmpower command uses the following options and operands:

       -c resource    Shows per-domain power  consumption  for  the  specified
                      resource type, resource. Valid values are processors and
                      memory. The long version of this option is --component.


       -e             Shows the minimum and maximum  power-consumption  values
                      since  data  recording  began.  The long version of this
                      option is --extremes.


       -h             Shows descriptions of the ldmpower command options.  The
                      alternate  short  version  of  this option is -? and the
                      long version of this option is --help.


       -i             Shows instantaneous  power-consumption  data.  The  long
                      versions  of  this  option are --instant and --instanta-
                      neous.


       -l ldom        Shows power-consumption data for one or  more  specified
                      domains.  Domain names are separated by commas. The long
                      version of this option is --list.

                      Note that less data is shown for domains that have  been
                      booted  for  a shorter amount of time than the requested
                      period.


       -m minutes     Shows up to one hour of average  power-consumption  data
                      in  fixed one-minute intervals. The long version of this
                      option is --minutes.

                      Note that less data is shown if the Logical Domains dae-
                      mon  has  been running for a shorter amount of time than
                      the requested period.


       -o hours       Shows up to 14 days of average power-consumption data in
                      fixed  one-hour  intervals.  The  long  version  of this
                      option is --hours.

                      Note that less data is shown if the Logical Domains dae-
                      mon  has  been running for a shorter amount of time than
                      the requested period.


       -p             Shows the overall power consumption for the entire  sys-
                      tem,  which  includes  processors, memory, and fans. The
                      long version of this option is --platform.


       -r             Shows the rolling average power-consumption history  for
                      the  past  15,  30,  and 60 seconds. The long version of
                      this option is --rolling.


       -s             Suppresses the output header. The long version  of  this
                      option is --suppress.


       -t             Shows  time  stamps  in  the output. The long version of
                      this option is --timestamps.


       -v             Shows version data. The long version of this  option  is
                      --version.


       -x             Shows  extrapolated  power-consumption  averages.  These
                      averages reflect the percentage of overall system  watts
                      that  are being consumed per domain. The per-domain sys-
                      tem power consumption  is  extrapolated  from  the  per-
                      domain  processor  and  memory  power  consumption. This
                      option can be used with any of the -o, -i,  -m,  and  -r
                      options.  The  long version of this option is --extrapo-
                      late.


       interval       Reports output once each interval seconds.


       count          Shows count reports. If you specify the count, you  must
                      first specify the interval.


EXAMPLES
       Example 1 Viewing Processor Power-Consumption Data



       The  following  command  shows  the 15-second, 30-second, and 60-second
       rolling average processor power-consumption data for all domains.


         # ldmpower
         Processor Power Consumption in Watts
         DOMAIN  15_SEC_AVG  30_SEC_AVG  60_SEC_AVG
         primary 75          84          86
         gdom1   47          24          19
         gdom2   10          24          26


       Example 2 Viewing Power-Consumption Data for the Entire System



       The following commands show the overall instantaneous system power con-
       sumption in watts:

           o      The following command shows the instantaneous power-consump-
                  tion data for the system, processors, memory, and fans.  The
                  -t option includes time stamps in the output.

                    # ldmpower -tp
                    Overall Instant System Power Consumption in Watts
                    System          2018.01.12 23:13:33     738
                    Processors      2018.01.12 23:13:33     295
                    Memory          2018.01.12 23:13:33     138
                    Fans            2018.01.12 23:13:33     28



           o      The following command shows the instantaneous power-consump-
                  tion data for the system, processors, memory, and fans:

                    # ldmpower -p
                    Overall Instant System Power Consumption in Watts
                    System          738
                    Processors      295
                    Memory          138
                    Fans            25



       Example 3 Viewing Memory and Processor Power-Consumption Data



       The following commands show the per-domain power consumption  in  watts
       for memory, processors, or both:

           o      The  following  command shows the power-consumption data for
                  memory:

                    # ldmpower -c memory
                    Memory Power Consumption in Watts
                    DOMAIN  15_SEC_AVG 30_SEC_AVG 60_SEC_AVG
                    primary 138        138        138
                    ldg1    19         19         19
                    ldg2    19         19         19



           o      The following command shows  the  rolling  power-consumption
                  data for memory and processors:

                    # ldmpower -c memory -c processors
                    Processor Power Consumption in Watts
                    DOMAIN  15_SEC_AVG 30_SEC_AVG 60_SEC_AVG
                    primary 63         61         60
                    ldg1    9          10         10
                    ldg2    9          9          10

                    Memory Power Consumption in Watts
                    DOMAIN  15_SEC_AVG 30_SEC_AVG 60_SEC_AVG
                    primary 138        138        138
                    ldg1    19         19         19
                    ldg2    19         19         19



           o      The following command shows the instantaneous power-consump-
                  tion data for memory and processors:

                    # ldmpower -c memory -c processors -i
                    Processor Power Consumption in Watts
                    DOMAIN  INSTANT
                    primary 292
                    ldg1    10
                    ldg2    10

                    Memory Power Consumption in Watts
                    DOMAIN  INSTANT
                    primary 138
                    ldg1    19
                    ldg2    19



       Example  4  Viewing  Processor  Power-Consumption  Data  for  Specified
       Domains



       The  following command shows the instantaneous processor power-consump-
       tion data for the gdom2 and gdom5 domains.  The  -i  option  shows  the
       instantaneous  power-consumption  data,  and  the  -t option shows time
       stamps in the output. The -l option arguments specify that only  infor-
       mation  about  the  gdom2  and  gdom5 domains appear in the output. The
       first operand, 10, indicates that power-consumption data is reported in
       10-second intervals. The second operand, 5, is the number of iterations
       for which the data is output.


         # ldmpower -itl gdom2, gdom5 10 5
         Processor Power Consumption in Watts
         DOMAIN          TIMESTAMP               INSTANT
         gdom2           2018.01.12 11:14:45     13
         gdom5           2018.01.12 11:14:45     24

         gdom2           2018.01.12 11:14:55     18
         gdom5           2018.01.12 11:14:55     26

         gdom2           2018.01.12 11:15:05     9
         gdom5           2018.01.12 11:15:05     16

         gdom2           2018.01.12 11:15:15     15
         gdom5           2018.01.12 11:15:15     19

         gdom2           2018.01.12 11:15:25     12
         gdom5           2018.01.12 11:15:25     18


       Example 5 Viewing Power-Consumption Data for a Specified Amount of Time



       The  following  commands  show  power-consumption  data  for  specified
       amounts of time:

           o      The  following  command  shows the average power-consumption
                  data for the last 12 hours for all domains.  The  -e  option
                  shows  the  minimum  and maximum values since data recording
                  began, and the -t option shows time stamps  in  the  output.
                  The -o option argument specifies the number of hours to show
                  the average hourly power-consumption data. Data is shown  at
                  one-hour  intervals, starting from the last requested hourly
                  calculation.

                    # ldmpower -eto 12
                    Per domain MINIMUM and MAXIMUM power consumption ever recorded:
                    primary         2018.01.12 08:53:06     3                Min Processors
                    primary         2018.01.12 08:40:44     273              Max Processors
                    gdom1           2018.01.12 09:56:35     2                Min Processors
                    gdom1           2018.01.12 08:53:06     134              Max Processors
                    gdom2           2018.01.12 10:31:55     2                Min Processors
                    gdom2           2018.01.12 08:56:35     139              Max Processors

                    primary         2018.01.12 08:53:06     99               Min Memory
                    primary         2018.01.12 08:40:44     182              Max Memory
                    gdom1           2018.01.12 09:56:35     13               Min Memory
                    gdom1           2018.01.12 08:53:06     20               Max Memory
                    gdom2           2018.01.12 10:31:55     65               Min Memory
                    gdom2           2018.01.12 08:56:35     66               Max Memory

                    Processor Power Consumption in Watts
                    12 hour's worth of data starting from 2018.01.12 09:36:02
                    DOMAIN          TIMESTAMP               1 HOUR AVG
                    primary         2018.01.12 09:37:35     112
                    gdom1           2018.01.12 09:37:35     15
                    gdom2           2018.01.12 09:37:35     26

                    primary         2018.01.12 10:37:35     96
                    gdom1           2018.01.12 10:37:35     12
                    gdom2           2018.01.12 10:37:35     21

                    primary         2018.01.12 11:37:35     85
                    gdom1           2018.01.12 11:37:35     11
                    gdom2           2018.01.12 11:37:35     23
                    ...



           o      The following command shows  the  average  power-consumption
                  data  for the last 30 minutes for all domains. The -e option
                  shows the minimum and maximum values  since  data  recording
                  began,  and  the  -t option shows time stamps in the output.
                  The -m option argument specifies the number  of  minutes  to
                  show  the  average  power-consumption data. Data is shown at
                  one-minute intervals.

                    # ldmpower -etm 30
                    Per domain MINIMUM and MAXIMUM power consumption ever recorded:

                    primary         2018.01.12 06:59:55     151              Min Processors
                    primary         2018.01.12 06:56:20     682              Max Processors
                    gdom1           2018.01.12 06:56:25     36               Min Processors
                    gdom1           2018.01.12 07:02:10     318              Max Processors
                    gdom2           2018.01.12 06:56:25     42               Min Processors
                    gdom2           2018.01.12 07:05:45     417              Max Processors

                    primary         2018.01.12 06:59:55     137              Min Memory
                    primary         2018.01.12 06:56:20     138              Max Memory
                    gdom1           2018.01.12 06:56:25     59               Min Memory
                    gdom1           2018.01.12 07:02:10     60               Max Memory
                    gdom2           2018.01.12 06:56:25     59               Min Memory
                    gdom2           2018.01.12 07:05:45     60               Max Memory

                    30 minute's worth of data starting from 2018.01.12 12:05:33:

                    DOMAIN          TIMESTAMP               1 MIN AVG
                    primary         2018.01.12 12:05:33     574
                    gdom1           2018.01.12 12:05:33     268
                    gdom2           2018.01.12 12:05:33     386

                    primary         2018.01.12 12:06:33     555
                    gdom1           2018.01.12 12:06:33     250
                    gdom2           2018.01.12 12:06:33     364

                    primary         2018.01.12 12:07:33     498
                    gdom1           2018.01.12 12:07:33     276
                    gdom2           2018.01.12 12:07:33     364
                    ...



       Example 6 Viewing Extrapolated Power-Consumption Data for All Domains



       The following command shows extrapolated power-consumption data for all
       the domains: primary, gdom1, and gdom2.


         # ldmpower -x
         System Power Consumption in Watts
         DOMAIN          15_SEC_AVG      30_SEC_AVG      60_SEC_AVG
         primary         585/57.47%      701/68.96%      712/70.22%
         gdom1           132/12.97%      94/9.31%        94/9.30%
         gdom2           298/29.27%      218/21.47%      205/20.22%


       Example 7 Viewing Power-Consumption Data for All Resources



       The  following command shows the system-wide rolling power averages for
       all resources: system, processors, memory, and fans.



       By default, rolling power averages are shown, so  this  output  matches
       the output of the ldmpower -rp command.


         # ldmpower -p
         Resource Power Consumption in Watts
         TYPE            15_SEC_AVG      30_SEC_AVG      60_SEC_AVG
         System          1016            1016            1016
         Processors      270             270             269
         Memory          179             179             179
         Fans            202             202             203


       Example 8 Viewing Instant Power-Consumption Data for All Resources



       The  following command shows the system-wide instant power averages for
       all resources: system, processors, memory, and fans.


         # ldmpower -ip
         Resource Power Consumption in Watts
         TYPE            INSTANT
         System          1012
         Processors      270
         Memory          179
         Fans            203


ATTRIBUTES
       See the attributes(7) man page  for  a  description  of  the  following
       attribute.


       +-------------------------------------------------------------+
       |Attribute Type                Attribute Value                |
       +-------------------------------------------------------------+
       |Availability                  pkg:/system/ldoms/ldomsmanager |
       +-------------------------------------------------------------+
       |Interface Stability           Uncommitted                    |
       +-------------------------------------------------------------+

SEE ALSO
         attributes(7), ldmd(8)


       Oracle VM Server for SPARC 3.6 Administration Guide



                                  August 2018                      ldmpower(8)