Installing MariaDB from a Development Source Tree
This section discusses how to install MariaDB from the latest development source code. Development trees have not necessarily received the same level of testing as standard release distributions, so this installation method is usually required only if you need the most recent code changes. Do not use a development tree for production systems. If your goal is simply to get MariaDB up and running on your system, you should use a standard release distribution (either a binary or source distribution). See , "How to Get MySQL".
MySQL development projects are hosted on Launchpad. MariaDB projects, including MariaDB Server, MariaDB Workbench, and others are available from the Oracle/MySQL Engineering page. For the repositories related only to MariaDB Server, see the MySQL Server page.
To install MariaDB from a development source tree, your system must satisfy the tool requirements listed at , "Installing MariaDB from Source", including the requirements for Bazaar and bison. For information about using Bazaar with MySQL, see http://forge.mysql.com/wiki/MySQL_Bazaar_Howto.
To create a local branch of the MariaDB development tree on your machine, use this procedure:
- To obtain a copy of the MariaDB source code, you must create a new Bazaar branch. If you do not already have a Bazaar repository directory set up, you must initialize a new directory:
shell>
mkdir mysql-server
shell>bzr init-repo --trees mysql-server
This is a one-time operation.
- Assuming that you have an initialized repository directory, you can branch from the public MariaDB server repositories to create a local source tree. To create a branch of a specific version:
shell>
cd mysql-server
shell>bzr branch lp:mysql-server/5.6 mysql-5.6
This is a one-time operation per source tree. You can branch the source trees for several versions of MariaDB under the
mysql-server
directory. - The initial download will take some time to complete, depending on the speed of your connection. Please be patient. Once you have downloaded the first tree, additional trees should take significantly less time to download.
- When building from the Bazaar branch, you may want to create a copy of your active branch so that you can make configuration and other changes without affecting the original branch contents. You can achieve this by branching from the original branch:
shell>
bzr branch mysql-5.6 mysql-5.6-build
- To obtain changes made after you have set up the branch initially, update it using the
pull
option periodically. Use this command in the top-level directory of the local copy:shell>
bzr pull
To examine the changeset comments for the tree, use the
log
option to bzr:shell> bzr log
You can also browse changesets, comments, and source code online at the Launchpad MySQL Server page.
If you see diffs (changes) or code that you have a question about, do not hesitate to send email to the MariaDB
internals
mailing list. See , "MySQL Mailing Lists". If you think you have a better idea on how to do something, send an email message to the list with a patch.
After you have the local branch, you can build MariaDB server from the source code. For information, see , "Installing MariaDB from a Standard Source Distribution", except that you skip the part about obtaining and unpacking the distribution.
Be careful about installing a build from a distribution source tree on a production machine. The installation command may overwrite your live release installation. If you already have MariaDB installed and do not want to overwrite it, run CMake with values for the CMAKE-INSTALL-PREFIX
, MYSQL_TCP_PORT
, and MYSQL_UNIX_ADDR
options different from those used by your production server. For additional information about preventing multiple servers from interfering with each other, see , "Running Multiple MariaDB Instances on One Machine".
Play hard with your new installation. For example, try to make new features crash. Start by running make test. See , "The MariaDB Test Suite".