Chapter 12. Management of iSCSI gateway using the Ceph Orchestrator (Limited Availability) As a storage administrator, you can use Ceph Orchestrator to deploy the iSCSI gateway. The iSCSI Gateway presents a Highly Available (HA) iSCSI target that exports RADOS Block Device (RBD) images as SCSI disks. You can deploy an iSCSI gateway by either using the placement specification or the service specification, like an YAML file. Note This technology is Limited Availability. See the Deprecated functionality chapter for additional information. This section covers the following administrative tasks: Deploying the iSCSI gateway using the placement specification . Deploying the iSCSI gateway using the service specification . Removing the iSCSI gateway using the Ceph Orchestrator . 12.1. Prerequisites A running Red Hat Ceph Storage cluster. Root-level access to all the nodes. Hosts are added to the cluster. All manager, monitor and OSD daemons are deployed. 12.2. Deploying the iSCSI gateway using the command line interface Using the Ceph Orchestrator, you can deploy the iSCSI gateway using the ceph orch command in the command line interface. Prerequisites A running Red Hat Ceph Storage cluster. Hosts are added to the cluster. All manager, monitor and OSD daemons are deployed. Procedure Log into the Cephadm shell: Example Create the pool: Syntax Example Deploy iSCSI gateway using command line interface: Syntax Example Verification List the service: Example List the hosts and process: Syntax Example 12.3. Deploying the iSCSI gateway using the service specification Using the Ceph Orchestrator, you can deploy the iSCSI gateway using the service specification. Prerequisites A running Red Hat Ceph Storage cluster. Hosts are added to the cluster. All manager, monitor and OSD daemons are deployed. Procedure Create the iscsi.yml file: Example Edit the iscsi.yml file to include the following details: Syntax Example Mount the YAML file under a directory in the container: Example Navigate to the following directory: Syntax Example Deploy iSCSI gateway using service specification: Syntax Example Verification List the service: Example List the hosts, daemons, and processes: Syntax Example 12.4. Removing the iSCSI gateway using the Ceph Orchestrator You can remove the iSCSI gateway daemons using the ceph orch rm command. Prerequisites A running Red Hat Ceph Storage cluster. Root-level access to all the nodes. Hosts are added to the cluster. At least one iSCSI gateway daemon deployed on the hosts. Procedure Log into the Cephadm shell: Example List the service: Example Remove the service Syntax Example Verification List the hosts, daemons, and processes: Syntax Example Additional Resources See Deploying the iSCSI gateway using the command line interface section in the Red Hat Ceph Storage Operations Guide for more information. See Deploying the iSCSI gateway using the service specification section in the Red Hat Ceph Storage Operations Guide for more information.

Commands:
cephadm shell
ceph osd pool create POOL_NAME
ceph osd pool create mypool
ceph orch apply iscsi POOLNAME admin admin --placement=" NUMBER_OF_DAEMONS HOST_NAME_1 HOST_NAME_2 "
ceph orch apply iscsi mypool admin admin --placement="1 host01"
ceph orch ls
ceph orch ps --daemon_type= DAEMON_NAME
ceph orch ps --daemon_type=iscsi
touch iscsi.yml
service_type: iscsi service_id: iscsi placement: hosts: - HOST_NAME_1 - HOST_NAME_2 spec: pool: POOL_NAME # RADOS pool where ceph-iscsi config data is stored. trusted_ip_list: " IP_ADDRESS_1 , IP_ADDRESS_2 " # optional api_port: ... # optional api_user: API_USERNAME # optional api_password: API_PASSWORD # optional api_secure: true/false # optional ssl_cert: | # optional ssl_key: | # optional
service_type: iscsi service_id: iscsi placement: hosts: - host01 spec: pool: mypool
cephadm shell --mount iscsi.yaml:/var/lib/ceph/iscsi.yaml
cd /var/lib/ceph/ DAEMON_PATH /
cd /var/lib/ceph/
ceph orch apply -i FILE_NAME .yml
ceph orch apply -i iscsi.yml
ceph orch ls
ceph orch ps --daemon_type= DAEMON_NAME
ceph orch ps --daemon_type=iscsi
cephadm shell
ceph orch ls
ceph orch rm SERVICE_NAME
ceph orch rm iscsi.iscsi
ceph orch ps
ceph orch ps