Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Added scaleio troubleshooting information #367

Merged
merged 1 commit into from
Apr 17, 2016
Merged

Added scaleio troubleshooting information #367

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
24 changes: 20 additions & 4 deletions .docs/user-guide/storage-providers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -270,8 +270,14 @@ rackspace:

## ScaleIO
The ScaleIO driver registers a storage driver named `scaleio` with the `REX-Ray`
driver manager and is used to connect and manage ScaleIO storage. The ScaleIO
`REST Gateway` is required for the driver to function.
driver manager and is used to connect and manage ScaleIO storage.


### Requirements
- The ScaleIO `REST Gateway` is required for the driver to function.
- REX-Ray must reside on a host that has the SDC client installed. You should
be able to run `/opt/emc/scaleio/sdc/bin/drv_cfg --query_guid` and it should
return the local SDC GUID.

### Configuration
The following is an example with all possible fields configured. For a running
Expand Down Expand Up @@ -327,20 +333,30 @@ parameter.
- By default the password is the same as your administrative MDM password.
- Start the gateway `service scaleio-gateway start`.
- With 1.32 we have noticed a restart of the gateway may be necessary as well
after an initial install with `service scaleio-gateway restart`.
after an initial install with `service scaleio-gateway restart`.

### Activating the Driver
To activate the ScaleIO driver please follow the instructions for
[activating storage drivers](/user-guide/config#storage-drivers),
using `scaleio` as the driver name.

### Troubleshooting
Ensure that you are able to open a TCP connection to the gateway with the
- Verify your parameters for `system`, `protectionDomain`, and
`storagePool` are correct.
- Verify that have the ScaleIO SDC service installed with
`rpm -qa EMC-ScaleIO-sdc`
- Verify that the following command returns the local SDC GUID
`/opt/emc/scaleio/sdc/bin/drv_cfg --query_guid`.
- Ensure that you are able to open a TCP connection to the gateway with the
address that you will be supplying below in the `gateway_ip` parameter. For
example `telnet gateway_ip 443` should open a successful connection. Removing
the `EMC-ScaleIO-gateway` package and reinstalling can force re-creation of
self-signed certs which may help resolve gateway problems. Also try restarting
the gateway with `service scaleio-gateway restart`.
- Ensure that you have the correct authentication credentials for the gateway.
This can be done with a curl login. You should receive an authentication
token in return.
`curl --insecure --user admin:XScaleio123 https://gw_ip:443/api/login`

### Examples
Below is a full `config.yml` file that works with ScaleIO.
Expand Down