From 9a2c78a9f892337fe79785101011f616ba69e044 Mon Sep 17 00:00:00 2001 From: Jan Prusinowski Date: Tue, 4 Jun 2024 09:14:54 +0200 Subject: [PATCH 1/3] docs/newcomers.md: Added Dasharo lab user guide and troubleshooting paragraphs Precomit fails due to a misspelled word in a link Signed-off-by: Jan Prusinowski --- docs/newcomers.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/docs/newcomers.md b/docs/newcomers.md index e34be1cff5..51ce5b724e 100644 --- a/docs/newcomers.md +++ b/docs/newcomers.md @@ -122,3 +122,58 @@ quick answers it's best to join our matrix space and talk to us there. If you've never used Matrix before, you will first need to get a client. Available clients are listed [here](https://matrix.org/clients/). + +## Dasharo lab user guide + +[**Test enviroment overview**](https://github.com/Dasharo/open-source-firmware-validation?tab=readme-ov-file#test-environment-overview) + +To get information about available platforms it's or it's RTE's IP address, use +the platform reservation tool: [SnipeIT](https://192.168.4.202/) + +[OSFV_CLI](https://github.com/Dasharo/osfv-scripts/tree/main/osfv_cli) is a script, +which allows to interact with devices setup in Dasharo OSFV lab. + +If the DUT has connected RTE you can refer to: [RTE +commands](https://github.com/Dasharo/osfv-scripts/blob/main/osfv_cli/README.md#rte-command), +also you may connect to the RTE by using web browser by typing: +`http://:8000`. For more please refer to: [RTE Quick Start +Guide](https://docs.dasharo.com/transparent-validation/rte/v1.1.0/quick-start-guide/). + +Default RTE login: `root`, password: `meta-rte` + +If the DUT uses PiKVM you may use: `https://`, for more info +refer to: +[PiKVM](https://docs.dasharo.com/transparent-validation/pikvm/assembly-and-validation/). + +Default PiKVM login: `admin`, password: `admin` + +Firmware source: [Dasharo +Universe](https://docs.dasharo.com/variants/protectli_vp2410/releases/) or +[Cloud](https://cloud.3mdeb.com/index.php/apps/files/?dir=/projects/dasharo/releases&fileid=297139) +(only for logged in users), alternatively newest builds can be found at [Github](https://github.com/Dasharo/coreboot/). + +## Troubleshooting + +**Connecting to RTE serial output: `Connection refused`** + +Most probably a telnet connection hasn't been closed correctly. To terminate +this connection restart RTE by logging to it by ssh and reboot it: + +`ssh root@rte_ip_address` + +password: meta-rte + +`systemctl restart ser2net` and then `logout` + +**DUT won't power on** + +1. Use the [OSFV CLI](https://github.com/Dasharo/osfv-scripts/tree/main/osfv_cli). +Check if Sonoff state is set to ON `osfv_cli sonoff --sonoff_ip + on` and power on the DUT `osfv_cli rte --rte_ip + pwr on` + +2. Check if a proper BIOS/firmware is flashed. If not a proper firmware can be + flashed with use of [OSFV + CLI](https://github.com/Dasharo/osfv-scripts/tree/main/osfv_cli) by running + `osfv_cli rte --rte_ip flash write --rom ` + command. From bdc0dcb3725f0f96711e13c970e6cbe36e15da79 Mon Sep 17 00:00:00 2001 From: Jan Prusinowski Date: Tue, 4 Jun 2024 12:29:05 +0200 Subject: [PATCH 2/3] Update docs/newcomers.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Piotr Król --- docs/newcomers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/newcomers.md b/docs/newcomers.md index 51ce5b724e..283d687b5e 100644 --- a/docs/newcomers.md +++ b/docs/newcomers.md @@ -125,7 +125,7 @@ Available clients are listed [here](https://matrix.org/clients/). ## Dasharo lab user guide -[**Test enviroment overview**](https://github.com/Dasharo/open-source-firmware-validation?tab=readme-ov-file#test-environment-overview) +[**Test environment overview**](https://github.com/Dasharo/open-source-firmware-validation?tab=readme-ov-file#test-environment-overview) To get information about available platforms it's or it's RTE's IP address, use the platform reservation tool: [SnipeIT](https://192.168.4.202/) From a7e51f71849f63421b3722501d3e297edae27d61 Mon Sep 17 00:00:00 2001 From: Jan Prusinowski Date: Mon, 8 Jul 2024 09:45:53 +0200 Subject: [PATCH 3/3] docs/newcomers.md: Added info about OSFV, starting 1st test and QEMU Signed-off-by: Jan Prusinowski --- docs/newcomers.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/newcomers.md b/docs/newcomers.md index 283d687b5e..35a9a79feb 100644 --- a/docs/newcomers.md +++ b/docs/newcomers.md @@ -152,6 +152,23 @@ Universe](https://docs.dasharo.com/variants/protectli_vp2410/releases/) or [Cloud](https://cloud.3mdeb.com/index.php/apps/files/?dir=/projects/dasharo/releases&fileid=297139) (only for logged in users), alternatively newest builds can be found at [Github](https://github.com/Dasharo/coreboot/). +Running tests: [Open Source Firmware Remote Test Environment](https://github.com/Dasharo/open-source-firmware-validation?tab=readme-ov-file#getting-started) +It is strongly suggested to run your first test on [QEMU](https://github.com/Dasharo/open-source-firmware-validation?tab=readme-ov-file#qemu-workflow). +To prepare Ubuntu OS image for QEMU refer to: [Ubuntu OS](https://github.com/Dasharo/preseeds?tab=readme-ov-file#ubuntu), +after downloading and creating image copy ```ubuntu.iso``` +to ```.../open-source-firmware-validation/qemu-data/``` +also create a drive onto which the os is going to be installed by running + +```qemu-img create -f qcow2 qemu-data/hdd.qcow2 20G``` + +run QEMU with: + +```./scripts/ci/qemu-run.sh graphic os_install``` + +To start QEMU so that it boots to os run: + +```./scripts/ci/qemu-run.sh graphic os``` + ## Troubleshooting **Connecting to RTE serial output: `Connection refused`** @@ -177,3 +194,10 @@ Check if Sonoff state is set to ON `osfv_cli sonoff --sonoff_ip CLI](https://github.com/Dasharo/osfv-scripts/tree/main/osfv_cli) by running `osfv_cli rte --rte_ip flash write --rom ` command. + +**Ubuntu won't download and create image** + +1. Download image from: [Ubuntu](https://ubuntu.task.gda.pl/ubuntu-releases/22.04.4/ubuntu-22.04.4-desktop-amd64.iso), +and use the script: + +```./ubuntu/create_image.sh -i ~/Downloads/ubuntu-22.04.4-desktop-amd64.iso```