# Upgrading MariaDB MaxScale From 2.4 to 2.5

## Upgrading MariaDB MaxScale from 2.4 to 2.5

## Upgrading MariaDB MaxScale from 2.4 to 2.5

This document describes possible issues when upgrading MariaDB\
MaxScale from version 2.4 to 2.5.

For more information about MaxScale 2.5, refer to the [ChangeLog](https://github.com/mariadb-corporation/mariadb-docs/blob/main/maxscale/maxscale-archive/archive/mariadb-maxscale-23.08/mariadb-maxscale-23-08-upgrading/broken-reference/README.md).

Before starting the upgrade, any existing configuration files should be\
backed up.

### MaxAdmin

The deprecated MaxAdmin interface has been removed in 2.5.0 in favor of the REST\
API and the MaxCtrl command line client. The `cli` and `maxscaled` modules can\
no longer be used.

### Authentication

The credentials used by services now require additional grants. For a full list\
of required grants, refer to the [protocol documentation](/docs/maxscale/maxscale-archive/archive/mariadb-maxscale-23.08/mariadb-maxscale-23-08-authenticators/mariadb-maxscale-2308-authentication-modules.md#required-grants).

### MariaDB-Monitor

The settings `detect_stale_master`, `detect_standalone_master` and`detect_stale_slave` are replaced by `master_conditions` and`slave_conditions`. The old settings may still be used, but will be removed in\
a later version.

#### Password encryption

The encrypted passwords feature has been updated to be more secure. Users are\
recommended to generate a new encryption key and re-encrypt their passwords\
using the `maxkeys` and `maxpasswd` utilities. Old passwords still work.

### Default Server State

The default state of servers in 2.4 was `Running` and in 2.5 it is now`Down`. This was done to prevent newly added servers from being accidentally\
used before they were monitored.

### Columnstore Monitor

It is now mandatory to specify in the configuration what version the\
monitored Columnstore cluster is.

```
[CSMonitor]
type=monitor
module=csmon
version=1.5
...
```

Please see the [documentation](https://mariadb.com/kb/Monitors/ColumnStore-Monitor#master-selection)\
for details.

### New binlog router

The binlog router delivered with MaxScale 2.5 is completely new and\
not 100% backward compatible with the binlog router delivered with\
earlier MaxScale versions. If you use the binlog router, carefully\
assess whether the functionality provided by the new one fulfills\
your requirements, before upgrading MaxScale.

### Tee Filter

The tee filter parameter `service` has been deprecated in favor of the `target`\
parameter. All usages of `service` can be replaced with `target`.

CC BY-SA / Gnu FDL


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/maxscale/maxscale-archive/archive/mariadb-maxscale-23.08/mariadb-maxscale-23-08-upgrading/mariadb-maxscale-2308-upgrading-mariadb-maxscale-from-24-to-25.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.