Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 35.1Mb
PDF (A4) - 35.2Mb
Man Pages (TGZ) - 256.4Kb
Man Pages (Zip) - 361.2Kb
Info (Gzip) - 3.4Mb
Info (Zip) - 3.4Mb
Excerpts from this Manual

19.2.1.2 Installing MySQL Shell on Linux

Note

Installation packages for MySQL Shell are available only for a limited number of Linux distributions, and only for 64-bit systems.

For supported Linux distributions, the easiest way to install MySQL Shell on Linux is to use theMySQL APT repository orMySQL Yum repository. For systems not using the MySQL repositories, MySQL Shell can also be downloaded and installed directly.

Installing MySQL Shell with the MySQL APT Repository

For Linux distributions supported by theMySQL APT repository, follow one of the paths below:

  • If you do not yet have theMySQL APT repository as a software repository on your system, do the following:

    • Follow the steps given inAdding the MySQL APT Repository, paying special attention to the following:

      • During the installation of the configuration package, when asked in the dialogue box to configure the repository, make sure you choose MySQL 5.7 (which is the default option) as the release series you want, and enable theMySQL Preview Packages component.

      • Make sure you do not skip the step for updating package information for the MySQL APT repository:

        sudo apt-get update

    • Install MySQL Shell with this command:

      sudo apt-get install mysql-shell

  • If you already have theMySQL APT repository as a software repository on your system, do the following:

    • Update package information for the MySQL APT repository:

      sudo apt-get update

    • Update the MySQL APT repository configuration package with the following command:

      sudo apt-get install mysql-apt-config

      When asked in the dialogue box to configure the repository, make sure you choose MySQL 5.7 (which is the default option) as the release series you want, and enable theMySQL Preview Packages component.

    • Install MySQL Shell with this command:

      sudo apt-get install mysql-shell
Installing MySQL Shell with the MySQL Yum Repository

For Linux distributions supported by theMySQL Yum repository, follow these steps to install MySQL Shell:

  • Do one of the following:

    • If you already have theMySQL Yum repository as a software repository on your system and the repository was configured with the new release packagemysql57-community-release, skip to the next step (“Enable the MySQL Tools Preview subrepository...”).

    • If you already have theMySQL Yum repository as a software repository on your system but have configured the repository with the old release packagemysql-community-release, it is easiest to install MySQL Shell by first reconfiguring the MySQL Yum repository with the newmysql57-community-release package. To do so, you need to remove your old release package first, with the following command :

      sudo yum remove mysql-community-release

      For dnf-enabled systems, do this instead:

      sudo dnf erase mysql-community-release

      Then, follow the steps given inAdding the MySQL Yum Repository to install the new release package,mysql57-community-release.

    • If you do not yet have theMySQL Yum repository as a software repository on your system, follow the steps given inAdding the MySQL Yum Repository.

  • Enable the MySQL Tools Preview subrepository. You can do that by editing manually the/etc/yum.repos.d/mysql-community.repo file. This is an example of the subrepository's default entry in the file (thebaseurl entry in your file might look different, depending on your Linux distribution):

    [mysql-tools-preview]name=MySQL Tools Previewbaseurl=http://repo.mysql.com/yum/mysql-tools-preview/el/6/$basearch/enabled=0gpgcheck=1gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-mysql

    Change the entryenabled=0 toenabled=1 to enable the subrepository.

  • Install MySQL Shell with this command:

    sudo yum install mysql-shell

    For dnf-enabled systems, do this instead:

    sudo dnf install mysql-shell
Installing MySQL Shell from Direct Downloads from the MySQL DeveloperZone

RPM, Debian, and source packages for installing MySQL Shell are also available for download atDownload MySQL Shell.