ibm cinder ds8k #11

Description

Cinder is the block storage service for the Openstack project.
This charm provides DS8K storage backend for Cinder


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

management_ips
(string) It defines the ds8k management ip's.
xiv_ds8k_connection_type
(string) It defines the ds8k connection type.
san_clustername
(string) It defines the storage pool.
ds8k_storage_unit
(string) Default pool name for volumes.
volume-backend-name
(string) This value is denotes the name of volume backend.
san-ip
(string) This is the IP address of the ds8k.
ds8k_java_path
(string) It defines the ds8k java path.
volume-driver
(string) This value is denotes the name of volume driver.
cinder.volume.drivers.ibm.xiv_ds8k.XIVDS8KDriver
host_profile
(string) It defines the ds8k host profile.
san-login
(string) This is the user id to login ds8k.
ds8k_jar_lib_path
(string) It defines the ds8k java lib path.
san-password
(string) This is the password for ds8k.
xiv_chap
(string) It defines the xiv_chap.