1ipa-addservice(1)                                            ipa-addservice(1)
2
3
4

NAME

6       ipa-addservice - Add a service principal
7
8

SYNOPSIS

10       ipa-addservice [OPTION]... principal
11

DESCRIPTION

13       Adds a service principal principal.
14
15       The principal takes the form of:
16
17       service/fully-qualified-hostname
18
19       The list of possible services is too extensive to list here but a short
20       list is:
21
22       cifs dns host HTTP ldap nfs
23
24       The IPA server automatically appends the Kerberos realm for which it is
25       configured. You cannot specify a different realm.
26
27       The  hostname must resolve to a DNS A record in order to ensure that it
28       will work with Kerberos. Use the --force flag to force the creation  of
29       a principal.
30

OPTIONS

32       --force
33              Force the creation of the given principal name.
34
35       -v, --verbose
36              Display the XML-RPC request and response for more verbose debug‐
37              ging output.
38

EXAMPLES

40       ipa-addservice HTTP/www.example.com
41              Add a service principal for a web server
42
43       ipa-addservice host/ipa.example.com
44              Add a service principal for the host (for ssh, for example)
45

EXIT STATUS

47       The exit status is 0 on success, nonzero on error.
48
49
50
51freeipa                           Jan 4 2008                 ipa-addservice(1)