Bug 45853 - error in UCR description and performance guide concerning ldap/database/mdb/envflags
Summary: error in UCR description and performance guide concerning ldap/database/mdb/e...
Status: CLOSED FIXED
Alias: None
Product: UCS extended documentation
Classification: Unclassified
Component: Performance guide
Version: unspecified
Hardware: Other Linux
: P5 normal
Target Milestone: UCS 4.2
Assignee: Stefan Gohmann
QA Contact: Philipp Hahn
URL:
Keywords:
Depends on:
Blocks: 47869
  Show dependency treegraph
 
Reported: 2017-12-11 19:10 CET by Daniel Tröder
Modified: 2019-02-07 09:48 CET (History)
2 users (show)

See Also:
What kind of report is it?: Bug Report
What type of bug is this?: 3: Simply Wrong: The implementation doesn't match the docu
Who will be affected by this bug?: 2: Will only affect a few installed domains
How will those affected feel about the bug?: 2: A Pain – users won’t like this once they notice it
User Pain: 0.069
Enterprise Customer affected?: Yes
School Customer affected?:
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number: 2018061221000386
Bug group (optional):
Customer ID:
Max CVSS v3 score:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Daniel Tröder univentionstaff 2017-12-11 19:10:59 CET
The performance guide states regarding UCRV "ldap/database/mdb/envflags":

"The following flags can be set (multiple values are separated by commas):"
and the UCRV description says "Multiple attributes are separated by commas." but that doesn't work:

# ucr set ldap/database/mdb/envflags=nosync,writemap
# service slapd restart
Job for slapd.service failed. See 'systemctl status slapd.service' and 'journalctl -xn' for details.
# systemctl status -l slapd.service

Dez 11 18:59:30 master41 slapd[4111]: 5a2ec782 OVER: Loading Translog Overlay 5a2ec782 OVER: db_init 5a2ec782 OVER: Configuring Translog Overlay 5a2ec782 OVER: Configured Translog Overlay to use file "/var/lib/univention-ldap/listener/listener" 5a2ec782 /etc/ldap/slapd.conf: line 124 envflags: unknown keyword "nosync,writemap" slapschema: bad configuration file!.
Comment 1 Christian Völker univentionstaff 2018-07-05 08:56:36 CEST
Customer affected.

Instead of commas the flags have to be separated by spaces.
Do not use:

# ucr set ldap/database/mdb/envflags=nosync,writemap

Use:

# ucr set ldap/database/mdb/envflags="nosync writemap"


Once configured like this slapd starts fine.


Direct link to doc:
http://docs.software-univention.de/performance-guide-4.2.html#slapd:bdb


man slpad-mdb is not clear regarding this and should fixed, too:

envflags {nosync,nometasync,writemap,mapasync,nordahead}
         Specify flags for finer-grained control of the LMDB library's operation.

Apears commas are correct here. But are not.
Comment 2 Stefan Gohmann univentionstaff 2018-09-27 08:07:21 CEST
Fixed:

[4.3-2 7d02e1f05c] Bug #45853: Use spaces instead of commas to add multiple values to the UCR variable ldap/database/mdb/envflags

I've created a new Bug for the UCR description in univention-ldap: https://forge.univention.org/bugzilla/show_bug.cgi?id=47869
Comment 3 Philipp Hahn univentionstaff 2018-10-02 17:20:31 CEST
OK: 7d02e1f05c
Comment 4 Stefan Gohmann univentionstaff 2018-10-16 16:46:55 CEST
Remove 'Waiting Support flag' since it does not match our definitions.
Comment 5 Philipp Hahn univentionstaff 2018-10-22 10:53:32 CEST
[master] 4056994 Bug #48006,Bug #44780,Bug #47970,Bug #45853: publish
 developer-reference-4.3.html              |  52 +++++++++++++++++-------------
 developer-reference-4.3.pdf               | Bin 1433745 -> 1453779 bytes
 illustrations43/versicherung-standort.jpg | Bin 0 -> 267585 bytes
 performance-guide-4.3.html                |   6 ++--
 performance-guide-4.3.pdf                 | Bin 431927 -> 430664 bytes
 5 files changed, 31 insertions(+), 27 deletions(-)
Comment 6 Christian Völker univentionstaff 2019-01-24 11:19:15 CET
Request to fix it for the 4.2 performance guide, too.
http://docs.software-univention.de/performance-guide-4.2.html#slapd:bdb

This still says "separated by commas".
Comment 7 Philipp Hahn univentionstaff 2019-02-07 09:43:40 CET
[4.2-5] 60432187a6 Bug #45853: Use spaces instead of commas to add multiple values to the UCR variable ldap/database/mdb/envflags
 doc/extended-docs/performance-guide-4.2.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)


<http://jenkins.knut.univention.de:8080/job/UCS-4.2/job/UCS-4.2-5/job/HandbookExtended/120/artifact/webroot/performance-guide-4.2.html#slapd:bdb>
Comment 8 Philipp Hahn univentionstaff 2019-02-07 09:48:05 CET
OK: <http://univention-repository.knut.univention.de/download/docs/performance-guide-4.2.html>
OK: <http://univention-repository.knut.univention.de/download/docs/performance-guide-4.2.pdf>

[master] 19fc9c3 Bug #45853: PUBLISH
 performance-guide-4.2.html |   2 +-
 performance-guide-4.2.pdf  | Bin 432762 -> 430781 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)

<http://jenkins.knut.univention.de:8080/view/Publish/job/Publish_docs.univention.de/137/>