2014-06-16 03:41:57 -05:00
|
|
|
.\" A man page for ipa-ca-install
|
2011-06-17 15:47:39 -05:00
|
|
|
.\" Copyright (C) 2011 Red Hat, Inc.
|
|
|
|
|
.\"
|
|
|
|
|
.\" This program is free software; you can redistribute it and/or modify
|
|
|
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
|
|
|
.\" the Free Software Foundation, either version 3 of the License, or
|
|
|
|
|
.\" (at your option) any later version.
|
|
|
|
|
.\"
|
|
|
|
|
.\" 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 General Public License
|
|
|
|
|
.\" along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Author: Rob Crittenden <rcritten@redhat.com>
|
|
|
|
|
.\"
|
2011-09-05 04:04:17 -05:00
|
|
|
.TH "ipa-ca-install" "1" "Jun 17 2011" "FreeIPA" "FreeIPA Manual Pages"
|
2011-06-17 15:47:39 -05:00
|
|
|
.SH "NAME"
|
2014-06-16 03:41:57 -05:00
|
|
|
ipa\-ca\-install \- Install a CA on a server
|
2011-06-17 15:47:39 -05:00
|
|
|
.SH "SYNOPSIS"
|
2014-06-16 03:41:57 -05:00
|
|
|
ipa\-ca\-install [\fIOPTION\fR]... [replica_file]
|
2011-06-17 15:47:39 -05:00
|
|
|
.SH "DESCRIPTION"
|
|
|
|
|
Adds a CA as an IPA\-managed service. This requires that the IPA server is already installed and configured.
|
|
|
|
|
|
|
|
|
|
The replica_file is created using the ipa\-replica\-prepare utility and should be the same one used when originally installing the replica.
|
2014-06-16 03:41:57 -05:00
|
|
|
|
|
|
|
|
Alternatively, you can run ipa\-ca\-install without replica_file to upgrade from CA-less to CA-full.
|
2011-06-17 15:47:39 -05:00
|
|
|
.SH "OPTIONS"
|
|
|
|
|
\fB\-d\fR, \fB\-\-debug\fR
|
|
|
|
|
Enable debug logging when more verbose output is needed
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-p\fR \fIDM_PASSWORD\fR, \fB\-\-password\fR=\fIDM_PASSWORD\fR
|
|
|
|
|
Directory Manager (existing master) password
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-w\fR \fIADMIN_PASSWORD\fR, \fB\-\-admin\-password\fR=\fIADMIN_PASSWORD\fR
|
|
|
|
|
Admin user Kerberos password used for connection check
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-host\-dns\fR
|
|
|
|
|
Do not use DNS for hostname lookup during installation
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-skip\-conncheck\fR
|
|
|
|
|
Skip connection check to remote master
|
|
|
|
|
.TP
|
Fix schema replication from old masters
The new merged database will replicate with both the IPA and CA trees, so all
DS instances (IPA and CA on the existing master, and the merged one on the
replica) need to have the same schema.
Dogtag does all its schema modifications online. Those are replicated normally.
The basic IPA schema, however, is delivered in ldif files, which are not
replicated. The files are not present on old CA DS instances. Any schema
update that references objects in these files will fail.
The whole 99user.ldif (i.e. changes introduced dynamically over LDAP) is
replicated as a blob. If we updated the old master's CA schema dynamically
during replica install, it would conflict with updates done during the
installation: the one with the lower CSN would get lost.
Dogtag's spawn script recently grew a new flag, 'pki_clone_replicate_schema'.
Turning it off tells Dogtag to create its schema in the clone, where the IPA
modifications are taking place, so that it is not overwritten by the IPA schema
on replication.
The patch solves the problems by:
- In __spawn_instance, turning off the pki_clone_replicate_schema flag.
- Providing a script to copy the IPA schema files to the CA DS instance.
The script needs to be copied to old masters and run there.
- At replica CA install, checking if the schema is updated, and failing if not.
The --skip-schema-check option is added to ipa-{replica,ca}-install to
override the check.
All pre-3.1 CA servers in a domain will have to have the script run on them to
avoid schema replication errors.
https://fedorahosted.org/freeipa/ticket/3213
2012-10-24 03:37:16 -05:00
|
|
|
\fB\-\-skip\-schema\-check\fR
|
|
|
|
|
Skip check for updated CA DS schema on the remote master
|
|
|
|
|
.TP
|
2011-06-17 15:47:39 -05:00
|
|
|
\fB\-U\fR, \fB\-\-unattended\fR
|
|
|
|
|
An unattended installation that will never prompt for user input
|
|
|
|
|
.SH "EXIT STATUS"
|
|
|
|
|
0 if the command was successful
|
|
|
|
|
|
|
|
|
|
1 if an error occurred
|
