|
 |
483b06 |
From 6534557508ba2ae7bda4ec2f2508d80dcef8297f Mon Sep 17 00:00:00 2001
|
|
|
483b06 |
From: Florence Blanc-Renaud <flo@redhat.com>
|
|
|
483b06 |
Date: Wed, 10 May 2017 18:04:52 +0200
|
|
|
483b06 |
Subject: [PATCH] ipa-kra-install manpage: document domain-level 1
|
|
|
483b06 |
|
|
|
483b06 |
ipa-kra-install man page was missing a specific section for domain level 1.
|
|
|
483b06 |
This commits also fixes a wrong option short name (for --log-file) and
|
|
|
483b06 |
indents the text corresponding to -p DM_PASSWORD
|
|
|
483b06 |
|
|
|
483b06 |
https://pagure.io/freeipa/issue/6922
|
|
|
483b06 |
|
|
|
483b06 |
Reviewed-By: Tomas Krizek <tkrizek@redhat.com>
|
|
|
483b06 |
---
|
|
|
483b06 |
install/tools/man/ipa-kra-install.1 | 17 ++++++++++++++---
|
|
|
483b06 |
1 file changed, 14 insertions(+), 3 deletions(-)
|
|
|
483b06 |
|
|
|
483b06 |
diff --git a/install/tools/man/ipa-kra-install.1 b/install/tools/man/ipa-kra-install.1
|
|
|
483b06 |
index 0aa9073c3303bd852627e430102ceb40575decc4..51afaac6474a9483e8c02bae605fe95994cce1f2 100644
|
|
|
483b06 |
--- a/install/tools/man/ipa-kra-install.1
|
|
|
483b06 |
+++ b/install/tools/man/ipa-kra-install.1
|
|
|
483b06 |
@@ -16,26 +16,37 @@
|
|
|
483b06 |
.\"
|
|
|
483b06 |
.\" Author: Ade Lee <alee@redhat.com>
|
|
|
483b06 |
.\"
|
|
|
483b06 |
-.TH "ipa-kra-install" "1" "Aug 24 2014" "FreeIPA" "FreeIPA Manual Pages"
|
|
|
483b06 |
+.TH "ipa-kra-install" "1" "May 10 2017" "FreeIPA" "FreeIPA Manual Pages"
|
|
|
483b06 |
.SH "NAME"
|
|
|
483b06 |
ipa\-kra\-install \- Install a KRA on a server
|
|
|
483b06 |
.SH "SYNOPSIS"
|
|
|
483b06 |
+.SS "DOMAIN LEVEL 0"
|
|
|
483b06 |
+.TP
|
|
|
483b06 |
ipa\-kra\-install [\fIOPTION\fR]... [replica_file]
|
|
|
483b06 |
+.SS "DOMAIN LEVEL 1"
|
|
|
483b06 |
+.TP
|
|
|
483b06 |
+ipa\-kra\-install [\fIOPTION\fR]...
|
|
|
483b06 |
.SH "DESCRIPTION"
|
|
|
483b06 |
Adds a KRA as an IPA\-managed service. This requires that the IPA server is already installed and configured, including a CA.
|
|
|
483b06 |
|
|
|
483b06 |
The KRA (Key Recovery Authority) is a component used to securely store secrets such as passwords, symmetric keys and private asymmetric keys. It is used as the back-end repository for the IPA Password Vault.
|
|
|
483b06 |
|
|
|
483b06 |
-ipa\-kra\-install can be run without replica_file to add KRA to the existing CA.
|
|
|
483b06 |
+In a domain at domain level 0, ipa\-kra\-install can be run without replica_file to add KRA to the existing CA, or with replica_file to install the KRA service on the replica.
|
|
|
483b06 |
ipa\-kra\-install will contact the CA to determine if a KRA has already been installed on another replica, and if so, will exit indicating that a replica_file is required.
|
|
|
483b06 |
|
|
|
483b06 |
The replica_file is created using the ipa\-replica\-prepare utility. A new replica_file should be generated on the master IPA server after the KRA has been installed and configured, so that the replica_file will contain the master KRA configuration and system certificates.
|
|
|
483b06 |
|
|
|
483b06 |
+In a domain at domain level 1, ipa\-kra\-install can be used to add KRA to the existing CA, or to install the KRA service on a replica, and does not require any replica file.
|
|
|
483b06 |
+
|
|
|
483b06 |
KRA can only be removed along with the entire server using ipa\-server\-install \-\-uninstall.
|
|
|
483b06 |
.SH "OPTIONS"
|
|
|
483b06 |
+.TP
|
|
|
483b06 |
\fB\-p\fR \fIDM_PASSWORD\fR, \fB\-\-password\fR=\fIDM_PASSWORD\fR
|
|
|
483b06 |
Directory Manager (existing master) password
|
|
|
483b06 |
.TP
|
|
|
483b06 |
+\fB\-\-no-host-dns\fR
|
|
|
483b06 |
+Do not use DNS for hostname lookup during installation
|
|
|
483b06 |
+.TP
|
|
|
483b06 |
\fB\-U\fR, \fB\-\-unattended\fR
|
|
|
483b06 |
An unattended installation that will never prompt for user input
|
|
|
483b06 |
.TP
|
|
|
483b06 |
@@ -45,7 +56,7 @@ Enable debug output when more verbose output is needed
|
|
|
483b06 |
\fB\-q\fR, \fB\-\-quiet\fR
|
|
|
483b06 |
Output only errors
|
|
|
483b06 |
.TP
|
|
|
483b06 |
-\fB\-v\fR, \fB\-\-log-file\fR=\fFILE\fR
|
|
|
483b06 |
+\fB\-\-log-file\fR=\fRFILE\fR
|
|
|
483b06 |
Log to the given file
|
|
|
483b06 |
.SH "EXIT STATUS"
|
|
|
483b06 |
0 if the command was successful
|
|
|
483b06 |
--
|
|
|
483b06 |
2.9.3
|
|
|
483b06 |
|