Chapter 12. Management of iSCSI gateway using the Ceph Orchestrator (Limited Availability)

Procedure

1. Log into the Cephadm shell:

   Example

   [root@host01 ~]# cephadm shell

2. Create the pool:

   Syntax

   ceph osd pool create POOL_NAME

   Example

   [ceph: root@host01 /]# ceph osd pool create mypool

3. Deploy iSCSI gateway using command line interface:

   Syntax

   ceph orch apply iscsi POOLNAME admin admin --placement="NUMBER_OF_DAEMONS HOST_NAME_1 HOST_NAME_2"

   Example

   [ceph: root@host01 /]# ceph orch apply iscsi mypool admin admin --placement="1 host01"

Procedure

1. Create the iscsi.yml file:

   Example

   [root@host01 ~]# touch iscsi.yml

2. Edit the iscsi.yml file to include the following details:

   Syntax

   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
     ...

   Example

   service_type: iscsi
   service_id: iscsi
   placement:
     hosts:
       - host01
   spec:
     pool: mypool

3. Mount the YAML file under a directory in the container:

   Example

   [root@host01 ~]# cephadm shell --mount iscsi.yaml:/var/lib/ceph/iscsi.yaml

4. Navigate to the following directory:

   Syntax

   cd /var/lib/ceph/DAEMON_PATH/

   Example

   [ceph: root@host01 /]# cd /var/lib/ceph/

5. Deploy iSCSI gateway using service specification:

   Syntax

   ceph orch apply -i FILE_NAME.yml

   Example

   [ceph: root@host01 iscsi]# ceph orch apply -i iscsi.yml

Procedure

1. Log into the Cephadm shell:

   Example

   [root@host01 ~]# cephadm shell

2. List the service:

   Example

   [ceph: root@host01 /]# ceph orch ls

   1. Remove the service

      Syntax

      ceph orch rm SERVICE_NAME

      Example

      [ceph: root@host01 /]# ceph orch rm iscsi.iscsi