The Cinder configuration must specify at least the following information:
Authorization information to authenticate with Keystone.
The class of volumes to be created.
The steps in this procedure refer to the configuration of Cinder endpoint services, not the Cinder or volume node.
controller# pkg install cinder
[DEFAULT] qpid_hostname=$CONTROLLER_ADM_NODE rabbit_host=$CONTROLLER_ADM_NODE my_ip=$CONTROLLER_ADM_NODE [database] connection = mysql://cinder:cinder@$CONTROLLER_ADM_NODE/cinder [keystone_authtoken auth_uri = http://$CONTROLLER_ADM_NODE:5000/v2.0 identity_uri = http://$CONTROLLER_ADM_NODE:35357 admin_tenant_name = tenant admin_user = cinder admin_password = service-password
controller# svcadm enable -rs cinder-db controller# svcadm enable -rs cinder-api cinder-scheduler
The Oracle ZFS Storage Appliance iSCSI Cinder driver enables the Oracle ZFS Storage Appliance (ZFSSA) to be used seamlessly as a block storage resource for Cinder. The driver provides the ability to create iSCSI volumes that can be allocated by a Cinder server to any virtual machine instantiated by the Nova service. The driver is delivered by the cloud/openstack/cinder package. Your appliance must be running at least ZFSSA software release 2013.1.2.0.
Before You Begin
Configure a pool on the Oracle ZFS Storage Appliance. You can choose to use a preexisting pool.
You can either use an existing user or create a new user with role authorizations for performing Cinder driver operations.
The cinder.akwf workflow 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.
You can run the workflow from the Command Line Interface (CLI) or from the Browser User Interface (BUI) of your appliance.
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 the cinder.akwf file" url = "url to the 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 (uncommitted)> set name=openstack name = openstack zfssa:maintenance workflow-001 execute (uncommitted)> set password=openstack-password password = ******** zfssa:maintenance workflow-001 execute (uncommitted)> commit User openstack created.
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.
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 126.96.36.199/24 Untitled Interface
connection – Set the parameter as follows:
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 ...
controller# svcadm enable cinder-volume:default cinder-volume:setup