summaryrefslogtreecommitdiffstats
path: root/doc/cephadm/services/iscsi.rst
blob: e039e8d9a34672043a4c9639429aaac1d2396cf9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
=============
iSCSI Service
=============

.. _cephadm-iscsi:

Deploying iSCSI
===============

To deploy an iSCSI gateway, create a yaml file containing a
service specification for iscsi:

.. code-block:: yaml

    service_type: iscsi
    service_id: iscsi
    placement:
      hosts:
        - host1
        - host2
    spec:
      pool: mypool  # RADOS pool where ceph-iscsi config data is stored.
      trusted_ip_list: "IP_ADDRESS_1,IP_ADDRESS_2"
      api_port: ... # optional
      api_user: ... # optional
      api_password: ... # optional
      api_secure: true/false # optional
      ssl_cert: | # optional
        ...
      ssl_key: | # optional
        ...

For example:

.. code-block:: yaml

    service_type: iscsi
    service_id: iscsi
    placement:
      hosts:
      - [...]
    spec:
      pool: iscsi_pool
      trusted_ip_list: "IP_ADDRESS_1,IP_ADDRESS_2,IP_ADDRESS_3,..."
      api_user: API_USERNAME
      api_password: API_PASSWORD
      ssl_cert: |
        -----BEGIN CERTIFICATE-----
        MIIDtTCCAp2gAwIBAgIYMC4xNzc1NDQxNjEzMzc2MjMyXzxvQ7EcMA0GCSqGSIb3
        DQEBCwUAMG0xCzAJBgNVBAYTAlVTMQ0wCwYDVQQIDARVdGFoMRcwFQYDVQQHDA5T
        [...]
        -----END CERTIFICATE-----
      ssl_key: |
        -----BEGIN PRIVATE KEY-----
        MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC5jdYbjtNTAKW4
        /CwQr/7wOiLGzVxChn3mmCIF3DwbL/qvTFTX2d8bDf6LjGwLYloXHscRfxszX/4h
        [...]
        -----END PRIVATE KEY-----

.. py:currentmodule:: ceph.deployment.service_spec

.. autoclass:: IscsiServiceSpec
   :members:


The specification can then be applied using:

.. prompt:: bash #

   ceph orch apply -i iscsi.yaml


See :ref:`orchestrator-cli-placement-spec` for details of the placement specification.

See also: :ref:`orchestrator-cli-service-spec`.

Further Reading
===============

* RBD: :ref:`ceph-iscsi`