Imported Upstream version 1.10.2
[platform/upstream/krb5.git] / doc / rst_source / krb_admins / database / ldap_operations / edir_so_pass.rst
1 eDir: Passwords for Service Objects
2 ============================================
3
4 The command *setsrvpw* allows an administrator to set password for service objects such as KDC and Administration server in eDirectory and store them in a file. The syntax is::
5
6    setsrvpw [-randpw|-fileonly][-f filename] service_dn
7
8 Options are as follows:
9
10 ================= =================================================================
11 -randpw            Generates and sets a random password on the directory object and stores it in the file. The -fileonly option can not be used if -randpw option is already specified. 
12 -fileonly          Stores the password only in a file and not in eDirectory. The -randpw option can not be used when -fileonly option is specified. 
13 -f *filename*      Specifies the complete path of the file where the service object password is stashed. If this option is not specified, the default file will be /usr/local/var/service_passwd. 
14 service_dn         Specifies the Distinguished Name (DN) of the service object whose password is to be set. 
15 ================= =================================================================
16
17 For example::
18
19      shell% kdb5_ldap_util setsrvpw -D cn=admin,dc=example,dc=com -H ldaps://ldap-server1.mit.edu
20      setsrvpw -f /home/andrew/conf_keyfile cn=service-kdc,dc=example,dc=com
21
22
23      Password for "cn=admin,dc=example,dc=com":
24      Password for "cn=service-kdc,dc=example,dc=com":
25      Re-enter password for "cn=service-kdc,dc=example,dc=com":
26      shell%
27      
28
29 ------------
30
31 Feedback:
32
33 Please, provide your feedback at krb5-bugs@mit.edu?subject=Documentation___edir
34
35