openstack/openstack-manuals
Code Issues Proposed changes

Install guide fixes for ceilometer

Browse Source 
* install the alarming services on debian/ubuntu (needs checking for
  rhel/centos/fedora)
* use the correct section for the metering_secret option
* the cinder installation suggests two nodes, reflect this in the cinder
  config for ceilometer

Change-Id: I5fa4b1ee993f2d5cbb90724d3855a55ecd339ea3
This commit is contained in:
Gauvain Pocentek 2014-04-05 12:18:48 +02:00
parent c071ab483c
commit b4142ff9b8
4 changed files with 31 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/install-guide/section_ceilometer-cinder.xml
View File

@ -11,22 +11,28 @@
Storage service to send notifications to the bus.</para> Storage service to send notifications to the bus.</para>
<para os="debian;ubuntu">Edit <filename>/etc/cinder/cinder.conf</filename> <para os="debian;ubuntu">Edit <filename>/etc/cinder/cinder.conf</filename>
and add in the <literal>[DEFAULT]</literal> section:</para> and add in the <literal>[DEFAULT]</literal> section on the controller
and volume nodes:</para>
<programlisting language="ini" os="debian;ubuntu">control_exchange = cinder <programlisting language="ini" os="debian;ubuntu">control_exchange = cinder
notification_driver = cinder.openstack.common.notifier.rpc_notifier</programlisting> notification_driver = cinder.openstack.common.notifier.rpc_notifier</programlisting>
<para os="opensuse;sles;fedora;rhel;centos">Run the following commands:</para> <para os="opensuse;sles;fedora;rhel;centos">Run the following commands on
<screen os="opensuse;sles;fedora;rhel;centos"><prompt>#</prompt> <userinput>openstack-config --set /etc/cinder/cinder.conf DEFAULT control_exchange cinder</userinput> the controller and volume nodes:</para>
<screen os="opensuse;sles;fedora;rhel;centos"><prompt>#</prompt> <userinput>openstack-config --set /etc/cinder/cinder.conf DEFAULT control_exchange cinder</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/cinder/cinder.conf DEFAULT notification_driver cinder.openstack.common.notifier.rpc_notifier</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/cinder/cinder.conf DEFAULT notification_driver cinder.openstack.common.notifier.rpc_notifier</userinput></screen>
</step> </step>
<step> <step>
<para>Restart the Block Storage services with their new <para>Restart the Block Storage services with their new
settings:</para> settings.</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-volume restart</userinput> <para>On the controller node:</para>
<prompt>#</prompt> <userinput>service cinder-api restart</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-api restart</userinput>
<prompt>#</prompt> <userinput>service cinder-scheduler restart</userinput></screen>
<screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput> <screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-api restart</userinput>
<prompt>#</prompt> <userinput>service openstack-cinder-volume restart</userinput></screen> <prompt>#</prompt> <userinput>service openstack-cinder-scheduler restart</userinput></screen>
<para>On the volume node:</para>
<screen os="rhel;fedora;centos;sles;opensuse"><prompt>#</prompt> <userinput>service openstack-cinder-volume restart</userinput></screen>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service cinder-volume restart</userinput></screen>
</step> </step>
</procedure> </procedure>
</section> </section>

4
doc/install-guide/section_ceilometer-glance.xml
View File

@ -28,8 +28,8 @@ rabbit_password = <replaceable>RABBIT_PASS</replaceable></programlisting>
</step> </step>
<step> <step>
<para>Restart the Image Services with their new <para>Restart the Image Services with their new
settings:</para> settings:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service glance-registry restart</userinput> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service glance-registry restart</userinput>
<prompt>#</prompt> <userinput>service glance-api restart</userinput></screen> <prompt>#</prompt> <userinput>service glance-api restart</userinput></screen>
<screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-glance-api restart</userinput> <screen os="rhel;fedora;centos;opensuse;sles"><prompt>#</prompt> <userinput>service openstack-glance-api restart</userinput>

20
doc/install-guide/section_ceilometer-install.xml
View File

@ -17,7 +17,8 @@
<step> <step>
<para>Install the Telemetry service on the controller <para>Install the Telemetry service on the controller
node:</para> node:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ceilometer-api ceilometer-collector ceilometer-agent-central python-ceilometerclient</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install ceilometer-api ceilometer-collector ceilometer-agent-central \
ceilometer-alarm-evaluator ceilometer-alarm-notifier python-ceilometerclient</userinput></screen>
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-api openstack-ceilometer-collector openstack-ceilometer-central python-ceilometerclient</userinput></screen> <screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install openstack-ceilometer-api openstack-ceilometer-collector openstack-ceilometer-central python-ceilometerclient</userinput></screen>
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-api openstack-ceilometer-collector \ <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-ceilometer-api openstack-ceilometer-collector \
openstack-ceilometer-agent-central python-ceilometerclient \ openstack-ceilometer-agent-central python-ceilometerclient \
@ -59,9 +60,7 @@
take effect: take effect:
</para> </para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service mongodb stop</userinput> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service mongodb stop</userinput>
<prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/j._0</userinput> <prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/prealloc.*</userinput>
<prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/prealloc.1</userinput>
<prompt>#</prompt> <userinput>rm /var/lib/mongodb/journal/prealloc,2</userinput>
<prompt>#</prompt> <userinput>service mongodb start</userinput></screen> <prompt>#</prompt> <userinput>service mongodb start</userinput></screen>
<para> <para>
For more information on the <option>smallfiles</option> For more information on the <option>smallfiles</option>
@ -124,17 +123,17 @@ connection = mongodb://ceilometer:<replaceable>CEILOMETER_DBPASS</replaceable>@<
store it in the configuration file:</para> store it in the configuration file:</para>
<screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>CEILOMETER_TOKEN=$(openssl rand -hex 10)</userinput> <screen os="rhel;centos;fedora;opensuse;sles"><prompt>#</prompt> <userinput>CEILOMETER_TOKEN=$(openssl rand -hex 10)</userinput>
<prompt>#</prompt> <userinput>echo $CEILOMETER_TOKEN</userinput> <prompt>#</prompt> <userinput>echo $CEILOMETER_TOKEN</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf publisher_rpc metering_secret $CEILOMETER_TOKEN</userinput></screen> <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf publisher metering_secret $CEILOMETER_TOKEN</userinput></screen>
<para os="sles;opensuse">For SUSE Linux Enterprise, run the <para os="sles;opensuse">For SUSE Linux Enterprise, run the
following command:</para> following command:</para>
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>CEILOMETER_TOKEN=$(openssl rand 10|hexdump -e '1/1 "%.2x"')</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>CEILOMETER_TOKEN=$(openssl rand 10|hexdump -e '1/1 "%.2x"')</userinput></screen>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>openssl rand -hex 10</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>openssl rand -hex 10</userinput></screen>
<para os="ubuntu;debian">Edit the <para os="ubuntu;debian">Edit the
<filename>/etc/ceilometer/ceilometer.conf</filename> file <filename>/etc/ceilometer/ceilometer.conf</filename> file
and change the <literal>[publisher_rpc]</literal> section. Replace and change the <literal>[publisher]</literal> section. Replace
<replaceable>CEILOMETER_TOKEN</replaceable> with the results of <replaceable>CEILOMETER_TOKEN</replaceable> with the results of
the <literal>openssl</literal> command:</para> the <literal>openssl</literal> command:</para>
<programlisting os="ubuntu;debian" language="ini">[publisher_rpc] <programlisting os="ubuntu;debian" language="ini">[publisher]
# Secret value for signing metering messages (string value) # Secret value for signing metering messages (string value)
metering_secret = <replaceable>CEILOMETER_TOKEN</replaceable></programlisting> metering_secret = <replaceable>CEILOMETER_TOKEN</replaceable></programlisting>
</step> </step>
@ -185,6 +184,8 @@ log_dir = /var/log/ceilometer</programlisting>
keystone_authtoken auth_uri http://<replaceable>controller</replaceable>:5000</userinput> keystone_authtoken auth_uri http://<replaceable>controller</replaceable>:5000</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \ <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \
keystone_authtoken admin_password <replaceable>CEILOMETER_PASS</replaceable></userinput> keystone_authtoken admin_password <replaceable>CEILOMETER_PASS</replaceable></userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \
service_credentials os_auth_url http://<replaceable>controller</replaceable>:5000/v2.0</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \ <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \
service_credentials os_username ceilometer</userinput> service_credentials os_username ceilometer</userinput>
<prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \ <prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf \
@ -206,6 +207,7 @@ admin_password = <replaceable>CEILOMETER_PASS</replaceable></programlisting>
<para os="ubuntu;debian">Also set the <para os="ubuntu;debian">Also set the
<literal>[service_credentials]</literal> section:</para> <literal>[service_credentials]</literal> section:</para>
<programlisting os="ubuntu;debian" language="ini">[service_credentials] <programlisting os="ubuntu;debian" language="ini">[service_credentials]
os_auth_url = http://<replaceable>controller</replaceable>:5000/v2.0
os_username = ceilometer os_username = ceilometer
os_tenant_name = service os_tenant_name = service
os_password = <replaceable>CEILOMETER_PASS</replaceable></programlisting> os_password = <replaceable>CEILOMETER_PASS</replaceable></programlisting>
@ -227,7 +229,9 @@ os_password = <replaceable>CEILOMETER_PASS</replaceable></programlisting>
<para>Restart the services with their new settings:</para> <para>Restart the services with their new settings:</para>
<screen><prompt>#</prompt> <userinput>service ceilometer-agent-central restart</userinput> <screen><prompt>#</prompt> <userinput>service ceilometer-agent-central restart</userinput>
<prompt>#</prompt> <userinput>service ceilometer-api restart</userinput> <prompt>#</prompt> <userinput>service ceilometer-api restart</userinput>
<prompt>#</prompt> <userinput>service ceilometer-collector restart</userinput></screen> <prompt>#</prompt> <userinput>service ceilometer-collector restart</userinput>
<prompt>#</prompt> <userinput>service ceilometer-alarm-evaluator restart</userinput>
<prompt>#</prompt> <userinput>service ceilometer-alarm-notifier restart</userinput></screen>
</step> </step>
<step os="rhel;fedora;centos;opensuse;sles"> <step os="rhel;fedora;centos;opensuse;sles">
<para>Start the <systemitem class="service" <para>Start the <systemitem class="service"

7
doc/install-guide/section_ceilometer-nova.xml
View File

@ -58,13 +58,14 @@ notification_driver = ceilometer.compute.nova_notifier</programlisting>
<para>You must set the secret key that you defined previously. <para>You must set the secret key that you defined previously.
The Telemetry service nodes share this key as a shared The Telemetry service nodes share this key as a shared
secret:</para> secret:</para>
<screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf publisher_rpc metering_secret $CEILOMETER_TOKEN</userinput></screen> <screen os="fedora;rhel;centos;opensuse;sles"><prompt>#</prompt> <userinput>openstack-config --set /etc/ceilometer/ceilometer.conf publisher \
metering_secret <replaceable>CEILOMETER_TOKEN</replaceable></userinput></screen>
<para os="ubuntu;debian">Edit the <para os="ubuntu;debian">Edit the
<filename>/etc/ceilometer/ceilometer.conf</filename> file <filename>/etc/ceilometer/ceilometer.conf</filename> file
and change these lines in the <literal>[DEFAULT]</literal> and change these lines in the <literal>[publisher]</literal>
section. Replace <replaceable>CEILOMETER_TOKEN</replaceable> with section. Replace <replaceable>CEILOMETER_TOKEN</replaceable> with
the ceilometer token that you created previously:</para> the ceilometer token that you created previously:</para>
<programlisting os="ubuntu;debian" language="ini">[publisher_rpc] <programlisting os="ubuntu;debian" language="ini">[publisher]
# Secret value for signing metering messages (string value) # Secret value for signing metering messages (string value)
metering_secret = <replaceable>CEILOMETER_TOKEN</replaceable></programlisting> metering_secret = <replaceable>CEILOMETER_TOKEN</replaceable></programlisting>
</step> </step>