Feature: link to the server guide for details on how to join complex AD setups with winbind
panlinux opened this issue · 2 comments
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
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 :)
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.