= Documentation =

== Usage ==

* link:crm.8.html[Man page (development version)]
* link:crm.1.2.6.html[Man page (stable version 1.2.6)]
* link:configuration.html[Configuration]
* link:scripts.html[Cluster scripts]
* link:tutorials.html[Guides & Tutorials]
* link:faq.html[FAQ]

The SUSE
https://www.suse.com/documentation/sle_ha/book_sleha/?page=/documentation/sle_ha/book_sleha/data/book_sleha.html[High
Availability Guide] provides a guide to
installing and configuring a complete cluster solution including both
the `crm` shell and Hawk, the web GUI which uses the `crm` shell as
its backend.

For more information on Pacemaker in general, see the
http://clusterlabs.org/doc/[Pacemaker documentation] at `clusterlabs.org`.

On the Pacemaker website, there is a set of guides to configuring
Pacemaker using `crmsh`. To find these guides, go to the documentation
page and search for `crmsh`.

For details on command line usage, see the link:crm.8.html[man page].

== Installation ==

Packages for several popular distributions are hosted at the open
build service. Get the *current stable version* of the `crm` shell
here:

* https://build.opensuse.org/package/show/network:ha-clustering:Stable/crmsh[OBS Project Page]

* http://download.opensuse.org/repositories/network:/ha-clustering:/Stable/[Direct package downloads]

For other distributions, packages may be available in the respective
package repositories.

=== openSUSE

On openSUSE, you will want to add the
http://download.opensuse.org/repositories/network:/ha-clustering:/Stable/[network:ha-clustering:Stable] repository, to get the latest stable version of the `crm` shell:

==== Repository links ====

* http://download.opensuse.org/repositories/network:/ha-clustering:/Stable/openSUSE_12.3/[openSUSE 12.3]
* http://download.opensuse.org/repositories/network:/ha-clustering:/Stable/openSUSE_13.1/[openSUSE 13.1]


.Adding a repository using zypper:
----
zypper ar <repository> network:ha-clustering:Stable
----

Once added, you can run

----
zypper in crmsh
----

=== Fedora 19

Download http://download.opensuse.org/repositories/network:/ha-clustering:/Stable/Fedora_19/network:ha-clustering:Stable.repo[network:ha-clustering:Stable.repo]
and copy it to the '/etc/yum.repos.d/' directory as `root`.

Then, you can run

----
yum install crmsh
----

=== Debian

Packages for Debian are provided by the Debian HA maintainers. For more
information, see the Debian packages list:

- http://packages.debian.org/search?keywords=crmsh

=== Ubuntu

There are packages that are fairly up-to-date in the more recent
versions of Ubuntu:

- https://launchpad.net/ubuntu/+source/crmsh
