Fix and clean up CDC documentation

The CDC_users.md document was not linked to and was in the wrong place. It
should reside in the protocol directory since it relates to the CDC protocol.
This commit is contained in:
Markus Makela
2016-08-11 14:14:07 +03:00
parent 33fb8effa1
commit b2035745fc
5 changed files with 47 additions and 47 deletions

View File

@ -1,4 +1,4 @@
#CDC Protocol
# Change Data Capture (CDC) Protocol
CDC is a new protocol that allows compatible clients to authenticate and
register for Change Data Capture events. The new protocol must be use in
@ -23,6 +23,8 @@ passwd=maxpwd
If the `cdcusers` file cannot be found, the service user (_maxuser:maxpwd_ in the example) can be used to connect through the CDC protocol.
For more details, refer to the [CDC users documentation](CDC_users.md).
## Protocol Phases
### Connection and Authentication

View File

@ -0,0 +1,36 @@
# Change Data Capture (CDC) users
Change Data Capture (CDC) is a new MaxScale protocol that allows compatible
clients to authenticate and register for Change Data Capture events. The new
protocol must be use in conjunction with AVRO router which currently converts
MySQL binlog events into AVRO records. Clients connect to CDC listener and
authenticate using credentials provided in a format described in the [CDC Protocol documentation](CDC.md).
**Note**: If no users are found in that file or if it doesn't exist, the only
available user will be the _service user_:
```
[avro-service]
type=service
router=avrorouter
source=replication-service
user=cdc_user
password=cdc_password
```
## Creating new CDC users
```
bash$ cdc_users [-h] USER PASSWORD
```
The output of this command should be appended to the _cdcusers_ file at
`/var/lib/maxscale/<service name>/`.
```
bash$ cdc_users user1 pass1 >> /var/lib/maxscale/avro-service/cdcusers
```
Users can be deleted by removing the related rows in 'cdcusers' file. For
more details on the format of the _cdcusers_ file, read the [CDC Protocol documentation](CDC.md).