5d252f9f04Updates documentation starter pack from 1.0.1 to 1.3. Most of the changes introduced are not user-facing and relate the internals of the documentation system. For example, Canonical extensions used with Sphinx have been split up into packages and the extension for rendering terminal output has been modified, a breaking change which required some modifications in the syntax that we used. The sitemaps generated for SEO have been updated to include a last modified date. There has also been some additional simplification of the files and the docs tests that can be run with `make <test>`. Changes from 1.0 to 1.3 can be found in the starter pack releases page: https://github.com/canonical/sphinx-docs-starter-pack/releases UDENG-8558 |
||
|---|---|---|
| .github | ||
| cmd | ||
| conf.example | ||
| debian | ||
| docs | ||
| e2e | ||
| installer | ||
| internal | ||
| pam | ||
| po | ||
| policies | ||
| systemd | ||
| tools | ||
| .clang-format | ||
| .gitignore | ||
| .golangci.yaml | ||
| adsys.pb.go | ||
| adsys.proto | ||
| adsys_grpc.pb.go | ||
| CONTRIBUTING.md | ||
| generate.go | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| NOTICE | ||
| package-build-tool.go | ||
| README.md | ||
| SECURITY.md | ||
adsys
Active Directory GPO support.
Documentation and Usage
The documentation and the command line reference is available on Read The Docs as well as the documentation for the current development release.
Installing development versions
For every commit on the main branch of the adsys repository, the GitHub Actions CI builds a development version of the adwatchd project. This is NOT a stable version of the application and should not be used for production purposes. However, it may prove useful to preview features or bugfixes not yet available as part of a stable release.
To get access to the build artifact you need to be logged in on GitHub. Then, click on any passing run of the QA workflow that has the Windows tests for adwatchd job, and look for the adwatchd_setup file.
Troubleshooting
If AD authentication works but adsys fails to fetch GPOs (e.g. you see can't get policies errors on login), please perform the following steps:
- Add the following to
/etc/samba/smb.conf:
log level = 10
-
Run
sudo login {user}@{domain}in a terminal, replacing with your AD credentials -
Paste the output in the bug report
The adsysctl command can also be useful to fetch logs for the daemon and client:
# You can increase the amount of information that will be displayed by using a more verbose tag (-vv or -vvv).
# Note that this command will start a watcher that will print logs as they are generated, so you will need to perform
# actions (such as trying to login) while the command is running.
adsysctl service cat -v
Additionally, you can check the system journal to look at more logs about adsys: Remember that adsys runs with privileges, so you will need to run the following commands as root.
# You can use the -b flag to control how many boots the log will show (e.g. -b 0 will show the current boot only)
journalctl -b0 | grep adsys
# You can also get the logs of the individual units:
systemctl list-units | grep adsys # this will show all adsys related systemd units
# The -u flag will show the logs of the specified unit
journalctl -b0 -u adsysd.service # this command will only show the adsysd.service logs of the current boot