From 6d72c175edbb7654a643a86411f6f95aae16d10d Mon Sep 17 00:00:00 2001 From: Benoît Ganne Date: Thu, 4 Jul 2019 11:25:59 +0200 Subject: docs: how to enable coredump with systemd MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Type: docs Change-Id: I1f657389fec716cc6cdc942803e65f861ffea5f5 Signed-off-by: Benoît Ganne --- docs/troubleshooting/reportingissues/reportingissues.rst | 4 ++++ extras/rpm/vpp.service | 5 +++++ src/pkg/debian/vpp.service | 5 +++++ 3 files changed, 14 insertions(+) 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 -- cgit 1.2.3-korg