Installing ybtools on Linux

Make sure that Java 1.8 64-bit is installed on your client system. See Installing the Java Runtime Environment.

Follow these steps to install the client tools on an Ubuntu, Debian, or CentOS Linux client system:

  1. Download the package for your client operating system from the SMC. Go to Configure > Drivers and Tools > Client Tools.
    If you are installing on a client with Ubuntu Version 12 through 16, download the 12.04 package (not the 17.10 package).
  2. If necessary, copy the downloaded package to the client system.
  3. From the client directory where the download file was copied, run the appropriate installation command:
    • Ubuntu: sudo apt update, then sudo apt install ./<name-of-deb-file>
    • CentOS: sudo rpm -ivh ./<name-of-rpm-file>
    For example:
    me@yb.io:~$ sudo apt update
    Hit:1 http://us.archive.ubuntu.com/ubuntu xenial InRelease
    Get:2 http://us.archive.ubuntu.com/ubuntu xenial-updates InRelease [102 kB]
    ...
    me@yb.io:~$ sudo apt install ./ybtools-1.2.0.4159.ubuntu.12.04.x86_64.deb
    Reading package lists... Done
    Building dependency tree      
    Reading state information... Done
    Note, selecting 'ybtools' instead of './ybtools-1.2.0.4159.ubuntu.12.04.x86_64.deb'
    The following packages were automatically installed and are no longer required:
      bsh libasm3-java libganymed-ssh2-java libisl13 libjackrabbit-java libjline-java libjna-java libjna-jni libjna-platform-java libjsch-agent-proxy-java libjsoncpp0v5 liblldb-3.8
      libllvm3.8 libmaven-scm-java libnetbeans-cvsclient-java libruby2.2 libsisu-guice-java llvm-3.8 llvm-3.8-dev llvm-3.8-runtime nagios-plugins-common python3-bcdoc ruby2.1-dev
    Use 'sudo apt autoremove' to remove them.
    The following NEW packages will be installed:
      ybtools
    0 upgraded, 1 newly installed, 0 to remove and 266 not upgraded.
    Need to get 0 B/43.1 MB of archives.
    After this operation, 0 B of additional disk space will be used.
    Get:1 /home/brumsby/ybtools-1.2.0.4159.ubuntu.12.04.x86_64.deb ybtools all 1.2.0.4159 [43.1 MB]
    Selecting previously unselected package ybtools.
    (Reading database ... 153862 files and directories currently installed.)
    Preparing to unpack .../ybtools-1.2.0.4159.ubuntu.12.04.x86_64.deb ...
    Unpacking ybtools (1.2.0.4159) ...
    Setting up ybtools (1.2.0.4159) ...
On Linux clients, the tools are installed in /opt/ybtools and symbolically linked to /usr/bin (for example, /usr/bin/ybsql points to /opt/ybtools/bin/ybsql).
me@yb.io:/opt/ybtools/bin$ ls -lah
total 2.9M
drwxr-xr-x 2 root root 4.0K Feb 13 13:35 .
drwxr-xr-x 4 root root 4.0K Feb 13 13:35 ..
-rwxr-xr-x 1 root root 5.1K Feb 13 10:11 ybbackup
-rwxr-xr-x 1 root root 5.1K Feb 13 10:11 ybbackup-list
-rwxr-xr-x 1 root root 5.1K Feb 13 10:11 ybbar
-rwxr-xr-x 1 root root 1.4M Feb 13 10:13 ybdumpschema
-rwxr-xr-x 1 root root 6.9K Feb 13 10:11 ybload
-rwxr-xr-x 1 root root 5.1K Feb 13 10:11 ybrestore
-rwxr-xr-x 1 root root 1.5M Feb 13 10:13 ybsql