61c744c2c5
After the technical review the Shared File Systems service documentation in the Cloud Admin Guide needs to be updated. Read and fixed some typos and incorrect English constructions in the sentences of all sections. Fixed indentations in code, tip and note directives. Also updated the following info: * Removed references to the Generic driver, because it is default only on Devstack. And even for Devstack the default driver is going to be changed. * Divided 'Create share' subsection on 3 subsections: added general concepts and info of creating a share in 2 back end modes. * Added info that with StandaloneNetworkPlugin the Shared File Systems service can be configured without Networking and Compute services. * Added export paths for GlusterFS and HDFS. * Added notes what driver in what mode you use in examples and a noted what modes exist and can be configured. * Added a console sample for "manila rate-limits" command and described how to add API rate limits. * Removed information and samples about a quota classes because they are not used in the Shared File Systems service and are not working properly for the current moment (in Liberty release). * Added second purpose of the share types. * Removed '/etc/manila/' in manila.conf file, because its path can be customly changed. * Said that consistency groups is the experimental part of API starting with Liberty release. * Updated a sample in shared_file_systems_multi_backend.html file. * Removed 'Storage' from the Shared File Systems service official name according to [1] document. [1] http://git.openstack.org/cgit/openstack/governance/tree/reference/projects.yaml Change-Id: I0530ea3c6bf74311e271cdabca26cd10afcddc92 Closes-Bug: #1508457
4.0 KiB
Key concepts
Share
In the Shared File Systems service share is the
fundamental resource unit allocated by the Shared File System service.
It represents an allocation of a persistent, readable, and writable
filesystem that can be accessed by OpenStack compute instances, or
clients outside of OpenStack, which depends on deployment
configuration.
Note
A share is an abstract storage object that may or may
not directly map to a "share" concept from the underlying storage
provider.
Snapshot
A snapshot is a point-in-time, read-only copy of a
share. Snapshots can be created from an
existing share that is operational regardless of whether a
client has mounted the file system. A snapshot can serve as
the content source for a new share when the
share is created with the create from snapshot option
specified.
Storage Pools
With the Kilo release of OpenStack, the Shared File Systems service
has introduced the concept of storage pools. The storage
may present one or more logical storage resource pools from which the
Shared File Systems service will select as a storage location when
provisioning shares.
Share Type
Share type is an abstract collection of criteria used to
characterize shares. They are most commonly used to create
a hierarchy of functional capabilities that represent a tiered level of
storage services; for example, a cloud administrator might define a
premium share type that indicates a greater level of
performance than a basic share type, which would represent
a best-effort level of performance.
Share Access Rules
Share access rules define which users can access a
particular share. For example, access rules can be declared
for NFS shares by listing the valid IP networks, in CIDR notation, which
should have access to the share.
Security Services
Security services are the concept in the Shared File
Systems service that allow Finer-grained client access rules to be
declared for authentication or authorization to access
share content. External services including LDAP, Active
Directory, Kerberos can be declared as resources that should be
consulted when making an access decision to a particular
share. Shares can be associated to multiple
security services but only one service per one type.
Share Networks
A share network is an object that defines a relationship
between a tenant's network and subnet, as defined in an OpenStack
Networking service or Compute service, and the shares
created by the same tenant; that is, a tenant may find it desirable to
provision shares such that only instances connected to a
particular OpenStack-defined network have access to the
share. Also, security services can be attached
to share networks, because most of auth protocols require
some interaction with network services.
The Shared File Systems service has the ability to work outside of
OpenStack. That is due to the StandaloneNetworkPlugin that
can be used with any network platform and does not require some specific
network services in OpenStack like Compute or Networking service. You
can set the network parameters in its configuration file.
Share Servers
A share server is a logical entity that hosts the shares
that are created on a specific share network. A
share server may be a configuration object within the
storage controller, or it may represent logical resources provisioned
within an OpenStack deployment that are used to support the data path
used to access shares.
Share servers interact with network services to
determine the appropriate IP addresses on which to export
shares according to the related share network.
The Shared File Systems service has a pluggable network model that
allows share servers to work with different implementations
of Network service.