hank-test/quick-docs
1
0
Fork 0
mirror of https://pagure.io/fedora-docs/quick-docs.git synced 2024-11-28 14:56:35 +00:00
Code Issues 1 Projects Releases Packages Wiki Activity Actions

Fix table in logging page

Browse source
This commit is contained in:
Jared Smith 2018-02-27 06:12:28 -05:00
parent e05bec1455
commit f8832b9e68
1 changed files with 35 additions and 30 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

65
en-US/anaconda/anaconda_logging.adoc
View file

@ -109,11 +109,11 @@ Run `analog` without the `-o` option to see how exactly does a fitting configura
Also notice that it uses the same message format for remote logging as anaconda does, but you can of course modify this to specify any format you want. Also notice that it uses the same message format for remote logging as anaconda does, but you can of course modify this to specify any format you want.
=== See also === See also
* [http://www.rsyslog.com/doc Rsyslog documentation] * link:http://www.rsyslog.com/doc[Rsyslog documentation]
* `man tailf` * `man tailf`
== Remote logging via virtio == Remote logging via virtio
QEMU/KVM in Fedora 13 and onwards allows one to create virtual machines with [[Features/VirtioSerial|multiple virtio char devices]] exposed to the guest machine. QEMU/KVM in Fedora 13 and onwards allows one to create virtual machines with link:http://fedoraprojet.org/wiki/Features/VirtioSerial[multiple virtio char devices] exposed to the guest machine.
One such device can be used to forward anaconda logs to the host machine. One such device can be used to forward anaconda logs to the host machine.
In that way we can get logs forwarded in real time, as soon the anaconda logging subsystem is initialized (early) and not need to wait for the network to come up. In that way we can get logs forwarded in real time, as soon the anaconda logging subsystem is initialized (early) and not need to wait for the network to come up.
Also, it's the only way to forward the logs in a no-network setup. Also, it's the only way to forward the logs in a no-network setup.
@ -126,10 +126,10 @@ See the ascii chart below for the whole ensemble:
---- ----
Anaconda--->rsyslog(guest)--->virtio(guest char device)--->kvm hypervisor--->virtio(TCP socket) Anaconda--->rsyslog(guest)--->virtio(guest char device)--->kvm hypervisor--->virtio(TCP socket)
| |
v v
forwarded log files<---rsyslog(host) forwarded log files<---rsyslog(host)
---- ----
@ -179,46 +179,51 @@ You should start seeing raw logs in the terminal once the guest machine starts b
After every successful installation, anaconda logs are copied into `/var/log` on the system you just installed. After every successful installation, anaconda logs are copied into `/var/log` on the system you just installed.
To avoid name clashes with other log files there, the anaconda logs are renamed: To avoid name clashes with other log files there, the anaconda logs are renamed:
{| [options="header"]
! Name during installation !! Name on the target system |====
|- | Name during installation | Name on the target system |
| `/tmp/anaconda.log` || `/var/log/anaconda.log` | `/tmp/anaconda.log` | `/var/log/anaconda.log` |
|- | `/tmp/syslog` | `/var/log/anaconda.syslog` |
| `/tmp/syslog` || `/var/log/anaconda.syslog` | `/tmp/X.log` | `/var/log/anaconda.xlog` |
|- | `/tmp/program.log` | `/var/log/anaconda.program.log` |
| `/tmp/X.log` || `/var/log/anaconda.xlog` | `/tmp/storage.log` | `/var/log/anaconda.storage.log` |
|- | `/tmp/yum.log` | `/var/log/anaconda.yum.log` |
| `/tmp/program.log` || `/var/log/anaconda.program.log` | `/tmp/ifcfg.log` (new in F14) | not copied |
|- |====
| `/tmp/storage.log` || `/var/log/anaconda.storage.log`
|-
| `/tmp/yum.log` || `/var/log/anaconda.yum.log`
|-
| `/tmp/ifcfg.log` (new in F14) || not copied
|}
Starting with Fedora 15 (or post F14 Rawhide), the logs go to `/var/log/anaconda` directory on the target system, including ifcfg.log inroduced in F14. Starting with Fedora 15 (or post F14 Rawhide), the logs go to `/var/log/anaconda` directory on the target system, including ifcfg.log inroduced in F14.
== Logging tips == Logging tips
If you are asked to provide logs for a bugzilla, your best option is switching from the anaconda GUI to tty2 and then use scp to copy the files to your computer, e.g.: If you are asked to provide logs for a bugzilla, your best option is switching from the anaconda GUI to tty2 and then use scp to copy the files to your computer, e.g.:
cd /tmp
scp anaconda.log aklap:/home/akozumpl/ ----
cd /tmp
scp anaconda.log aklap:/home/akozumpl/
----
It is also possible to make a complete dump of a state of running anaconda process (the same dump that is compiled automatically if an unhandled exception occurs). It is also possible to make a complete dump of a state of running anaconda process (the same dump that is compiled automatically if an unhandled exception occurs).
To do this send the main anaconda process SIGUSR2: To do this send the main anaconda process SIGUSR2:
kill -USR2 `cat /var/run/anaconda.pid``
----
kill -USR2 `cat /var/run/anaconda.pid``
----
This builds a file `/tmp/anaconda-tb-?????` that also contains `anaconda.log`, `storage.log` and `syslog`. This builds a file `/tmp/anaconda-tb-?????` that also contains `anaconda.log`, `storage.log` and `syslog`.
If you are on a KVM virtual machine and there's no scp available (stage1), you can (after setting up the network if not up already) redirect to a special tcp file, on host: If you are on a KVM virtual machine and there's no scp available (stage1), you can (after setting up the network if not up already) redirect to a special tcp file, on host:
nc -l 4444 > syslog.log
----
nc -l 4444 > syslog.log
----
on guest: on guest:
ifconfig eth0 10.0.2.10/24 up
grep "" /tmp/syslog > /dev/tcp/10.0.2.2/4444 ----
ifconfig eth0 10.0.2.10/24 up
grep "" /tmp/syslog > /dev/tcp/10.0.2.2/4444
----
== To do == To do
* The current list of logging requirements and tasks is maintained in bugzilla [https://bugzilla.redhat.com/show_bug.cgi?id=524980 524980]. * The current list of logging requirements and tasks is maintained in bugzilla [https://bugzilla.redhat.com/show_bug.cgi?id=524980 524980].
* A support for KVM's virtio logging is coming later [https://bugzilla.redhat.com/show_bug.cgi?id=576439 576439]. * A support for KVM's virtio logging is coming later [https://bugzilla.redhat.com/show_bug.cgi?id=576439 576439].