Bug 1936096

Summary: [Doc RFE] Document how to configure and use the orchestrator CLI
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: Anjana Suparna Sriram <asriram>
Component: DocumentationAssignee: Ranjini M N <rmandyam>
Status: CLOSED CURRENTRELEASE QA Contact: Manasa <mgowri>
Severity: high Docs Contact: Amrita <asakthiv>
Priority: unspecified    
Version: 5.0CC: agunn, asakthiv, gpatta, gsitlani, hyelloji, kdreyer, mgowri, rmandyam, tchandra, ukurundw, vashastr, vereddy
Target Milestone: ---Keywords: Documentation, FutureFeature
Target Release: 5.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1940304 (view as bug list) Environment:
Last Closed: 2021-09-09 11:57:04 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1929147, 1940304    

Comment 1 RHEL Program Management 2021-03-06 17:23:15 UTC
Please specify the severity of this bug. Severity is defined here:
https://bugzilla.redhat.com/page.cgi?id=fields.html#bug_severity.

Comment 13 Vasishta 2021-05-25 09:06:54 UTC
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

Comment 19 Gopi 2021-06-17 06:57:43 UTC
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.