The HP3PARFCDriver and
HP3PARISCSIDriver are installed
with the OpenStack software.
Install the
hp3parclientPython package on the OpenStack Block Storage system.# pip install 'hp3parclient>=3.0,<4.0'
Verify that the HP 3PAR Web Services API server is enabled and running on the HP 3PAR storage system.
Log onto the HP 3PAR storage system with administrator access.
$ ssh 3paradm@
<HP 3PAR IP Address>View the current state of the Web Services API Server.
# showwsapi -Service- -State- -HTTP_State- HTTP_Port -HTTPS_State- HTTPS_Port -Version- Enabled Active Enabled 8008 Enabled 8080 1.1
If the Web Services API Server is disabled, start it.
# startwsapi
If the HTTP or HTTPS state is disabled, enable one of them.
# setwsapi -http enable
or
# setwsapi -https enable
![[Note]](../common/images/admon/note.png)
Note To stop the Web Services API Server, use the stopwsapi command. For other options run the setwsapi –h command.
If you are not using an existing CPG, create a CPG on the HP 3PAR storage system to be used as the default location for creating volumes.
Make the following changes in the
/etc/cinder/cinder.conffile.## REQUIRED SETTINGS # 3PAR WS API Server URL hp3par_api_url=https://10.10.0.141:8080/api/v1 # 3PAR Super user username hp3par_username=3paradm # 3PAR Super user password hp3par_password=3parpass # 3PAR CPG to use for volume creation hp3par_cpg=OpenStackCPG_RAID5_NL # IP address of SAN controller for SSH access to the array san_ip=10.10.22.241 # Username for SAN controller for SSH access to the array san_login=3paradm # Password for SAN controller for SSH access to the array san_password=3parpass # FIBRE CHANNEL(uncomment the next line to enable the FC driver) # volume_driver=cinder.volume.drivers.san.hp.hp_3par_fc.HP3PARFCDriver # iSCSI (uncomment the next line to enable the iSCSI driver and # hp3par_iscsi_ips or iscsi_ip_address) #volume_driver=cinder.volume.drivers.san.hp.hp_3par_iscsi.HP3PARISCSIDriver # iSCSI multiple port configuration # hp3par_iscsi_ips=10.10.220.253:3261,10.10.222.234 # Still available for single port iSCSI configuration #iscsi_ip_address=10.10.220.253 ## OPTIONAL SETTINGS # Enable HTTP debugging to 3PAR hp3par_debug=False # Enable CHAP authentication for iSCSI connections. hp3par_iscsi_chap_enabled=false # The CPG to use for Snapshots for volumes. If empty hp3par_cpg will be used. hp3par_snap_cpg=OpenStackSNAP_CPG # Time in hours to retain a snapshot. You can't delete it before this expires. hp3par_snapshot_retention=48 # Time in hours when a snapshot expires and is deleted. This must be larger than retention. hp3par_snapshot_expiration=72
![[Note]](../common/images/admon/note.png)
Note You can enable only one driver on each cinder instance unless you enable multiple back-end support. See the Cinder multiple back-end support instructions to enable this feature.
![[Note]](../common/images/admon/note.png)
Note You can configure one or more iSCSI addresses by using the
hp3par_iscsi_ipsoption. When you configure multiple addresses, the driver selects the iSCSI port with the fewest active volumes at attach time. The IP address might include an IP port by using a colon (:) to separate the address from port. If you do not define an IP port, the default port 3260 is used. Separate IP addresses with a comma (,). Theiscsi_ip_address/iscsi_portoptions might be used as an alternative tohp3par_iscsi_ipsfor single port iSCSI configuration.Save the changes to the
cinder.conffile and restart thecinder-volumeservice.
The HP 3PAR Fibre Channel and iSCSI drivers are now enabled on your OpenStack system. If you experience problems, review the Block Storage service log files for errors.

