Skip to content

Commit

Permalink
Merge pull request #231 from danforrest/feature/isilon_size_and_preem…
Browse files Browse the repository at this point in the history
…ption

Feature/isilon size and preemption
  • Loading branch information
akutz committed Jan 22, 2016
2 parents 7821f5c + 93a49d4 commit 0499d57
Show file tree
Hide file tree
Showing 3 changed files with 207 additions and 35 deletions.
30 changes: 26 additions & 4 deletions .docs/user-guide/storage-providers/isilon.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Scale-Out NAS is my fame.

## Overview
The Isilon driver registers a storage driver named `isilon` with the `REX-Ray`
driver manager and is used to connect and manage Isilon NAS storage.
driver manager and is used to connect and manage Isilon NAS storage. The driver creates logical volumes in directories on the Isilon cluster. Volumes are exported via NFS and restricted to a single client at a time. Quotas can also be used to ensure that a volume directory doesn't exceed a specified size.

## Configuration
The following is an example configuration of the Isilon driver.
Expand All @@ -16,9 +16,12 @@ isilon:
endpoint: https://endpoint:8080
insecure: true
username: username
group: groupname
password: password
volumePath: /rexray
nfsHost: nfsHost
dataSubnet: subnet
quotas: true
```

For information on the equivalent environment variable and CLI flag names
Expand All @@ -30,6 +33,15 @@ The following items are configurable specific to this driver.

- `volumePath` represents the location under `/ifs/volumes` to allow volumes to be created and removed.
- `nfsHost` is the configurable host used when mounting exports
- `dataSubnet` is the subnet the REX-Ray driver is running on

## Optional Paramters
The following items are not required, but available to this driver.

- `insecure` defaults to `false`.
- `group` defaults to the group of the user specified in the configuration. Only use this option if you need volumes to be created with a different group.
- `volumePath` defaults to "". This will have all new volumes created directly under `/ifs/volumes`.
- `quotas` defaults to `false`. Set to `true` if you have a SmartQuotas license enabled.

## Activating the Driver
To activate the Isilon driver please follow the instructions for
Expand All @@ -50,12 +62,22 @@ isilon:
password: password
volumePath: /rexray
nfsHost: nfsHost
dataSubnet: subnet
quotas: true
```

## Instructions
It is expected that the `volumePath` exists already within the Isilon system. This would reflect a directory create under `/ifs/volumes/rexray`. It is not necessary to export this volume.
It is expected that the `volumePath` exists already within the Isilon system. This example would reflect a directory create under `/ifs/volumes/rexray` for created volumes. It is not necessary to export this volume. The `dataSubnet` parameter is required so the Isilon driver can restrict access to attached volumes to the host that REX-Ray is running on.

If `quotas` are enabled, a SmartQuotas license must also be enabled on the Isilon cluster for the capacity size functionality of REX-Ray to work.

## Caveats

- This driver currently ignores the `--size` and `--volumeType` flags.
- This driver does not support pre-emption currently. Requests from alternate hosts can have bad results.
- This driver currently ignores the `--volumeType` flag.
- The account used to access the Isilon cluster must be in a role with these privileges:
- Namespace Access (ISI_PRIV_NS_IFS_ACCESS)
- Platform API (ISI_PRIV_LOGIN_PAPI)
- NFS (ISI_PRIV_NFS)
- Restore (ISI_PRIV_IFS_RESTORE)
- Quota (ISI_PRIV_QUOTA) (if `quotas` are enabled)

Loading

0 comments on commit 0499d57

Please sign in to comment.