openstack/devstack
Code Issues Proposed changes

doc: How to pdb under systemd

Browse Source 
Add a section to the systemd doc describing how to use regular pdb in a
systemd environment.

Change-Id: Ib1f616f407eccc087de1c60624fa74e2555971c2
This commit is contained in:
Eric Fried 2017-09-07 13:36:00 -05:00
parent 1ad91a7d4b
commit 12fcd61930
1 changed files with 24 additions and 2 deletions

26
doc/source/systemd.rst

@ -98,8 +98,7 @@ Follow logs for a specific service::
Following logs for multiple services simultaneously::
journalctl -f --unit devstack@n-cpu.service --unit
devstack@n-cond.service
journalctl -f --unit devstack@n-cpu.service --unit devstack@n-cond.service
or you can even do wild cards to follow all the nova services::
@ -121,6 +120,29 @@ left/right arrow keys.
See ``man 1 journalctl`` for more.
Debugging with pdb
==================
In order to break into a regular pdb session on a systemd-controlled
service, you need to invoke the process manually - that is, take it out
of systemd's control.
Discover the command systemd is using to run the service::
systemctl show devstack@n-sch.service -p ExecStart --no-pager
Stop the systemd service::
sudo systemctl stop devstack@n-sch.service
Inject your breakpoint in the source, e.g.::
import pdb; pdb.set_trace()
Invoke the command manually::
/usr/local/bin/nova-scheduler --config-file /etc/nova/nova.conf
Known Issues
============