How to Configure Oracle ZFSSA for OpenStack

Language:

The procedure uses the workflow cinder.akwf which performs the following tasks:

Creates the user if the user does not exist.
Sets role authorizations for performing Cinder driver operations.
Enables the RESTful service if the service is currently disabled.

Before You Begin

Configure a pool on the Oracle ZFS Storage Appliance. You can choose to use a preexisting pool.

Run the workflow cinder.akwf by using one of the following methods:

Run the workflow from the CLI.

zfssa:maintenance workflows> download
zfssa:maintenance workflows download (uncommitted)> show
Properties:
                          url = (unset)
                         user = (unset)
                     password = (unset)

zfssa:maintenance workflows download (uncommitted)> set url= "url-to-cinder.akwf-file"
                          url = "url-to-cinder.akwf-file"
zfssa:maintenance workflows download (uncommitted)> commit
Transferred 2.64K of 2.64K (100%) ... done

zfssa:maintenance workflows> ls
Properties:
                   showhidden = false

Workflows:

WORKFLOW     NAME                                      OWNER SETID ORIGIN              VERSION
workflow-000 Clear locks                               root  false Oracle Corporation  1.0.0
workflow-001 Configuration for OpenStack Cinder Driver root  false Oracle Corporation  1.0.0

zfssa:maintenance workflows> select workflow-001

zfssa:maintenance workflow-001> execute 
zfssa:maintenance workflow-001 execute (uncommitted)> 

zfssa:maintenance workflow-001 execute (uncommitted)> set name=user
                         name = user
zfssa:maintenance workflow-001 execute (uncommitted)> set password=password
                     password = password
zfssa:maintenance workflow-001 execute (uncommitted)> commit
User openstack created.

Note that for user and password, the values are as defined for the san_login and san_password parameters in the cinder.conf file.

Run the workflow from the BUI.
1. Select Maintenance → Workflows, and use the plus icon to upload a new workflow.
2. Click the Browse button, and select the cinder.akwf file.
3. Click the UPLOAD button to finish uploading the workflow.
4. Click on the new row that appears on the BUI Workflows page to run the Cinder driver workflow.
  The workflow prompts for a user name and password. This user name and password will also be used in the cinder.conf file as san_login and san_password.

Set parameters in the /etc/cinder/cinder.conf file.
Specify the following required properties in the cinder.conf file:
- volume_driver – Make sure cinder.volume.drivers.zfssa.zfssaiscsi.ZFSSAISCSIDriver is uncommented. Make sure the other three selections are commented out.
- san_ip – The name or IP address of the ZFSSA management host.
- san_login – The user name of the Cinder user on the ZFSSA.
- san_password – The password of the Cinder user on the ZFSSA.
- zfssa_pool – The pool to be used to allocate volumes.
- zfssa_target_portal – The ZFSSA iSCSI target portal (data-ip:port). The default port is 3260.
- zfssa_project – The name of the ZFSSA project. If the project does not exist on the appliance, a project with that name is created by the driver at startup time. This project contains all the volumes created by the driver. Additional ZFSSA properties are provided for setting up volume characteristics (for example, block size) and access (for example, initiators, targets, security).
- zfssa_initiator_group – The name of the initiator group. If the initiator group does not exist on the appliance, an initiator group with that name is created by the driver at startup time. If you want to use the default initiator group, set the value of this parameter to default. The default initiator group can be useful for evaluation purposes. The default initiator group should not normally be used because it can result in exposure of the volumes to unwanted or conflicting initiators.
- zfssa_target_interfaces – The ZFSSA iSCSI target network interfaces. Use the following command to see the interfaces:
```
zfssa:configuration net interfaces> show
Interfaces:

  INTERFACE STATE CLASS LINKS    ADDRS          LABEL
  e1000g0   up    ip    e1000g0  1.10.20.30/24  Untitled Interface
```
- connection – Set the parameter as follows:
```
connection=mysql://cinder:service-password@controller-fqdn/cinder
```
Ensure the ZFSSA iSCSI service is online.
If the ZFSSA iSCSI service is not online, use either the BUI or the CLI in the appliance to enable it. The following example shows using the CLI in the appliance:
```
zfssa:> configuration services iscsi
zfssa:configuration services iscsi> enable
zfssa:configuration services iscsi> show
Properties:
<status> = online
...
```

Enable the Cinder volume SMF services.

controller# svcadm enable cinder-volume:default cinder-volume:setup