{"id":22758792,"url":"https://github.com/clusterlabs/pcs","last_synced_at":"2025-05-16T00:04:41.904Z","repository":{"id":1766367,"uuid":"2683361","full_name":"ClusterLabs/pcs","owner":"ClusterLabs","description":"Pacemaker command line interface and GUI","archived":false,"fork":false,"pushed_at":"2025-05-07T10:42:16.000Z","size":26742,"stargazers_count":255,"open_issues_count":24,"forks_count":118,"subscribers_count":33,"default_branch":"main","last_synced_at":"2025-05-10T04:38:04.506Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ClusterLabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2011-10-31T20:18:21.000Z","updated_at":"2025-05-07T10:31:46.000Z","dependencies_parsed_at":"2023-07-10T04:02:16.912Z","dependency_job_id":"a034cf9a-31ea-4839-9eab-b16b0da5c3da","html_url":"https://github.com/ClusterLabs/pcs","commit_stats":{"total_commits":4247,"total_committers":41,"mean_commits":"103.58536585365853","dds":0.668236402166235,"last_synced_commit":"a412fba1f4fb0eb78aac7f7b2283b5db73632aaf"},"previous_names":[],"tags_count":196,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClusterLabs%2Fpcs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClusterLabs%2Fpcs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClusterLabs%2Fpcs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClusterLabs%2Fpcs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ClusterLabs","download_url":"https://codeload.github.com/ClusterLabs/pcs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254442854,"owners_count":22071878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-11T08:15:55.081Z","updated_at":"2025-05-16T00:04:41.876Z","avatar_url":"https://github.com/ClusterLabs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PCS - Pacemaker/Corosync Configuration System\n\nPcs is a Corosync and Pacemaker configuration tool. It permits users to easily\nview, modify and create Pacemaker based clusters. Pcs contains pcsd, a pcs\ndaemon, which operates as a remote server for pcs.\n\n## Pcs Branches\n\n* main\n  * This is where pcs-0.12 lives.\n  * Clusters running Pacemaker 3.x on top of Corosync 3.x are supported.\n  * The main development happens here.\n* pcs-0.11\n  * Clusters running Pacemaker 2.1 on top of Corosync 3.x are supported.\n  * This branch is in maintenance mode - bugs are being fixed but only a subset\n    of new features lands here.\n* pcs-0.10\n  * Clusters running Pacemaker 2.0 on top of Corosync 3.x are supported.\n  * Pacemaker 2.1 is supported, if it is compiled with `--enable-compat-2.0`\n    option.\n  * This branch is no longer maintained.\n* pcs-0.9\n  * Clusters running Pacemaker 1.x on top of Corosync 2.x or Corosync 1.x with\n    CMAN are supported.\n  * This branch is no longer maintained.\n\n## Dependencies\n\nThese are the runtime dependencies of pcs and pcsd:\n* python 3.12+\n* python3-cryptography\n* python3-dateutil 2.7.0+\n* python3-lxml\n* python3-pycurl\n* python3-pyparsing 3.0.0+\n* python3-tornado 6.1.0+\n* [dacite](https://github.com/konradhalas/dacite)\n* ruby 3.1.0+\n* killall (package psmisc)\n* corosync 3.x\n* pacemaker 3.x\n\n## Installation from Source\n\nApart from the dependencies listed above, these are also required for\ninstallation:\n\n* python development files (packages python3-devel, python3-setuptools 66.1+,\n  python3-pip, python3-wheel)\n* ruby development files (package ruby-devel)\n* rubygems\n* rubygem bundler (package rubygem-bundler or ruby-bundler or bundler)\n* autoconf, automake\n* pkgconf, pkgconfig(booth), pkgconfig(sbd)\n* pacemaker-libs-devel (or libpacemaker-devel and libpacemaker3-devel)\n* gcc\n* gcc-c++\n* FFI development files (package libffi-devel or libffi-dev)\n* printf (package coreutils)\n* redhat-rpm-config (if you are using Fedora)\n* wget (to download bundled libraries)\n\nDuring the installation, all required rubygems are automatically downloaded and\ncompiled.\n\nWeb UI frontend is no longer part of pcs sources. You can get it at\n[https://github.com/ClusterLabs/pcs-web-ui](https://github.com/ClusterLabs/pcs-web-ui).\nWeb UI frontend can run in two modes, either as a cockpit plugin or as a\nstandalone application served by pcsd. Specify `--enable-webui` flag for\n`./configure` to build pcsd backend support for running the web UI frontend as\na standalone application.\n\nTo install pcs and pcsd run the following in terminal:\n```shell\n./autogen.sh\n./configure\n# alternatively, './configure --enable-local-build' can be used to also download\n# missing dependencies\n# alternatively, './configure --enable-webui' to build support for web UI as\n# a standalone application\nmake\nmake install\n```\n\nIf you are using GNU/Linux with systemd, it is now time to:\n```shell\nsystemctl daemon-reload\n```\n\nStart pcsd and make it start on boot:\n```shell\nsystemctl start pcsd\nsystemctl enable pcsd\n```\n\n## Packages\n\nCurrently this is built into Fedora, RHEL, CentOS and Debian and its\nderivates. It is likely that other Linux distributions also contain pcs\npackages.\n* [Fedora package git repositories](https://src.fedoraproject.org/rpms/pcs)\n* [Current Fedora .spec](https://src.fedoraproject.org/rpms/pcs/blob/rawhide/f/pcs.spec)\n* [Debian-HA project home page](https://wiki.debian.org/Debian-HA)\n\n## Quick Start\n\n* **Authenticate cluster nodes**\n\n  Set the same password for the `hacluster` user on all nodes.\n  ```shell\n  passwd hacluster\n  ```\n\n  To authenticate the nodes, run the following command on one of the nodes\n  (replacing node1, node2, node3 with a list of nodes in your future cluster).\n  Specify all your cluster nodes in the command. Make sure pcsd is running on\n  all nodes.\n  ```shell\n  pcs host auth node1 node2 node3 -u hacluster\n  ```\n\n* **Create a cluster**\n\n  To create a cluster run the following command on one node (replacing\n  cluster\\_name with a name of your cluster and node1, node2, node3 with a list\n  of nodes in the cluster). `--start` and `--enable` will start your cluster\n  and configure the nodes to start the cluster on boot respectively.\n  ```shell\n  pcs cluster setup cluster_name node1 node2 node3 --start --enable\n  ```\n\n* **Check the cluster status**\n\n   After a few moments the cluster should startup and you can get the status of\n   the cluster.\n   ```shell\n   pcs status\n   ```\n\n* **Add cluster resources**\n\n   After this you can add stonith agents and resources:\n   ```shell\n   pcs stonith create --help\n   ```\n   and\n   ```shell\n   pcs resource create --help\n   ```\n\n## Further Documentation\n\n[ClusterLabs website](https://clusterlabs.org) is an excellent place to learn\nmore about Pacemaker clusters.\n* [ClusterLabs quick start](https://clusterlabs.org/quickstart.html)\n* [Clusters from Scratch](https://clusterlabs.org/pacemaker/doc/2.1/Clusters_from_Scratch/html/)\n* [ClusterLabs documentation page](https://clusterlabs.org/pacemaker/doc/)\n\n## Inquiries\nIf you have any bug reports or feature requests please feel free to open a\ngithub issue on the pcs project.\n\nAlternatively you can use ClusterLabs\n[users mailinglist](https://lists.clusterlabs.org/mailman/listinfo/users)\nwhich is also a great place to ask Pacemaker clusters related questions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclusterlabs%2Fpcs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclusterlabs%2Fpcs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclusterlabs%2Fpcs/lists"}