[MXS-2045] Avrorouter tutorial is not good enough Created: 2018-09-12  Updated: 2018-09-25  Resolved: 2018-09-25

Status: Closed
Project: MariaDB MaxScale
Component/s: Documentation
Affects Version/s: None
Fix Version/s: 2.2.15

Type: Bug Priority: Major
Reporter: markus makela Assignee: markus makela
Resolution: Fixed Votes: 0
Labels: None

Sprint: MXS-SPRINT-66

 Description   

The tutorial is unnecessarily verbose on areas that should not be in a tutorial. There are also some factual errors that should be corrected.



 Comments   
Comment by Claudio Nanni [ 2018-09-12 ]

In no particular order, I'll add some observations.


If GTID is used binlogrouter will use 'binlogdir'/gtid_domain_id/server_id for binary logs, while avroservice will still look into root 'binlogdir', in such case it's needed to use the full path in the avroservice parameter.


If the directory set in 'binlogdir' doesn't exist, the message is misleading at least:

2018-09-11 14:29:09   error  : Unexpected parameter 'binlogdir' for object 'avro-service' of type 'service', or '/tmp/maxscale/0/10133' is an invalid value for parameter 'binlogdir'.

I have the impression that different exceptions have been joined into one with the result of some nonsense for the user.

i) "Unexpected parameter 'binlogdir' for object 'avro-service' " it's false, the parameter exists and it's perfectly placed.
IMHO this message should be removed when the problem is a non existing directory, or generally speaking I would not group such different error messages into the same exception(if that is).

ii) "'/tmp/maxscale/0/10133' is an invalid value for parameter 'binlogdir'." it's technically true but invalid makes me think something is wrong with the format, not the value itself.
More meaningful message would be "Path not found" or similar.

Generated at Thu Feb 08 04:11:17 UTC 2024 using Jira 8.20.16#820016-sha1:9d11dbea5f4be3d4cc21f03a88dd11d8c8687422.