public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-09-29 14:38:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Sync up docs with the old site, related to these PRs:

Browse Source 
https://github.com/rancher/rancher.github.io/pull/1023
https://github.com/rancher/rancher.github.io/pull/1022
https://github.com/rancher/rancher.github.io/pull/1021
https://github.com/rancher/rancher.github.io/pull/1020
https://github.com/rancher/rancher.github.io/pull/1025 @superseb

https://github.com/rancher/docs/pull/263 @JacieChao
This commit is contained in:
niusmallnan
2018-06-10 20:03:38 -07:00
committed by Denise
parent 22cb0d134b
commit 351ce6502e
6 changed files with 124 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/os/v1.x/en/installation/configuration/loading-kernel-modules/_index.md
+45 -16
View File
@@ -1,21 +1,51 @@
---
title: Loading Extra Kernel Modules
title: Loading Kernel Modules
weight: 134
---
Since RancherOS v0.8, we build our own kernels using an unmodified kernel.org LTS kernel.
We provide both loading kernel modules with parameters and loading extra kernel modules for you.
### Loading Kernel Modules with parameters
_Available as of v1.4_
The `rancher.modules` can help you to set kernel modules or module parameters.
As an example, I'm going to set a parameter for kernel module `ndb`
```
sudo ros config set rancher.modules "['nbd nbds_max=1024', 'nfs']"
```
Or
```
#cloud-config
rancher:
modules: [nbd nbds_max=1024, nfs]
```
After rebooting, you can check that `ndbs_max` parameter has been updated.
```
# cat /sys/module/nbd/parameters/nbds_max
1024
```
### Loading Extra Kernel Modules
We also build almost all optional extras as modules - so most in-tree modules are available
in the `kernel-extras` service.
If you do need to build kernel modules for RancherOS, there are 4 options:
If you do need to build kernel modules for RancherOS, there are 3 options:
* Try the `kernel-extras` service
* Ask us to add it into the next release
* If its out of tree, copy the methods used for the zfs and open-iscsi services
* Build it yourself.
0 Try the `kernel-extras` service
1 Ask us to add it into the next release
2 If its out of tree, copy the methods used for the zfs and open-iscsi services
3 Build it yourself.
## Try the kernel-extras service
#### Try the kernel-extras service
We build the RancherOS kernel with most of the optional drivers as kernel modules, packaged
into an optional RancherOS service.
@@ -29,13 +59,13 @@ sudo ros service up kernel-extras
The modules should now be available for you to `modprobe`
## Ask us to do it
#### Ask us to do it
Open a GitHub issue in the https://github.com/rancher/os repository - we'll probably add
it to the kernel-extras next time we build a kernel. Tell us if you need the module at initial
configuration or boot, and we can add it to the default kernel modules.
## Copy the out of tree build method
#### Copy the out of tree build method
See https://github.com/rancher/os-services/blob/master/z/zfs.yml and
https://github.com/rancher/os-services/tree/master/images/20-zfs
@@ -43,19 +73,17 @@ https://github.com/rancher/os-services/tree/master/images/20-zfs
The build container and build.sh script build the source, and then create a tools image, which is used to
"wonka.sh" import those tools into the console container using `docker run`
## Build your own.
#### Build your own.
As an example I'm going build the `intel-ishtp` hid driver using the `rancher/os-zfs:<version>` images to build in, as they should contain the right tools versions for that kernel.
```
sudo docker run --rm -it --privileged -v $(pwd):/data -w /data rancher/os-zfs:$(ros -v | cut -d ' ' -f 3) bash
sudo docker run --rm -it --entrypoint bash --privileged -v /lib:/host/lib -v $(pwd):/data -w /data rancher/os-zfs:$(ros -v | cut -d ' ' -f 2)
apt-get update
apt-get install -qy libncurses5-dev bc libssh-dev
curl -SsL -o src.tgz https://github.com/rancher/os-kernel/releases/download/v$(uname -r)/linux-$(uname -r)-src.tgz
tar zxvf src/tgz
tar zxvf src.tgz
zcat /proc/config.gz >.config
# Yes, ignore the name of the directory :/
cd v*
@@ -70,7 +98,8 @@ insmod drivers/hid/intel-ish-hid/intel-ishtp.ko
rmmod intel-ishtp
# install it
cp drivers/hid/intel-ish-hid/*.ko /lib/modules/4.9.45-rancher/kernel/drivers/hid/
ln -s /host/lib/modules/ /lib/
cp drivers/hid/intel-ish-hid/*.ko /host/lib/modules/$(uname -r)/kernel/drivers/hid/
depmod
# done