diff --git a/doc/common/section_support-compute.xml b/doc/common/section_support-compute.xml
index 6d8e4263f3..1505ade93a 100644
--- a/doc/common/section_support-compute.xml
+++ b/doc/common/section_support-compute.xml
@@ -13,7 +13,7 @@
compute node. This section shows you how to troubleshoot
Compute.
- Compute log files
+ Compute service logging
Compute stores a log file for each service in
/var/log/nova. For example,
nova-compute.log is the log for
@@ -147,7 +147,26 @@
returns an error:
# virsh create libvirt.xml
-
+
+ Empty log output for Linux instances
+ You can view the log output of running instances
+ from either the Log tab of the
+ dashboard or the output of
+ nova console-log. In some cases, the
+ log output of a running Linux instance will be empty or
+ only display a single character (for example,
+ the ? character).
+ This occurs when the Compute service attempts to
+ retrieve the log output of the instance via a serial
+ console while the instance itself is not configured to
+ send output to the console. To rectify this, append the
+ following parameters to kernel arguments specified in the
+ instance's boot loader:
+ console=tty0 console=ttyS0,115200n8
+ Upon rebooting, the instance will be configured to
+ send output to the Compute service.
+
+
Reset the state of an instance
If an instance remains in an intermediate state, such as