openstack-manuals/doc/common/section_cli_cinder_read-only-volumes.xml
Christian Berendt b2235bf3fb Unified the syntax of the XML root element (common)
Execluded all XML files in the directory doc/common/tables because
they are autogenerated.

The XML root element of Docbook XML files should match the following
format:

<ELEMENT xmlns="http://docbook.org/ns/docbook"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:xlink="http://www.w3.org/1999/xlink"
  version="5.0"
  xml:id="THE_XML_ID_OF_THE_ELEMENT">

Change-Id: If12091be81ec8b2e6e53bfcb4c3a883a65e24736
2014-07-09 22:23:03 +02:00

31 lines
1.4 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="cli_read-only-volumes">
<title>Set a volume to read-only access</title>
<para>To give multiple users shared, secure access to the same
data, you can set a volume to read-only access.</para>
<para>Run the following command to set a volume to read-only
access:</para>
<screen><prompt>$</prompt> <userinput>cinder readonly-mode-update <replaceable>VOLUME</replaceable> <replaceable>BOOLEAN</replaceable></userinput></screen>
<para><replaceable>VOLUME</replaceable> is the ID of the target
volume and <replaceable>BOOLEAN</replaceable> is a flag that
enables read-only or read/write access to the volume.</para>
<para>The following values for <replaceable>BOOLEAN</replaceable>
are valid:</para>
<itemizedlist>
<listitem>
<para><literal>true</literal>. Sets the read-only flag in
the volume. When you attach the volume to an instance,
the instance checks for this flag to determine whether
to restrict volume access to read-only.</para>
</listitem>
<listitem>
<para><literal>false</literal>. Sets the volume to
read/write access.</para>
</listitem>
</itemizedlist>
</section>