Build TomElliott Kernel - Revision history

SebastianRoth: Replaced content with "Moved to the official docs, see here: https://docs.fogproject.org/en/latest/reference/compile_fos_kernel.html"

2021-12-12T22:11:31Z

Replaced content with "Moved to the official docs, see here: https://docs.fogproject.org/en/latest/reference/compile_fos_kernel.html"

SebastianRoth: /* To Build 64 bit Kernel */

2021-02-02T12:21:58Z

‎To Build 64 bit Kernel

SebastianRoth: /* Additional Patches */

2018-12-16T12:19:14Z

‎Additional Patches

SebastianRoth: /* drivers/scsi/storvsc_drv.c */

2018-12-16T12:04:06Z

‎drivers/scsi/storvsc_drv.c

SebastianRoth: /* Additional Patches */

2018-10-03T00:55:07Z

‎Additional Patches

SebastianRoth: /* Additional Patches */

2018-10-03T00:14:11Z

‎Additional Patches

SebastianRoth: /* Build TomElliott Kernel for FOG 0.33b and newer */

2018-09-10T19:31:49Z

‎Build TomElliott Kernel for FOG 0.33b and newer

Tom-elliott.7271: /* drivers/net/usb/r8152.c */

2017-05-11T19:18:32Z

‎drivers/net/usb/r8152.c

Tom-elliott.7271: /* drivers/scsi/storvsc_drv.c */

2017-01-19T21:30:00Z

‎drivers/scsi/storvsc_drv.c

Tom-elliott.7271: /* drivers/net/ethernet/intel/e1000e/netdev.c */

2017-01-06T23:31:50Z

‎drivers/net/ethernet/intel/e1000e/netdev.c

← Older revision		Revision as of 22:11, 12 December 2021
Line 1:		Line 1:
−	~~'''PRE BUILD ENVIRONMENT IS ASSUMED ALREADY INSTALLED ON THE SYSTEM YOU'RE BUILDING'''~~	+	Moved to the official docs, see here: https://docs.fogproject.org/en/latest/reference/compile_fos_kernel.html
−	~~NOTE: It is assumed you have root access to the system you're building this on. It also assumes you know your CWD (Current Working Directory).~~
−	~~= Build TomElliott Kernel for FOG 0.32 and earlier=~~
−	~~The below instructions are~~ to ~~build~~ the ~~TomElliott kernel. There is an extra step involved compared to the normal kernel build as there are firmware's built directly into the kernels now.~~
−	~~== Download the Kernel ==~~
−	~~As of the time of this writing kernel 3.13 is the latest. You can use previous~~, ~~or future kernels as well though.~~
−	~~<pre>wget https~~:~~//www.kernel.org/pub/linux/kernel/v3.x/linux-3.13.tar.xz</pre>~~
−
−	~~== Uncompress the kernel ==~~
−	~~<pre>tar -xf linux-3.13.tar.xz</pre>~~
−
−	~~== Go into uncompressed linux kernel directory ==~~
−	~~<pre>cd linux-3.13</pre>~~
−
−	~~== Get the config file ==~~
−	~~<pre>wget~~ https://~~svn~~.~~code.sf.net/p/freeghost/code/trunk/kernel/TomElliott.config.32 -O .config</pre>~~
−
−	~~== Download the prerequisite package '''(THE EXTRA STEP IS HERE)''' ==~~
−	~~<pre>git clone git://git.kernel~~.org/~~pub/scm/linux/kernel/git/firmware/linux-firmware.git<~~/~~pre>~~
−
−	~~== Prepare the build ==~~
−	~~<pre>make ARCH=i386 menuconfig</pre>~~
−	~~Add any choices, or don't but when you exit, it will ask you to save the config, '''NEEDED'''.~~
−
−	~~After you've saved the config.~~
−
−	~~== Build the bzImage ==~~
−	~~<pre>make ARCH=i386 bzImage</pre>~~
−
−	~~This will take a while. Once successful, it will say bzImage created.~~
−
−	~~== Copy the built kernel to your FOG Server's kernel directory. ==~~
−	~~NOTE: In my example, the FOG Server is the same as my build system.~~
−	~~NOTE: Recommend to make a backup of the original /tftpboot/fog/kernel/bzImage before continuing just in case.~~
−	~~<pre>cp arch/x86/boot/bzImage /tftpboot/fog/kernel/bzImage</pre>~~
−	~~= Build TomElliott Kernel for FOG 0.33b and newer=~~
−	~~The below instructions are to build the TomElliott kernel. There is an extra step involved compared to the normal kernel build as there are firmware's built directly into the kernels now.~~
−	~~== Download the Kernel ==~~
−	~~As of the time of this writing kernel 4.17 is the~~ latest~~. You can use previous, or future kernels as well though.~~
−	~~<pre>wget https://www.kernel.org/pub/linux/kernel/v4.x/linux-4.17.tar.xz</pre>~~
−
−	~~== Uncompress the kernel ==~~
−	~~<pre>tar -xf linux-4.17.tar.xz</pre>~~
−
−	~~== Go into uncompressed linux kernel directory ==~~
−	~~<pre>cd linux-4.17</pre>~~
−
−	~~== Get the config file ==~~
−	~~===To Build 32 bit Kernel===~~
−	~~<pre>wget -O .config https://github.com/FOGProject/fos/raw/master/configs/kernelx86.config</pre>~~
−	~~===To Build 64 bit Kernel===~~
−	~~<pre>wget -O .config https://github.com/FOGProject/fos/raw/master/configs/kernelx64.config</pre>~~
−	~~== Download the prerequisite package '''(THE EXTRA STEP IS HERE)''' ==~~
−	~~<pre>git clone git://git.kernel.org/pub/scm/linux/kernel~~/~~git~~/~~firmware/linux-firmware~~.~~git</pre>~~
−
−	~~== Prepare the build ==~~
−	~~===To Build 32 bit Kernel===~~
−	~~<pre>make ARCH=i386 oldconfig</pre>~~
−	~~===To Build 64 bit Kernel===~~
−	~~'''NOTE: MUST BE ON A 64 BIT OS'''~~
−	~~<pre>make oldconfig</pre>~~
−
−	~~In case you want to make changes to the config run:~~
−	~~<pre>make menuconfig</pre>~~
−	or
−	~~<pre>make oldconfig</pre>~~
−
−	~~Make sure to save when exiting the menuconfig.~~
−
−	~~== Build the bzImage ==~~
−	~~===To Build 32 bit Kernel===~~
−	~~<pre>make ARCH=i386 bzImage</pre>~~
−	~~===To Build 64 bit Kernel===~~
−	~~<pre>make bzImage</pre>~~
−
−	~~This will take a while. Once successful, it will say bzImage created.~~
−
−	~~== Copy the built kernel to your FOG Server's kernel directory. ==~~
−	~~NOTE: In my example, the FOG Server is the same as my build system.~~
−	~~NOTE: Recommend to make a backup of the original /var/www/~~html~~/fog/service/ipxe/bzImage before continuing just in case.~~
−	~~<pre>cp arch/x86/boot/bzImage /var/www/html/fog/service/ipxe/bzImage</pre>~~
−	or
−	~~<pre>cp arch/x86/boot/bzImage /var/www/html/fog/service/ipxe/bzImage32</pre>~~
−
−	~~= Additional Patches =~~
−	~~Edit the files within the linux decompressed folder:~~
−	~~== drivers/net/usb/r8152.c ==~~
−	~~https://forums.fogproject.org/topic/12465/microsoft-surface-go-usb-c-to-ethernet-adapter-compatibility~~
−	~~Search for <pre>REALTEK_USB_DEVICE(VENDOR_ID_REALTEK</pre> and add this line:~~
−	~~<pre>~~
−	~~{REALTEK_USB_DEVICE(VENDOR_ID_MICROSOFT, 0x0927)}~~
−	~~</pre>~~
−
−	~~== drivers/scsi/storvsc_drv.c ==~~
−	~~This is an important patch to help prevent from major performance issues in HyperV: https://forums.fogproject.org/topic/6695/performance-decrease-using-hyper-v-win10-clients~~
−
−	~~Search for <pre>blk_queue_virt_boundary</pre>~~
−
−	~~Delete the line and add:~~
−	~~<pre>~~
−	~~if (PAGE_SIZE - 1 < 4096) {~~
−	~~blk_queue_virt_boundary(sdevice->request_queue, 4096);~~
−	~~} else {~~
−	~~blk_queue_virt_boundary(sdevice->request_queue, PAGE_SIZE - 1);~~
−	}
−	~~</pre>~~

@@ Line 62: / Line 62: @@
 In case you want to make changes to the config run:
-<pre>make ARCH=i386 menuconfig</pre>
+<pre>make menuconfig</pre>
 or
 <pre>make oldconfig</pre>

@@ Line 104: / Line 104: @@
          blk_queue_virt_boundary(sdevice->request_queue, PAGE_SIZE - 1);
+     }
 </pre>

@@ Line 104: / Line 104: @@
          blk_queue_virt_boundary(sdevice->request_queue, PAGE_SIZE - 1);
+     }
 </pre>

@@ Line 86: / Line 86: @@
 Edit the files within the linux decompressed folder:
 == drivers/net/usb/r8152.c ==
 Search for <pre>REALTEK_USB_DEVICE(VENDOR_ID_REALTEK</pre> and add this line:
 <pre>
@@ Line 103: / Line 104: @@
          blk_queue_virt_boundary(sdevice->request_queue, PAGE_SIZE - 1);
+     }
 </pre>

@@ Line 86: / Line 86: @@
 Edit the files within the linux decompressed folder:
 == drivers/net/usb/r8152.c ==
-Appears to have been added with Kernel 4.11
+Search for <pre>REALTEK_USB_DEVICE(VENDOR_ID_REALTEK</pre> and add this line:
 <pre>
-     {REALTEK_USB_DEVICE(VENDOR_ID_MICROSOFT, 0x07ab)}
+     {REALTEK_USB_DEVICE(VENDOR_ID_MICROSOFT, 0x0927)}
 </pre>
-== drivers/mmc/card/block.c ==
+== drivers/scsi/storvsc_drv.c ==
-Relevant to MMC block devices to remove the RPMB drive from view
+This is an important patch to help prevent from major performance issues in HyperV: https://forums.fogproject.org/topic/6695/performance-decrease-using-hyper-v-win10-clients
-Right before the line add:
+Search for <pre>blk_queue_virt_boundary</pre>
 Delete the line and add:
@@ Line 135: / Line 106: @@
 == drivers/net/ethernet/intel/igb/e1000_82575.c ==
-Search E1000_STATUS_FUNC_SHIFT;
+Search for <pre>E1000_STATUS_FUNC_SHIFT;</pre>
 Directly after the line add:

@@ Line 37: / Line 37: @@
 The below instructions are to build the TomElliott kernel.  There is an extra step involved compared to the normal kernel build as there are firmware's built directly into the kernels now.
 == Download the Kernel ==
-As of the time of this writing kernel 3.13 is the latest.  You can use previous, or future kernels as well though.
+As of the time of this writing kernel 4.17 is the latest.  You can use previous, or future kernels as well though.
-<pre>wget https://www.kernel.org/pub/linux/kernel/v3.x/linux-3.13.tar.xz</pre>
+<pre>wget https://www.kernel.org/pub/linux/kernel/v4.x/linux-4.17.tar.xz</pre>
 == Uncompress the kernel ==
-<pre>tar -xf linux-3.13.tar.xz</pre>
+<pre>tar -xf linux-4.17.tar.xz</pre>
 == Go into uncompressed linux kernel directory ==
-<pre>cd linux-3.13</pre>
+<pre>cd linux-4.17</pre>
 == Get the config file ==
 ===To Build 32 bit Kernel===
-<pre>wget https://svn.code.sf.net/p/freeghost/code/trunk/kernel/TomElliott.config.32 -O .config</pre>
+<pre>wget -O .config https://github.com/FOGProject/fos/raw/master/configs/kernelx86.config</pre>
 ===To Build 64 bit Kernel===
-<pre>wget https://svn.code.sf.net/p/freeghost/code/trunk/kernel/TomElliott.config.64 -O .config</pre>
+<pre>wget -O .config https://github.com/FOGProject/fos/raw/master/configs/kernelx64.config</pre>
 == Download the prerequisite package '''(THE EXTRA STEP IS HERE)''' ==
 <pre>git clone git://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git</pre>
@@ Line 56: / Line 56: @@
 == Prepare the build ==
 ===To Build 32 bit Kernel===
-<pre>make ARCH=i386 menuconfig</pre>
+<pre>make ARCH=i386 oldconfig</pre>
 ===To Build 64 bit Kernel===
 '''NOTE: MUST BE ON A 64 BIT OS'''
-<pre>make menuconfig</pre>
+<pre>make oldconfig</pre>
-NOTE: If it doesn't ask you to save the configuration, the easiest method to ensure all will work fine is to deselect an small item and reselect it.
+In case you want to make changes to the config run:
-After you've saved the config.
+Make sure to save when exiting the menuconfig.
 == Build the bzImage ==
@@ Line 76: / Line 78: @@
 == Copy the built kernel to your FOG Server's kernel directory. ==
 NOTE: In my example, the FOG Server is the same as my build system.
-NOTE: Recommend to make a backup of the original /var/www/{html/fog,fog}/service/ipxe/bzImage before continuing just in case.
+NOTE: Recommend to make a backup of the original /var/www/html/fog/service/ipxe/bzImage before continuing just in case.
 <pre>cp arch/x86/boot/bzImage /var/www/html/fog/service/ipxe/bzImage</pre>
 = Additional Patches =

@@ Line 82: / Line 82: @@
 Edit the files within the linux decompressed folder:
 == drivers/net/usb/r8152.c ==
 Relevant to the r8152 network cards.
 Search VENDOR_ID_REALTEK

@@ Line 121: / Line 121: @@
 Delete the line and add:
 <pre>
-     if (PAGE_SIZE - 1 < 0) blk_queue_virt_boundary(sdevice->request_queue, 0);
+     if (PAGE_SIZE - 1 < 4096) {
-     else blk_queue_virt_boundary(sdevice->request_queue, PAGE_SIZE - 1);
+        blk_queue_virt_boundary(sdevice->request_queue, 4096);
 </pre>

@@ Line 107: / Line 107: @@
 == drivers/net/ethernet/intel/e1000e/netdev.c ==
 Search er32(TIMINCA)
@@ Line 113: / Line 115: @@
      rem = incvalue != 0 ? do_div(temp,incvalue) : 0;
 </pre>
 == drivers/scsi/storvsc_drv.c ==
 Search blk_queue_virt_boundary.