Cinder is the block storage service for the Openstack project.
This charm provides XIV storage backend for Cinder
Software & terms:
XIV Storage Backend for Cinder
This charm provides XIV storage support on S390x for use with a Cinder charm deployment, allowing multiple XIV storage clusters to be associated with a single Cinder deployment, potentially alongside storage backends from other vendors.
See the Troubleshooting section below before running the deployment to make sure that your system requirements are met.
To set up the backend:
juju deploy cinder juju deploy ibm-cinder-xiv --resource ibm_cinder_xiv_installer=</path/to/installer.tar.zip> juju add-relation cinder ibm-cinder-xiv
Run the next command to test the Cinder XIV storage after successful deployment of the
ibm-cinder-xiv charm. Its output will list all the storage back ends which were configured.
Deploying the charm to the right machine
ibm-cinder-xivis a subordinate charm to the base Cinder charm. As a consequence, it needs to be deployed to the machine Cinder is deployed to. After identifying the machine that is connected to the backend, it can be configured with:
juju deploy cinder --to
Installing the correct driver
Driver software needs to be the exact version as is noted in the charm resource configuration, namely
Running OpenStack commands
In order to run commands such as
cinder service-list, you need authentication as an administrator. If you set up the OpenStack cloud with OpenStack on LXD, you can run their admin configuration with:
In order to use the charm's resource, download a licensed IBM XIV Installer package following this link.
When deploying from the Charm Store, the terms and conditions will be presented to you for your consideration. To accept the terms, enter:
juju agree ibmcharmers/ibm-cinder-xiv/1
Once the charm is deployed, a number of config parameters need to be passed to the driver in order to fulfill access requirements for the XIV management interface.
They can be set, among others, by running the following commands:
juju config ibm-cinder-xiv san-ip="ip address" juju config ibm-cinder-xiv san-login="login_name" juju config ibm-cinder-xiv san-password ="login_password" juju config ibm-cinder-xiv volume-driver="drivername" juju config ibm-cinder-xiv volume-backend-name="backend_name" juju config ibm-cinder-xiv san-clustername="san-clustername" juju config ibm-cinder-xiv xiv-ds8k-connection-type="connection_type" juju config ibm-cinder-xiv xiv-chap="enabled/disabled"
To Remove the relation and application, run:
juju remove-relation cinder ibm-cinder-xiv juju remove-application ibm-cinder-xiv juju remove-application cinder
This charm makes use of Juju features that are only available in version 2.0 or greater.
For issues with this charm, please contact the IBM Juju Support Team
- (string) Specifies the name of the XIV storage pool that is used by the Cinder driver.
- (string) IP address of SAN controller.
- (string) Username for SAN controller.
- (string) Password for SAN controller.
- (string) This value denotes the name of volume backend.
- (string) This value denotes the name of volume driver.
- (string) CHAP authentication mode, effective only for iscsi (disabled|enabled).
- (string) Connection type to the IBM Storage Array.