alfano:/var/lib/openqa/tests/kubic/products/kubic/:[0]# tree
.
|-- main.pm
|-- needles -> ../opensuse/needles
`-- testsuites
    |-- microos_10G.pm
    |-- microos.pm
    |-- microos_uefi.pm
    `-- rcshell.pm




The triggering from main.pm looks like this:

if (jobgroup 'Tumbleweed kubic-dvd') {
    microos::run_tests      if testsuite('microos@64bit-4G-HD40G');
    microos_uefi::run_tests if testsuite('microos@uefi-4G-HD40G');
    microos_10G::run_tests  if testsuite('microos_10G-disk');
    rcshell::run_tests      if testsuite('rcshell');
}


The testsuite strings are the same ones used in web-UI (e.g. https://openqa.opensuse.org/tests/overview?distri=kubic&distri=opensuse&version=Tumbleweed&build=20181105&groupid=1)



Adding a new testsuite:

WebUI
1. Go to webui and add a new testsuite.
2. Go to webui and add it to Tumbleweed Kubic-dvd jobgroup

Code
1. Create a new file with the name of the testsuite (e.g. /var/lib/openqa/tests/kubic/products/kubic/testsuites/mytestsuite.pm) and load your tests there under the 'run_test' subroutine. 

2. Include this file to main.pm (mytestsuite.pm)

3. At the 'testsuite' subroutine define 'when' you want this to get triggered

4. Finally trigger it under the correct jobgroup
e.g. mytestsuite::run_tests  if testsuite('mytestsuite');