# Introduction

Use this guide to install the `singlestoredb-toolbox` and `singlestoredb-server` packages and migrate from MemSQL Ops to the SingleStore management tools for cluster management. The migration tool automates most of the migration process.

SingleStore Tools allow you to perform cluster management operations for setup, configuration, and diagnostics. Operations are done through CLI commands which can be easily scripted for use in a variety of deployment environments and scenarios.

Most of the tools are part of the `singlestoredb-toolbox` package. However, the lower-level management tool, `memsqlctl`, is part of the `singlestoredb-server` package (which includes the SingleStore engine).

Along with these packages, SingleStore also offers a client application through the `singlestore-client` package to connect to your SingleStore cluster and run queries.

## Prerequisites

> **⚠️ Warning**: This guide assumes that your cluster is running MemSQL v7.0 or later, which can be verified via `memsql-ops memsql-list`.If your cluster is running an earlier version of MemSQL, **it will be upgraded to MemSQL v7.0** as part of this migration.

In addition, this guide assumes:

* The SingleStore cluster components were installed via `rpm,` `yum`, `apt`, or `dpkg`. To verify that the cluster was created via package install, run the following commands on the Linux command line.

  **Red Hat Distribution**:
  ```shell
  sudo yum list --installed | grep memsql-toolbox --or--
  sudo yum list --installed | grep singlestoredb-toolbox --or--
  rpm -qa | grep memsql-toolbox --or--
  rpm -qa | grep singlestoredb-toolbox
  ```
  **Debian Distribution**:
  ```shell
  dpkg -s memsql-toolbox | grep Status --or--
  dpkg -s singlestoredb-toolbox | grep Status
  ```
  If none of these packages are installed, the cluster was likely deployed via tarball, and so the [non-sudo version](https://docs.singlestore.com/db/v9.1/user-and-cluster-administration/migrate-from-ops-to-tools/non-sudo/introduction.md) of the Ops to Tools migration guide should be followed instead.
* The user that created the cluster has `sudo` privileges.
* The user performing the migration has `sudo` privileges.
* A `root` password has been set on all nodes in the cluster [Learn how to set root password](https://docs.singlestore.com/db/v9.1/user-and-cluster-administration/migrate-from-ops-to-tools/sudo/migrate-cluster/#set-root-password.md).
* The SingleStore cluster is managed by MemSQL Ops v7.0 or later, which can be verified via `memsql-ops agent-list` [Learn how to upgrade](https://docs.singlestore.com/db/v9.1/user-and-cluster-administration/maintain-your-cluster/upgrade-or-uninstall-singlestore/upgrade-singlestore.md).
* SingleStore Toolbox v1.3.0 or later, which can be verified via `sdb-toolbox-config version` [Learn how to upgrade](https://docs.singlestore.com/db/v9.1/user-and-cluster-administration/cluster-management-with-tools/singlestore-tools-installation/singlestore-toolbox-installation/#upgrade-singlestore-toolbox.md).

## Ports

Ensure that the following ports are open for use:

| Port | Type             | For                               |
| ---- | ---------------- | --------------------------------- |
| 22   | Inbound/Outbound | SSH / SFTP                        |
| 80   | Inbound/Outbound | MemSQL Ops                        |
| 443  | Inbound/Outbound | SingleStore repository connection |
| 3306 | Inbound/Outbound | SingleStore(default)              |

## Secure-Shell Access

The installing user must be able to log into each host via `ssh`.

## Terminology

**Host**

A ***host*** is a physical or virtual machine.

**Node**

In SingleStore parlance, a ***node*** is a SingleStore database component of type *[aggregator](https://docs.singlestore.com/db/v9.1/introduction/distributed-architecture/cluster-components/#UUID-5ab4d9d6-9704-50a3-e36b-47484a35ad81.md)* or *[leaf](https://docs.singlestore.com/db/v9.1/introduction/distributed-architecture/cluster-components/#UUID-335da25a-71e3-5497-4d4f-d610e600b846.md)*.

***

Modified at: June 22, 2022

Source: [/db/v9.1/user-and-cluster-administration/migrate-from-ops-to-tools/sudo/introduction/](https://docs.singlestore.com/db/v9.1/user-and-cluster-administration/migrate-from-ops-to-tools/sudo/introduction/)

(An index of the documentation is available at /llms.txt)