Zen

Translation

English type: Title ====
virt-install
12/120 · 12

Sign in to save the translation.

English Spanish 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
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 vareli

Translation added
virt-install
virt-install
11 months ago
User avatar vareli

Contributor joined
Contributor joined 11 months ago
User avatar None

String updated in the repository
virt-install
 
a year ago
Browse all string changes

Things to check

Unchanged translation

Source and translation are identical

Reset

Glossary

English Spanish
No related strings found in the glossary.

15175324 String information

Source string description
type: Title ====
Flags
no-wrap
Source string location
./pages/anaconda-logging.adoc:168
String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
po/es/master/pages/anaconda-logging.po, string 88