readme.txt 3.66 KB
Newer Older
Kevin Kershaw's avatar
Kevin Kershaw committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82
File:        readme.txt
Author:      Nick Nielsen <n.nielsen@cablelabs.com>
Date:        Tue Jul 14 10:11:04 2009
Description: readme file for the CheckOutTool.  This actually combines two 
             existing readme files:  1. README.txt and 2. 'Checkout readme.txt'

==============================================================================

The Checkout Tool is an OCAP application that allows for debugging and 
troubleshooting of a tru2way network.  It parses and displays SI information, 
and can also act as a proxy to the TCT, which is a Windows application that 
does some more extensive parsing of DSG Tunnel packets.

The Checkout Tool is an UNBOUND application, which means that to be useful, it 
must run on a settop box that ignores the XAIT that is sent from the headend (on
a live plant).  Currently, CableLabs has been using an ADB settop box with a 
special code load that will ignore the XAIT and be able to load the application 
via the debug ethernet port.

Here are the requirements for a settop box running the Checkout Tool:
1.  Have a debug ethernet port, to use in loading code and forwarding proxy data
2.  Will ignore the XAIT on a live plant and continue to execute the Checkout 
    tool.
3.  Will forward all DSG packets received to its ethernet interface.

Requirements 1 and 3 are only truly required when using the Checkout Tool as a 
proxy for the TCT tool.

==============================================================================

To run the ADB exe's for downloading the CheckOutTool, you'll need to do the 
following:

1. Set your laptop's IP to 10.24.0.148, and connect crossover cable between 
laptop and ADB box.

2. Run proxy.bat -- this starts TCP listeners on ports 4444 and 4445.

3. To get debug output, telnet to localhost on port 4444, then type log.

4. Now boot up the ADB box -- you should see a bunch of log messages in the 
telnet window.

5. When box is finished booting (after 1 or 2 notifications about missing 
monitor app), the CheckOutTool can be downloaded.  To do this, cd to the 
checkouttool_dist folder, and run upload.bat.  The CheckOutTool will 
automatically launch after a few seconds.

==============================================================================

Here are the steps to run the Checkout Tool as a proxy for the TCT.

1.  Set laptop to static IP 10.24.0.148
2.  Run "proxy.bat" before booting STB 
3.  Run Tera Term with Host: set to localhost Telnet and TCP port# = 4444
4.  After Tera Term connects enter log (This will not show up on the Tera Term 
    screen)
5.  Connect PC to STB through crossover Ethernet cable 
6.  Apply power to STB and immediatly run the next step after the Ethernet 
    connection is established
7.  Run DHCP server "DHCP DualServer" before booting STB, using the 
    RunStandAlone.bat script.
8.  Validate on DualServer window that STB gets 10.24.0.50 
	 -- if not, modify the TCT launch bat file to reflect the correct IP in the 
       http.proxyHost property.
9.  Ensure the STB is set to send debug information to the laptop at 10.24.0.148
	 - Press Menu 3 times or until Main Menu comes up
	 - Select Installation
	 - Enter the Pin 1234
	 - Select Debug Setup
	 - Set Debug IP to 010.024.000.148
	 - Set Debug port to 04445
10. Wait for the Channel Banner to appear at the top of the screen and press 
    channel up several times
11. After STB boots completely, run "upload.bat" to load checkoutserver xlet 
12. Xlet should now be running -- choose "RunProxy" on the xlet -- proxy will 
    start.
13. Start the Truveiw Cable Tester application by running:
	 - "C:\Program Files\TruView Cable Tester\cabletester_modified.bat"