{question}
How to upgrade singlestore toolbox?
{question}
{answer}
Guide to perform an online upgrade or offline upgrade of the SingleStore toolbox on RedHat or Debian Distribution platforms, click here.
In this article, we are going to look into the tarball package upgrade of the SingleStore toolbox.
Tarball Upgrade:
Tarball upgrade is just replacing the old binaries with the new binaries. A simple way to achieve this "upgrade" is by keeping the binaries in different directories and using symbolic links to point to the version being used.
1. Navigate to the current installed directories,
In this example, we are upgrading the SingleStore toolbox from 1.10.0 to 1.11.4.
Note: In the below example, singlestoredb-toolbox is a symbolic link pointing to the current singlestoredb-toolbox-1.10.0-88cac5e083 directory
/singlestore$ ls -lrt
drwxr-xr-x. 4 ec2-user ec2-user 227 Jan 1 2018 singlestoredb-toolbox-1.10.0-88cac5e083
lrwxrwxrwx. 1 ec2-user ec2-user 39 May 18 09:52 singlestoredb-toolbox -> singlestoredb-toolbox-1.10.0-88cac5e083
2. Download the latest tarball version of the toolbox from here.
3. Transfer the tarball file to the main deployment host where the earlier version of the toolbox is currently available.
4. Unpack the tarball file as below,
/singlestore$ tar xzvf singlestoredb-toolbox-<version>.tar.gz
After the folder extract, we have both the versions of the toolbox under /singlestore directory
/singlestore$ ls -lrt
drwxr-xr-x. 4 ec2-user ec2-user 227 Jan 1 2018 singlestoredb-toolbox-1.11.4-2d5a3b5137
drwxr-xr-x. 4 ec2-user ec2-user 227 Jan 1 2018 singlestoredb-toolbox-1.10.0-88cac5e083
lrwxrwxrwx. 1 ec2-user ec2-user 39 May 18 09:52 singlestoredb-toolbox -> singlestoredb-toolbox-1.10.0-88cac5e083
5. Remove the current symbolic link,
/singlestore$ rm singlestoredb-toolbox
6. Now let's recreate the symbolic link pointing to the new extracted version,
/singlestore$ ln -s singlestoredb-toolbox-1.11.4-2d5a3b5137 singlestoredb-toolbox
/singlestore$ ls -lrt
drwxr-xr-x. 4 ec2-user ec2-user 227 Jan 1 2018 singlestoredb-toolbox-1.11.4-2d5a3b5137
drwxr-xr-x. 4 ec2-user ec2-user 227 Jan 1 2018 singlestoredb-toolbox-1.10.0-88cac5e083
lrwxrwxrwx. 1 ec2-user ec2-user 39 May 18 11:42 singlestoredb-toolbox -> singlestoredb-toolbox-1.11.4-2d5a3b5137
7. Check the cluster status with the commands under the new toolbox directory. In case of any issues, we can repoint easily to the older version by following the step 4 and step 5 (Point the symbolic to older version directory of the singlestore toolbox).
8.Let's remove the old version of the toolbox after successful validation.
/singlestore$ rm -rf singlestoredb-toolbox-1.10.0-88cac5e083
Note: It's not necessary to create a symbolic link, instead we can just proceed with replacing the binaries with the newer binaries.
For ops to toolbox migration guide click here and for cluster upgrade click here.
{answer}