Easymysql

Helper Bash script for MySQL multi instance management on one server

Purpose

This tools is a simple Bash script that help you to clone and manage several MySQL server instances on the same server. It supports 6 main features:

• clone
• destroy
• start
• stop
• restart
• status

Prerequirements

1. Use a standard Linux and Bash shell
   • http://www.linux.com/directory/Distributions
   • http://www.gnu.org/software/bash/
2. Download mysqlutilities
   • http://dev.mysql.com/downloads/utilities/
3. A classic MySQL or MariaDb server
   • http://dev.mysql.com/downloads/mysql/
   • https://downloads.mariadb.org/

Installation

Installation from Git

# git clone https://github.com/jmrenouard/easymysql

Download Source from GitHub

# curl https://github.com/jmrenouard/easymysql/archive/master.zip
# unzip master.zip

Setup

# source mysql_functions.sh

Specific configurations

This parameters are set at the begin of mysql_functions.sh script.

Root Directory for all instances

ROOT_DIR=/var/lib

Type of servers

TYPE=mysql

General options for all instances

GENERAL_OPTIONS="--log-bin=mysql-bin --pid-file=clone.pid --explicit_defaults_for_timestamp --plugin-dir=/usr/lib64/mysql/plugin"

User used for running mysqld process

MUSER=mysql

Password used for root user in all instances

RPASSWORD=admin

Main MySQL configuration file

MAIN_CFG_FILE=/etc/my.cnf

Include Configuration Directory

ETC_DIR=/etc/my.cnf.d/

Basic concepts

Server Identifier

Identifier is the only concept your really need to handle all instances.

For example, MySQL instance with id=x gets the following properties:

1. Port: 3306+X
2. Datadir: /var/lib/mysql + X
3. Server id: X
4. Socket: Datadir/mysqlX.sock

Main functions

• Clone a existing and running instance

    mclone < ID DESTINATION > [ < ID SOURCE > ]
  

• Start one or several MySQL instance

    mstart < ID1 > [ < ID2 > ] [ < ID3 > ] ...
  

• Stop one or several MySQL instance

    mstart < ID1 > [ < ID2 > ] [ < ID3 > ] ...
  

• Restart one or several MySQL instance

    mrestart < ID1 > [ < ID2 > ] [ < ID3 > ] ...
  

• Get status of one, several or all MySQL instances

    mstatus [ < ID1 > ] [ < ID2 > ] ...
  

• Destroy one or several MySQL instance

    mdestroy < ID1 > [ < ID2 > ] [ < ID3 > ] ...
  

Examples

Cloning a instance standard 3306 instance

# source mysql_functions.sh
# mclone 1

Cloning MySQL instance 1 port 3307

# source mysql_functions.sh
# mclone 2 1

Destroying MySQL instance 2

# source mysql_functions.sh
# mdestroy 2

Getting the status of all MySQL instances

# source mysql_functions.sh
# mstatus
ID      DIRECTORY       PORT    STATUS  PID
PRI     /var/lib/mysql  3306    ON      2144
1       /var/lib/mysql1 3307    ON      3029
2       /var/lib/mysql2 3308    ON      3048

Stopping MySQL instance 2

# source mysql_functions.sh
# mstop 2
# mstatus
ID      DIRECTORY       PORT    STATUS  PID
PRI     /var/lib/mysql  3306    ON      2144
1       /var/lib/mysql1 3307    ON      3029
2       /var/lib/mysql2 3308    OFF

Starting MySQL instance 2

# source mysql_functions.sh
# mstart 2
# mstatus
ID      DIRECTORY       PORT    STATUS  PID
PRI     /var/lib/mysql  3306    ON      2144
1       /var/lib/mysql1 3307    ON      3029
2       /var/lib/mysql2 3308    ON      3049

Restarting MySQL instances 1 2

# source mysql_functions.sh
# mrestart 1 2
# mstatus
ID      DIRECTORY       PORT    STATUS  PID
PRI     /var/lib/mysql  3306    ON      2144
1       /var/lib/mysql1 3307    ON      3029
2       /var/lib/mysql2 3308    ON      3049

Creating 10 MySQL instances at once

# source mysql_functions.sh
# for i in `seq 1 10`; do mclone $i; done
# mstatus
ID      DIRECTORY       PORT    STATUS  PID
PRI     /var/lib/mysql  3306    ON      2144
1       /var/lib/mysql1 3307    ON      3029
10      /var/lib/mysql10        3316    ON      4018
2       /var/lib/mysql2 3308    ON      3048
3       /var/lib/mysql3 3309    ON      3562
4       /var/lib/mysql4 3310    ON      3627
5       /var/lib/mysql5 3311    ON      3692
6       /var/lib/mysql6 3312    ON      3757
7       /var/lib/mysql7 3313    ON      3822
8       /var/lib/mysql8 3314    ON      3887
9       /var/lib/mysql9 3315    ON      3952

Stopping 10 first MySQL instances

# source mysql_functions.sh
# mstart `seq 1 10`

Destroying 10 MySQL instances

# source mysql_functions.sh
# mdestroy `seq 1 10`

Getting a mysql client on MySQL instances 7

# source mysql_functions.sh
# mclient 7
mysql> ...

Requesting from a mysql client on MySQL instances 4

# source mysql_functions.sh
# mclient 4 select @@server_id
@@server_id
4

Support easymysql script

Bugs report

https://github.com/jmrenouard/easymysql/issues

Pull request

https://github.com/jmrenouard/easymysql/pulls

Send an email

jmrenouard@gmail.com