Microsoft KB Archive/929984

= An update for Microsoft TV Foundation Edition Hybrid Edition 1.0.2 Server is available =

Article ID: 929984

Article Last Modified on 1/24/2007

-

APPLIES TO


 * Microsoft TV Foundation Edition Hybrid Edition 1.0.2

-



INTRODUCTION
An update for Microsoft TV Foundation Edition Hybrid Edition 1.0.2 Server is available. This update lets you deploy a managed application at the root level of the application lobby page.

When you install this update, you must modify the managed application's XML file to specify the &quot;root&quot; value for the Name attribute in the  node.



Update information
A supported feature that modifies the product's default behavior is now available from Microsoft, but it is only intended to modify the behavior that this article describes. Apply it only to systems that specifically require it. This feature may receive additional testing. Therefore, if the system is not severely affected by the lack of this feature, we recommend that you wait for the next release that contains this feature.

To obtain this feature immediately, contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

Prerequisites
There are no prerequisites for this update.

Restart requirement
You do not have to restart the computer after you install this update.

Update replacement information
This update does not replace any other software updates.

File information
The English version of this update has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

Installation information
To install this update, follow these steps:  Prepare the files for installation. To do this, follow these steps:  On all the application servers, copy the FEH1Server_1.0.2_QFE_126226patch.zip compressed file to the C:\MSTVSolution\QFEs\Zipped folder.

Note If the Zipped folder does not exist, create it. Extract all the files.  Install the update. To do this, follow these steps:  Start Microsoft Windows Explorer, and then locate the C:\MSTVSolution\QFEs\FEH1_1.0.2_QFE_126226Patch folder. In this folder, double-click the Install_QFE16226.bat file.</li> On the Resuming the Microsoft TV Server, Hybrid Setup Wizard page, click Install.</li> On the Completed the Microsoft TV Server, Foundation Edition Setup Wizard page, click Finish.</li></ol> </li> Bootstrap the server. To do this, follow these steps:  At a command prompt, run the following command:

cd C:\Program Files\Microsoft TV Foundation Edition Hybrid\bin Net Stop SNMP

</li> If the server is not optimized to use a domain user account instead of a local computer account, run the following command:

Bootstrap

Note Run this command if the installation is a default installation.

If the server is optimized to use a domain user account instead of a local computer account, run a command that resembles the following:

Bootstrap -p /Administrator  

Notes <ul>  is placeholder for the domain name.</li>  is a placeholder for the administrator password.</li> If you are not sure if the server is optimized, run the Bootstrap –p command on all the servers. After you install this update, the servers are optimized to use a domain user account.</li></ul>

After the process is complete in approximately 5 minutes, you receive the following message in the output area of the window:

Bootstrap succeeded.

</li> Run the following command:

Net start SNMP

</li></ol> </li> On all the application servers, repeat steps 1 through 3.</li> Verify that the installation was successful. To do this, follow these steps:   Modify the managed application's XML file to specify the &quot;root&quot; value for the Name attribute in the <Category> node.

Note In the documentation for the managed application, the managed application's XML file is known as the Managed Application Description File (MADF). The MADF has the same name as the managed application.

For example, the MADF for the Poker application is named the Poker.xml file. In the <Category> node of the Poker.xml file, change the value for the Name attribute from the &quot;Games&quot; value to the &quot;root&quot; value as follows:

Existing code

<Categories> <Category Name=&quot;Games&quot; /> </Categories>

Replacement code

<Categories> <Category Name=&quot;root&quot; /> </Categories> </li> Redeploy the managed application by using the Deploy Content tool. To do this, follow these steps: <ol> <li>On the application server that has the managed application files, start the Deploy Content tool. The DeployContent.exe file is in the &quot;C:\Program Files\Microsoft TV Foundation Edition Hybrid\Bin&quot; folder.</li> <li>At the Deploy Content command prompt, connect to the ILAppDelivery service, and then run the asset pushupdate command.

Note The Deploy Content command prompt is a greater than sign (>).

For example, run the following commands if the modified Poker.xml file is in the C:\MSTVSolution\ClientGUI\FEH1Apps\Poker folder:

connect http://localhost/ILAppDelivery/TargetingService.asmx

asset pushupdate Poker c:\MSTVSolution\ClientGUI\FEH1Apps\Poker

</li></ol>

Note These steps assume that you already read the &quot;Managed Application&quot; section of the Foundation_Edition_17_Hybrid.doc file or of the Help file.</li> <li>Test the installation. Before you can test the installation, the set-top box (STB) must download the changes. Therefore, use one of the following techniques to test the installation: <ul> <li>Periodically monitor the STB to confirm that it downloads the changes. Typically, the STB downloads the changes within 3 hours.</li> <li>Force the STB to download a new menu, the user interface, and the guide data by turning off the power and then turning on the power. Typically, this process takes about 5 minutes.</li></ul> </li></ol> </li></ol>

Rollback information
If the installation was unsuccessful, follow these steps: <ol> <li>Uninstall the update. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>Start Windows Explorer, and then locate the C:\MSTVSolution\QFEs\FEH1_1.0.2_QFE_126226Patch folder.</li> <li>In this folder, double-click the Uninstall_QFE16226.bat file.</li> <li>On the Resuming the Microsoft TV Server, Hybrid Setup Wizard page, click Install.</li> <li>On the Completed the Microsoft TV Server, Foundation Edition Setup Wizard page, click Finish.</li></ol> </li> <li>Bootstrap the server. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>At a command prompt, run the following command:

cd C:\Program Files\Microsoft TV Foundation Edition Hybrid\bin Net Stop SNMP

</li> <li>If the server is not optimized to use a domain user account instead of a local computer account, run the following command:

Bootstrap

If the server is optimized to use a domain user account instead of a local computer account, run a command that resembles the following:

Bootstrap -p /Administrator  

Notes <ul> <li> is placeholder for the domain name.</li> <li> is a placeholder for the administrator password.</li></ul>

After the process is complete in approximately 5 minutes, you receive the following message in the output area of the window:

Bootstrap succeeded.

</li> <li>Run the following command:

Net start SNMP

</li></ol> </li> <li>Verify that the update is uninstalled. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> <li>Restore the managed application's XML file to the original state. Specifically, replace the &quot;root&quot; value by using the original value for the Name attribute in the <Category> node.</li> <li>Follow step 5 from the &quot;Installation information&quot; section.</li></ol> </li></ol>

Keywords: kbinfo kbhowto KB929984

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.