Installation and startup Untar the binary distribution in the desired location, e.g. /usr/local/skysql Alternatively build from the source code using the instructions in the README file and execute make install. Simply set the environment variable MAXSCALE_HOME to point to the MaxScale directory, found inside the path into which the files have been copied, e.g. MAXSCALE_HOME=/usr/local/skysql/maxscale/MaxScale Also you will need to optionaly set LD_LIBRARY_PATH to include the 'lib' folder, found inside the path into which the files have been copied, e.g. LD_LIBRARY_PATH=/usr/local/skysql/maxscale/lib Because we need the libmysqld library for parsing we must create a valid my.cnf file to enable the library to be used. Copy the my.cnf to $MAXSCALE_HOME/mysql/my.cnf. To start MaxScale execute the command 'maxscale' from the bin folder, e.g. /usr/local/skysql/maxscale/bin/maxscale Configuration You need to edit the file MaxScale.cnf in $MAXSCALE_HOME/etc, you should define the set of server definitions you require, with the addresses and ports of those servers. Also define the listening ports for your various services. In order to view the internal activity of the gateway you can telnet to the port defined for the telnet listener. Initially you may login with the user name of "admin" and the password "skysql". Once connected type help for an overview of the commands and help for the more detailed help on commands. Use the add user command to add a new user, this will also remove the admin/skysql user.