Skip to content
CSI Driver for Dell EMC PowerMax
Go Gherkin Shell Smarty RPC Makefile Dockerfile
Branch: master
Clone or download
eric-young Merge pull request #8 from dell/version-1.0.0/docs
Publishing final documentation for Version 1.0.0
Latest commit 4e60e86 Jul 25, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
core
helm Added helm charts for installation Jul 10, 2019
pmax Version 1.0.0 Jul 10, 2019
provider
service refactoring unit tests for cache timeout and deletion worker Jul 23, 2019
test Version 1.0.0 Jul 10, 2019
.gitignore
CSI Driver for Dell EMC PowerMax Product Guide.pdf
CSI Driver for Dell EMC PowerMax Release Notes.pdf
Dockerfile Version 1.0.0 Jul 10, 2019
LICENSE Version 1.0.0 Jul 10, 2019
Makefile
README.md
check.sh
docker.mk
env.sh
go.mod
go.sum Version 1.0.0 Jul 10, 2019
main.go
plugin.go Version 1.0.0 Jul 10, 2019

README.md

CSI Driver for Dell EMC PowerMax

Repository for CSI Driver for Dell EMC PowerMax development project

Description

CSI Driver for Dell EMC PowerMax is a Container Storage Interface (CSI) driver that provides support for provisioning persistent storage using Dell EMC PowerMax storage array.

It supports CSI specification version 1.0.

This project may be compiled as a stand-alone binary using Golang that, when run, provides a valid CSI endpoint. This project can also be built as a Golang plug-in in order to extend the functionality of other programs.

Building

This project is a Go module (see golang.org Module information for explanation). The dependencies for this project are in the go.mod file.

To build the source, execute make clean build.

To run unit tests, execute make unit-test.

To build a docker image, execute make docker.

You can run an integration test on a Linux system by populating the file env.sh with values for your Dell EMC PowerMax systems and then run "make integration-test".

Runtime Dependencies

Both the Controller and the Node portions of the driver can only be run on nodes which have network connectivity to a “Unisphere for PowerMax” server (which is used by the driver).

The Node portion of the driver can only be run on nodes that have the iscsi-initiator-utils package installed.

Installation

Installation in a Kubernetes cluster should be done using the install.powermax script and accompanying Helm chart in the helm directory.

For more information, please refer to the CSI Driver for Dell EMC PowerMax Product Guide and CSI Driver for Dell EMC PowerMax Release Notes.

The driver will be started in Kubernetes as a result of executing the installation script.

Using driver

A number of test helm charts and scripts are found in the directory test/helm. Product Guide provides descriptions of how to run these and explains how they work.

Parameters

When using the driver, some additional parameters have to be specified in the storage class in Kubernetes. These parameters influence how the volume is provisoned on the PowerMax array.

Those parameters are listed here.

  • SYMID : The symmetrix ID of the PowerMax array
  • SRP : The Storage Resource Pool (SRP) name
  • ServiceLevel : Service Level on the PowerMax array (Optional). If not specified, the driver will default to Optimized Service Level.

Capable operational modes

The CSI spec defines a set of AccessModes that a volume can have. CSI Driver for Dell EMC PowerMax supports the following modes for volumes that will be mounted as a filesystem:

// Can only be published once as read/write on a single node,
// at any given time.
SINGLE_NODE_WRITER = 1;

// Can only be published once as readonly on a single node,
// at any given time.
SINGLE_NODE_READER_ONLY = 2;

This means that volumes can be mounted to a single node at a time, with read-write or read-only permission

In general, volumes should be formatted with xfs or ext4.

Support

The CSI Driver for Dell EMC PowerMax image available on Dockerhub is officially supported by Dell EMC.

The source code available on Github is unsupported and provided solely under the terms of the license attached to the source code. For clarity, Dell EMC does not provide support for any source code modifications.

For any CSI driver setup, configuration issues, questions or feedback, join the Dell EMC Container community athttps://www.dell.com/community/Containers/bd-p/Containers

For any Dell EMC storage issues, please contact Dell support at: https://www.dell.com/support.

You can’t perform that action at this time.