Skip to content

Commit 35005e5

Browse files
committed
Rewrite of Readme
1 parent 135b9f8 commit 35005e5

File tree

1 file changed

+64
-9
lines changed

1 file changed

+64
-9
lines changed
Lines changed: 64 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,72 @@
11
# Hitachi Storage Plug-in for Containers
2+
23
Hitachi Storage Plug-in for Containers lets you create containers and run stateful applications
34
inside those containers by using the Hitachi storage volumes as dynamically provisioned
45
persistent volumes.
56

6-
# Kubernetes versions supported:
7-
Above 1.21
8-
Maximum supported minor version is 1.31
97

10-
# Pre-requisites
11-
A Hitachi Virtual Storage Platform (VSP) array.
8+
## Prerequisites
9+
10+
- A Hitachi Virtual Storage Platform (VSP) array.
11+
12+
13+
## Parameters
14+
15+
To deploy the Hitachi HSPC pack, you need to set, at minimum, the following parameters in the pack's YAML.
16+
17+
| Name | Description | Type | Default Value | Required |
18+
| --- | --- | --- | --- | --- |
19+
| `hspc.vsp.url` | The URL of your Hitachi VSP management endpoint. | String | - | Yes |
20+
| `hspc.vsp.user` | The username of a Hitachi VSP account with appropriate permissions. | String | - | Yes |
21+
| `hspc.vsp.password` | The password of a Hitachi VSP account with appropriate permissions. | String | - | Yes |
22+
| `hspc.storageClass.parameters.serialNumber` | The serial number of the VSP storage chassis. | String | - | Yes |
23+
| `hspc.storageClass.parameters.poolID` | The HDP Pool ID (omit for VSP One SDS Block). | String | - | Yes |
24+
| `hspc.storageClass.parameters.portID` | The port ID (omit for VSP One SDS Block). Use a comma separator for multipath. If an NVMe over FC is used, don't set this option. | String | - | Yes |
25+
| `hspc.storageClass.parameters.connectionType` | Storage connection type. fc, iscsi, and nvme-fc are supported. Defaults to fc if not set. | String | fc | No |
26+
| `hspc.storageClass.parameters.storageEfficiency` | Adaptive data reduction. "Compression", "CompressionDeduplication", and "Disabled" are supported. | String | - | Yes |
27+
| `hspc.storageClass.parameters.storageEfficiencyMode` | Compression execution mode. "Inline" and "PostProcess" are supported. | String | - | No |
28+
| `hspc.storageClass.parameters.storageType` | For VSP One SDS Block, set the "storagetype" parameter to "vsp-one-sds-block". | String | - | No |
29+
| `hspc.storageClass.parameters.csi.storage.k8s.io/fstype` | Filesystem type, ext4 and xfs are supported. Defaults to ext4 if not set. | String | ext4 | No |
30+
31+
32+
Review the [Hitachi Storage Plug-in for Containers Quick Reference Guide](https://docs.hitachivantara.com/v/u/en-us/adapters-and-drivers/3.14.x/mk-92adptr142) for more details on parameters.
33+
34+
## Upgrade
35+
36+
This pack deploys an operator, which takes care of phased upgrades
37+
38+
39+
## Usage
40+
41+
To use the Hitachi Storage Plug-in for Containers pack, first create a new [infrastructure cluster profile](https://docs.spectrocloud.com/profiles/cluster-profiles/create-cluster-profiles/create-infrastructure-profile/), select MAAS for the Infrastructure Provider and when you get to the Storage pack, search for the **Hitachi Storage Plug-in for Containers** pack in the Palete Community Registry. Then configure the `hspc.vsp` and `hspc.storageClass` sections in the pack YAML:
42+
43+
```yaml
44+
charts:
45+
hspc:
46+
...
47+
vsp:
48+
url: http://172.16.1.1
49+
user: "User01"
50+
password: "*******"
51+
storageClass:
52+
name: spectro-storage-class
53+
isDefaultStorageClass: true
54+
allowVolumeExpansion: true
55+
reclaimPolicy: Delete
56+
volumeBindingMode: Immediate
57+
parameters:
58+
serialNumber: "54321"
59+
poolID: "1"
60+
portID : CL1-A,CL2-A
61+
connectionType: fc
62+
storageEfficiency: "CompressionDeduplication"
63+
storageEfficiencyMode: "Inline"
64+
```
65+
66+
Once you have confiogured the pack, you can deploy a cluster with it.
67+
1268
13-
# Cloud types supported:
14-
MAAS, Edge
69+
## References
1570
16-
# References:
17-
- https://www.hitachivantara.com/
71+
- [Hitachi Vantara website](https://www.hitachivantara.com/)
72+
- [Hitachi HSPC Quick Reference Guide](https://docs.hitachivantara.com/v/u/en-us/adapters-and-drivers/3.14.x/mk-92adptr142)

0 commit comments

Comments
 (0)