2008-03-17 17:04:49 -05:00
. \" 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 <rcritten@redhat.com>
. \"
.TH "ipa-server-install" "1" "Mar 14 2008" "freeipa" ""
.SH "NAME"
ipa\- server\- install \- Configure an IPA server
.SH "SYNOPSIS"
ipa\- server\- install [\fI OPTION\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
\fB \- u\fR , \fB \- \- user\fR =\fI DS_USER\fR
The user that the Directory Server will run as
.TP
\fB \- r\fR , \fB \- \- realm\fR =\fI REALM_NAME\fR
The Kerberos realm name for the IPA server
.TP
\fB \- n\fR , \fB \- \- domain\fR =\fI DOMAIN_NAME\fR
Your DNS domain name
.TP
\fB \- p\fR , \fB \- \- ds\- password\fR =\fI DM_PASSWORD\fR
The password to be used by the Directory Server for the Directory Manager user
.TP
\fB \- P\fR , \fB \- \- master\- password\fR =\fI MASTER_PASSWORD\fR
The kerberos master password (normally autogenerated)
.TP
\fB \- a\fR , \fB \- \- admin\- password\fR =\fI ADMIN_PASSWORD\fR
The password for the IPA admin user
.TP
\fB \- d\fR , \fB \- \- debug\fR
Enable debug logging when more verbose output is needed
.TP
\fB \- \- hostname\fR =\fI HOST_NAME\fR
The fully\- qualified DNS name of this server
.TP
\fB \- \- ip\- address\fR =\fI IP_ADDRESS\fR
The IP address of this server
.TP
\fB \- U\fR , \fB \- \- unattended\fR
An unattended installation that will never prompt for user input
.TP
\fB \- \- setup\- bind\fR
Generate a DNS zone file that contains auto\- discovery records for this IPA server
.TP
\fB \- n\fR , \fB \- \- no\- ntp\fR
Do not configure NTP
2008-07-11 10:34:29 -05:00
\fB \- U\fR , \fB \- \- uninstall\fR
2008-03-17 17:04:49 -05:00
Uninstall an existing IPA installation
2008-07-11 10:34:29 -05:00
.TP
\fB \- \- dirsrv_pkcs12\fR =\fI FILE\fR
PKCS#12 file containing the Directory Server SSL Certificate
.TP
\fB \- \- http_pkcs12\fR =\fI FILE\fR
PKCS#12 file containing the Apache Server SSL Certificate
.TP
\fB \- \- dirsrv_pin\fR =\fI DIRSRV_PIN\fR
The password of the Directory Server PKCS#12 file
.TP
\fB \- \- http_pin\fR =\fI HTTP_PIN\fR
The password of the Apache Server PKCS#12 file
2008-03-17 17:04:49 -05:00
.PP
.SH "EXIT STATUS"
0 if the installation was successful
1 if an error occurred