usr/src/man/man1m/kprop.1m

   1 '\" te
   2 .\" Copyright 1987, 1989 by the Student Information Processing Board of the Massachusetts Institute of Technology.  For copying and distribution information,  please see the file kerberosv5/mit-sipb-copyright.h.
   3 .\" Portions Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH KPROP 1M "Oct 29, 2015"
   8 .SH NAME
   9 kprop \- Kerberos database propagation program
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/lib/krb5/kprop\fR [\fB-d\fR] [\fB-f\fR \fIfile\fR] [\fB-p\fR \fIport-number\fR]
  14      [\fB-r\fR \fIrealm\fR] [\fB-s\fR \fIkeytab\fR] [\fIhost\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 \fBkprop\fR is a command-line utility used for propagating a Kerberos database
  21 from a master \fBKDC\fR to a slave \fBKDC\fR. This command must be run on the
  22 master \fBKDC\fR. See the \fISolaris System Administration Guide, Vol. 6\fR on
  23 how to set up periodic propagation between the master \fBKDC\fR and slave
  24 \fBKDC\fRs.
  25 .sp
  26 .LP
  27 To propagate a Kerberos database, the following conditions must be met:
  28 .RS +4
  29 .TP
  30 .ie t \(bu
  31 .el o
  32 The slave \fBKDC\fRs must have an \fB/etc/krb5/kpropd.acl\fR file that contains
  33 the principals for the master \fBKDC\fR and all the slave \fBKDC\fRs.
  34 .RE
  35 .RS +4
  36 .TP
  37 .ie t \(bu
  38 .el o
  39 A keytab containing a host principal entry must exist on each slave \fBKDC\fR.
  40 .RE
  41 .RS +4
  42 .TP
  43 .ie t \(bu
  44 .el o
  45 The database to be propagated must be dumped to a file using
  46 \fBkdb5_util\fR(1M).
  47 .RE
  48 .SH OPTIONS
  49 .sp
  50 .LP
  51 The following options are supported:
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-d\fR\fR
  56 .ad
  57 .RS 18n
  58 Enable debug mode. Default is debug mode disabled.
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB-f\fR \fIfile\fR\fR
  65 .ad
  66 .RS 18n
  67 File to be sent to the slave \fBKDC\fR. Default is the
  68 \fB/var/krb5/slave_datatrans\fR file.
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fB-p\fR \fIport-number\fR\fR
  75 .ad
  76 .RS 18n
  77 Propagate \fIport-number\fR. Default is port \fB754\fR.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fB-r\fR \fIrealm\fR\fR
  84 .ad
  85 .RS 18n
  86 Realm where propagation will occur. Default \fIrealm\fR is the local realm.
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-s\fR \fIkeytab\fR\fR
  93 .ad
  94 .RS 18n
  95 Location of the keytab. Default location is \fB/etc/krb5/krb5.keytab\fR.
  96 .RE
  97
  98 .SH OPERANDS
  99 .sp
 100 .LP
 101 The following operands are supported:
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fIhost\fR\fR
 106 .ad
 107 .RS 8n
 108 Name of the slave \fBKDC\fR.
 109 .RE
 110
 111 .SH EXAMPLES
 112 .LP
 113 \fBExample 1 \fRPropagating the Kerberos Database
 114 .sp
 115 .LP
 116 The following example propagates the Kerberos database from the
 117 \fB/tmp/slave_data\fR file to the slave \fBKDC\fR \fBlondon\fR. The machine
 118 \fBlondon\fR must have a host principal keytab entry and the \fBkpropd.acl\fR
 119 file must contain an entry for the all the \fBKDC\fRs.
 120
 121 .sp
 122 .in +2
 123 .nf
 124 # kprop -f /tmp/slave_data london
 125 .fi
 126 .in -2
 127 .sp
 128
 129 .SH FILES
 130 .sp
 131 .ne 2
 132 .na
 133 \fB\fB/etc/krb5/kpropd.acl\fR\fR
 134 .ad
 135 .RS 29n
 136 List of principals of all the KDCs; resides on each slave KDC.
 137 .RE
 138
 139 .sp
 140 .ne 2
 141 .na
 142 \fB\fB/etc/krb5/krb5.keytab\fR\fR
 143 .ad
 144 .RS 29n
 145 Keytab for Kerberos clients.
 146 .RE
 147
 148 .sp
 149 .ne 2
 150 .na
 151 \fB\fB/var/krb5/slave_datatrans\fR\fR
 152 .ad
 153 .RS 29n
 154 Kerberos database propagated to the KDC slaves.
 155 .RE
 156
 157 .SH SEE ALSO
 158 .sp
 159 .LP
 160 \fBkpasswd\fR(1), \fBsvcs\fR(1), \fBinetadm\fR(1M),
 161 \fBinetd\fR(1M), \fBkadmind\fR(1M), \fBkadmin.local\fR(1M),
 162 \fBkdb5_util\fR(1M), \fBsvcadm\fR(1M), \fBkadm5.acl\fR(4), \fBkdc.conf\fR(4),
 163 \fBattributes\fR(5), \fBkerberos\fR(5), \fBsmf\fR(5)
 164 .sp
 165 .LP
 166 \fI\fR