Zen

Source string Source string

12/10000 · 12

The string is read only.

English Actions
`man tailf`
Remote logging via virtio
QEMU/KVM in Fedora 13 and onwards allows one to create virtual machines with link:https://fedoraproject.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. 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.
Remote Logging Configuration
Anaconda will be forwarding logs over virtio automatically if it is able to find the port `/dev/virtio-ports/org.fedoraproject.anaconda.log.0"`. This is port is created using a libvirt XML directive that wires it to a TCP socket on the host's side. It's then possible to read the logs from there directly, or make an rsyslog instance to parse them and file them into respective files. See the ascii chart below for the whole ensemble:
Anaconda--->rsyslog(guest)--->virtio(guest char device)--->kvm hypervisor--->virtio(TCP socket)
|
v
forwarded log files<---rsyslog(host)
Step by step instructions to set everything up follow:
Create a testing virtual machine, e.g. using Virtual Manager </li>
Add the virtio-serial port to your virtual machine, direct it to the TCP port 6080 on the host. Start by editing the guest configuration:`virsh edit <machine name>`
In the guest editor, add following information into the `<devices>` section:
<channel type='tcp'>
<source mode='connect' host='127.0.0.1' service='6080'/>
<target type='virtio' name='org.fedoraproject.anaconda.log.0'/>
</channel>
Start the listening rsyslogd process on the host, using the `analog` script described [[#Remote_logging_via_TCP|above]]:
eval `analog -p 6080 -o rsyslogd.conf -s /home/akozumpl/remote_inst`
Start the virtual machine.
Continue with the installation. Immediately after the Anaconda greeting is displayed the log messages will appear in the directory given to `analog` script, in the `127.0.0.1` subdirectory.
virt-install
If you are using virt-install you can configure it with the --channel option:
--channel tcp,host=127.0.0.1:6080,mode=connect,target_type=virtio,name=org.fedoraproject.anaconda.log.0
Known issues and troubleshooting
works in libvirt>=0.8.2
chroot syslog messages from `/mnt/sysimage/root/install.log.syslog` are not forwarded.
it is not possible to start the machine unless something is listening on the TCP port where virtio-serial is connected.
if you want to test that the virtio connection is working, instead of using analog and rsyslog just let a netcat utility listen on the given port, e.g. `nc -l 0.0.0.0 6080`. You should start seeing raw logs in the terminal once the guest machine starts booting.
if both remote TCP logging via `syslog=` and remote virtio logging via `virtiolog=` are specified on the command line, one has to setup two rsyslogd instances on the server/host to listen to both the connections otherwise the sending rsyslog's queues get full and the forwarding stops.
link:https://fedoraproject.org/wiki/Features/VirtioSerial[VirtioSerial]
link:https://wiki.libvirt.org/page/Virtio[Virtio at the libvirt wiki]
link:https://libvirt.org/formatdomain.html#elementsConsole[libvirt domain XML format]
Anaconda logs on the running system
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:
| Name during installation | Name on the target system
| `/tmp/anaconda.log` | `/var/log/anaconda/anaconda.log`
| `/tmp/program.log` | `/var/log/anaconda/program.log`
| `/tmp/storage.log` | `/var/log/anaconda/storage.log`
| `/tmp/packaging.log` | `/var/log/anaconda/packaging.log`
Logging tips

Loading…

User avatar None

String updated in the repository

  1. fedora-docs-l10n/quick-docs
  2. master/pages/anaconda-logging
  3. English
virt-install
virt-install
9 months ago
Browse all string changes

Things to check

Multiple failing checks

Following checks are failing:
Unchanged translation: Portuguese (Brazil), Spanish

Reset

Glossary

English English
No related strings found in the glossary.

String information

Source string description
type: Title ====
Flags
no-wrap, read-only
Source string location
./pages/anaconda-logging.adoc:168
String age
9 months ago
Last updated
9 months ago
Source string age
9 months ago
Translation file
pot/master/pages/anaconda-logging.pot, string 88