From Fedora Project Wiki

(Template page)
(Rearrange installation instructions)
 
(8 intermediate revisions by 3 users not shown)
Line 2: Line 2:
|description=Join the current machine to an Active Directory using OpenLMI
|description=Join the current machine to an Active Directory using OpenLMI
|setup=
|setup=
# TODO TODO TODO TODO This page is not done
# We need to gather SELinux AVC's, be sure to gather all AVC's generated by this test case. See Troubleshooting section below
# Fulfill the [[QA:Testcase_realmd_prerequisites|prerequisites and make sure your Active Directory domain access works]].
#: <pre>$ sudo setenforce 0</pre>
# XXX Requirements to satisfy first
# Install the components
# XXX Setup step
#: <pre>$ sudo yum install tog-pegasus pywbem realmd</pre>
# XXX Setup step
# Download the realm CIM scriptlet
#: XXX Setup substep
#: <pre>$ sudo wget -O /usr/local/bin/realmd-cim http://jdennis.fedorapeople.org/realmd-cim</pre>
# Make it executable
#: <pre>$ sudo chmod +x /usr/local/bin/realmd-cim</pre>
# Start the pgasus CIMOM
#: <pre>$ sudo systemctl start tog-pegasus.service</pre>
# Verify pegasus is running
#: <pre>$ sudo systemctl status tog-pegasus</pre>
# Make sure you have other required software:
#* realmd 0.14.0 or later
#* adcli 0.7 or later
#* openlmi-providers 0.21 or later
#: <pre>$ sudo yum install realmd openlmi-providers openlmi-realmd</pre>
# Verify the OpenLMI Realmd provider is properly registered
#:  <pre>$ sudo cimprovider -l</pre>
# If the previous command did not list cmpiLMI_Realmd register the provider manually
#: <pre>$ sudo openlmi-mof-register register /usr/share/openlmi-providers/60_LMI_Realmd.mof /usr/share/openlmi-providers/60_LMI_Realmd.reg</pre>
# Set the pegasus password, in this example we'll use XXXX as the password
#: <pre>$ sudo passwd pegasus</pre>
# Verify that your [[QA:Testcase_Active_Directory_Setup|Active Directory domain access works, or set a domain up]].


|actions=
|actions=
# XXX Step to run the join command
# Show joined domains
#: XXX Notes about what should be seen
<pre>
# XXX Press enter to boot and run the installation.
$ realm list
$ realmd-cim -u pegasus -p XXXX list
</pre>
<code>realmd-cim</code> should show equivalent information as to what <code>realmd-cim</code> shows
 
# Join a domain
<pre>
$ realmd-cim -u pegasus -p XXXX join Administrator DomainPassword ad.example.com
</pre>


|results=
|results=
Line 34: Line 60:
#: This should automatically create a new home directory for the user, and log into a shell prompt.
#: This should automatically create a new home directory for the user, and log into a shell prompt.
}}
}}
=== More: Explore the realmd-cim script ===
Use <code>realmd-cim --help</code> to see how to leave a domain.


=== More: Try it with FreeIPA ===
=== More: Try it with FreeIPA ===
Line 41: Line 71:
== Troubleshooting ==
== Troubleshooting ==


* {{bz|XXXXXX}} If you see '''SELinux issues''' see this bug for details.
* {{bz|961207}} When you see SELinux AVC's report them AVC's to this bug.
** Please do this and report all AVC's to the above bug.
<pre>
<pre>
$ sudo setenforce permissive
$ sudo setenforce permissive
... do the test
... do the test
$ sudo grep realmd /var/log/audit/audit.log
$ sudo less /var/log/audit/audit.log
</pre>
</pre>


[[Category:Active_Directory_Test_Cases]] [[Category:Realmd_Test_Cases]]
[[Category:Active_Directory_Test_Cases]] [[Category:Realmd_Test_Cases]]

Latest revision as of 11:49, 14 May 2013

Description

Join the current machine to an Active Directory using OpenLMI

Setup

  1. We need to gather SELinux AVC's, be sure to gather all AVC's generated by this test case. See Troubleshooting section below
    $ sudo setenforce 0
  2. Install the components
    $ sudo yum install tog-pegasus pywbem realmd
  3. Download the realm CIM scriptlet
    $ sudo wget -O /usr/local/bin/realmd-cim http://jdennis.fedorapeople.org/realmd-cim
  4. Make it executable
    $ sudo chmod +x /usr/local/bin/realmd-cim
  5. Start the pgasus CIMOM
    $ sudo systemctl start tog-pegasus.service
  6. Verify pegasus is running
    $ sudo systemctl status tog-pegasus
  7. Make sure you have other required software:
    • realmd 0.14.0 or later
    • adcli 0.7 or later
    • openlmi-providers 0.21 or later
    $ sudo yum install realmd openlmi-providers openlmi-realmd
  8. Verify the OpenLMI Realmd provider is properly registered
    $ sudo cimprovider -l
  9. If the previous command did not list cmpiLMI_Realmd register the provider manually
    $ sudo openlmi-mof-register register /usr/share/openlmi-providers/60_LMI_Realmd.mof /usr/share/openlmi-providers/60_LMI_Realmd.reg
  10. Set the pegasus password, in this example we'll use XXXX as the password
    $ sudo passwd pegasus
  11. Verify that your Active Directory domain access works, or set a domain up.

How to test

  1. Show joined domains
$ realm list
$ realmd-cim -u pegasus -p XXXX list

realmd-cim should show equivalent information as to what realmd-cim shows

  1. Join a domain
$ realmd-cim -u pegasus -p XXXX join Administrator DomainPassword ad.example.com

Expected Results

  1. Check if you are joined to the domain
    realm list
    The domain should be listed
    Make note of the login format
  2. Check that domain accounts can be resolved
    getent passwd 'AD\User'
    Make sure to use the quotes around the user name.
    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 DOMAIN\User, where DOMAIN is the first part of your full Active Directory domain name.
  3. Check that you have an appropriate entry in your hosts keytab.
    sudo klist -k
  4. Check that you can use your keytab with kerberos
    sudo kinit -k 'HOSTNAME$@AD.EXAMPLE.COM'
    Make sure to use quotes around the argument, because of the characters in there. #: Make sure the hostname and domain are capitalized.
    Use the principal from the output of the klist command above. Use the one that's capitalized and looks like HOSTNAME$@DOMAIN.
    There should be no output from this command.
  5. Try to log into the machine as a domain account at the console.
    This should automatically create a new home directory for the user, and log into a shell prompt.



More: Explore the realmd-cim script

Use realmd-cim --help to see how to leave a domain.

More: Try it with FreeIPA

Use a FreeIPA domain with the OpenLMI join.

Troubleshooting

  • RHBZ #961207 When you see SELinux AVC's report them AVC's to this bug.
$ sudo setenforce permissive
... do the test
$ sudo less /var/log/audit/audit.log