Please specify the severity of this bug. Severity is defined here:
https://bugzilla.redhat.com/page.cgi?id=fields.html#bug_severity.

Hi Ranjini,

I have a confusion here on scope of this BZ and the content of new operations guide.
Mainly on chapters 2.9 to 2.12 .

Will we be having object-gateway guide, block device guide and filesystem guide for 5.0 ?
If yes, I think the above mentioned chapter might belong to those respective chapters to be more specific I think or either we need to provide reference to these chapters or duplicae the content in those guides.

Can you please let me know your views?

Regards,
Vasishta Shastry
QE, ceph

Hi Ranjini,

Few changes are required for iscsi.

In section 1.13.3 - step2 - Navigate to the following directory: -- This step is not necessary i feel as that path doesn't exists and we can create iscsi.yml file under root and apply.
[ceph: root@magna031 ~]# cd /var/lib/ceph/iscsi/
bash: cd: /var/lib/ceph/iscsi/: No such file or directory
[ceph: root@magna031 ~]# cat iscsi.yaml 
service_type: iscsi
service_id: iscsi
placement:
  hosts:
  - magna031.ceph.redhat.com
  - magna032.ceph.redhat.com
spec:
  pool: iscsi_pool
  trusted_ip_list: "10.8.128.31,10.8.128.32,2620:52:0:880:225:90ff:fefc:25a4,2620:52:0:880:225:90ff:fefc:25a6"
  api_user: admin
  api_password: admin
[ceph: root@magna031 ~]#

Suggestion: You can just mention that, create file under root for better understanding


In section 1.13.3 - step4 - Edit the iscsi.yml file to include the following details: 

In syntax it's telling that poolname is optional but it's mandatory.

service_type: iscsi
service_id: iscsi
placement:
  hosts:
    - HOST_NAME_1
    - HOST_NAME_2
spec:
  pool: POOL_NAME  # optional  (This is not optional): 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
  ...

[ceph: root@magna031 ~]# cat iscsi.yaml 
service_type: iscsi
service_id: iscsi
placement:
  hosts:
  - magna031.ceph.redhat.com
  - magna032.ceph.redhat.com
spec:
  trusted_ip_list: "10.8.128.31,10.8.128.32,2620:52:0:880:225:90ff:fefc:25a4,2620:52:0:880:225:90ff:fefc:25a6"
  api_user: admin
  api_password: admin
[ceph: root@magna031 ~]# ceph orch apply -i iscsi.yaml 
Error EINVAL: Cannot add ISCSI: No Pool specified
[ceph: root@magna031 ~]#


Apart from that, everything looks fine.

Here is the latest preview link: https://jenkins.dxp.redhat.com/job/CCS/job/ccs-mr-preview/884/artifact/preview/index.html#deploying-the-iscsi-gateway-using-the-service-specification_ops