ibm cinder xiv #6
Description
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
Overview
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.
Usage
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.
cinder service-list
Troubleshooting
-
Deploying the charm to the right machine Note that
ibm-cinder-xiv
is 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
1.7.0.1-b985
. -
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:source openstack-on-lxd/novarc
Installation
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
Configuration
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"
Uninstalling
To Remove the relation and application, run:
juju remove-relation cinder ibm-cinder-xiv
juju remove-application ibm-cinder-xiv
juju remove-application cinder
Known Limitations:
This charm makes use of Juju features that are only available in version 2.0 or greater.
Contact Information:
For issues with this charm, please contact the IBM Juju Support Team
Configuration
- san-clustername
- (string) Specifies the name of the XIV storage pool that is used by the Cinder driver.
- san-ip
- (string) IP address of SAN controller.
- san-login
- (string) Username for SAN controller.
- san-password
- (string) Password for SAN controller.
- volume-backend-name
- (string) This value denotes the name of volume backend.
- volume-driver
- (string) This value denotes the name of volume driver.
- xiv-chap
- (string) CHAP authentication mode, effective only for iscsi (disabled|enabled).
- xiv-ds8k-connection-type
- (string) Connection type to the IBM Storage Array.