diff options
| author | Michael Biebl <biebl@debian.org> | 2023-08-09 21:56:59 +0200 |
|---|---|---|
| committer | Michael Biebl <biebl@debian.org> | 2023-08-09 21:56:59 +0200 |
| commit | b1206f287e4fae1f9a7e29ec0dc11b54d726a7f8 (patch) | |
| tree | cc1d62cd21f10b2375c76484b5e2187f1e75f010 /man/nm-cloud-setup.xml | |
| parent | a6d4d07b23485507f30ddb1ce99f5c82428714c8 (diff) | |
| parent | 05e4a733f2141995181a551854d5df929f084adf (diff) | |
Update upstream source from tag 'upstream/1.44.0'
Update to upstream version '1.44.0' with Debian dir e69e19b54914190e7696747b3e0508f95977f387
Diffstat (limited to 'man/nm-cloud-setup.xml')
| -rw-r--r-- | man/nm-cloud-setup.xml | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/man/nm-cloud-setup.xml b/man/nm-cloud-setup.xml index 976fc647..74ec0400 100644 --- a/man/nm-cloud-setup.xml +++ b/man/nm-cloud-setup.xml @@ -173,7 +173,9 @@ <para><literal>NM_CLOUD_SETUP_LOG</literal>: control the logging verbosity. Set it to one of <literal>TRACE</literal>, <literal>DEBUG</literal>, <literal>INFO</literal>, <literal>WARN</literal>, <literal>ERR</literal> or <literal>OFF</literal>. The program - will print message on stdout and the default level is <literal>WARN</literal>.</para> + will print message on stdout and the default level is <literal>WARN</literal>. When + run as systemd service, the log will be collected by journald can can be seen with + <command>journalctl</command>.</para> </listitem> <listitem> <para><literal>NM_CLOUD_SETUP_AZURE</literal>: boolean, whether Microsoft Azure support is enabled. Defaults @@ -195,6 +197,16 @@ </refsect1> + <refsect1 id="debugging"> + <title>Debugging</title> + <para>Enable debug logging by setting <literal>NM_CLOUD_SETUP_LOG</literal> environment variable to <literal>TRACE</literal>.</para> + <para>In the common case where nm-cloud-setup is running as systemd service, this can be done via <command>systemctl edit nm-cloud-setup.service</command> + and add <literal>Environment=NM_CLOUD_SETUP_LOG=TRACE</literal> to the <literal>[Service]</literal> section. Afterwards, the log can + be found in syslog via <literal>journalctl</literal>. You may also want to enable debug logging in NetworkManager as descibed + in the DEBUGGING section in <link linkend='NetworkManager'><citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>5</manvolnum></citerefentry></link> + manual. When sharing logs, it's best to share complete logs and not preemptively filter for NetworkManager or nm-cloud-setup logs.</para> + </refsect1> + <refsect1 id="deploy"> <title>Example Setup for Configuring and Predeploying nm-cloud-setup</title> |