Remove content that was placed in the CDG and add a link: https://review.opendev.org/#/c/749089/ Unleash Bugs section. Minor touchups. Leave preview status admonishment a while longer (charm will be promoted to stable in 20.10). Change-Id: I191bfd1f3cdcef7acfe09f93c5474aafce49bf8c
|2 days ago|
|src||3 days ago|
|templates||3 days ago|
|tests||3 days ago|
|unit_tests||3 days ago|
|.gitignore||1 month ago|
|.gitmodules||1 month ago|
|.gitreview||1 month ago|
|.jujuignore||1 month ago|
|.stestr.conf||4 months ago|
|.zuul.yaml||1 month ago|
|README.md||2 days ago|
|actions.yaml||3 days ago|
|build-requirements.txt||1 month ago|
|config.yaml||3 days ago|
|copyright||1 month ago|
|metadata.yaml||2 months ago|
|requirements.txt||6 days ago|
|test-requirements.txt||1 month ago|
|tox.ini||1 month ago|
Warning: This charm is in a preview state and should not be used in production. See the OpenStack Charm Guide for more information on preview charms.
config.yaml for the full list of options, along with their
descriptions and default values.
We are assuming a pre-existing Ceph cluster.
To provide multiple data paths to clients deploy exactly two ceph-iscsi units:
juju deploy -n 2 cs:~openstack-charmers-next/ceph-iscsi
Then add a relation to the ceph-mon application:
juju add-relation ceph-iscsi:ceph-client ceph-mon:client
Deploying four ceph-iscsi units is theoretical possible but it is not an officially supported configuration.
The ceph-iscsi application cannot be containerised.
Co-locating ceph-iscsi with another application is only supported with ceph-osd, although doing so with other applications may still work.
This section covers Juju actions supported by the charm. Actions allow specific operations to be performed on a per-unit basis.
To display action descriptions run
juju actions ceph-iscsi. If the charm is
not deployed then see file
An iSCSI target can be created easily with the charm’s
juju run-action --wait ceph-iscsi/0 create-target \ client-initiatorname=iqn.1993-08.org.debian:01:aaa2299be916 \ client-username=myiscsiusername \ client-password=myiscsipassword \ image-size=5G \ image-name=small \ pool-name=images
In the above, all option values are generally user-defined with the exception
of the initiator name (
client-initiatorname). An iSCSI initiator is
essentially an iSCSI client and so its name is client-dependent. Some
initiators may impose policy on credentials (
Important: The underlying machines for the ceph-iscsi units must have internal name resolution working (i.e. the machines must be able to resolve each other’s hostnames).
The management of targets, beyond the target-creation action described above,
can be accomplished via the
gwcli utility. This CLI tool has its own shell,
and is available from any ceph-iscsi unit:
juju ssh ceph-iscsi/1 sudo gwcli /> help
Please report bugs on Launchpad.
For general charm questions refer to the OpenStack Charm Guide.