Bug 742616

Summary:	IPA man pages should be more clear about the meaning of --selfsign
Product:	Red Hat Enterprise Linux 6	Reporter:	Dmitri Pal <dpal>
Component:	ipa	Assignee:	Rob Crittenden <rcritten>
Status:	CLOSED ERRATA	QA Contact:	IDM QE LIST <seceng-idm-qe-list>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	6.1	CC:	grajaiya, jgalipea, mkosek
Target Milestone:	rc
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	ipa-2.1.2-1.el6	Doc Type:	Bug Fix
Doc Text:	Do not document	Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-12-06 18:33:04 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Dmitri Pal 2011-09-30 19:02:22 UTC

ipa man pages on the install should be explicit that --selfsign is a parameter that will reduce the functionality and should be used only if the user wants to deliberately remove the certificate management capabilities. It should also state that there is no way to change things later so it is an important decision to make before installing IPA.

Comment 1 Dmitri Pal 2011-09-30 19:03:57 UTC

Upstream ticket:
https://fedorahosted.org/freeipa/ticket/1908

Comment 2 Jenny Severance 2011-09-30 19:55:23 UTC

it was suggested that --selfsign be changed --test-selfsign ... not sure if that is required or not ... or just be clear in man pages and documentation

Comment 3 Martin Kosek 2011-10-04 09:05:50 UTC

Fixed upstream:
master: https://fedorahosted.org/freeipa/changeset/28603e0c3ac20390a860347afb7a6ed976166e03
ipa-2-1: https://fedorahosted.org/freeipa/changeset/651534087c1e45f4a3f501b80bc1b43dbef3a6a5

I did not dear to change the API, option is still named --selfsign. But user is not properly warned in man pages, online help etc that this option restrain certificate management capabilities.

Comment 5 Martin Kosek 2011-11-01 07:50:03 UTC

    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
Do not document

Comment 6 Gowrishankar Rajaiyan 2011-11-05 08:51:18 UTC

    --selfsign          Configure a self-signed CA instance rather than a
                        dogtag CA. WARNING: Certificate management
                        capabilities will be limited


WARNING message included in ipa-server-install --help. 


[root@decepticons ~]# rpm -qi ipa-server 
Name        : ipa-server                   Relocations: (not relocatable)
Version     : 2.1.3                             Vendor: Red Hat, Inc.
Release     : 8.el6                         Build Date: Wed 02 Nov 2011 03:21:27 AM IST
Install Date: Thu 03 Nov 2011 10:13:53 AM IST      Build Host: x86-012.build.bos.redhat.com
Group       : System Environment/Base       Source RPM: ipa-2.1.3-8.el6.src.rpm
Size        : 3381421                          License: GPLv3+
Signature   : (none)
Packager    : Red Hat, Inc. <http://bugzilla.redhat.com/bugzilla>
URL         : http://www.freeipa.org/
Summary     : The IPA authentication server

Comment 7 errata-xmlrpc 2011-12-06 18:33:04 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.

http://rhn.redhat.com/errata/RHSA-2011-1533.html