Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== B@D Reference Test Cases (5/5)======

These instructions provide some Example Tests and Test Cases you can use to validate your CIP Board-at-Desk Single-Developer (B@D) Virtual Machine (VM) or from which, you can learn how all of the tooling works together. 

This set of instructions assumes you have already connected the board to the machine where you have installed B@D. If that is not the case please go back to the [[beagleboneblackboard|Beaglebone Black Setup & Configuration wiki page]] or [[renesasboard|Renesas IWG20M]] depending on the board you are using, which is step 3.


It is also assumed you have already created an initramfs with BusyBox for the board, that is step 4. If that is not the case, please go back to the [[cipsystembuildhowto|wiki page where the creation is explained]].

If you have a kernel that you have built on another machine that you wish to test with B@D please refer to [[ciptestingreferencetestcases#test-6testing-externally-built-kernels|Test 6]].

// Note that if you are using the latest version of B@D with LAVA 2018-4 or greater (LAVA version is checkable by clicking the Help button and examining the header of that Help page) then see [[ciptestingreferencetestcases#LAVA-2018-4|Version specific information]] //

===== Test #1: Running the Health Check for the QEMU Device =====

==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine

==== Procedure: ====

1. On your host machine, open a web browser and enter the following in the address box:

''<nowiki>http://localhost:8080</nowiki>''

2. The LAVA Home Page is displayed in your web browser. Log in to the web server as the superuser:

   * Click the login link in the upper right-hand corner of the Lava Server website
   * Enter the username: **lavauser**
   * Enter the password: **mylava1234**

3. Click on **Scheduler** and then select **All Devices**.

4. Click on the **qemu01** Hostname

5. Click the **Force Health Check** button.

6. The results are displayed in the web page as the test runs. When the test is done, the status of the Job will show as **Complete** at the top of the page.

This is what the start of the Health Check looks like:

   lava-dispatcher, installed at version: 2018.4-2~bpo9+1
   start: 0 validate
   Start time: 2018-05-09 10:10:28.905849+00:00 (UTC)
   Validating that https://images.validation.linaro.org/kvm/standard/stretch-2.img.gz exists
   qemu-system-x86, installed at version: 1:2.8+dfsg-6+deb9u3
   validate duration: 0.15
   case: validate
   case_id: 1
   definition: lava
   result: pass
   start: 1 deployimages (timeout 00:05:00) [common]
   start: 1.1 download-retry (timeout 00:05:00) [common]
   start: 1.1.1 http-download (timeout 00:05:00) [common]
   downloading https://images.validation.linaro.org/kvm/standard/stretch-2.img.gz
   saving as /var/lib/lava/dispatcher/tmp/1/deployimages-vsmyq1ic/rootfs/stretch-2.img
 
   <snip>

This is what the end of a successful test looks like:

   </snip>
   start: 4 finalize (timeout 00:05:00) [common]
   start: 4.1 power-off (timeout 00:00:05) [common]
   end: 4.1 power-off (duration 00:00:00) [common]
   start: 4.2 read-feedback (timeout 00:05:00) [common]
   <LAVA_TEST_RUNNER>: exiting lava-test-runner
   Listened to connection for namespace 'common' for 1s
   Finalising connection for namespace 'common'
   end: 4.2 read-feedback (duration 00:00:01) [common]
   end: 4 finalize (duration 00:00:01) [common]
   Cleaning after the job
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/1/deployimages-vsmyq1ic/rootfs
   Root tmp directory removed at /var/lib/lava/dispatcher/tmp/1
   Job finished correctly
   case: job
   case_id: 10
   definition: lava
   result: pass
   

7. You can see an example of a successful test log file here:
{{ https://gitlab.com/snippets/1715971 | the QEMU Test results }}

----

===== Test #2: Building the CIP Kernel with Kernel CI =====

See [[cipsystembuildhowto#building-the-cip-kernel-with-kernel-ci|the build howto]] for the method.


----

===== Test #3: Running the Health Check for the Beaglebone Black Device =====

==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine
   * A Beaglebone Black that is powered up, connected to the LAN with an ethernet cable and connected to the host machine with an FTDI cable.
   * A locally built CIP kernel and initramfs.

==== Procedure: ====

1. Check the status of the (4) blue user LED's on the Beaglebone Black. If they are all off, manually reboot the board by pressing the reset button (S1) or disconnect and reconnect the power cable to the board.

2. On your host machine, open a web browser and enter the following in the address box:

''<nowiki>http://localhost:8080</nowiki>''

3. The LAVA Home Page is displayed in your web browser. Log in to the web server as the superuser:

   * Click the login link in the upper right-hand corner of the Lava Server website
   * Enter the username: **lavauser**
   * Enter the password: **mylava1234**

4. In a Vagrant ssh session change to the ''~/git-repos/linux-cip'' directory.

''vagrant@guest:~$ **cd ~/git-repos/linux-cip**''


5. Set the TREE_NAME environment variable.

'' vagrant@guest:~/git-repos/linux-cip$ **export TREE_NAME=cip-example** ''

// Note: This must be the same name you used when you built the kernel. //

6. Create a test - from within the ''linux-cip'' git repository. 

'' vagrant@guest:~/git-repos/linux-cip$ **/vagrant/scripts/create_test.sh /vagrant/tests/bbb_debian_local.yaml ~/mytest-bbb.yaml**''

// Note: ''create_test.sh'' must be run in the ''linux-cip'' directory so that the script can retrieve the git settings. //

// Note: ''mytest-bbb.yaml'' is an example filename. Substitute your own test file name in its place. //

7. Replace the current health check (see [[ciptestingboardatdesksingledevsetup#configure-the-lava-health-check-jobs-for-your-devices|Health Check configuration]] for the location of the health check) with the contents of the yaml file you generated in the previous step.

8. Click on **Scheduler** and then select **All Devices**.

9. Click on the **bbb01** Hostname

10. Click the **Force Health Check** button.

11. The results are displayed in the web page as the test runs. When the test is done, the status of the Job will show as **Complete** at the top of the page.

This is what the start of the Health Check looks like:

   lava-dispatcher, installed at version: 2018.4-2~bpo9+1
   start: 0 validate
   Start time: 2018-05-10 12:14:13.326013+00:00 (UTC)
   Validating that http://localhost:8010/initramfs/initramfs.cpio.gz exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/zImage exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/dtbs/am335x-boneblack.dtb exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/modules.tar.xz exists
   validate duration: 0.02
   case: validate
   case_id: 128
   definition: lava
   result: pass
   start: 1 tftp-deploy (timeout 00:04:00) [common]
   start: 1.1 download-retry (timeout 00:04:00) [common]
   start: 1.1.1 http-download (timeout 00:04:00) [common]
   Not decompressing ramdisk as can be used compressed.
   downloading http://localhost:8010/initramfs/initramfs.cpio.gz
   saving as /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk/initramfs.cpio.gz
   <snip>

This is what the end of a successful test looks like:

   </snip>
   Finalising connection for namespace 'common'
   end: 4.2 read-feedback (duration 00:00:01) [common]
   end: 4 finalize (duration 00:00:01) [common]
   Cleaning after the job
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/kernel
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/dtb
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/modules
   Override tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Root tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Job finished correctly
   case: job
   case_id: 142
   definition: lava
   result: pass



// Note: After running the health check, if the (4) user LED's are all off, manually reboot the board by pressing the reset button (S1) or disconnect and reconnect the power cable to the board before re-running the health check.//

12. You can see an example of a successful test log file [[ https://gitlab.com/snippets/1715994 | the Beaglebone Black Test results ]]. 

----


===== Test #4: Testing the CIP Kernel on the Beaglebone Black =====

==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine
   * A Beaglebone Black that is powered up, connected to the LAN with an ethernet cable and connected to the host machine with an FTDI cable.
   * A locally built CIP kernel and initramfs.
==== Procedure: ====

1. Check the status of the (4) blue user LED's on the Beaglebone Black. If they are all off, manually reboot the board by pressing the reset button (S1) or disconnect and reconnect the power cable to the board.

2. On your host machine, open a web browser and enter the following in the address box:

''<nowiki>http://localhost:8080</nowiki>''

3. The LAVA Home Page is displayed in your web browser. Log in to the web server as the superuser:

   * Click the login link in the upper right-hand corner of the Lava Server website
   * Enter the username: **lavauser**
   * Enter the password: **mylava1234**

4. From the LAVA homepage, click on **Scheduler** and **Submit Job** 

5. Copy the contents of the ''/vagrant/tests/bbb_debian_ramdisk_test.yaml'' and paste them into the job definition box on the Submit Job page.

6. Modify the job's "Action Block" to include the paths to the files generated by Kernel CI.
 
   * Modify the kernel url to point to the zImage file link 
         * The link will look like: <nowiki>http://localhost:8010/cip-example/cip_v4.4.83/v4.4.83-cip8/arm/omap2plus_defconfig/zImage</nowiki>

      * Modify the modules url to point to the modules.tar.xz file link and change the compression type to "xz".
         * The link will look like: <nowiki>http://localhost:8010/cip-example/cip_v4.4.83/v4.4.83-cip8/arm/omap2plus_defconfig/modules.tar.xz</nowiki>
   
      * Modify the dtb url to point to the Beaglebone Black's dtb file link
         * The link will look like: <nowiki>http://localhost:8010/cip-example/cip_v4.4.83/v4.4.83-cip8/arm/omap2plus_defconfig/dtbs/am335x-boneblack.dtb</nowiki>

7. Click on the **Validate** button under the job definition box to make sure the syntax of the job is correct.

8. Click the **Submit** button. You will then be taken to the page showing the log as it runs.

9. When the test is done, the status of the Job will show as **Complete** at the top of the page (if successful).

This is what the start of the Health Check looks like:

   lava-dispatcher, installed at version: 2018.4-2~bpo9+1
   start: 0 validate
   Start time: 2018-05-10 12:14:13.326013+00:00 (UTC)
   Validating that http://localhost:8010/initramfs/initramfs.cpio.gz exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/zImage exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/dtbs/am335x-boneblack.dtb exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/modules.tar.xz exists
   validate duration: 0.02
   case: validate
   case_id: 128
   definition: lava
   result: pass
   start: 1 tftp-deploy (timeout 00:04:00) [common]
   start: 1.1 download-retry (timeout 00:04:00) [common]
   start: 1.1.1 http-download (timeout 00:04:00) [common]
   Not decompressing ramdisk as can be used compressed.
   downloading http://localhost:8010/initramfs/initramfs.cpio.gz
   saving as /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk/initramfs.cpio.gz
   <snip>

This is what the end of a successful test looks like:

   </snip>
   Finalising connection for namespace 'common'
   end: 4.2 read-feedback (duration 00:00:01) [common]
   end: 4 finalize (duration 00:00:01) [common]
   Cleaning after the job
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/kernel
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/dtb
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/modules
   Override tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Root tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Job finished correctly
   case: job
   case_id: 142
   definition: lava
   result: pass


===== Test #5: Running the Health Check for the Renesas IWG20M Device =====

==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine
   * An IWG20M that is powered up, connected to the LAN with an ethernet cable and connected to the host machine with a USB cable.
   * A locally built CIP kernel and initramfs.
   * A Remote Power on Switcher - see [[renesasboard|Renesas IWG20M]] for these details.

==== Procedure: ====



1. On your host machine, open a web browser and enter the following in the address box:

''<nowiki>http://localhost:8080</nowiki>''

2. The LAVA Home Page is displayed in your web browser. Log in to the web server as the superuser:

   * Click the login link in the upper right-hand corner of the Lava Server website
   * Enter the username: **lavauser**
   * Enter the password: **mylava1234**

3. In a Vagrant ssh session change to the ''~/git-repos/linux-cip'' directory.

''vagrant@guest:~$ **cd ~/git-repos/linux-cip**''


4. Set the TREE_NAME environment variable.

'' vagrant@guest:~/git-repos/linux-cip$ **export TREE_NAME=cip-example** ''

// Note: This must be the same name you used when you built the kernel. //

5. Create a test - from within the ''linux-cip'' git repository. 

'' vagrant@guest:~/git-repos/linux-cip$ **/vagrant/scripts/create_test.sh /vagrant/tests/iwg20m-test-ramdisk.yaml ~/mytest-iwg20m.yaml**''

// Note: ''create_test.sh'' must be run in the ''linux-cip'' directory so that the script can retrieve the git settings. //

// Note: ''mytest-iwg20m.yaml'' is an example filename. Substitute your own test file name in its place. //

6. Replace the current health check (see [[ciptestingboardatdesksingledevsetup#configure-the-lava-health-check-jobs-for-your-devices|Health Check configuration]] for the location of the health check) with the contents of the yaml file you generated in the previous step.

7. Click on **Scheduler** and then select **All Devices**.

8. Click on the **iwg20m01** Hostname

9. Click the **Force Health Check** button.

10. The results are displayed in the web page as the test runs. When the test is done, the status of the Job will show as **Complete** at the top of the page.

This is what the start of the Health Check looks like:

   lava-dispatcher, installed at version: 2018.4-2~bpo9+1
   start: 0 validate
   Start time: 2018-05-17 12:20:24.171357+00:00 (UTC)
   Validating that http://localhost:8010/initramfs/initramfs.cpio.gz exists
   Validating that http://localhost:8010/cip-checks/cip_v4.4.126/v4.4.126-cip22/arm/shmobile_defconfig/zImage exists
   Validating that http://localhost:8010/cip-checks/cip_v4.4.126/v4.4.126-cip22/arm/shmobile_defconfig/dtbs/r8a7743-iwg20d-q7.dtb exists
   Specifying a type in the boot action is deprecated. Please specify the kernel type in the deploy parameters.
   validate duration: 0.02
   case: validate
   case_id: 114
   definition: lava
   result: pass
   start: 1 tftp-deploy (timeout 00:05:00) [common]
   start: 1.1 download-retry (timeout 00:05:00) [common]
   start: 1.1.1 http-download (timeout 00:05:00) [common]
   Not decompressing ramdisk as can be used compressed.
   downloading http://localhost:8010/initramfs/initramfs.cpio.gz
   saving as /var/lib/lava/dispatcher/tmp/9/tftp-deploy-ge8cmxso/ramdisk/initramfs.cpio.gz
   total size: 5813656 (5MB)
   <snip>

This is what the end of a successful test looks like:

   </snip>
   Finalising connection for namespace 'common'
   end: 4.2 read-feedback (duration 00:00:01) [common]
   end: 4 finalize (duration 00:00:01) [common]
   Cleaning after the job
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/9/tftp-deploy-ge8cmxso/ramdisk
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/9/tftp-deploy-ge8cmxso/kernel
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/9/tftp-deploy-ge8cmxso/dtb
   Override tmp directory removed at /var/lib/lava/dispatcher/tmp/9
   Root tmp directory removed at /var/lib/lava/dispatcher/tmp/9
   Job finished correctly
   case: job
   case_id: 127
   definition: lava
   result: pass




11. You can see an example of a successful test log file [[ https://gitlab.com/snippets/1716407 | the Renesas IWG20M Test results ]]. 

----

===== Test #6: Use lava-tool utility =====

Note that lava-tool is deprecated so, in preference, set up and use lavacli see [[ciptestingreferencetestcases#test-7use-lavacli-utility|lavacli instructions]].

==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine
   * A Beaglebone Black or a Renesas IWG20M board that is powered up, connected to the LAN with an ethernet cable and connected to the host machine with an FTDI cable.
   * A built kernel for the appropriate board (see Test #3 or #5 depending upon your board)
   * The board has a current successful health check (it is marked as online in LAVA)

==== Procedure: ====

1. On the Virtual machine change to the ''~/git-repos/linux-cip'' directory.

''vagrant@guest:~$ **cd ~/git-repos/linux-cip**''

2. //If you have not already done so//, you will need to create an authentication token
    In the LAVA web interface, click on API->Authentication Tokens and then on the 'new' button, 
    give it a description and then click the 'View Token Hash' button and copy the displayed hash value.
    Then: 
'' vagrant@guest:~/git-repos/linux-cip$ **lava-tool auth-add http://lavauser@localhost:8080/RPC2** ''

    Paste token for http://lavauser@localhost:8080/RPC2/: **paste token - which will not be echoed**


3. Set the TREE_NAME environment variable.

'' vagrant@guest:~/git-repos/linux-cip$ **export TREE_NAME=cip-example** ''

// Note: This must be the same name you used when you built the kernel. //

4. Create a test for use with the ''lava-tool'' utility from within the ''linux-cip'' git repository. 

'' vagrant@guest:~/git-repos/linux-cip$ **/vagrant/scripts/create_test.sh /vagrant/tests/bbb_debian_local.yaml ~/mytest-board.yaml**''
- if you are using the Renesas IWG20M use /vagrant/tests/iwg20m-test-ramdisk.yaml as the second parameter!

// Note: ''create_test.sh'' must be run in the ''linux-cip'' directory so that the script can retrieve the git settings. //

// Note: ''mytest-board.yaml'' is an example filename. Substitute your own test file name in its place. //

5. Run the ''lava-tool command'' to submit the job to LAVA. 

'' vagrant@guest:~/git-repos/linux-cip$ **<nowiki>lava-tool submit-job http://lavauser@localhost:8080/RPC2 ~/mytest-bbb.yaml</nowiki>**''
    submitted as job: http://localhost:8080/scheduler/job/12


// Note: Please see the LAVA documentation for help [[https://validation.linaro.org/static/docs/v2/developing-tests.html|writing tests]] in LAVA, //

6. On your host machine, open a web browser and navigate to the LAVA Website:

''**<nowiki>http://localhost:8080</nowiki>**''

7. Click on the Scheduler menu and select the All Jobs option.

8. Click on the View Job Results icon for the top job to watch the build.

9. The results are displayed in the web page as the test runs. When the test is done, the status of the Job will show as **Complete** at the top of the page.

This is an example what the start of the test looks like in the Beaglebone case:

   lava-dispatcher, installed at version: 2018.4-2~bpo9+1
   start: 0 validate
   Start time: 2018-05-10 12:14:13.326013+00:00 (UTC)
   Validating that http://localhost:8010/initramfs/initramfs.cpio.gz exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/zImage exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/dtbs/am335x-boneblack.dtb exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/modules.tar.xz exists
   validate duration: 0.02
   case: validate
   case_id: 128
   definition: lava
   result: pass
   start: 1 tftp-deploy (timeout 00:04:00) [common]
   start: 1.1 download-retry (timeout 00:04:00) [common]
   start: 1.1.1 http-download (timeout 00:04:00) [common]
   Not decompressing ramdisk as can be used compressed.
   downloading http://localhost:8010/initramfs/initramfs.cpio.gz
   saving as /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk/initramfs.cpio.gz
   <snip>

This is what the end of a successful test looks like:

   </snip>
   Finalising connection for namespace 'common'
   end: 4.2 read-feedback (duration 00:00:01) [common]
   end: 4 finalize (duration 00:00:01) [common]
   Cleaning after the job
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/kernel
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/dtb
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/modules
   Override tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Root tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Job finished correctly
   case: job
   case_id: 142
   definition: lava
   result: pass


// Note: After running the test, if the (4) user LED's are all off, manually reboot the board by pressing the reset button (S1) or disconnect and reconnect the power cable to the board before re-running the test.//

10. You can see an example of a successful test log file [[https://gitlab.com/snippets/1715994| the Beaglebone Black Test results ]]. 

===== Test #7: Use lavacli utility =====
==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine
   * A Beaglebone Black or a Renesas IWG20M board that is powered up, connected to the LAN with an ethernet cable and connected to the host machine with an FTDI cable.
   * A built kernel for the appropriate board (see Test #3 or #5 depending upon your board)
   * The board has a current successful health check (it is marked as online in LAVA)

==== Procedure: ====

1. On the Virtual machine change to the ''~/git-repos/linux-cip'' directory.

''vagrant@guest:~$ **cd ~/git-repos/linux-cip**''

2. If you have not done so you will need to install lavacli:

''vagrant@guest:~$ **sudo apt install lavacli** ''

''vagrant@guest:~$ ** mkdir ~/.config** ''

3. //If you have not already done so//, you will need to create an authentication token
    In the LAVA web interface, click on API->Authentication Tokens and then on the 'new' button, 
    give it a description and then click the 'View Token Hash' button and copy the displayed hash value.
    Then: 
'' vagrant@guest:~/git-repos/linux-cip$ **<nowiki>lavacli identities add --token <paste token here> --uri http://localhost:8080/RPC2 --username lavauser boardAtDesk</nowiki>** ''


4. Set the TREE_NAME environment variable.

'' vagrant@guest:~/git-repos/linux-cip$ **export TREE_NAME=cip-example** ''

// Note: This must be the same name you used when you built the kernel. //

5. Create a test for use with the ''lava-tool'' utility from within the ''linux-cip'' git repository. 

'' vagrant@guest:~/git-repos/linux-cip$ **/vagrant/scripts/create_test.sh /vagrant/tests/bbb_debian_local.yaml ~/mytest-board.yaml**''
- if you are using the Renesas IWG20M use /vagrant/tests/iwg20m-test-ramdisk.yaml as the second parameter!

// Note: ''create_test.sh'' must be run in the ''linux-cip'' directory so that the script can retrieve the git settings. //

// Note: ''mytest-board.yaml'' is an example filename. Substitute your own test file name in its place. //

6. Run the ''lavacli command'' to submit the job to LAVA. 

'' vagrant@guest:~/git-repos/linux-cip$ **<nowiki>lavacli -i boardAtDesk jobs submit ~/mytest-bbb.yaml</nowiki>**''
    // a job number will be echoed //


// Note: Please see the LAVA documentation for help [[https://validation.linaro.org/static/docs/v2/developing-tests.html|writing tests]] in LAVA, //

7. On your host machine, open a web browser and navigate to the LAVA Website:

''**http://localhost:8080**''

8. Click on the Scheduler menu and select the All Jobs option.

9. Click on the View Job Results icon for the top job to watch the build.

10. The results are displayed in the web page as the test runs. When the test is done, the status of the Job will show as **Complete** at the top of the page.

This is an example what the start of the test looks like in the Beaglebone case:

   lava-dispatcher, installed at version: 2018.4-2~bpo9+1
   start: 0 validate
   Start time: 2018-05-10 12:14:13.326013+00:00 (UTC)
   Validating that http://localhost:8010/initramfs/initramfs.cpio.gz exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/zImage exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/dtbs/am335x-boneblack.dtb exists
   Validating that http://localhost:8010/cip-test/cip_v4.4.126/v4.4.126-cip22/arm/omap2plus_defconfig/modules.tar.xz exists
   validate duration: 0.02
   case: validate
   case_id: 128
   definition: lava
   result: pass
   start: 1 tftp-deploy (timeout 00:04:00) [common]
   start: 1.1 download-retry (timeout 00:04:00) [common]
   start: 1.1.1 http-download (timeout 00:04:00) [common]
   Not decompressing ramdisk as can be used compressed.
   downloading http://localhost:8010/initramfs/initramfs.cpio.gz
   saving as /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk/initramfs.cpio.gz
   <snip>

This is what the end of a successful test looks like:

   </snip>
   Finalising connection for namespace 'common'
   end: 4.2 read-feedback (duration 00:00:01) [common]
   end: 4 finalize (duration 00:00:01) [common]
   Cleaning after the job
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/ramdisk
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/kernel
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/dtb
   Cleaning up download directory: /var/lib/lava/dispatcher/tmp/11/tftp-deploy-pozjv6jf/modules
   Override tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Root tmp directory removed at /var/lib/lava/dispatcher/tmp/11
   Job finished correctly
   case: job
   case_id: 142
   definition: lava
   result: pass


// Note: After running the test, if the (4) user LED's are all off, manually reboot the board by pressing the reset button (S1) or disconnect and reconnect the power cable to the board before re-running the test.//

11. You can see an example of a successful test log file [[https://gitlab.com/snippets/1715994| the Beaglebone Black Test results ]]. 


===== Test #8: Testing Externally Built Kernels =====
==== Prerequisites: ====

   * A working CIP Board-at-Desk Single-Developer (B@D) Virtual Machine
   * A board on which to test that kernel.
   * A defined device and device dictionary for the new device. Copy the dictionary entry into /etc/lava-server/dispatcher-config/devices (see /vagrant/integration-scripts/configure_lava.sh for examples).

==== Procedure: ====

   * Copy the kernel associated files and ramdisk onto the Virtual Machine. This can be done either by putting the files in a subdirectory of board-at-desk-single-dev in which case they will end up as a subdirectory of /vagrant. Or use  
<code>         vagrant scp $PATH_TO/kernelFiles.tgz :kernelFiles.tgz  </code> 
   * Move the files into a single directory within /var/www/images/kernel-ci. So, for example, if testing the Renesas iwg20m, create /var/www/images/kernel-ci/renesas/iwg20m.
   * Then in your health check reference the files as <nowiki>http://localhost/renesas/iwg20m/uImage</nowiki> etc..
 

----
===== LAVA 2018-4 =====
With this version of LAVA, in the above test cases, replace any of the following sequences:

>  Click on Scheduler and then select All Devices.

>  Click on the BoardName Hostname

>  Click the Force Health Check button.

With:
   In Administration scroll down to Devices and select it, tick the appropriate device and then in the Action pull down select 'Update health of selected devices to Unknown' and click the 'Go' button.
   
If a test file has been generated and you wish to replace the default health check then copy it as below:
   
   vagrant@guest:~$ sudo cp testFileName.yaml /etc/lava-server/dispatcher-config/health-checks/DeviceName.yaml
   
So for the supported devices replace DeviceName with beaglebone-black.yaml or renesas-iwg20m.yaml as appropriate.

If you wish to just test then use the [[ciptestingreferencetestcases#test-7use-lavacli-utility|lavacli instructions]], replacing the file with your appropriate test.
----

Return to the B@D [[ciptestingboardatdesksingledevfeaturepage|feature page]]
Wiki

User Tools

Site Tools

Page Tools
