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