Bug 53584 – In documentation, inform about missing DNS-Server-Entry in dhcp-dns-policy if not using import_networks-script

Bug 53584 - In documentation, inform about missing DNS-Server-Entry in dhcp-dns-policy if not using import_networks-script


Summary:	In documentation, inform about missing DNS-Server-Entry in dhcp-dns-policy i...

Status:	CLOSED FIXED

Product:	UCS@school
Classification:	Unclassified
Component:	Documentation
Version:	UCS@school 4.4
Hardware:	Other Mac OS X 10.1

Importance:	P5 normal (vote)
Target Milestone:	---
Assigned To:	Nico Gulden
QA Contact:	Jürn Brodersen

URL:	https://git.knut.univention.de/univen...
Keywords:

Depends on:
Blocks:
	Show dependency tree / graph

Reported:	2021-07-15 15:53 CEST by Daniel Duchon
Modified:	2023-08-28 12:44 CEST (History)
CC List:	2 users (show)

See Also:
What kind of report is it?:	Bug Report
What type of bug is this?:	1: Cosmetic issue or missing function but workaround exists
Who will be affected by this bug?:	1: Will affect a very few installed domains
How will those affected feel about the bug?:	1: Nuisance – not a big deal but noticeable
User Pain:	0.006
Enterprise Customer affected?:
School Customer affected?:	Yes
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:	2021071221000181
Bug group (optional):
Max CVSS v3 score:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description Daniel Duchon

2021-07-15 15:53:04 CEST

If you not use the import_networks-script after creating a school, the DNS-Entry is missing in the dhcp-dns-policy because of the missing subnet and server IP.

Please add a note in the documentation that actively points out this fact and which objects are to be edited manually afterwards.

Comment 1 Dirk Ahrnke

2021-07-16 13:50:50 CEST

https://docs.software-univention.de/ucsschool-handbuch-4.4.html#school:schoolcreate:network:import states

"Das Importieren von Subnetzen empfiehlt sich in größeren UCS@school-Umgebungen. Kleinere Umgebungen können diesen Schritt häufig überspringen, da fehlende Netzwerke beim Import von Rechnerkonten automatisch angelegt werden. "

when reading this I would not expect to have to do manual steps after the software did things for me automatically. 

Es empfiehlt sich, die Phrase "es empfiehlt sich" in einer Dokumentation mit Bedacht zu verwenden.

Comment 3 Nico Gulden

2023-08-18 10:57:50 CEST

Discussion with Jürn:

* In smaller school environments, administrators only use the computer import. It creates network objects, but no DHCP policies.

* The script `import_networks` creates network objects **with** DHPC policies about the NetBios and DNS servers

* Recommended scenario: UCS is responsible for DHCP leases to clients

Next steps:

* Rework the section 4.4 in the UCS@school 5.0 manual to reflect the above points: https://docs.software-univention.de/ucsschool-manual/5.0/de/manage-school-imports.html#skriptbasierter-import-von-netzwerken

* Improve the example and use tabs instead of spaces to make it copy-able.

Comment 4 Nico Gulden

2023-08-28 10:54:40 CEST

Feedback received and included in the merge request. Ready for merge, build and publish.

Comment 5 Jürn Brodersen

2023-08-28 11:24:22 CEST

Looks good to me :)

The documentation now describes what the import does, explains what an administrator might have to do manually if they not use the script and where to find further documentation on how to do it.

-> Verified

Comment 6 Nico Gulden

2023-08-28 12:43:44 CEST

Changes are built and on their way to the public:

35bad5309 | Bug #53584: Rework section about `import_networks`

Comment 7 Nico Gulden

2023-08-28 12:44:20 CEST

The updated content locates at https://docs.software-univention.de/ucsschool-manual/5.0/de/manage-school-imports.html#skriptbasierter-import-von-netzwerken