StorageDocsPerfectWorldScenario

From Libvirt Wiki
Jump to: navigation, search

Storage Documentation Mapping

This is a first go at what our Storage docs would include, if we had unlimited resources. :)

Putting this here, so we have a decent idea of the breadth of the subject matter, and choose what to actually put resources into/prioritise.


General concepts

Pools and volumes (high level)
Shared, networked pools can be using for live migration, host specific ones can't
Creation of storage pools
(high level, with specific types detailed later on)

Managing volumes

General concepts
Tasks

  • Creating, listing, refreshing, deleting, cloning, volumes with VMM
  • Creating, listing, refreshing, deleting, cloning, wiping, volumes with virsh

Reference

  • Link to Virsh Command Reference pages

Block devices vs image files

General concepts
Image file types (raw, iso, qcow2)

  • Including pros & cons of each

Statistics and measurement

General concepts
Tools to use
Tasks

  • No clear idea what should be here. Prob need to ask Dave Allen and Rich Jones for input.

Reference

  • Link to the home pages of tools mentioned?
  • No solid idea of what else should be here. Prob need to ask Dave Allen and Rich Jones for input.

Using local directory pools

Intro concept (short)
Tasks

  • Creating a 'dir' type pool with VMM
  • Creating a 'dir' type pool with virsh
  • Creating a 'fs' type pool with VMM
  • Creating a 'fs' type pool with virsh

Reference

  • Link to Virsh Command Reference pages

Using NFS pools

General concepts

  • Include those set up manually in /etc/fstab (allows for passing non-default mount options)
  • Include the 'netfs' pool type (limited flexibility, only allows default mount options)
  • Mention anything NetApp specific

Tasks

  • Creating a 'netfs' type pool with VMM
  • Creating a 'netfs' type pool with virsh

Reference

  • Link to Virsh Command Reference pages
  • Link to NetApp reference material

Using LVM pools

General concepts

  • LVM created manually (allows for passing non-default options)
  • LVM created through libvirt (limited flexibility, only allows default options)

Tasks

  • Creating a 'logical' type pool with VMM
  • Creating a 'logical' type pool with virsh

Reference

  • Link to Virsh Command Reference pages

Using iSCSI pools

General concepts

  • Manually managed iSCSI luns (pros/cons)
  • Libvirt managed (pros/cons)
  • iSCSI multipathing and failover

Tasks

  • Creating an 'iscsi' type pool with VMM
  • Creating an 'iscsi' type pool with virsh

Reference

  • Link to Virsh Command Reference pages

Using dedicated disk device pools

General concepts

  • Stable vs unstable device names
  • Partition types (dos, gpt)
  • Locally attached disks
  • Network block devices (not meaning NBD here)

Tasks

  • Creating an 'disk' type pool with VMM
  • Creating an 'disk' type pool with virsh

Reference

  • Link to Virsh Command Reference pages

Using multipath pools

General concepts

  • Manually managed vs Libvirt managed

Tasks

  • Creating a 'mpath' type pool with VMM
  • Creating a 'mpath' type pool with virsh

Reference

  • Link to Virsh Command Reference pages

Using dedicated SCSI HBAs

General concepts
Tasks

  • Creating a 'scsi' type pool with VMM
  • Creating a 'scsi' type pool with virsh

Reference

  • Link to Virsh Command Reference pages

Using Fibre Channel

General concepts

  • As block devices
  • NPIV
  • Multipathing

Tasks

  • No clear idea what should be here. Ask Dave Allen.

Reference

  • No clear idea what should be here. Ask Dave Allen.

Using Infiniband

General concepts

  • SRP block devices
  • iSER (iSCSI over infiniband)
  • NFS-RDMA

Tasks

  • Configuring SRP LUNS on the host
  • Configuring iSER on the host
  • Configuring NFS-RDMA on the host

Reference

  • Link to the OpenFabrics projects
  • Link to Virsh Command Reference pages

Using GlusterFS

General concepts

  • Manually managed
  • Using the 'fs' pool type

Tasks

  • Creating a GlusterFS 'fs' type pool with virsh

Reference

  • Link to the GlusterFS docs (on gluster.com site)
  • Link to Virsh Command Reference pages

Using Ceph

General concepts

  • No clear idea what should be here.

Tasks

  • No clear idea what should be here.

Reference

  • Link to the Ceph site
  • Link to Virsh Command Reference pages

Using Sheepdog

General concepts

  • No clear idea what should be here.

Tasks

  • No clear idea what should be here.

Reference

  • Link to the Sheepdog site
  • Link to Virsh Command Reference pages

Accessing guest images (using Guestfish?)

General concepts

  • Ask Richard Jones

Tasks

  • Ask Richard Jones

Reference

  • Ask Richard Jones

Miscellaneous

Configuring persistent device names
Creating a virtual floppy controller