home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / w017ast.zip / W017AST.DSK / DBSETUP.TXT < prev    next >
Text File  |  1994-08-12  |  7KB  |  132 lines
  1.      PREPARING FOR REMOTE DEBUG:
  2.  
  3. Terms:
  4.     MUT:  Machine Under Test - Machine with failure that is being debugged.
  5.     DEBUG SYSTEM - System that is initiating the debug session at the
  6.                    remote site and examining the failure on the MUT.
  7.  
  8. You need:
  9.  
  10. 1. An appropriate cable to connect the modem to your system's com port.
  11.  
  12. 2. A 2400 baud or higher Hayes-compatible modem, which can be either
  13.    internal or external.  An external modem is preferred so that the user
  14.    can monitor the lights while the remote site is connecting and reset
  15.    the modem without affecting the MUT.  A 9600 baud modem is preferred.
  16.    Lower than 2400 baud can be used by special arrangement.
  17.  
  18. 3. Two phone lines, one is the voice or talk line, the other is for your modem.
  19.    The modem phone line should be an analog line or a digital
  20.    phone with an acoustic coupler.  It MUST not have an answering machine or
  21.    voicemail connected to it.  It also should not go through a
  22.    switchboard that requires further dialing.  If there is a live
  23.    operator, special arrangements can be made.  It must be a line that
  24.    only rings in one location.
  25.  
  26. The following instructions will assist you when you work together with your
  27. analyst to set up and establish communications with the remote debug host. The
  28. instructions must be followed EXACTLY.  The instructions are space dependent
  29. and something so trivial as an extra carriage return can keep your system from
  30. booting.
  31.  
  32. Follow these steps:
  33.  
  34. 1.  Connect the cable from the com port to the modem. You should use COM2
  35.     if you have two or more com ports on your system.  If there is no COM2,
  36.     attach cable to COM1.  If you have at least two COM ports and absolutely
  37.     need to use COM1, be sure to choose the appropriate COM1 settings in the
  38.     KDB.INI, as described below in step #4. COM3 and higher are not supported
  39.     for doing a remote debug.  If using 1.3 and you have two com ports, COM2
  40.     MUST be used for the debug session.  COM1 can ONLY be used if the
  41.     system has only 1 communications port.
  42.  
  43. 2.  The debug kernel defaults to 9600. The KDB.INI file can change the speed
  44.     at which the kernel communicates with the modem.  The modem of the MUT
  45.     must be able to be set to the same speed as the modem of the remote site.
  46.  
  47. 3.  Put the kernel debugger install diskette in your diskette drive. At an
  48.     OS/2 Window or Full screen prompt, type "a:install" (or b:install, as
  49.     appropriate). You should be in the root directory of your boot drive
  50.     (normally the default directory of the OS/2 Command Prompt icon).
  51.  
  52. 4.  If you need to change the com port or baud rate, or if the analyst has
  53.     commands that need to be set on every bootup, you must set up a KDB.INI
  54.     file. This MUST be done live and MUST NOT be done with an editor.  Type
  55.     the following after you finish with the above install.
  56.  
  57.             NOTE:  <enter> means hit enter, ¬ indicates a necessary space
  58.      copy¬con¬kdb.ini <enter>
  59.      .b¬2400t¬1 <enter>            (Enter a "dot" in front of the "b")
  60.                                    (Replace 1 with 2 if modem is on com2 and
  61.                                     the 2400 with whatever speed you need.)
  62.  
  63.      <your analyst may insert more commands here, such as "vsf *">
  64.  
  65.      g          <F6 key>   <enter>            (File closes.)
  66.      (note that some people have reported problems if you hit enter before
  67.       hitting F6)
  68.  
  69. 5. Type the following at the command line to see if the system recognizes the
  70.    modem:
  71.      mode com1  <enter>            (Or com2.  You will see baud rate,
  72.                                     parity, etc. listed.)
  73.  
  74.    If you receive an error message, verify that you have the comm driver
  75.    loaded in the config.sys.
  76.                DEVICE=C:\OS2\COM02.SYS (1.3 microchannel systems)
  77.                DEVICE=C:\OS2\COM01.SYS (1.3 AT BUS systems)
  78.                DEVICE=C:\OS2\COM.SYS (2.x systems)
  79.  
  80.    *Note that you do not have to have the COM device driver installed once 
  81.     you are done setting up your modem. Also note that the COM.SYS supplied
  82.     with 2.1 GA requires that DOS support (including VCOM.SYS) be active.
  83.     No other version has this requirement. This is APAR PJ08728.
  84.  
  85. 6. Refer to the accompanying Modemset.txt file to see whether we have any
  86.    known DIP switch settings for your modem.
  87.  
  88. 7. Type "t <enter>". This will pull up the T.exe that got installed with the
  89.    kernel debug package. The default is com1/9600 baud. If this does not
  90.    match your modem/port setup, hit F2 twice. You can now change COM port
  91.    and speed. Hit Enter to return to the main screen. If you type AT<enter>
  92.    you should get back an OK. If not, go back into the setup screen and see if
  93.    changing Handshaking from Xon/Xoff to  Hardware helps.  If not, you will
  94.    need to fix your modem, cable, or whatever -- OS/2 support cannot help.
  95.    Once you get OK back when you type AT<enter>, refer to the accompanying
  96.    Modemset.txt file for AT commands for your modem.
  97.  
  98.    *Note: there is currently a bug in T.exe such that it cannot access com2 if
  99.     a mouse is on com1. If this is true for you, you must either use your
  100.     own com package (such as PROCOMM) to set up the modem or move your mouse
  101.     to use com2.
  102.  
  103. 8. Now you are ready to call your analyst so that he/she may dial in and
  104.    test your link before you recreate the failure.  If you do not have his/her
  105.    phone number, you can open a secondary call by calling 1 800-992-4777
  106.    with the PMR #. The analyst will return your call.
  107.  
  108. 9. Do an orderly shutdown and reboot to activate the debugger.
  109.  
  110. 10. Analyst now dials in.  You should arrange to do a dialin before the
  111.     problem occurs, if possible, to make sure everything is properly set up.
  112.  
  113. ----------------------------------------------------------------
  114.  
  115. PREPARING FOR LOCAL DEBUG:
  116.  
  117. Follow through step 4 above.
  118.  
  119. 1. Reboot the MUT.  You should see the kernel's signon at the debug terminal.
  120.    You should see the message, "Symbols linked" on the screen.  Do not proceed
  121.    until this step is successful.
  122.  
  123. 2. When the MUT has completed booting, press control-C at the debug terminal.
  124.    You should see a register dump and a # prompt.  The debug kernel has stopped
  125.    the OS/2 machine under test (MUT);therefore, the MUT will appear to be dead.
  126.  
  127. 3. Press G (the debug kernel command for GO) and press enter.  Activity at the
  128.    MUT will resume.
  129.  
  130.  
  131.  
  132.