openstack-manuals/doc/common/section_cli_cinder_read-only-volumes.xml
Thang Pham 4a12ecb41f Fix cinder option to set a volume to read-only access
Under the "Manage volume" section of the OpenStack End User Guide,
it says to use "cinder read-only-mode-update VOLUME BOOLEAN" to
set the volume to read-only. The option "read-only-mode-update" is
incorrect. It should be "readonly-mode-update". This patch corrects
the option used.

Change-Id: I863272f98a3289c6bab877a618c8f6e898800bd3
Closes-Bug: #1311283
2014-04-23 19:21:33 +02:00

33 lines
1.5 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!ENTITY nbsp "&#160;">
]>
<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 this 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>Where <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>Valid values for <replaceable>BOOLEAN</replaceable>
are:</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>