From 195035cef51a132b2b80df57ed50f2fe620244e6 Mon Sep 17 00:00:00 2001 From: Florence Blanc-Renaud Date: Wed, 7 Jul 2021 14:11:40 +0200 Subject: [PATCH] man page: update ipa-server-upgrade.1 The man page needs to clarify in which case the command needs to be run. Fixes: https://pagure.io/freeipa/issue/8913 Reviewed-By: Francois Cami --- install/tools/man/ipa-server-upgrade.1 | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/install/tools/man/ipa-server-upgrade.1 b/install/tools/man/ipa-server-upgrade.1 index 3db19b0f1..f01e21c6b 100644 --- a/install/tools/man/ipa-server-upgrade.1 +++ b/install/tools/man/ipa-server-upgrade.1 @@ -8,7 +8,12 @@ ipa\-server\-upgrade \- upgrade IPA server .SH "SYNOPSIS" ipa\-server\-upgrade [options] .SH "DESCRIPTION" -ipa\-server\-upgrade is used to upgrade IPA server when the IPA packages are being updated. It is not intended to be executed by end\-users. +ipa\-server\-upgrade is executed automatically to upgrade IPA server when +the IPA packages are being updated. It is not intended to be executed by +end\-users, unless the automatic execution reports an error. In this case, +the administrator needs to identify and fix the issue that is causing the +upgrade failure (with the help of /var/log/ipaupgrade.log) +and manually re\-run ipa\-server\-upgrade. ipa\-server\-upgrade will: -- 2.31.1