Bug 1518157

Summary:	Clarify the need to restart services in ipa-server-certinstall(1)
Product:	Red Hat Enterprise Linux 7	Reporter:	Aneta Šteflová Petrová <apetrova>
Component:	ipa	Assignee:	IPA Maintainers <ipa-maint>
Status:	CLOSED ERRATA	QA Contact:	ipa-qe <ipa-qe>
Severity:	unspecified	Docs Contact:
Priority:	high
Version:	7.4	CC:	amore, frenaud, ksiddiqu, pasik, pvoborni, rcritten, tscherf
Target Milestone:	rc	Keywords:	ZStream
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	ipa-4.6.4-1.el7	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1565519 (view as bug list)		Environment:
Last Closed:	2018-10-30 10:57:10 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1565519

Description Aneta Šteflová Petrová 2017-11-28 10:46:38 UTC

Description of problem:

DESCRIPTION in ipa-server-certinstall(1) reads:

~~~~
Replace the current Directory server SSL certificate, Apache server SSL certificate and/or Kerberos KDC certificate with the certificate in the specified files.
~~~~

and

~~~~
The service(s) are not automatically restarted. In order to use the newly installed certificate(s) you will need to manually restart the Directory and/or Apache servers.
~~~~

It seems # systemctl restart krb5kdc.service is also needed after installing the KDC certificate, but the man page doesn't say that -- it only says to restart DS and Apache.

Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:

The man page should clearly list all services that need to be restarted if the certificate(s) changed.


Additional info:

Comment 2 Florence Blanc-Renaud 2017-11-29 09:57:03 UTC

This issue has already been fixed upstream (https://pagure.io/freeipa/issue/7016 ipa_server_certinstall - restart krb5kdc service after kdc cert is installed), in the master branch as well as ipa-4-5 and ipa-4-6 branches.

Comment 4 Petr Vobornik 2018-04-09 15:34:04 UTC

ipa-4-5 patch: https://pagure.io/freeipa/c/512bf317b191ffefcc9baca4f766c1fb010f344f

Comment 9 anuja 2018-07-25 07:49:51 UTC

verified using :
ipa-server-4.6.4-3.el7.x86_64

man ipa-server-certinstall contains :

       The  service(s)  are  not automatically restarted. In order to use the newly installed certificate(s) you will need to manually restart
       the Directory, Apache and/or Krb5kdc servers.


Expected information is there in man page. 
Thus marking it verified.

Comment 11 errata-xmlrpc 2018-10-30 10:57:10 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:3187