2020-04-26 16:39:10 +08:00
|
|
|
## PCS - Pacemaker/Corosync Configuration System
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
Pcs is a Corosync and Pacemaker configuration tool. It permits users to
|
|
|
|
|
easily view, modify and create Pacemaker based clusters. Pcs contains pcsd, a
|
|
|
|
|
pcs daemon, which operates as a remote server for pcs and provides a web UI.
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
---
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
### Dependencies
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
These are the runtime dependencies of pcs and pcsd:
|
|
|
|
|
* python 3.6+
|
|
|
|
|
* python3-lxml
|
|
|
|
|
* python3-pycurl
|
|
|
|
|
* python3-setuptools
|
|
|
|
|
* python3-pyOpenSSL (python3-openssl)
|
|
|
|
|
* python3-tornado
|
|
|
|
|
* ruby 2.2.0+
|
|
|
|
|
* killall (package psmisc)
|
|
|
|
|
* openssl
|
|
|
|
|
* corosync 3.x
|
|
|
|
|
* pacemaker 2.x
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
It is also recommended to have these:
|
|
|
|
|
* python3-clufter
|
|
|
|
|
* liberation fonts (package liberation-sans-fonts or fonts-liberation or
|
|
|
|
|
fonts-liberation2)
|
|
|
|
|
* overpass fonts (package overpass-fonts)
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
---
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
### Installation from Source
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
Apart from the dependencies listed above, these are also required for
|
|
|
|
|
installation:
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
* python development files (package python3-devel)
|
|
|
|
|
* ruby development files (package ruby-devel)
|
|
|
|
|
* rubygems
|
|
|
|
|
* rubygem bundler (package rubygem-bundler or ruby-bundler or bundler)
|
|
|
|
|
* gcc
|
|
|
|
|
* gcc-c++
|
|
|
|
|
* FFI development files (package libffi-devel or libffi-dev)
|
|
|
|
|
* fontconfig
|
|
|
|
|
* printf (package coreutils)
|
|
|
|
|
* redhat-rpm-config (if you are using Fedora)
|
|
|
|
|
* wget (to download bundled libraries)
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
During the installation, all required rubygems are automatically downloaded and
|
|
|
|
|
compiled.
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
To install pcs and pcsd run the following in terminal:
|
|
|
|
|
```shell
|
|
|
|
|
# tar -xzvf pcs-0.10.1.tar.gz
|
|
|
|
|
# cd pcs-0.10.1
|
|
|
|
|
# make install
|
|
|
|
|
# make install_pcsd
|
|
|
|
|
```
|
2020-04-11 14:44:34 +08:00
|
|
|
|
2020-04-26 16:39:10 +08:00
|
|
|
If you are using GNU/Linux with systemd, it is now time to:
|
|
|
|
|
```shell
|
|
|
|
|
# systemctl daemon-reload
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Start pcsd and make it start on boot:
|
|
|
|
|
```shell
|
|
|
|
|
# systemctl start pcsd
|
|
|
|
|
# systemctl enable pcsd
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### Packages
|
|
|
|
|
|
|
|
|
|
Currently this is built into Fedora, RHEL and its clones and Debian and its
|
|
|
|
|
derivates.
|
|
|
|
|
* [Fedora package git repositories](https://src.fedoraproject.org/rpms/pcs)
|
|
|
|
|
* [Current Kylin git repositories](https://gitee.com/openkylin/pcs)
|
|
|
|
|
* [Debian-HA project home page](https://wiki.debian.org/Debian-HA)
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### Quick Start
|
|
|
|
|
|
|
|
|
|
* **Authenticate cluster nodes**
|
|
|
|
|
|
|
|
|
|
Set the same password for the `hacluster` user on all nodes.
|
|
|
|
|
```shell
|
|
|
|
|
# passwd hacluster
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
To authenticate the nodes, run the following command on one of the nodes
|
|
|
|
|
(replacing node1, node2, node3 with a list of nodes in your future cluster).
|
|
|
|
|
Specify all your cluster nodes in the command. Make sure pcsd is running on
|
|
|
|
|
all nodes.
|
|
|
|
|
```shell
|
|
|
|
|
# pcs host auth node1 node2 node3 -u hacluster
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* **Create a cluster**
|
|
|
|
|
|
|
|
|
|
To create a cluster run the following command on one node (replacing
|
|
|
|
|
cluster\_name with a name of your cluster and node1, node2, node3 with a list
|
|
|
|
|
of nodes in the cluster). `--start` and `--enable` will start your cluster
|
|
|
|
|
and configure the nodes to start the cluster on boot respectively.
|
|
|
|
|
```shell
|
|
|
|
|
# pcs cluster setup cluster_name node1 node2 node3 --start --enable
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* **Check the cluster status**
|
|
|
|
|
|
|
|
|
|
After a few moments the cluster should startup and you can get the status of
|
|
|
|
|
the cluster.
|
|
|
|
|
```shell
|
|
|
|
|
# pcs status
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* **Add cluster resources**
|
|
|
|
|
|
|
|
|
|
After this you can add stonith agents and resources:
|
|
|
|
|
```shell
|
|
|
|
|
# pcs -h stonith create
|
|
|
|
|
```
|
|
|
|
|
and
|
|
|
|
|
```shell
|
|
|
|
|
# pcs -h resource create
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### Accessing the Web UI
|
|
|
|
|
|
|
|
|
|
Apart from command line interface you can use web user interface to view and
|
|
|
|
|
configure your cluster. To access the web UI open a browser to the following
|
|
|
|
|
URL (replace nodename with an address of your node):
|
|
|
|
|
```
|
|
|
|
|
https://nodename:2224
|
|
|
|
|
```
|
|
|
|
|
Login as the `hacluster` user.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### Further Documentation
|
|
|
|
|
|
|
|
|
|
[ClusterLabs website](https://clusterlabs.org) is an excellent place to learn
|
|
|
|
|
more about Pacemaker clusters.
|
|
|
|
|
* [ClusterLabs quick start](https://clusterlabs.org/quickstart.html)
|
|
|
|
|
* [Clusters from Scratch](https://clusterlabs.org/pacemaker/doc/en-US/Pacemaker/2.0/html/Clusters_from_Scratch/index.html)
|
|
|
|
|
* [ClusterLabs documentation page](https://clusterlabs.org/pacemaker/doc/)
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### Inquiries
|
|
|
|
|
If you have any bug reports or feature requests please feel free to open a
|
|
|
|
|
github issue on the pcs project.
|
|
|
|
|
|
|
|
|
|
Alternatively you can use ClusterLabs
|
|
|
|
|
[users mailinglist](https://oss.clusterlabs.org/mailman/listinfo/users)
|
|
|
|
|
which is also a great place to ask Pacemaker clusters related questions.
|
