# Upgrading MariaDB MaxScale From 1.4 to 2.0

## Upgrading MariaDB MaxScale from 1.4 to 2.0

## Upgrading MariaDB MaxScale from 1.4 to 2.0

This document describes particular issues to take into account when upgrading\
MariaDB MaxScale from version 1.4 to 2.0.

For more information about MariaDB MaxScale 2.0, please refer to [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).

### Installation

Before starting the upgrade, we **strongly** recommend you back up your current\
configuration file.

### MaxAdmin

The default way the communication between MaxAdmin and MariaDB MaxScale is\
handled has been changed from an internet socket to a Unix domain socket.\
The former alternative is still available but has been *deprecated*.

If no arguments are given to MaxAdmin, it will attempt to connect to\
MariaDB MaxScale using a Unix domain socket. After the upgrade you will\
need to provide at least one internet socket related flag - `-h`, `-P`,`-u` or `-p` - to force MaxAdmin to use the internet socket approach.

E.g.

```
user@host $ maxadmin -u admin
```

### MySQL Monitor

The MySQL Monitor now assigns the stale state to the master server by default.\
In addition to this, the slave servers receive the stale slave state when they\
lose the connection to the master. This should not cause changes in behavior\
but the output of MaxAdmin will show new states when replication is broken.

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-14-to-20.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.