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

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

To start MaxScale execute the command 'maxscale' from the bin folder,
e.g. /usr/local/skysql/maxscale/bin/maxscale  or by using the
installed init.d script.

Configuration

You need to create and 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 MaxScale 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 <command> for the more
detailed help on commands. Use the 'add user' command to add a new user
which will also remove the admin/skysql user.