Edit RST install guide for clarity and accuracy
[krb5.git] / doc / rst_source / krb_admins / install_kdc / krb_daemon.rst
1 .. _start_kdc_daemons:
2
3 Start the Kerberos daemons on the master KDC
4 ============================================
5
6 At this point, you are ready to start the Kerberos KDC
7 (:ref:`krb5kdc(8)`) and administrative daemons on the Master KDC.  To
8 do so, type::
9
10     shell% /usr/local/sbin/krb5kdc
11     shell% /usr/local/sbin/kadmind
12
13 Each server daemon will fork and run in the background.
14
15 .. note:: Assuming you want these daemons to start up automatically at
16           boot time, you can add them to the KDC's ``/etc/rc`` or
17           ``/etc/inittab`` file.  You need to have a
18           :ref:`stash_definition` in order to do this.
19
20 You can verify that they started properly by checking for their
21 startup messages in the logging locations you defined in
22 :ref:`krb5.conf(5)` (see :ref:`logging`).  For example::
23
24     shell% tail /var/log/krb5kdc.log
25     Dec 02 12:35:47 beeblebrox krb5kdc[3187](info): commencing operation
26     shell% tail /var/log/kadmin.log
27     Dec 02 12:35:52 beeblebrox kadmind[3189](info): starting
28
29 Any errors the daemons encounter while starting will also be listed in
30 the logging output.
31
32 As an additional verification, check if :ref:`kinit(1)` succeeds
33 against the principals that you have created on the previous step
34 (:ref:`addadmin_kdb`).  Run::
35
36     shell% /usr/local/bin/kinit admin/admin@ATHENA.MIT.EDU
37
38
39 Feedback
40 --------
41
42 Please, provide your feedback or suggest a new topic at
43 krb5-bugs@mit.edu?subject=Documentation___install_kdc