diff --git a/doc/config-reference/block-storage/drivers/zfssa-volume-driver.xml b/doc/config-reference/block-storage/drivers/zfssa-volume-driver.xml new file mode 100644 index 0000000000..ac22d23de7 --- /dev/null +++ b/doc/config-reference/block-storage/drivers/zfssa-volume-driver.xml @@ -0,0 +1,129 @@ +
+ Oracle ZFSSA iSCSI Driver + Oracle ZFS Storage Appliances (ZFSSAs) provide advanced software to protect data, speed tuning and + troubleshooting, and deliver high performance and high availability. + Through the Oracle ZFSSA iSCSI Driver, OpenStack Block Storage can use an Oracle ZFSSA as a block storage resource. + The driver enables you to create iSCSI volumes that an OpenStack Block Storage server can allocate to any virtual machine running on a compute host. + The Oracle ZFSSA iSCSI Driver, version 1.0.0, supports ZFSSA software release 2013.1.2.0 and later. + + + + Configuration + + + Enable RESTful service on the ZFSSA Storage Appliance. + + + Create a new user on the appliance with the following authorizations: + + + scope=stmf - allow_configure=true + + + scope=nas - allow_clone=true, allow_createProject=true, allow_createShare=true, allow_changeSpaceProps=true, allow_changeGeneralProps=true, allow_destroy=true, allow_rollback=true, allow_takeSnap=true + + + + You can create a role with authorizations as follows: + + zfssa:> configuration roles +zfssa:configuration roles> role OpenStackRole +zfssa:configuration roles OpenStackRole (uncommitted)> set description="OpenStack Cinder Driver" +zfssa:configuration roles OpenStackRole (uncommitted)> commit +zfssa:configuration roles> select OpenStackRole +zfssa:configuration roles OpenStackRole> authorizations create +zfssa:configuration roles OpenStackRole auth (uncommitted)> set scope=stmf +zfssa:configuration roles OpenStackRole auth (uncommitted)> set allow_configure=true +zfssa:configuration roles OpenStackRole auth (uncommitted)> commit + You can create a user with a specific role as follows: + zfssa:> configuration users +zfssa:configuration users> user cinder +zfssa:configuration users cinder (uncommitted)> set fullname="OpenStack Cinder Driver" +zfssa:configuration users cinder (uncommitted)> set initial_password=12345 +zfssa:configuration users cinder (uncommitted)> commit +zfssa:configuration users> select cinder set roles=OpenStackRole + + + You can also run this workflow to automate the above tasks. + + + + + + Ensure that the ZFSSA iSCSI service is online. If the ZFSSA iSCSI service is not online, enable the service by using the BUI, CLI or REST API in the appliance. + + zfssa:> configuration services iscsi +zfssa:configuration services iscsi> enable +zfssa:configuration services iscsi> show +Properties: +<status>= online +... + + + +Define the following required properties in the cinder.conf file: + volume_driver = cinder.volume.drivers.zfssa.zfssaiscsi.ZFSSAISCSIDriver +san_ip = myhost +san_login = username +san_password = password +zfssa_pool = mypool +zfssa_project = myproject +zfssa_initiator_group = default +zfssa_target_portal = w.x.y.z:3260 +zfssa_target_interfaces = e1000g0 +Optionally, you can define additional properties. + Target interfaces can be seen as follows in the CLI: + zfssa:> configuration net interfaces +zfssa:configuration net interfaces> show +Interfaces: +INTERFACE STATE CLASS LINKS ADDRS LABEL +e1000g0 up ip e1000g0 1.10.20.30/24 Untitled Interface +... + + + Do not use management interfaces for zfssa_target_interfaces. + + + + + + Supported operations + + + Create and delete volumes + + + Extend volume + + + Create and delete snapshots + + + Create volume from snapshot + + + Delete volume snapshots + + + Attach and detach volumes + + + Get volume stats + + + Clone volumes + + + + + + Driver options + The Oracle ZFSSA iSCSI Driver supports these options: + + + +
\ No newline at end of file diff --git a/doc/config-reference/block-storage/section_misc.xml b/doc/config-reference/block-storage/section_misc.xml index a0633f77e1..598f959cf7 100644 --- a/doc/config-reference/block-storage/section_misc.xml +++ b/doc/config-reference/block-storage/section_misc.xml @@ -32,7 +32,6 @@ - diff --git a/doc/config-reference/block-storage/section_volume-drivers.xml b/doc/config-reference/block-storage/section_volume-drivers.xml index ea84fc3515..dc3321f8b9 100644 --- a/doc/config-reference/block-storage/section_volume-drivers.xml +++ b/doc/config-reference/block-storage/section_volume-drivers.xml @@ -42,4 +42,5 @@ +