Revision as of 00:53, 9 July 2014

Associated release criterion
This test case is associated with the Basic_Release_Criteria#remote-authentication release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.

Description

Join the current machine to a FreeIPA domain. Domain accounts are available on the local machine once this is done.

This testcase assumes you have already set up a FreeIPA domain (named "ipa.example.org"). If you haven't, you can set one up.
Your machine must have a configured host name. Do not proceed if your host name is localhost or similar.
```
$ hostname
```
Make sure you have realmd-0.13.3-2 or later installed.
```
$ yum list realmd
```

Check that the domain is now configured.
```
$ realm list
```
Make sure the domain is listed.

Make sure you have a configured: kerberos-member line in the output.

Make note of the login-formats line for the next command.
Check that you can resolve domain accounts on the local computer.
```
$ getent passwd admin@ipa.example.org
```
You should see an output line that looks like passwd(5) output. It should contain an appropriate home directory, and a shell.

Use the login-formats you saw above, to build a remote user name. It will be in the form of $user@$fqdn, where fqdn is your fully qualified IPA domain name (e.g. ipa.example.org).
Check that you have an appropriate entry in your hosts keytab.
```
sudo klist -k
```
You should see several lines, with your host name. For example 1 host/$hostname@$FQDN
Check that you can use your keytab with kerberos
```
sudo kinit -k host/client.ipa.example.org@IPA.EXAMPLE.ORG
```
Make sure the domain name is capitalized.

Use the principal from the output of the klist command above. Use the one that's capitalized and looks like host/$hostname@$FQDN.

There should be no output from this command.
If you have set up the FreeIPA Web UI, you can use it to see that the computer account was created under the Hosts section.

Use the --verbose argument to see details of what's being done during a join. Include verbose output in any bug reports.

$ realm join --verbose ipa.example.org

@@ Line 1: / Line 1: @@
+{{Template:Associated_release_criterion|Alpha|remote-authentication}}
 {{QA/Test_Case
 |description=Join the current machine to a FreeIPA domain. Domain accounts are available on the local machine once this is done.