Running Diagnostics With Target

From STRIDE Wiki
Jump to navigation Jump to search

This article describes how to run the built-in STRIDE diagnostics with your target device. It assumes that your have completed the steps described in the article Build Integration.

Running STRIDE Diagnostics

To execute the diagnostic tests, use a Windows or Linux host computer that has connectivity with the target system via your configured STRIDE transport (TCP/IP or serial). Additionally, make the generated STRIDE database (.sidb) visible to the host computer via a shared filesystem or a file copy to the host system.

If not already present, install the appropriate STRIDE Framework package on the host computer.

Start the target app running on the target hardware, then run stride as follows:

stride --diagnostics --database=<path>/stride.sidb --device=<device_address> --run="*"

Specify your database and device options as required.

Interpreting Diagnostic Results

Upon running, the host console running stride will display summary test results:

Loading database...
Connecting to device...
  runtime version: 4.2.0x 
Diagnosing target application...
  script "diagnostics.pl"
    > 3 passed, 0 failed, 0 in progress, 0 not in use.
  test unit "Link"
    Loopback ............
    Payload Fragmentation
    Stub-Proxy Deadlock
    Target Characteristics
    > 4 passed, 0 failed, 0 in progress, 0 not in use.
  test unit "Stat"
    > 2 passed, 0 failed, 0 in progress, 0 not in use.
  test unit "Time"
    > 2 passed, 0 failed, 0 in progress, 0 not in use.
  --------------------------------------------------------------------- 
  Summary: 11 passed, 0 failed, 0 in progress, 0 not in use.

Disconnecting from device...
Saving result file...

Once the test run is complete, you will see the files stride.xml (result name defaults to same as database name) and, if you were connected to the Internet when you ran the tests, stride.xsl in the directory from which you ran stride.

By opening stride.xml in a web browser, the xsl is automatically applied to create html in the browser.

All tests should pass.

Publishing Results

Optionally, if you have Internet connectivity and access to your company's Test Space[1] you could run again the diagnostics and upload the results by submitting the following command line parameters to stride:

--diagnostics
--run "*"
--database <path>/stride.sidb --device=<device_address> 
--testspace https://<user>:<pwd>@<mycompany>.stridetestspace.com 
--project Sandbox 
--space MySpaceName 
--upload

Notes

  1. You need to have an account with access to a dedicated project and space created by your Test Space administrator