From 4f010cfda63dd0c16e324c9f74ea042092274d9a Mon Sep 17 00:00:00 2001 From: Rob Crittenden Date: Wed, 27 Jan 2010 17:24:10 -0500 Subject: Bring ipa-server-install man page up-to-date, fix some syntax errors Remove a bunch of trailing spaces Add the --ca option Add the --no-host-dns option Add the --subject option Fix the one-character option for --no-ntp, should be -N not -n Add missing line break between --no-ntp and --uninstall Resolves #545260 --- install/tools/man/ipa-server-install.1 | 50 ++++++++++++++++++++-------------- 1 file changed, 30 insertions(+), 20 deletions(-) (limited to 'install/tools/man') diff --git a/install/tools/man/ipa-server-install.1 b/install/tools/man/ipa-server-install.1 index 5b0df3dc..6d7c0ff5 100644 --- a/install/tools/man/ipa-server-install.1 +++ b/install/tools/man/ipa-server-install.1 @@ -1,21 +1,21 @@ .\" A man page for ipa-server-install .\" Copyright (C) 2008 Red Hat, Inc. -.\" +.\" .\" This is free software; you can redistribute it and/or modify it under .\" the terms of the GNU Library General Public License as published by .\" the Free Software Foundation; version 2 only -.\" +.\" .\" This program is distributed in the hope that it will be useful, but .\" WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU .\" General Public License for more details. -.\" +.\" .\" You should have received a copy of the GNU Library General Public .\" License along with this program; if not, write to the Free Software .\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -.\" +.\" .\" Author: Rob Crittenden -.\" +.\" .TH "ipa-server-install" "1" "Mar 14 2008" "freeipa" "" .SH "NAME" ipa\-server\-install \- Configure an IPA server @@ -24,34 +24,37 @@ ipa\-server\-install [\fIOPTION\fR]... .SH "DESCRIPTION" Configures the services needed by an IPA server. This includes setting up a Kerberos Key Distribution Center (KDC) with an LDAP back\-end, configuring Apache, configuring NTP and starting some IPA\-provided services: ipa_kpasswd and ipa_webgui. .SH "OPTIONS" -.TP +.TP \fB\-u\fR, \fB\-\-user\fR=\fIDS_USER\fR The user that the Directory Server will run as -.TP +.TP \fB\-r\fR, \fB\-\-realm\fR=\fIREALM_NAME\fR The Kerberos realm name for the IPA server -.TP +.TP \fB\-n\fR, \fB\-\-domain\fR=\fIDOMAIN_NAME\fR Your DNS domain name -.TP +.TP \fB\-p\fR, \fB\-\-ds\-password\fR=\fIDM_PASSWORD\fR The password to be used by the Directory Server for the Directory Manager user -.TP +.TP \fB\-P\fR, \fB\-\-master\-password\fR=\fIMASTER_PASSWORD\fR The kerberos master password (normally autogenerated) -.TP +.TP \fB\-a\fR, \fB\-\-admin\-password\fR=\fIADMIN_PASSWORD\fR The password for the IPA admin user -.TP +.TP \fB\-d\fR, \fB\-\-debug\fR Enable debug logging when more verbose output is needed -.TP +.TP +\fB\-\-ca\fR +Configure a CA instance for issuing server certificates +.TP \fB\-\-hostname\fR=\fIHOST_NAME\fR The fully\-qualified DNS name of this server -.TP +.TP \fB\-\-ip\-address\fR=\fIIP_ADDRESS\fR The IP address of this server -.TP +.TP \fB\-U\fR, \fB\-\-unattended\fR An unattended installation that will never prompt for user input .TP @@ -59,7 +62,7 @@ An unattended installation that will never prompt for user input Generate a DNS zone if it does not exist already and configure the DNS server. This option requires that you either specify at least one DNS forwarder through the \fB\-\-forwarder\fR option or use the \fB\-\-no\-forwarders\fR option. -.TP +.TP \fB\-\-forwarder\fR=\fIIP_ADDRESS\fR Add a DNS forwarder to the DNS configuration. You can use this option multiple times to specify more forwarders, but at least one must be provided, unless @@ -68,8 +71,12 @@ the \fB\-\-no\-forwarders\fR option is specified. \fB\-\-no\-forwarders\fR Do not add any DNS forwarders. Root DNS servers will be used instead. .TP -\fB\-n\fR, \fB\-\-no\-ntp\fR +\fB\-\-no\-host\-dns\fR +Do not use DNS for hostname lookup during installation +.TP +\fB\-N\fR, \fB\-\-no\-ntp\fR Do not configure NTP +.TP \fB\-U\fR, \fB\-\-uninstall\fR Uninstall an existing IPA installation .TP @@ -84,13 +91,16 @@ The password of the Directory Server PKCS#12 file .TP \fB\-\-http_pin\fR=\fIHTTP_PIN\fR The password of the Apache Server PKCS#12 file -.PP +.TP \fB\-\-uidstart\fR=\fIUIDSTART\fR The starting user id number (default random) -.PP +.TP \fB\-\-gidstart\fR=\fIGIDSTART\fR The starting group id number (default random) -.PP +.TP +\fB\-\-subject\fR=\fISUBJECT\fR + The certificate subject base (default O=IPA) +.TP .SH "EXIT STATUS" 0 if the installation was successful -- cgit