ibm cinder xiv #6

Description

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


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

xiv-ds8k-connection-type
(string) Connection type to the IBM Storage Array.
san-password
(string) Password for SAN controller.
san-ip
(string) IP address of SAN controller.
volume-driver
(string) This value denotes the name of volume driver.
xiv-chap
(string) CHAP authentication mode, effective only for iscsi (disabled|enabled).
san-login
(string) Username for SAN controller.
volume-backend-name
(string) This value denotes the name of volume backend.
san-clustername
(string) Specifies the name of the XIV storage pool that is used by the Cinder driver.