From nobody Sat May 4 13:25:57 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1642692863; cv=none; d=zohomail.com; s=zohoarc; b=RSqr4qXicLNEuwOk7gA5FhdfYvlShnjkUn19yBmFw/MxfcGBJkZW0fbvdAA6lwKWLBy0Pul6HsT3ZNHtTG8sOoZLv97/0Vl3USSQb5ulo1n7bKW68oPCFe2MiVrAN0ISWiXgF0tu3pS13WzTPqA0WptKet/KnBzmfbOCnRhQ1Nw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1642692863; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=22sNTrHjiftNFYGqjt9ObL/BXc+mTFfsZzQqpKX8zeU=; b=Nkb89t9wQa9xg721+uZCYvBSGwylD+ThJOKHAXINfmKsE9l7ouWnF3G8KrpgJrXELvY3gPnDYZCxtlrSXenRAsRsNwpP8r0Nfni/4mNw26NL5xr8co27h4L8rtytkjHRkQ+A5IMrasK7TH6qeTFWqQP/Ab6G8gfbyWZRmffVJEs= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1642692863435702.4314687535613; Thu, 20 Jan 2022 07:34:23 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-228-QSOrDufvNOibvSbJumRr4Q-1; Thu, 20 Jan 2022 10:34:18 -0500 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id AC05851089; Thu, 20 Jan 2022 15:34:13 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 896377EBC9; Thu, 20 Jan 2022 15:34:13 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 55E0E4A7C8; Thu, 20 Jan 2022 15:34:13 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 20KFYBXF020593 for ; Thu, 20 Jan 2022 10:34:11 -0500 Received: by smtp.corp.redhat.com (Postfix) id E57FB282E9; Thu, 20 Jan 2022 15:34:11 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.7]) by smtp.corp.redhat.com (Postfix) with ESMTP id 4E6F32BCFF for ; Thu, 20 Jan 2022 15:34:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1642692862; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=22sNTrHjiftNFYGqjt9ObL/BXc+mTFfsZzQqpKX8zeU=; b=giyXyUfM3tGPh8FQKxpKVlrtUbI868jPTBu98IzXGlgNOPuW9h0ziGGFg0NrvJuqQECUde 9sKjBhDjPKp8wgk3XJ+5y4wyQpb2/jIhMbQVmHGw6VKSVXXaVkS+FVbkIkZhT9Weg2AdCK 40qTlx5pofv3I/0W9TgJ3Iut6iWWgLw= X-MC-Unique: QSOrDufvNOibvSbJumRr4Q-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH v2 1/3] docs: daemons: Add section on figuring out whether modular or monolithic daemon is in use Date: Thu, 20 Jan 2022 16:34:01 +0100 Message-Id: <21b46e39ed85bb1d11070780be8a103cca7baae9.1642692813.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1642692865522100001 Content-Type: text/plain; charset="utf-8" Since we are at a transition period where some users may be running monolithic libvirtd and others already the modular topology we need a section that allows users to figure out which is in use. This will be particularly important in the document about enabling logging, as the active log file depends on which daemon is in use. Signed-off-by: Peter Krempa Reviewed-by: Erik Skultety --- docs/daemons.rst | 52 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) diff --git a/docs/daemons.rst b/docs/daemons.rst index 1f9bc34260..c3970eb89c 100644 --- a/docs/daemons.rst +++ b/docs/daemons.rst @@ -435,6 +435,58 @@ host first. $ systemctl enable virtproxyd-tls.socket $ systemctl start virtproxyd-tls.socket +Checking whether modular/monolithic mode is in use +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D + +New distributions are likely to use the modular mode although the upgrade +process preserves whichever mode was in use before the upgrade. + +To determine whether modular or monolithic mode is in use on a host running +``systemd`` as the init system you can take the following steps: + +#. Check whether the modular daemon infrastructure is in use + + First check whether the modular daemon you are interested (see + `Modular driver daemons`_ for a summary of which daemons are provided by + libvirt) in is running: + + #. Check ``.socket`` for socket activated services + + :: + + # systemctl is-active virtqemud.socket + active + + #. Check ``.service`` for always-running daemons + + :: + + # systemctl is-active virtqemud.service + active + + If either of the above is ``active`` your system is using the modular d= aemons. + +#. Check whether the monolithic daemon is in use + + #. Check ``libvirtd.socket`` + + :: + + # systemctl is-active libvirtd.socket + active + + #. Check ``libvirtd.service`` for always-running daemon + + :: + + # systemctl is-active libvirtd.service + active + + If either of the above is ``active`` your system is using the monolithic + daemon. + +#. To determine which of the above will be in use on the next boot of the = system, + substitute ``is-enabled`` for ``is-active`` in the above examples. Proxy daemon =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.34.1 From nobody Sat May 4 13:25:57 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1642692944; cv=none; d=zohomail.com; s=zohoarc; b=MmOVQFK0K601pMrpABxBdkLV4easV+8LdMhBP4uBBPS7iB+8DAqMb9FdwRAs1TpIrie1s4PyKTp4bJHn2XsxAKl7eXIczs5ijJ0GFx8u8rD8m8RZ/CJeis57mI3/CQd5vywN8Tlju9nk6TJAowaeNjsDslknc7ejJmfd+88aSKs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1642692944; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=vQdtYvp/Skdo1s2csVcjS+pugJRIsAAn5mFDe3wwWsk=; b=nXW1rCQ05PmmaNSLLVoVfJrAQMNA+OoYPo+QPDRO1vcdQs0goH5BaSUZPonHBEVCgCGL+jQliSXG4HIPvKaYrLi3EJF0yX0/FBu8f0O8nFwteV6GqR9w5Kkr7yO+Gu7uTxoxg1PdmWq29kEsKHdmurc1RB8n7o2D4rUp8HcDNtA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1642692944408941.6762863227574; Thu, 20 Jan 2022 07:35:44 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-297-ZC25WPQXNVSClAptUhXO1A-1; Thu, 20 Jan 2022 10:35:41 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 476751926DA0; Thu, 20 Jan 2022 15:35:36 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 1ECD810A3943; Thu, 20 Jan 2022 15:35:36 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id D065B4CA9B; Thu, 20 Jan 2022 15:35:35 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 20KFYDlU020600 for ; Thu, 20 Jan 2022 10:34:13 -0500 Received: by smtp.corp.redhat.com (Postfix) id 006C52B45F; Thu, 20 Jan 2022 15:34:13 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.7]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5782D282E9 for ; Thu, 20 Jan 2022 15:34:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1642692943; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=vQdtYvp/Skdo1s2csVcjS+pugJRIsAAn5mFDe3wwWsk=; b=N+YpaSdchxD/hFevkqQPJU1Use7sl3LwaPLGksWjAelpxmkQYX6Vz+y38DOC7RtlPsSaeu hMR8M3hldbeaznK5p+/gAbZQXoptcXs8ZxfxAUiwQ+va03ZJb/Uxc17h0GCww0KftDxR4J 3wBmsy7koCEH/D3ipC/wf4WRoBARWmg= X-MC-Unique: ZC25WPQXNVSClAptUhXO1A-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH v2 2/3] kbase: debuglogs: Fix for modular daemons Date: Thu, 20 Jan 2022 16:34:02 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1642692945911100001 Content-Type: text/plain; charset="utf-8" Modular daemons are now the default in many new installations, thus we need to include steps how to determine that modular daemons are used and modular-daemon specific locations for the config files and admin URIs. Signed-off-by: Peter Krempa Reviewed-by: Erik Skultety --- docs/kbase/debuglogs.rst | 98 ++++++++++++++++++++++++++++++++-------- 1 file changed, 79 insertions(+), 19 deletions(-) diff --git a/docs/kbase/debuglogs.rst b/docs/kbase/debuglogs.rst index c3d4d3a425..d2632cfff1 100644 --- a/docs/kbase/debuglogs.rst +++ b/docs/kbase/debuglogs.rst @@ -92,38 +92,94 @@ important. Libvirt daemons logging configuration =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +Libvirt daemons can be configured either via a config file or via the +administration API. The configuration location depends on multiple factors. + +Session vs system daemons +------------------------- + +Libvirt daemons run either in the ``system`` mode or on ``session`` (user) +mode, depending on the configuration of the host and available permission +levels. + +The `connection URI `__ influences which dae= mon +the client will communicate with. + +System daemon mode +~~~~~~~~~~~~~~~~~~ + * all connection URIs end in ``/system`` e.g. ``qemu:///system`` + + * config files are usually placed in ``/etc/libvirt`` + +Session daemon mode +~~~~~~~~~~~~~~~~~~~ + + * connection URIs end in ``/session`` + + * config files are usually placed in ``$XDG_CONFIG_HOME/libvirt/`` direc= tory + +Modular vs. monolithic daemons +------------------------------ + +While there is only a single 'libvirtd.conf' configuration file in case of= the +monolithic daemon setup, each of the modular daemons has their own +configuration file giving you a lot of possibilities how to configure them +individually including logging. Realistically though, logging will have to= be +configured only for a single or a couple of daemons in case debug logs are +requested. + + +Refer to `documentation about daemons <../daemons.html#checking-whether-mo= dular-monolithic-mode-is-in-use>`__ +to figure out which is in use by your system. + +Modular daemons +~~~~~~~~~~~~~~~ + +The configuration of modular daemons is in file named after the daemon. E.= g. +for ``qemu:///system`` connection this is the ``virtqemud`` daemon and +correspondingly: + + * ``virtqemud.conf`` config file is used + + * ``virtqemud:///system`` or ``virtqemud:///session`` admin URI is used + +Monolithic daemon +~~~~~~~~~~~~~~~~~ + + * ``libvirtd.conf`` config file is used + + * ``libvirtd:///system`` or ``libvirtd:///session`` admin URI is used + when the modular qemu hypervisor driver ``virtqemud`` + Persistent setting ------------------ -The daemon configuration files location is dependent on `connection -URI `__. For ``qemu:///system``: - +In order to setup libvirt logging persistently, follow the steps below: +- open the appropriate daemon config file in your favourite editor :: -- open ``/etc/libvirt/libvirtd.conf`` in your favourite editor -- find & replace, or set these variables: + /etc/libvirt/virtqemud.conf + /etc/libvirt/libvirtd.conf + $XDG_CONFIG_HOME/libvirt/libvirtd.conf + $XDG_CONFIG_HOME/libvirt/virtqemud.conf -:: +- find & replace, or set the apropriate `Log outputs`_ and `Log filters`_= , e.g :: - log_filters=3D"3:remote 4:event 3:util.json 3:rpc 1:*" - log_outputs=3D"1:file:/var/log/libvirt/libvirtd.log" + log_filters=3D"3:remote 4:event 3:util.json 3:rpc 1:*" + log_outputs=3D"1:file:/var/log/libvirt/libvirtd.log" - save and exit -- restart libvirtd service - -:: +- restart the corresponding service/daemon e.g. :: - systemctl restart libvirtd.service + systemctl restart virtqemud.socket + systemctl restart libvirtd.socket + systemctl restart libvirtd.service *Note:* Libvirt prior to the ``libvirt-4.4.0`` release didn't support glob= bing patterns and thus requires more configuration. See `Legacy (pre-4.4.0) libvirt daemon logging configuration`_. -However, when you are using the session mode ``qemu:///session`` or you ru= n the -``libvirtd`` as unprivileged user you will find configuration file under -``$XDG_CONFIG_HOME/libvirt/libvirtd.conf``. - Runtime setting --------------- @@ -132,9 +188,13 @@ after the daemon restarts, since the new session can m= ake the anomaly "disappear". Therefore, it's possible to enable the debug logs during runt= ime using libvirt administration API. To use it conveniently, there's the ``virt-admin`` client provided by the ``libvirt-admin`` package. Use the -package manager provided by your distribution to install this package. Onc= e you -have it installed, run the following as root to see the set of log filters -currently being active: +package manager provided by your distribution to install this package. + +**Important**: Substitute ``virt-admin -c $ADMIN_URI`` according to the +guideline in the sections above in place of ``virt-admin`` in the examples +below if needed. + +The following command allows to query the list of currently active log fil= ters: :: --=20 2.34.1 From nobody Sat May 4 13:25:57 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1642693037; cv=none; d=zohomail.com; s=zohoarc; b=VqJXJ/7ohrg41wuRYEWflKRGJr6xRqqmm+Z7W2U7GkS84hM+bhJ/CInjTJYmTh4IS2NQ4Ngh3ChW1cQaoBbs2r41mDH+S+bYJjgJemBUeSnYGrV4PNP5lLeopzpSgiBZ7x7mdIuzSOlhJbmOn1eqncUV0fqaew4iDdr9VyEgWjU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1642693037; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=kbqTdaN8ZHN6K0GjoOqiWtD5XGvCbVzQmoG9cBDBg8U=; b=nW6ztLnrhxDL9sroAFUapygenjOL5HqByIHz6vPYmbMPrQ2BlHJ1yEOU/DfrSgMN1TpZ6numTiyqy0e7lAOBL2BV3Cr/UeYb6MnhzRJFPXpzhheJGTFHhhG2ULvZU0NaVg5LwoxCh/Ytno0JQK4fSFbDv5RBxVteKazMEYDlpdU= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1642693037677536.3979314117556; Thu, 20 Jan 2022 07:37:17 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-615-VGKFdrBCNhe1HCY5iG3NMg-1; Thu, 20 Jan 2022 10:35:47 -0500 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id E15D31091DBB; Thu, 20 Jan 2022 15:35:40 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C1BB710A3943; Thu, 20 Jan 2022 15:35:40 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 913F91809CB8; Thu, 20 Jan 2022 15:35:40 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 20KFYEke020627 for ; Thu, 20 Jan 2022 10:34:14 -0500 Received: by smtp.corp.redhat.com (Postfix) id 1BF222B45F; Thu, 20 Jan 2022 15:34:14 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.40.208.7]) by smtp.corp.redhat.com (Postfix) with ESMTP id 77819282E9 for ; Thu, 20 Jan 2022 15:34:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1642693036; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=kbqTdaN8ZHN6K0GjoOqiWtD5XGvCbVzQmoG9cBDBg8U=; b=MH5ZvHC80Onv0cAxrI5YfJJ6MGBU6v7q2FqzxPNAlaKvQ4k3mVDvkiwWc8xPnmjIhUMLGp 7qmXoM5Qq+yCk9cuLapDawlWFGE4+GiTmcZVkXHzuHvyUp+oRnw8dDYHQYZ2n3a6kBbRTj MqtRi8myD1JN36MTYdIhhynMpNoh3Xg= X-MC-Unique: VGKFdrBCNhe1HCY5iG3NMg-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH v2 3/3] man: virt-admin: Mention monolithic daemon URIs Date: Thu, 20 Jan 2022 16:34:03 +0100 Message-Id: <10fdd2f47cec1442b3a6b742a9666682321c2787.1642692813.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1642693039115100003 Content-Type: text/plain; charset="utf-8" Hint users that they can use 'virt-admin' also for the new monolithic daemons. Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=3D2038045 Signed-off-by: Peter Krempa Reviewed-by: Erik Skultety --- docs/manpages/virt-admin.rst | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/docs/manpages/virt-admin.rst b/docs/manpages/virt-admin.rst index 940a38bfce..21c664bb68 100644 --- a/docs/manpages/virt-admin.rst +++ b/docs/manpages/virt-admin.rst @@ -55,7 +55,7 @@ The ``virt-admin`` program understands the following *OPT= IONS*. ``-c``, ``--connect`` *URI* Connect to the specified *URI*, as if by the ``connect`` command, -instead of the default connection. +instead of the default connection. See `NOTES`_. ``-d``, ``--debug`` *LEVEL* @@ -90,11 +90,19 @@ virt-admin is coming from. NOTES =3D=3D=3D=3D=3D -Running ``virt-admin`` requires root privileges due to the -communications channels used to talk to the daemon. Consider changing the -*unix_sock_group* ownership setting to grant access to specific set of use= rs -or modifying *unix_sock_rw_perms* permissions. Daemon configuration file -provides more information about setting permissions. +The ``virt-admin`` supports both the monolithic ``libvirtd`` daemon and the +`modular daemons `__ +whichever is in use by your system. The connection *URI* used with +``-c/--connect`` or the `connect`_ command is based on the name of the +controlled daemon e.g.: ``virtqemud:///system``, ``libvirtd:///system``. + +Running ``virt-admin`` requires root privileges when communicating with the +system instance of a daemon (*URI* ending in ``/system``) due to the +communications channels used to talk to the daemon. + +Consider changing the *unix_sock_group* ownership setting to grant access = to +specific set of users or modifying *unix_sock_rw_perms* permissions. Daemon +configuration file provides more information about setting permissions. GENERIC COMMANDS @@ -198,6 +206,8 @@ If *LIBVIRT_ADMIN_DEFAULT_URI* or *uri_default* (see be= low) were set, active connection is executed. Note that this only applies if there is no connection at all or there is an inactive one. +See `NOTES`_ on picking the correct *URI* corresponding to a libvirt daemo= n. + To find the currently used URI, check the *uri* command documented below. --=20 2.34.1