Skip to content

docs: dts-tests.md: add custom iPXE server manual #933

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion docs/dts-tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,9 @@ Control variables:

* `dts_ipxe_link`: useful if you are testing DTS which is not released yet. Just
put here a link to your script which will load your DTS. By default DTS is
being booted from `dl.3mdeb.com`;
being booted from `dl.3mdeb.com`. Check [the following
chapter](#http-server-with-dts-ipxe-boot) for information on how to set up a
custom HTTP iPXE server with DTS.
* `dpp_email`, `dpp_password`: for DPP credentials, if tests need them.

Launching example:
Expand All @@ -44,6 +46,18 @@ robot -b command_log.txt -v snipeit:no -L TRACE -v config:qemu -v rte_ip:127.0.0
> `http://192.168.0.102:8080/ipxe` with your DTS iPXE
> script link.

### HTTP server with DTS iPXE boot

Use [the automation script](https://github.com/Dasharo/open-source-firmware-validation/blob/develop/scripts/ci/ipxe-run.sh)
to prepare an iPXE server with a custom DTS image. After that the `dts.ipxe` can
be used via iPXE shell to boot the DTS image:

```text
chain http://IP:4321/dts.ipxe
```

Where IP is the IP address of the machine where the HTTP server is launched.

## Unit tests

These tests have not been implemented yet.