How To Install ceph-iscsi on Ubuntu 22.04

In this tutorial we learn how to install ceph-iscsi on Ubuntu 22.04. ceph-iscsi is common logic and CLI tools for creating and managing LIO gateways for Ceph

Introduction

In this tutorial we learn how to install ceph-iscsi on Ubuntu 22.04.

What is ceph-iscsi

ceph-iscsi is:

It includes the rbd-target-api daemon which is responsible for restoring the state of LIO following a gateway reboot/outage and exporting a REST API to configure the system using tools like gwcli. It replaces the existing ’target’ service.

There is also a second daemon rbd-target-gw which exports a REST API to gather statistics.

It also includes the CLI tool gwcli which can be used to configure and manage the Ceph iSCSI gateway, which replaces the existing targetcli CLI tool. This CLI tool utilizes the rbd-target-api server daemon to configure multiple gateways concurrently.

There are three methods to install ceph-iscsi on Ubuntu 22.04. We can use apt-get, apt and aptitude. In the following sections we will describe each method. You can choose one of them.

Install ceph-iscsi Using apt-get

Update apt database with apt-get using the following command.

sudo apt-get update

After updating apt database, We can install ceph-iscsi using apt-get by running the following command:

sudo apt-get -y install ceph-iscsi

Install ceph-iscsi Using apt

Update apt database with apt using the following command.

sudo apt update

After updating apt database, We can install ceph-iscsi using apt by running the following command:

sudo apt -y install ceph-iscsi

Install ceph-iscsi Using aptitude

If you want to follow this method, you might need to install aptitude first since aptitude is usually not installed by default on Ubuntu. Update apt database with aptitude using the following command.

sudo aptitude update

After updating apt database, We can install ceph-iscsi using aptitude by running the following command:

sudo aptitude -y install ceph-iscsi

How To Uninstall ceph-iscsi on Ubuntu 22.04

To uninstall only the ceph-iscsi package we can use the following command:

sudo apt-get remove ceph-iscsi

Uninstall ceph-iscsi And Its Dependencies

To uninstall ceph-iscsi and its dependencies that are no longer needed by Ubuntu 22.04, we can use the command below:

sudo apt-get -y autoremove ceph-iscsi

Remove ceph-iscsi Configurations and Data

To remove ceph-iscsi configuration and data from Ubuntu 22.04 we can use the following command:

sudo apt-get -y purge ceph-iscsi

Remove ceph-iscsi configuration, data, and all of its dependencies

We can use the following command to remove ceph-iscsi configurations, data and all of its dependencies, we can use the following command:

sudo apt-get -y autoremove --purge ceph-iscsi

References

Summary

In this tutorial we learn how to install ceph-iscsi package on Ubuntu 22.04 using different package management tools: apt, apt-get and aptitude.