ipa-addservice (1) Linux Manual Page

ipa-addservice – Add a service principal

Synopsis

ipa-addservice [OPTION]… principal

Description

Adds a service principal principal.

The principal takes the form of:

service/fully-qualified-hostname

The list of possible services is too extensive to list here but a short list is:

cifs dns host HTTP ldap nfs

The IPA server automatically appends the Kerberos realm for which it is configured. You cannot specify a different realm.

The hostname must resolve to a DNS A record in order to ensure that it will work with Kerberos. Use the –force flag to force the creation of a principal.

Options

–force

Force the creation of the given principal name.

-v, –verbose

Display the XML-RPC request and response for more verbose debugging output.

Examples

ipa-addservice HTTP/www.example.com

Add a service principal for a web server

ipa-addservice host/ipa.example.com

Add a service principal for the host (for ssh, for example)

Exit Status

The exit status is 0 on success, nonzero on error.