MySQL Router 2.1  /  Installing MySQL Router  /  Installing MySQL Router on Linux

2.1 Installing MySQL Router on Linux

There are binary distributions of MySQL Router available for several variants of Linux, including Fedora, Oracle Linux, Red Hat, and Ubuntu.

Installation options include:

The procedure for installing on Linux depends on your Linux distribution.

Installing MySQL Router using an official DEB or RPM package creates a local system user and group named "mysqlrouter" on the host that MySQL Router runs as by default. For additional information, see the system user's configuration option.

Installing DEB packages

On Ubuntu, and other systems that use the Debian package scheme, you can either download and install .deb packages or use the APT package manager.

Using the APT Package Manager

  1. Install the MySQL APT repository as described in the MySQL APT Repository documentation. For example:

    Note

    Download the APT configuration package from here.

    shell> sudo dpkg -i mysql-apt-config_0.8.8-1_all.deb

    Enable the "MySQL Tools & Connectors" on the configuration screen.

  2. Update your APT repository:

    shell> sudo apt-get update
  3. Install MySQL Router. For example:

    shell> sudo apt-get install mysql-router

Manually Installing a Package

You can also download the .deb package and install it from the command line similarly to

shell> sudo dpkg -i package.deb

package.deb is the MySQL Router package name; for example, mysql-router-version-1ubu1604-amd64.deb, where version is the MySQL Router version number.

Installing RPM packages

On RPM-based systems, you can either download and install RPM packages or use the Yum package manager.

Using the Yum Package Manager

  • First, install the MySQL Yum repository as described in the MySQL Yum Repository documentation. For example:

    Note

    Download the Yum configuration package from here.

    shell> sudo rpm -Uvh mysql57-community-release-el7-11.noarch.rpm
  • Next, install MySQL Router. For example:

    shell> sudo yum install mysql-router

Manually Installing an RPM Package

shell> sudo rpm -i package.rpm

package.rpm is the MySQL Router package name; for example, mysql-router-version-el7.x86_64.rpm, where version is the MySQL Router version number.

Uninstalling

The procedure for uninstalling MySQL Router on Linux depends on the package you are using.

Uninstalling DEB packages

To uninstall a Debian package, use this command:

shell> sudo dpkg -r mysql-router

This command does not remove the configuration files. To also remove them and the data directory, use:

shell> sudo dpkg --purge mysql-router
Note

Alternatively, use apt-get remove mysql-router or apt-get purge mysql-router.

Uninstalling RPM packages

To uninstall an RPM package, use this command:

shell> sudo rpm -e mysql-router
Note

Similarly, use yum remove mysql-router.

This command does not remove the configuration files.

What Is Not Removed

When not purging, the uninstallation process does not remove your configuration files. On Debian systems, this might include files such as:

/etc/init.d/mysqlrouter
/etc/mysqlrouter/mysqlrouter.conf
/etc/apparmor.d/usr.sbin.mysqlrouter

User Comments
User comments in this section are, as the name implies, provided by MySQL users. The MySQL documentation team is not responsible for, nor do they endorse, any of the information provided here.
Sign Up Login You must be logged in to post a comment.