Liberty -  Liberty -  Liberty -  Liberty -  Liberty -  Liberty -  Liberty -  Liberty - 

 Enable the HP 3PAR Fibre Channel and iSCSI drivers

The HP3PARFCDriver and HP3PARISCSIDriver are installed with the OpenStack software.

  1. Install the hp3parclient Python package on the OpenStack Block Storage system.

    # pip install 'hp3parclient>=3.0,<4.0'

  2. Verify that the HP 3PAR Web Services API server is enabled and running on the HP 3PAR storage system.

    1. Log onto the HP 3PAR storage system with administrator access.

      $ ssh 3paradm@<HP 3PAR IP Address>
    2. 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
    3. If the Web Services API Server is disabled, start it.

      # startwsapi
  3. If the HTTP or HTTPS state is disabled, enable one of them.

    # setwsapi -http enable

    or

    # setwsapi -https enable

    [Note]Note

    To stop the Web Services API Server, use the stopwsapi command. For other options run the setwsapi –h command.

  4. 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.

  5. Make the following changes in the /etc/cinder/cinder.conf file.

    ## REQUIRED SETTINGS
    # 3PAR WS API Server URL
    hp3par_api_url=https://10.10.0.141:8080/api/v1
    
    # 3PAR username with the 'edit' role
    hp3par_username=edit3par
    
    # 3PAR password for the user specified in hp3par_username
    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
    
    # The ratio of oversubscription when thin provisioned volumes are involved.
    # Default ratio is 20.0, this means that a provisioned capacity can be 20 times of the total
    # physical capacity.
    max_over_subscription_ratio=20.0
    
    # This flag represents the percentage of reserved back-end capacity.
    reserved_percentage=15
    [Note]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]Note

    You can configure one or more iSCSI addresses by using the hp3par_iscsi_ips option. 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 (,). The iscsi_ip_address/iscsi_port options might be used as an alternative to hp3par_iscsi_ips for single port iSCSI configuration.

  6. Save the changes to the cinder.conf file and restart the cinder-volume service.

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.

The following table contains all the configuration options supported by the HP 3PAR Fibre Channel and iSCSI drivers.

Table 2.12. Description of HP 3PAR Fibre Channel and iSCSI drivers configuration options
Configuration option = Default value Description
[DEFAULT]
hp3par_api_url = (StrOpt) 3PAR WSAPI Server Url like https://<3par ip>:8080/api/v1
hp3par_cpg = OpenStack (ListOpt) List of the CPG(s) to use for volume creation
hp3par_cpg_snap = (StrOpt) The CPG to use for Snapshots for volumes. If empty the userCPG will be used.
hp3par_debug = False (BoolOpt) Enable HTTP debugging to 3PAR
hp3par_iscsi_chap_enabled = False (BoolOpt) Enable CHAP authentication for iSCSI connections.
hp3par_iscsi_ips = (ListOpt) List of target iSCSI addresses to use.
hp3par_password = (StrOpt) 3PAR password for the user specified in hp3par_username
hp3par_snapshot_expiration = (StrOpt) The time in hours when a snapshot expires and is deleted. This must be larger than expiration
hp3par_snapshot_retention = (StrOpt) The time in hours to retain a snapshot. You can't delete it before this expires.
hp3par_username = (StrOpt) 3PAR username with the 'edit' role

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

loading table of contents...