ibm cinder ds8k #11
Description
Cinder is the block storage service for the Openstack project. This charm provides DS8K storage backend for Cinder
Software & terms:
DS8K Storage Backend for Cinder
Overview
This charm provides DS8K storage support on S390x for use with a Cinder charm deployment, allowing multiple DS8K 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-ds8k --resource ibm_cinder_ds8k_installer=</path/to/installer.tar.zip>
juju add-relation cinder ibm-cinder-ds8k
Run the next command to test the Cinder DS8K storage after successful deployment of the ibm-cinder-ds8k
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-ds8k
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 DS8K 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-ds8k/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 DS8K management interface. They can be set, among others, by running the following commands:
juju config ibm-cinder-ds8k san-ip="ip address"
juju config ibm-cinder-ds8k san-login="login_name"
juju config ibm-cinder-ds8k san-password ="login_password"
juju config ibm-cinder-ds8k volume-driver="drivername"
juju config ibm-cinder-ds8k volume-backend-name="backend-name"
juju config ibm-cinder-ds8k ds8k_storage_unit="storage_unit"
juju config ibm-cinder-ds8k san_clustername=clustername"
juju config ibm-cinder-ds8k xiv_chap="enabled/disabled"
juju config ibm-cinder-ds8k xiv_ds8k_connection_type="ds8k connection type"
juju config ibm-cinder-ds8k management_ips="ip's"
juju config ibm-cinder-ds8k ds8k_java_path="java_path"
juju config ibm-cinder-ds8k host_profile="host_profile"
juju config ibm-cinder-ds8k ds8k_jar_lib_path="jar_lib_path"
Uninstalling
To Remove the relation and application, run:
juju remove-relation cinder ibm-cinder-ds8k
juju remove-application ibm-cinder-ds8k
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 IBM Juju Support Team
Configuration
- ds8k_jar_lib_path
- (string) It defines the ds8k java lib path.
- ds8k_java_path
- (string) It defines the ds8k java path.
- ds8k_storage_unit
- (string) Default pool name for volumes.
- host_profile
- (string) It defines the ds8k host profile.
- management_ips
- (string) It defines the ds8k management ip's.
- san-ip
- (string) This is the IP address of the ds8k.
- san-login
- (string) This is the user id to login ds8k.
- san-password
- (string) This is the password for ds8k.
- san_clustername
- (string) It defines the storage pool.
- volume-backend-name
- (string) This value is denotes the name of volume backend.
- volume-driver
- (string) This value is denotes the name of volume driver.
- cinder.volume.drivers.ibm.xiv_ds8k.XIVDS8KDriver
- xiv_chap
- (string) It defines the xiv_chap.
- xiv_ds8k_connection_type
- (string) It defines the ds8k connection type.