Hitachi Storage Manual Setup Guide

Overview

The Burrito platform services OpenStack in a Kubernetes environment.

This document provides manual setup instructions for using Hitachi Storage as a storage backend on the Burrito platform.

The reference model is the Hitachi VSP E990.

The Burrito platform services OpenStack in a Kubernetes environment.

You need to set up Hitachi Storage Plug-in for Containers (HSPC) for Kubernetes Persistent Volume service and Hitachi Block Storage Driver (HBSD) for OpenStack Cinder Volume service.

Host Group Naming Rules

Host groups can be created automatically or manually, but the automatic host group setting method cannot be used due to the different host group naming rules defined by HSPC and HBSD.

HSPC’s Host Group naming rule is spc-<wwn1>-<wwn2>-<wwn3>.

  • Sort each WWN in ascending order and use the first three WWNs.

  • If the host has two HBA ports, the Host Group name rule would be spc-<wwn1>-<wwn2>.

  • If the host has more than three HBA ports, the Host Group name is still spc-<wwn1>-<wwn2>-<wwn3>.

The Host Group naming rule for HBSD is HBSD-<wwn>.

  • If there are multiple HBA ports, sort each wwn in ascending order and use the first wwn.

Preparation

Fill in the WWN and Host Name information for each host in the following table with the help of a Hitachi engineer.

Example) Assume there are 2 HBA ports for each node.

Port

HBA WWN

Host Name

Host Group

CL3-A

51402ec0181c5148

control-1

CL4-A

51402ec0181c514a

control-1

CL2-A

51402ec0181c5158

compute-1

CL1-A

51402ec0181c515a

compute-1

CL5-A

51402ec0181c50a8

compute-2

CL6-A

51402ec0181c50aa

compute-2

  • Port: The port name of the Hitachi Storage

  • HBA WWN: HBA WWN of the node

Now, enter the Host Group name for manual configuration in the table below according to the rules.

In Burrito, only the control node uses Kubernetes PV, so the first WWN of the control node is mapped to Host Group name HBSD-<wwn1> for OpenStack, and the second WWN is mapped to Host Group name spc-<wwn1>-<wwn2> for Kubernetes.

The Compute node does not use Kubernetes PV, so all HBA WWNs are mapped to Host Group name HBSD-<wwn1> for OpenStack.

Port

HBA WWN

Host Name

Host Group

CL3-A

51402ec0181c5148

control-1

HBSD-51402ec0181c5148

CL4-A

51402ec0181c514a

control-1

spc-51402ec0181c5148-51402ec0181c514a

CL2-A

51402ec0181c5158

compute-1

HBSD-51402ec0181c5158

CL1-A

51402ec0181c515a

compute-1

HBSD-51402ec0181c5158

CL5-A

51402ec0181c50a8

compute-2

HBSD-51402ec0181c50a8

CL6-A

51402ec0181c50aa

compute-2

HBSD-51402ec0181c50a8

Manual Host Group Setup

Based on the table above, create and set up a manual Host Group in the Hitachi Virtual Storage Platform (VSP) UI.

Connect to Hitachi VSP. (Contact a Hitachi engineer for access instructions)

Click “Ports/Host Groups/iSCSI Targets” in the left Explorer -> Storage Systems -> VSP E990 (S/N:xxxxxx) tree menu.

Click the Create Host Groups button on the right panel to create each host group as shown in the table above.

Create Host Group

  • Enter the host group name.

  • Clock Host Mode Options and select Mode No. 2, 13, 22, 68, 91 to enable.

  • Under Available Hosts, select the HBA WWN that is mapped.

  • Under Available Ports, select the Storage port that is mapped.

Click the Add button, and then click the Finish button to create the host group.

The following is a list of host groups after all host groups are created.

List Host Group

Click the host group name and click the Host Mode Options tab to view the Host Mode Options settings. 2, 13, 22, 68. 91 should be enabled.

Host Mode Options

The Host Group setup is complete. Now that your Hitachi Storage is ready to use, you can proceed to install Burrito.