openstack
/
tripleo-quickstart-extras
Code Issues Proposed changes

Merge "remove duplicate README file"

This commit is contained in:
Zuul 2018-02-14 05:54:36 +00:00 committed by Gerrit Code Review
parent c044317d22 78bd33392e
commit 5aaebadbe1
1 changed files with 0 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
roles/collect-logs/templates/README-logs.html.j2
View File

@ -1,55 +0,0 @@
<!DOCTYPE HTML>
<html lang="en-US">
<head>
<title>README for Quickstart Logs</title>
</head>
<body>
<h1>How to figure out what went wrong?</h1>
<p>Check the console log and search for <b>PLAY RECAP</b>. There are sometimes
multiple ansible runs in a job, usually the last one is the relevant.
If no <b>PLAY RECAP</b> text is found that usually means an infra failure
before Quickstart could even start. Try rechecking or asking on <i>#tripleo</i>
if there's an ongoing infra issue.</p>
<p>Look for a line above the <b>PLAY RECAP</b> that starts with
"<b>fatal:</b>". If no such line is found, try searching for other PLAY RECAP
lines or other error outputs.</p>
<p>If this "fatal" line contains the execution of a shell script and redirects
to a log, check which machine that task ran on. Look under that node's
directory in the logs to find the file.</p>
<p>Example output:<br/>
<br/><code>
fatal: [<b>undercloud</b>]: FAILED! => {"changed": true, "cmd": "set -o pipefail &&
/home/{{ undercloud_user }}/<b>overcloud-prep-images.sh</b> 2>&1 | awk '{ print
strftime(\"%Y-%m-%d %H:%M:%S |\"), $0; fflush(); }' >
/home/stack/<b>overcloud_prep_images.log</b>", "failed": true, "rc": 1}<br/>
<br/>
PLAY RECAP *********************************************************************<br/>
</code></p>
<p>In this case the <code>overcloud-prep-images.sh</code> script failed, which
is redirected to <code>/home/{{ undercloud_user }}/overcloud_prep_images.log
</code> on the undercloud.</p>
<p>If this is a different Ansible error, that could mean either an infra
problem (often has <b>UNREACHABLE</b> in the line) or a bug in Quickstart. Ask
on <i>#tripleo</i> to get help or open a bug on
<a href='https://bugs.launchpad.net/tripleo/+filebug'>Launchpad</a>. Add the
"ci" tag if it's a CI issue and "quickstart" if you suspect that the bug is in
Quickstart itself.</p>
<h1>Links to common log files</h1>
<ul>
<li><a href='undercloud/home/{{ undercloud_user }}/'>undercloud/home/{{ undercloud_user }}/</a>
- the source and log output of all templated shell scripts</li>
<li><a href='undercloud/var/log/extra/'>undercloud/var/log/extra/</a> -
extra system details like package list, and cpu info gathered from the
undercloud</li>
<li><a href='undercloud/var/lib/mistral'>undercloud/var/lib/mistral</a>
- output of all ansible used by config-download to drive the overcloud deployment</li>
<li><a href='docs/build/'>docs/build/</a> - autogenerated documentation</li>
</ul>
</body>
</html>