1
|
|
-# Kernel CI for the Civil Infrastructure Platform #
|
|
1
|
+# Board at desk - single dev description #
|
2
|
2
|
|
3
|
|
-This repository provides the vagrant infrastructure that allows users/labs
|
4
|
|
-to easily set up a Kernel CI frontend and backend tailored to the needs
|
5
|
|
-of the Civil Infrastructure Platform (http://www.cip-platform.org).
|
|
3
|
+Board at desk - single dev is an effort to ease the deployment of KernelCI and LAVAv2 allowing
|
|
4
|
+a developer with a board connected to its machine test kernels.
|
|
5
|
+In order to do so, a VM has been created with all the tools and configurations required.
|
|
6
|
+The current technology used to create that VM is Vagrant.
|
6
|
7
|
|
7
|
|
-## KernelCI Virtual Machine Setup & Configuration ##
|
|
8
|
+# Interesting links #
|
8
|
9
|
|
9
|
|
-The current setup requires (2) Virtual Machines; one for KernelCI and the other for LAVA v2
|
|
10
|
+* Board at desk - single dev [feature page](https://wiki.linuxfoundation.org/civilinfrastructureplatform/ciptestingboardatdesksingledevfeaturepage)
|
|
11
|
+* [Download](https://wiki.linuxfoundation.org/civilinfrastructureplatform/cipdownload) Board at desk - single dev.
|
|
12
|
+* Instructions to [download and set up Board at desk - single dev](https://wiki.linuxfoundation.org/civilinfrastructureplatform/ciptestingboardatdesksingledevsetup).
|
|
13
|
+* [Connect and configure Beaglebone Black](https://wiki.linuxfoundation.org/civilinfrastructureplatform/beagleboneblackboard) to test the kernel on the board.
|
|
14
|
+* [CIP testing project home page](https://wiki.linuxfoundation.org/civilinfrastructureplatform/ciptesting)
|
10
|
15
|
|
11
|
|
-### Setting up the Debian Jessie KernelCI VM ###
|
12
|
|
-
|
13
|
|
-1.) Install Vagrant
|
14
|
|
-
|
15
|
|
-```[user@host ~] $ sudo apt-get install vagrant```
|
16
|
|
-
|
17
|
|
-2.) Install Oracle Virtualbox
|
18
|
|
-
|
19
|
|
-```[user@host ~] $ sudo apt-get install virtualbox```
|
20
|
|
-
|
21
|
|
-OR, if you downloaded Virtualbox from the Oracle website
|
22
|
|
-Note: This assumes you are running Ubuntu Xenial(16.04) 64-bit
|
23
|
|
-```[user@host ~] $ cd Downloads```
|
24
|
|
-```[user@host Downloads] $ sudo dpkg -i virtualbox-5.1_5.1.8-111374-Ubuntu-xenial_amd64.deb```
|
25
|
|
-
|
26
|
|
-3.) Get the CIP Debian Jessie KernelCI Project
|
27
|
|
-
|
28
|
|
-```[user@host ~/git] $ git clone https://gitlab.com/cip-project/kernelci-debian.git```
|
29
|
|
-
|
30
|
|
-4.) Change to the kernelci-debian directory
|
31
|
|
-
|
32
|
|
-```[user@host ~/git] $ cd kernelci-debian```
|
33
|
|
-
|
34
|
|
-5.) Launch the KernelCI Virtual Machine
|
35
|
|
-
|
36
|
|
-```[user@host ~/git/kernelci-debian] $ vagrant up```
|
37
|
|
-
|
38
|
|
-Note: Please ignore any warnings such as “GetPassWarning: Can not control echo on the terminal.” or “Warning: Password input may be echoed.” - These do not affect the operation of the KernelCI VM.
|
39
|
|
-
|
40
|
|
-6.) Connect to the KernelCI VM through ssh using vagrant
|
41
|
|
-
|
42
|
|
-```[user@host ~] $ vagrant ssh```
|
43
|
|
-
|
44
|
|
-### Get CIP Kernel using git ###
|
45
|
|
-
|
46
|
|
-7.) Change to the git-repos directory
|
47
|
|
-
|
48
|
|
-```vagrant@guest:~$ cd git-repos```
|
49
|
|
-
|
50
|
|
-8.) Clone the Linux Kernel
|
51
|
|
-
|
52
|
|
-```vagrant@guest:~/git-repos$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git```
|
53
|
|
-
|
54
|
|
-9.) Find the branch of the kernel version you want (i.e. 4.4.27)
|
55
|
|
-
|
56
|
|
-```vagrant@guest:~/git-repos$ cd linux-stable```
|
57
|
|
-
|
58
|
|
-```vagrant@guest:~/git-repos/linux-stable$ git tag -l | grep 4.4.y```
|
59
|
|
-
|
60
|
|
-10.) Create a new branch using that tag.
|
61
|
|
-
|
62
|
|
-```vagrant@guest:~/git-repos/linux-stable$ git checkout -b cip_v4.4.27 v4.4.27```
|
63
|
|
-
|
64
|
|
-### Compile CIP Kernel ###
|
65
|
|
-
|
66
|
|
-11.) Set the environment variables
|
67
|
|
-
|
68
|
|
-```vagrant@guest:~/git-repos/linux-stable$ export TREE_NAME=cip-test```
|
69
|
|
-
|
70
|
|
-```vagrant@guest:~/git-repos/linux-stable$ export ARCH=arm```
|
71
|
|
-
|
72
|
|
-```vagrant@guest:~/git-repos/linux$ export CROSS_COMPILE=arm-linux-gnueabi-```
|
73
|
|
-
|
74
|
|
-Note: Don't forget the dash (-) at the end of the CROSS_COMPILE line!
|
75
|
|
-
|
76
|
|
-12.) Execute the build.py command
|
77
|
|
-
|
78
|
|
-```vagrant@guest:~/git-repos/linux-stable$ ~/kernelci-build/build.py -c tinyconfig -p CIP-KernelCI```
|
79
|
|
-
|
80
|
|
-13.) The Web Server is already running in the background. when you navigate from page to page the logs are written to the screen. To get back to the command line, simply press Enter
|
81
|
|
-
|
82
|
|
-14.) On your host machine, open a web browser and enter the following in the address box:
|
83
|
|
-
|
84
|
|
-http://localhost:5000
|
85
|
|
-
|
86
|
|
-15.) You will see the KernelCI Website home page from which, you can navigate to the different builds and trees that you've created
|
87
|
|
-
|
|
16
|
+# Contribute to the CIP testing project: #
|
|
17
|
+* Please read the Testing at [CIP FAQ](https://wiki.linuxfoundation.org/civilinfrastructureplatform/ciptestingfaq) to learn more about this action.
|
|
18
|
+* Join the technical mailing list ( [cip-dev](https://lists.cip-project.org/mailman/listinfo/cip-dev) ) to follow this effort.
|
|
19
|
+* Report a [bug](https://gitlab.com/cip-project/testing/boards).
|
88
|
20
|
|