netconsole remote kernel logger
To configure:
* set system.netconsole.enabled to true
* create system.netconsole.target dict
* set a record with IP address and MAC and interface as subdict
It works with both static and DHCP interfaces, and applies online.
You could use bash-scripting in netconsole.conf.
You could override the MAC.
See tests/pillar/system.sls for further information.
Change-Id: I1cbde47575eb5d32a34cd6d79a063f42dbea7643
diff --git a/README.rst b/README.rst
index 2cccd1d..6f1c5b6 100644
--- a/README.rst
+++ b/README.rst
@@ -1184,6 +1184,32 @@
username: test
password: test
+Netconsole Remote Kernel Logging
+--------------------------------
+
+Netconsole logger could be configured for configfs-enabled kernels
+(`CONFIG_NETCONSOLE_DYNAMIC` should be enabled). Configuration applies both in
+runtime (if network is already configured), and on-boot after interface
+initialization. Notes:
+
+ * receiver could be located only in same L3 domain
+ (or you need to configure gateway MAC manually)
+ * receiver's MAC is detected only on configuration time
+ * using broadcast MAC is not recommended
+
+.. code-block:: yaml
+
+ parameters:
+ linux:
+ system:
+ netconsole:
+ enabled: true
+ port: 514 (optional)
+ loglevel: debug (optional)
+ target:
+ 192.168.0.1:
+ interface: bond0
+ mac: "ff:ff:ff:ff:ff:ff" (optional)
Usage
=====