openstack-manuals/doc/admin-guide-cloud/blockstorage/section_increase-api-throughput.xml
Christian Berendt d99744c3df Unified the syntax of the XML root element (admin-guide-cloud)
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: I95a6f36d6887af952257a800e3359d53ac1f895a
2014-07-09 19:43:01 +02:00

38 lines
1.9 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="cinder-api-throughput">
<title>Increase Block Storage API service throughput</title>
<para>By default, the Block Storage API service runs in one process.
This limits the number of API requests that the Block Storage
service can process at any given time. In a production
environment, you should increase the Block Storage API throughput
by allowing the Block Storage API service to run in as many
processes as the machine capacity allows.</para>
<note>
<para>The Block Storage API service is named
<literal>openstack-cinder-api</literal> on the following
distributions: CentOS, Fedora, openSUSE, Red Hat Enterprise
Linux, and SUSE Linux Enterprise. In Ubuntu and Debian
distributions, the Block Storage API service is named
<literal>cinder-api</literal>.</para>
</note>
<para>To do so, use the Block Storage API service option
<parameter>osapi_volume_workers</parameter>. This option allows
you to specify the number of API service workers (or OS processes)
to launch for the Block Storage API service.</para>
<para>To configure this option, open the
<filename>/etc/cinder/cinder.conf</filename> configuration file
and set the <literal>osapi_volume_workers</literal> configuration
key to the number of CPU cores/threads on a machine.</para>
<para>On distributions that
include <application>openstack-config</application>, you can
configure this by running the following command instead:</para>
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/cinder/cinder.conf \
DEFAULT osapi_volume_workers <replaceable>CORES</replaceable></userinput></screen>
<para>Replace <replaceable>CORES</replaceable> with the number of CPU
cores/threads on a machine.</para>
</section>