From 8b7f44e21b151d5adb9417787fdf28ac8e0ab9cd Mon Sep 17 00:00:00 2001 From: Dmitry Tantsur Date: Thu, 5 May 2016 16:12:05 +0200 Subject: [PATCH] Document accessing stored introspection ramdisk logs Change-Id: I4e96f94c929477dad13917442d966a6a1a3781e1 --- .../troubleshooting/troubleshooting-nodes.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/source/troubleshooting/troubleshooting-nodes.rst b/doc/source/troubleshooting/troubleshooting-nodes.rst index 59ed04b1..a8623999 100644 --- a/doc/source/troubleshooting/troubleshooting-nodes.rst +++ b/doc/source/troubleshooting/troubleshooting-nodes.rst @@ -83,6 +83,19 @@ or DHCP logs from SSH as a root user with the temporary password or the SSH key. +Accessing logs from the ramdisk +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Introspection logs are saved on ramdisk failures. Starting with the Newton +release, they are actually stored on all introspection failures. The standard +location is ``/var/log/ironic-inspector/ramdisk``, and the files there are +actually ``tar.gz`` without an extension. + +To collect introspection logs in other cases, set +``always_store_ramdisk_logs = true`` in +``/etc/ironic-inspector/inspector.conf``, restart the +``openstack-ironic-inspector`` service and retry the introspection. + Refusing to introspect node with provision state "available" ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^