Installing a target system and adding it to the controller
Select Machine name and Partition ID
Every target machine in GNOME Hardware Testing should have a unique name. The name is arbitrary, but the convention being used is classical composers (brahms, vivaldi, etc.) (Reasoning: it's clear that the name is arbitrary (compared to, say, FastAMDMachine5) - and there is no danger in running out any time soon.)
Each target machine can have a number of partitions - different partitions could be on different drives with different performance characteristics, or could be formatted with different filesystems. The partition ID is unique only within the target machine and should be of the form ext4-ssd or btrfs-hd. (There are strict limits on the length of partition labels which forces the partition ID to be short - 9 characters except on XFS where only 5 characters is allowed.)
On the target machine
- Write the hwtest image to a USB key
- Boot the target system from the USB key
- Login as root (no password)
- Do:
gnome-hwtest-install
- Confirm the drive you want to install on, and the partition you want to create. (You can gnome-hwtest-install again this to create further partitions.)
- Use ifconfig to determine the MAC address of the machines ethernet controller, write it down
On the controller machine
- Create a keypair for the target with:
cd /srv/gnome-hwtest openssl genrsa -out <machinename>.secret 4096 openssl pkey -in <machinename>.secret -out <machinename>.pubkey -pubout
- Transfer the .pubkey file to a USB key for future use
- Add the following lines to /srv/gnome-hwtest/controller.conf - every machine should have a distinct index, and power_tty and power_index should correspond to your switch box setup.
[machine <machinename>] index=1 hwaddr=<hwaddr> power_tty=/dev/ttyUSB0 power_index=1 [partition <machinename>/<partition_id>] tree=gnome-continuous/buildmaster/x86_64-runtime testsets=x11
In GNOME Git (optional)
* To register the machine on perf.gnome.org, in the perf-web module module in GNOME git, create the files <machinename>.pubkey (using the pubkey file you saved to the USB key) and <machinename.conf with contents similar to:
[machine <machinename>] owner=Your Name <somebody@example.com> location=Foo Corp Offices summary=i5-4200U, 8GB cpu=Intel Core i5-4200U CPU @ 1.60GHz graphics=Intel HD Graphics 4400 memory=8GiB [partition <machinename>/<partition-id>] filesystem=ext4 disk=Samsung SSD 840 Evo, 120GB [target <machinename>/<partition-id>/buildmaster-x86_64/x11]