Feature: link to the server guide for details on how to join complex AD setups with winbind

[panlinux]

Is there an existing request for this feature?

• I have searched the existing issues and found none that matched mine

Describe the feature

The Ubuntu Server guide now has more detailed documentation on joining Active Directory domains or forests using winbind.

This issue is to request that the page https://canonical-adsys.readthedocs-hosted.com/en/latest/how-to/join-ad-manually/ contains links to the ubuntu server guide, as described below, to cover other scenarios of joining an Active Directory domain or forest.

Under Explanation (https://ubuntu.com/server/docs/explanation), we have:

• Active Directory integration:
  • introduction https://ubuntu.com/server/docs/introduction-to-active-directory-integration
  • choosing an integration method https://ubuntu.com/server/docs/choosing-an-integration-method
  • security identifiers (SIDs) https://ubuntu.com/server/docs/security-identifiers-sids
  • identity mapping backends https://ubuntu.com/server/docs/identity-mapping-backends
  • The rid idmap backend https://ubuntu.com/server/docs/the-rid-backend
  • The autorid idmap backend https://ubuntu.com/server/docs/the-autorid-backend

Under How-to guides (https://ubuntu.com/server/docs/how-to) we have:

• Active Directory integration with winbind:
  • Preparing to join a domain with winbind https://ubuntu.com/server/docs/howto-active-directory-integration-joining-a-domain-preparation
  • Joining a simple domain with the rid backend https://ubuntu.com/server/docs/howto-active-directory-integration-joining-a-simple-domain-with-the-rid-backend
  • Joining a forest with the rid backend https://ubuntu.com/server/docs/howto-active-directory-integration-joining-a-forest-with-the-rid-backend
  • Joining a forest with the autorid backend https://ubuntu.com/server/docs/howto-active-directory-integration-joining-a-forest-with-the-autorid-backend

I don't have links to the actual top-level entries, as they are just menu items on the left. Maybe use the first link of each block (so https://ubuntu.com/server/docs/introduction-to-active-directory-integration and https://ubuntu.com/server/docs/howto-active-directory-integration-joining-a-domain-preparation), or any other you think is best. I may get better links after I show this to Sally, and if they change, I'll file another issue (or update this one).

Describe the ideal solution

No response

Alternatives and current workarounds

No response

Ubuntu users: System information

No response

Non Ubuntu users: System information

Environment

• adsys version: please run adsysctl version
• Distribution: (NAME in /etc/os-release)
• Distribution version: (VERSION_ID on /etc/os-release):

Log files

Please redact/remove sensitive information:

adsys service logs can be acquired by running `adsysctl service cat -v`.
You can increase the amount of information displayed by increasing the verbosity level (-v) to -vv or -vvv.

Application settings

Please redact/remove sensitive information:

Paste the contents of your adsys.yaml file here, if you created one.

Additional information

No response

Double check your logs

• I have redacted any sensitive information from the logs

[didrocks]

Thanks @panlinux! I agree this is some nice suggestion. Let me invoke @edibotopic our WSL/Desktop Enterprise documentation tech author who have the most context on how to organize this properly :)

[edibotopic]

Thanks @didrocks !

I think using a link to the first entry would work fine @panlinux -- we can always try to indicate in the wording that additional material will be found there also.

Before doing anything I will wait to see if you have any updates after talking with Sally.

Thank you for filing the issue.