The Ultimate Guide to High Availability with MariaDB
This is a read-only copy of the MariaDB Knowledgebase generated on 2025-05-02. For the latest, interactive version please visit https://mariadb.com/kb/.

Deleting a REST API User for MaxScale with MaxCtrl

Contents

  1. Overview
  2. Deleting a User

Overview

MaxScale has a MaxScale's REST API, which can be configured to require authentication. When it is first installed, it has a single default admin user (admin) and password (mariadb). However, this user can be deleted, and other users can be created.

MaxCtrl is a command-line utility that can perform administrative tasks using MaxScale's MaxScale's REST API. It can be used to delete a user for the MaxScale's REST API.

Deleting a User

1. Configure the REST API if the default configuration is not sufficient.

2. Use MaxCtrl to execute the destroy user command:

$ maxctrl --secure \
   --user=maxscale_rest_admin \
   --password=maxscale_rest_admin_password \
   --hosts=192.0.2.100:8443
   --tls-key=/certs/client-key.pem \
   --tls-cert=/certs/client-cert.pem \
   --tls-ca-cert=/certs/ca.pem \
   destroy user "admin"

3. Replace admin with the actual user.

MaxScale will refuse to delete the last remaining admin user.

Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.