Skip to content

Commit f65a7d3

Browse files
committed
MXS: Update SmartRouter documentation
Add entry for the new 'forward_nonmaster_errors' setting.
1 parent d767f44 commit f65a7d3

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

maxscale/reference/maxscale-routers/maxscale-smartrouter.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,27 @@ InnoDB engine.
3636
The ReadWriteSplit [documentation](maxscale-readwritesplit.md)
3737
has more on primary-replica setup.
3838

39+
### `forward_nonmaster_errors`
40+
41+
* Type: [boolean](../../maxscale-management/deployment/maxscale-configuration-guide.md#booleans)
42+
* Mandatory: No
43+
* Dynamic: No
44+
* Default: true
45+
46+
Specifies whether an error returned by a target other than the [master](#master),
47+
should be returned to the client, if it arrives faster than the response from
48+
the master. If all targets are MariaDB servers, the default value of `true`
49+
is usually the correct choise. If a non-master target is not a MariaDB server,
50+
but, for instance, a server used over ODBC, `false` is usually the correct choise.
51+
52+
For instance, if the master is a regular MariaDB server, but a non-master target
53+
is a server that does not support the `SLEEP` function, then
54+
```
55+
SELECT SLEEP(5);
56+
```
57+
would with the default `forward_nonmaster_errors=true` result in an error, but
58+
with `forward_nonmaster_errors=false`, the behaviour would be that of MariaDB.
59+
3960
**Example**
4061

4162
Suppose we have a Transactional service like

0 commit comments

Comments
 (0)