th
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
THIS WHITE PAPER IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL
ERRORS AND TECHNICAL INACCURACIES. THE CONTENT IS PROVIDED AS IS, WITHOUT EXPRESS OR
IMPLIED WARRANTIES OF ANY KIND.
© 2010 Dell Inc. All rights reserved. Reproduction of this material in any manner whatsoever without the express written permission of Dell Inc. is strictly forbidden. For more information, contact Dell.
Dell, the DELL logo, PowerEdge, and OpenManage are trademarks of Dell Inc . Microsoft, and Windows are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. PKUNZIP is a registered trademark of PKWARE, Inc. in the United States and other countries.
Page ii
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
Page 1
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
This white paper describes how to use the Dell OpenManage™ Deployment Toolkit (DTK) and an
Intelligent Platform Management Interface (IPMI) utility to configure the Power Restore Policy on
PowerEdge 11th generation servers.
Because the DTK provides an OS Windows Preinstallation Environment (WinPE) and command line tools, administrators can use DTK scripts to change hardware settings on multiple servers, prior to deploying complete operating systems.
After describing the required software and procedure necessary to build the DTK ISO image, several examples illustrate using the ipmitool commands to change and display Power Restore Policy settings, plus manage local and remote servers.
To create the DTK ISO image with the WinPE and ipmitool, you need these software components:
Windows Automated Installation Kit (AIK), http://www.microsoft.com/downloads/details.aspx?FamilyID=94BB6E34-D890-4932-81A5-
5B50C657DE08&displaylang=en
Latest Dell Deployment Toolkit, support.dell.com
ipmitool.exe
, support.dell.com
Obtain the Dell Deployment Toolkit
Download the DTK as a self-extractable file for Windows from support.dell.com
.
The current version is
DTK3.3-WINPE-218.exe
at publication time. Check for the availability of later releases. You can also obtain the toolkit from an FTP server, available at ftp.dell.com/sysman/DTK3.3-WINPE-218.exe
.
The Dell Support website supplies DTK components as a self-extracting zip file that can be placed on any machine running a Microsoft Windows operating system. It can also be extracted at the Windows
Command Prompt ( cmd.exe
) using the PKUNZIP.EXE™ utility (not supplied with the DTK).
Obtain the ipmitool
1.
Download the Dell Baseboard Management Controller (BMC) Utility OMI-BMC-Dell-Web-
WIN-xxx-xx-xxx.exe
software from support.dell.com
.
2.
Extract this file to the C:\openmanage default directory.
3.
Extract the BMC Utilities from the BMC.msi
installer in the C:\openmanage\windows\BMC directory to the default C:\Program Files\Dell\SysMgt\bmc directory.
Copy Files to ipmitool Directory
Copy the cygcrypto-0.9.8.dll
, cygwin1.dll
, dcwipm32.dll
and ipmitool.exe
files from the
BMC source directory (Figure 1) to the destination C:\Dell\ipmitool directory.
Page 2
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
Figure 1: BMC Source Directory
To create a Windows Preinstallation Environment image with the Dell Deployment Toolkit
WPE_driverinst.bat
script, use these steps:
1.
Install the Windows AIK to its default installation directory. DTK requires this installation.
2.
Extract the DTK to the C:\Dell default directory.
3.
At the windows command line prompt, change to the C:\Dell\Drivers\winpe3.x
directory. The WPE_driverinst.bat
script can be found here.
4.
Change the script with a text editor by adding this command before section eleven. xcopy %DTKPATH%\..\..\ipmitool\*.*
%WINPEPATH%\mount\Dell\Toolkit\tools\ipmitool /S /E /I /Y
5.
Save the script and run it with two arguments (required) at the prompt:
WPE_driverinst.bat <WINPEPATH> <DTK PATH> where <WINPEPATH> is a nonexistent directory created to store the PE and <DTK PATH> is the directory containing Dell DTK drivers
Example: WPE_driverinst.bat C:\winpe3.0-image C:\Dell\x32\Drivers
Note: The script adds a new destination C:\winpe3.0-image folder. If the script was run previously, delete this folder.
Note: The script creates a WMI image boot.wim
(containing DTK drivers) in the
C:\ winpe3.0-image \ISO\sources subdirectory. The command prompt changes to the
C:\winpe3.0-image directory .
Page 3
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
6.
At the Windows command line prompt, run this command to make a CD-bootable ISO image labeled dtk-ipmitool.iso
: oscdimg -n -bc:\winpe3.0-image\etfsboot.com c:\winpe3.0-image\ISO c:\winpe3.0-image\dtk-ipmitool.iso
1.
Boot the server using the dtk-ipmitool.iso
file.
After the server boots, the command prompt displays X:\Dell\Toolkit\Tools directory.
2.
Change the command prompt to the ipmitool subdirectory ( > cd ipmitool ).
3.
Run the ipmitool.exe
program from the command prompt. See Figure 2 and Figure 3 for examples of server management activities.
Note: The ipmitool changes and displays server hardware settings for local and remote servers with known Dell Remote Assist Card (DRAC) IP addresses.
These ipmitool commands change the server Power Restore Policy:
ipmitool -I wmi chassis policy always-on , setting the power restore policy to always-on.
Equivalent to using the syscfg –acpower=on command.
ipmitool -I wmi raw 0x0 0x6 0x0 , setting the power restore policy to always-off.
Equivalent to using the syscfg –acpower=off command.
ipmitool -I wmi raw 0x0 0x6 0x1 , setting the power restore policy to previous.
Equivalent to using the syscfg –acpower=last command.
ipmitool -I wmi raw 0x0 0x6 0x2 , setting the power restore policy to always on.
Equivalent to using the syscfg –acpower=on command.
These ipmitool commands display the server Power Restore Policy:
ipmitool -I wmi chassis status
ipmitool -I wmi raw 0x0 0x1
Power restore policy is determined by the middle 2 binary digits of the first response byte.
For example:
01 00 00 50 - 0x0=0000 implies always off
21 00 00 50 - 0x2=0010 implies previous
41 00 00 50 - 0x4=0100 implies always-on
Page 4
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
Note: For more example commands, refer to the IPMI specification, section 28 and Table G-1, available at http://www.intel.com/design/servers/ipmi/spec.htm
.
Figure 2 illustrates an example of ipmitool commands used to change and display server hardware
Power Restore Policies.
Figure 2: Changes and Display Server Power Restore Policy Settings
Use with local servers:
ipmitool -I wmi chassis policy always-on
ipmitool -I wmi delloem sysinfo
ipmitool -I wmi delloem vflash
ipmitool -I wmi delloem mac
Use with remote servers:
ipmitool -I la n -H 10.94.149.237 -U root -P calvin chassis policy alwayson
ipmitool -I lan -H 10.94.149.237 -U root -P calvin delloem sysinfo
ipmitool -I lan -H 10.94.149.237 -U root -P calvin delloem vflash
ipmitool -I lan -H 10.94.149.237 -U root -P calvin delloem mac
Note: For a complete command list supported by the ipmitool Dell version, refer to Dell OpenManage™
Baseboard Management Controller Utilities User’s Guide , available at support.dell.com
.
Figure 3 illustrates the Dell specific command to display the MAC addresses of local and remote server
Network Interface Cards (NIC).
Page 5
Power Restore Policy on PowerEdge 11th Generation Servers using ipmitool in Windows PE 3.0
Figure 3: Using ipmitool to Display MAC Addresses for Server NICs
Windows Automated Installation Kit (AIK), Microsoft.com
Dell OpenManage™ Deployment Toolkit (DTK), support.dell.com
The Dell Baseboard Management Controller User's Guide provides information about configuring a managed system to use the BMC Management Utility to manage your system, support.dell.com
Intelligent Platform Management Interface (IPMI) Specifications, http://www.intel.com/design/servers/ipmi/spec.htm
Dell BMC Utility OMI-BMC-Dell-Web-WIN-xxx-xx-xxx.exe
software, support.dell.com
Page 6