1
1
<appendix id="ap-install">
2
2
<title>Installation</title>
3
3
<section id="s-install-stack">
4
<title>Choosing a Cluster Stack</title>
4
<title>Choosing a <indexterm significance="preferred"><primary>Cluster Stack</primary><secondary>choosing one</secondary></indexterm>Cluster Stack</title>
5
5
<para>Ultimately the choice of cluster stack is a personal decision that must be made in the context of you or your company's needs and strategic direction. Pacemaker currently functions equally well with both stacks.</para>
6
<para>Here are some factors that may influence the decision</para>
6
<para>Here are some factors that may influence the decision:
7
<itemizedlist spacing="compact">
9
9
<para>SUSE/Novell, Red Hat and Oracle are all putting their collective weight behind the Corosync cluster stack.</para>
12
<para>Corosync is an OSI Certified implementation of an industry standard (the Service Availability Forum Application Interface Specification).</para>
12
<para><indexterm significance="preferred"><primary>Cluster Stack</primary><secondary>Corosync</secondary></indexterm>
13
<indexterm significance="preferred"><primary>Corosync</primary></indexterm>Corosync is an OSI Certified implementation of an industry standard (the Service Availability Forum Application Interface Specification).</para>
15
<para>Using Corosync gives your applications access to the following additional cluster services</para>
16
<para>Using Corosync gives your applications access to the following additional cluster services
17
<itemizedlist spacing="compact">
21
22
distributed locking service
24
extended virtual synchrony service
25
extended virtual synchronization service
27
28
cluster closed process group service
30
</itemizedlist></para>
32
33
<para>It is likely that Pacemaker, at some point in the future, will make use of some of these additional services not provided by Heartbeat</para>
35
<para>To date, Pacemaker has received less real-world testing on Corosync than it has on Heartbeat.</para>
36
<para>To date, Pacemaker has received less real-world testing on Corosync than it has on
37
<indexterm significance="preferred"><primary>Cluster Stack</primary><secondary>Heartbeat</secondary></indexterm>
38
<indexterm significance="preferred"><primary>Heartbeat</primary></indexterm>Heartbeat.</para>
40
</itemizedlist></para>
39
42
<section id="s-install-enable">
40
43
<title>Enabling Pacemaker</title>
41
44
<section id="s-install-enable-ais">
42
45
<title>For Corosync</title>
43
<para>The Corosync configuration is normally located in <filename>/etc/corosync/corosync.conf</filename> and an example for a machine with an address of 1.2.3.4 in a cluster communicating on port 1234 (without peer authentication and message encryption) is shown below.</para>
46
<para>The Corosync configuration is normally located in <filename>/etc/corosync/corosync.conf</filename> and an example for a machine with an address of <literal>1.2.3.4</literal> in a cluster communicating on port 1234 (without peer authentication and message encryption) is shown below.</para>
45
48
<title>An example Corosync configuration file</title>
49
<programlisting>totem {
68
70
<para>The logging should be mostly obvious and the amf section refers to the Availability Management Framework and is not covered in this document.</para>
69
<para>The interesting part of the configuration is the totem section. This is where we define the how the node can communicate with the rest of the cluster and what protocol version and options (including encryption<footnote>
71
<para>The interesting part of the configuration is the totem section. This is where we define how the node can communicate with the rest of the cluster and what protocol version and options (including encryption<footnote>
70
72
<para>Please consult the <ulink url="http://www.corosync.org/">Corosync website</ulink> and documentation for details on enabling encryption and peer authentication for the cluster.</para>
71
73
</footnote>) it should use. Beginners are encouraged to use the values shown and modify the interface section based on their network. </para>
72
<para>It is also possible to configure Corosync for an IPv6 based environment. Simply configure bindnetaddr and mcastaddr with their IPv6 equivalents. Eg </para>
74
<para>It is also possible to configure Corosync for an IPv6 based environment. Simply configure <literal>bindnetaddr</literal> and <literal>mcastaddr</literal> with their IPv6 equivalents, eg. </para>
74
76
<title>Example options for an IPv6 environment</title>
76
bindnetaddr: fec0::1:a800:4ff:fe00:20
77
<programlisting>bindnetaddr: fec0::1:a800:4ff:fe00:20
80
81
<para>To tell Corosync to use the Pacemaker cluster manager, add the following fragment to a functional Corosync configuration and restart the cluster.</para>
82
83
<title>Configuration fragment for enabling Pacemaker under Corosync</title>
84
<programlisting>aisexec {
94
<para>The cluster needs to be run as root so that its child processes (the lrmd in particular) have sufficient privileges to perform the actions requested of it. After-all, a cluster manager that can't add an IP address or start apache is of little use.</para>
94
<para>The cluster needs to be run as root so that its child processes (the <literal>lrmd</literal> in particular) have sufficient privileges to perform the actions requested of it. After all, a cluster manager that can't add an IP address or start apache is of little use.</para>
95
95
<para>The second directive is the one that actually instructs the cluster to run Pacemaker.</para>
97
97
<section id="s-install-enable-heartbeat">
98
98
<title>For Heartbeat</title>
99
<para>Add the following to a functional <filename>ha.cf</filename> configuration file and restart Heartbeat</para>
99
<para>Add the following to a functional <filename>ha.cf</filename> configuration file and restart Heartbeat:</para>
101
101
<title>Configuration fragment for enabling Pacemaker under Heartbeat</title>
102
<programlisting>crm respawn
104
103
</programlisting>
added
removed
doc/Pacemaker_Explained/en-US/Ap-Install.xml
