Hands-On Lab: HORM. Lab Manual Expediting Power Up with HORM

Transcription

1 Lab Manual Expediting Power Up with HORM

2 Summary In this lab, you will learn how to build a XP embedded images capable of supporting HORM (Hibernate Once Resume Many). You will also learn how to utilize EWFMGR command line interface and EWF API to monitor and control state of HORM. Estimated Time to Complete This HOL 1 hour Applies to This feature is used when customer wants a quick power up to a known state. Last Update 7/12/2007

3 This is a preliminary document and may be changed substantially prior to final commercial release of the software described herein. The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the date of publication. This White Paper is for informational purposes only. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS DOCUMENT. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. Unless otherwise noted, the example companies, organizations, products, domain names, addresses, logos, people, places and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, address, logo, person, place or event is intended or should be inferred Microsoft Corporation. All rights reserved. Microsoft, Windows, ActiveSync, Outlook, Visual Studio, and Windows Mobile are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

4 HOL Requirements The following applications are required to run this HOL: Target Designer Credentials Used None

5 Contents Expediting Power Up with HORM...1 Lab 1: Expediting Power Up with HORM...6 Exercise 1:Creating the image that supports HORM...6 Exercise 2:Exercising the EWFMGR command line interface to monitor and control HORM...17 Exercise 3:Exercising the EWF API interface to monitor and control HORM...22

6 Lab 1: Lab Objective Expediting Power Up with HORM Learn how to build a XP embedded images capable of supporting HORM. Also, learn how to utilize EWFMGR command line interface and EWF API to monitor and control state of HORM. In this HOL you will perform the following exercises: Creating the image that supports HORM, Exercising the EWFMGR command line interface to monitor and control HORM, Exercising the EWF API interface to monitor and control HORM, and Exercise 1: Creating the image that supports HORM 1. In this exercise we will build and EWF image that supports HORM. We will use the tools in D:\ drive to build the image. The image will be configured to run on and protect the C:\ drive. 2. Open Target Designer 3. Click on File -> New and give the new configuration a name: Click OK and create the new configuration 6

7 4. Find Virtual PC Helper macro in the configuration browser pane by searching for virtual PC helper macro component 7

8 5. Drag and drop Virtual PC to the configuration editor pane: 8

9 6. Using the same search, and drag and drop method, add the following components to the Configuration Editor Pane: a. Background Disk Defragmentation Disable b. Enhanced Write Filter c. Enhanced Write Filter API (EWF API) d. EWF NTLDR e. EWF Manager Console Application f. NTFS g. NTFS Format h. Windows Logon i. English Language Support j. Explorer Shell k. Power Management Application l. CMD Windows Command Process m..net Framework 2.0 9

10 7. Configure Target Designer to automatically resolve dependencies by clicking Tools->Options. Choose Dependency Check tab and pick Auto-Resolve Dependencies. 8. Check dependencies for Virtual PC Helper Macro by clicking on Configuration-> Check Dependencies 10

11 9. We are now ready to configure EWF and HORM. Click on Advanced Configuration and Power Interface (ACPI) PC. Click Settings. The System Settings appear in the Details Pane. 10. Under Power Management Settings, click Show. The Power Management Settings are displayed. To enable system hibernation, select Enable hibernation support. 11

12 11. In Enhanced Write Filter configuration settings, check Enable Hibernate-Once-Resume-Many Mode. 12

13 12. Build the image by clicking on Configuration->Build Target Image. Click Yes on doing the dependency check. Close the dependency check window and the build will continue. The image will be saved under c:\windows Embedded Images by default. 13. Save the configuration and exit Target Designer. 13

14 14. We are now ready to change the boot.ini file on the directory that contains the embedded image to make the system dual boot. Open a shell command window, and edit the boot.ini file in D:\Windows Embedded Images. After modifications, the file should look like the following: 14

15 15. Copy all the content of D:\Windows Embedded Images to C:\ drive: 15

16 16. Now reboot the PC and on power up choose Windows XP Embedded partition. First Boot Agent (FBA) will execute and after 2 reboots, the system will come up in XP Embedded mode. Note that you have to select Microsoft Windows XP Embedded choice after each reboot. 16

17 Exercise 2: Exercising the EWFMGR command line interface to monitor and control HORM 1. Once the XP Embedded OS is up, open a command window 17

18 2. At the prompt, type ewfmgr. This command displays the state the EWF including the state of HORM support. 18

19 3. Hibernate the system, by clicking on Start -> Turn Off Computer and then select Hibernate. 19

20 4. After hibernation, the system will shut off. Turn it back on again and verify that you get to the state just before first hibernation. 5. Verify that restarting the system will result is restoring from hibernation over and over again. 20

21 6. De-activate HORM by typing ewfmgr c: -deactivatehorm 7. Verify that restarting the system will not result in restoring from hibernation. 21

22 Exercise 3: Exercising the EWF API interface to monitor and control HORM This exercise relies on an application written to interface with EWF API. In this lab we only run the application and we do compile/link the source code. The source code for this application is as follows: // EWFTestAPI.cpp : Defines the entry point for the console application. // #include "stdafx.h" #include <windows.h> #include <windef.h> #include <winbase.h> #include <winioctl.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #define EWFIMP #include "ewfapi.h" #include "ewfapip.h" // main body int _tmain(int argc, _TCHAR* argv[]) { HANDLE hsrcdevice = INVALID_HANDLE_VALUE; char * psz; int i; BOOL ret_status; PEWF_VOLUME_NAME_ENTRY pvolumenamelist = NULL; pvolumenamelist = EwfMgrGetProtectedVolumeList(); if (!pvolumenamelist) { printf("unable to find any protected volumes.\n"); goto done; } hsrcdevice = EwfMgrOpenProtected(pVolumeNameList->Name); if (hsrcdevice == INVALID_HANDLE_VALUE) { printf(("failed opening the protected volume %s with error %ld\n"), pvolumenamelist->name, GetLastError()); goto done; } 22

23 for (i = 1; i < argc; i++) { psz = (char *)argv[i]; if (*psz == '?') { goto usage; } else if (*psz == 'A') { printf("activating..."); ret_status = EwfMgrActivateHORM(hSrcDevice); if (ret_status) printf("passed\n"); else printf ("FAILED\n"); } else if (*psz == 'D') { printf("deactivating..."); ret_status = EwfMgrDeactivateHORM(hSrcDevice); if (ret_status) printf("passed\n"); else printf ("FAILED\n"); } else if (*psz == 'G') { printf("geting the state..."); ret_status = EwfMgIsHORMActivated(hSrcDevice); if (ret_status) printf("activated\n"); else printf ("Deactivated\n"); } } goto done; else goto usage; usage: printf ("USAGE: EWFTestAPI A: Activates HORM \n"); printf (" EWFTestAPI D: Deactivates HORM\n"); printf (" EWFTestAPI G: Returns the state of HORM (Activated, or Deactivated)\n"); done: if (hsrcdevice!= INVALID_HANDLE_VALUE) EwfMgrClose(hSrcDevice); // we're done with the handle if (pvolumenamelist) EwfMgrVolumeNameListDelete(pVolumeNameList); return 0; 23

24 } 24

25 1. Copy EWFTestAPI.exe application to the D:\ from C:\. 2. Boot into the XP Embedded partition. 3. Type EWFTestAPI? to get the usage. 4. Type EWFTestAPI G to get the state of HORM support. 5. Type EWFTestAPI A to activate HORM. Verify activation as you did in Exercise Type EWFTestAPI D to deactivate HORM. Verify deactivation as you did in Exercise 2. 25