Documentation-Contents.md

Contents

About MariaDB MaxScale

• About MariaDB MaxScale
• Changelog
• Limitations

Getting Started

• MariaDB MaxScale Installation Guide
• Building MariaDB MaxScale from Source Code
• Configuration Guide

Upgrading MariaDB MaxScale

• Upgrading MariaDB MaxScale from 2.3 to 2.4
• Upgrading MariaDB MaxScale from 2.2 to 2.3
• Upgrading MariaDB MaxScale from 2.1 to 2.2
• Upgrading MariaDB MaxScale from 2.0 to 2.1
• Upgrading MariaDB MaxScale from 1.4 to 2.0

Reference

• MaxCtrl - Command Line Admin Interface
• MaxAdmin - Legacy Admin Interface
• Routing Hints
• MaxBinlogCheck
• MaxScale REST API
• Module Commands

Tutorials

The main tutorial for MariaDB MaxScale consist of setting up MariaDB MaxScale for the environment you are using with either a connection-based or a read/write-based configuration.

• MariaDB MaxScale Tutorial

These tutorials are for specific use cases and module combinations.

• Connection Routing Tutorial
• Read Write Splitting Tutorial
• Administration Tutorial
• Avro Router Tutorial
• MariaDB Monitor Failover Tutorial
• MariaDB MaxScale Information Schema Tutorial
• Replication Proxy with the Binlog Router Tutorial
• Simple Schema Sharding Tutorial
• Filter Tutorial
• RabbitMQ and Tee Filter Data Archiving Tutorial
• RabbitMQ Setup and MariaDB MaxScale Integration Tutorial
• Clustrix Monitor Tutorial
• MaxScale Clustrix Tutorial

Here are tutorials on monitoring and managing MariaDB MaxScale in cluster environments.

• REST API Tutorial

Routers

The routing module is the core of a MariaDB MaxScale service. The router documentation contains all module specific configuration options and detailed explanations of their use.

• Avrorouter
• Binlogrouter
• Cat
• HintRouter
• Read Connection Router
• Read Write Split
• Schemarouter
• SmartRouter

The legacy diagnostic routing module MaxAdmin has been deprecated: avoid using it.

• CLI

Filters

Here are detailed documents about the filters MariaDB MaxScale offers. They contain configuration guides and example use cases. Before reading these, you should have read the filter tutorial so that you know how they work and how to configure them.

• Cache
• Consistent Critical Read Filter
• Database Firewall Filter
• Insert Stream Filter
• Luafilter
• Masking Filter
• Maxrows Filter
• Named Server Filter
• Query Log All
• Hint Filter
• RabbitMQ Filter
• Regex Filter
• Tee Filter
• Throttle Filter
• Top N Filter
• Transaction Performance Monitoring Filter
• Binlog Filter

Monitors

Common options for all monitor modules.

• Monitor Common

Module specific documentation.

• MariaDB Monitor
• Galera Monitor
• ColumnStore Monitor
• Aurora Monitor
• Clustrix Monitor

Protocols

Documentation for MaxScale protocol modules.

• Change Data Capture (CDC) Protocol
• Change Data Capture (CDC) Users

The MaxScale CDC Connector provides a C++ API for consuming data from a CDC system.

• CDC Connector

Authenticators

A short description of the authentication module type can be found in the Authentication Modules document.

• MySQL Authenticator
• GSSAPI Authenticator

Utilities

• RabbitMQ Consumer Client

Design Documents

• Plugin development guide