summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBenoît Ganne <bganne@cisco.com>2019-07-04 11:25:59 +0200
committerPaul Vinciguerra <pvinci@vinciconsulting.com>2019-07-12 01:51:59 +0000
commit6d72c175edbb7654a643a86411f6f95aae16d10d (patch)
treee409af87cec7cf1116691d5018703c6bdd223ce0
parentbbe6d110a10d64e5bde21c4b839642acfbf91cbd (diff)
docs: how to enable coredump with systemd
Type: docs Change-Id: I1f657389fec716cc6cdc942803e65f861ffea5f5 Signed-off-by: Benoît Ganne <bganne@cisco.com>
-rw-r--r--docs/troubleshooting/reportingissues/reportingissues.rst4
-rw-r--r--extras/rpm/vpp.service5
-rw-r--r--src/pkg/debian/vpp.service5
3 files changed, 14 insertions, 0 deletions
diff --git a/docs/troubleshooting/reportingissues/reportingissues.rst b/docs/troubleshooting/reportingissues/reportingissues.rst
index 261dec9013a..73b2397477f 100644
--- a/docs/troubleshooting/reportingissues/reportingissues.rst
+++ b/docs/troubleshooting/reportingissues/reportingissues.rst
@@ -194,6 +194,10 @@ will capture usable vpp core files in /tmp/dumps.
# ulimit -c unlimited
# echo 2 > /proc/sys/fs/suid_dumpable
+If you start VPP from systemd, you also need to edit
+/lib/systemd/system/vpp.service and uncomment the "LimitCORE=infinity"
+line before restarting VPP.
+
Vpp core files often appear enormous. Gzip typically compresses them
to manageable sizes. A multi-GByte corefile often compresses to 10-20
Mbytes.
diff --git a/extras/rpm/vpp.service b/extras/rpm/vpp.service
index 40bf9d48c3b..2cf9f9194ac 100644
--- a/extras/rpm/vpp.service
+++ b/extras/rpm/vpp.service
@@ -9,6 +9,11 @@ ExecStart=/usr/bin/vpp -c /etc/vpp/startup.conf
Type=simple
Restart=on-failure
RestartSec=5s
+# Uncomment the following line to enable VPP coredumps on crash
+# You still need to configure the rest of the system to collect them, see
+# https://fdio-vpp.readthedocs.io/en/latest/troubleshooting/reportingissues/reportingissues.html#core-files
+# for details
+#LimitCORE=infinity
[Install]
WantedBy=multi-user.target
diff --git a/src/pkg/debian/vpp.service b/src/pkg/debian/vpp.service
index 2e86941de8b..4927feb43cd 100644
--- a/src/pkg/debian/vpp.service
+++ b/src/pkg/debian/vpp.service
@@ -8,6 +8,11 @@ ExecStartPre=-/sbin/modprobe uio_pci_generic
ExecStart=/usr/bin/vpp -c /etc/vpp/startup.conf
ExecStopPost=/bin/rm -f /dev/shm/db /dev/shm/global_vm /dev/shm/vpe-api
Restart=always
+# Uncomment the following line to enable VPP coredumps on crash
+# You still need to configure the rest of the system to collect them, see
+# https://fdio-vpp.readthedocs.io/en/latest/troubleshooting/reportingissues/reportingissues.html#core-files
+# for details
+#LimitCORE=infinity
[Install]
WantedBy=multi-user.target