ClusterShell is an event-driven open source Python framework, designed to run
local or distant commands in parallel on server farms or on large Linux
clusters. It will take care of common issues encountered on HPC clusters, such
as operating on groups of nodes, running distributed commands using optimized
execution algorithms, as well as gathering results and merging identical
outputs, or retrieving return codes. ClusterShell takes advantage of existing
remote shell facilities already installed on your systems, like SSH.
User tools
----------
ClusterShell provides clush, clubak and cluset/nodeset, convenient command-line
tools that allow traditional shell scripts to benefit from some of the
library's features:
- **clush**: issue commands to cluster nodes and format output
Example of use:
::
$ clush -abL uname -r
node[32-49,51-71,80,82-150,156-159]: 2.6.18-164.11.1.el5
node[3-7,72-79]: 2.6.18-164.11.1.el5_lustre1.10.0.36
node[2,151-155]: 2.6.31.6-145.fc11.2.x86_64
See *man clush* for more details.
- **clubak**: improved dshbak to gather and sort dsh-like outputs
See *man clubak* for more details.
- **nodeset** (or **cluset**): compute advanced nodeset/nodegroup operations
Examples of use:
::
$ echo node160 node161 node162 node163 | nodeset -f
node[160-163]
$ nodeset -f node[0-7,32-159] node[160-163]
node[0-7,32-163]
$ nodeset -e node[160-163]
node160 node161 node162 node163
$ nodeset -f node[32-159] -x node33
node[32,34-159]
$ nodeset -f node[32-159] -i node[0-7,20-21,32,156-159]
node[32,156-159]
$ nodeset -f node[33-159] --xor node[32-33,156-159]
node[32,34-155]
$ nodeset -l
@oss
@mds
@io
@compute
$ nodeset -e @mds
node6 node7
See *man nodeset* (or *man cluset*) for more details.
Please visit the ClusterShell website_.
.. _website: http://cea-hpc.github.io/clustershell/
Raw data
{
"_id": null,
"home_page": "https://clustershell.readthedocs.io/",
"name": "ClusterShell",
"maintainer": "",
"docs_url": "https://pythonhosted.org/ClusterShell/",
"requires_python": "",
"maintainer_email": "",
"keywords": "clustershell,clush,clubak,nodeset",
"author": "Stephane Thiell",
"author_email": "sthiell@stanford.edu",
"download_url": "https://files.pythonhosted.org/packages/48/8c/c8eee7aa92fac6605e3ad81a70c0d00a54787bc32736ce10748c0b8e3467/ClusterShell-1.9.1.tar.gz",
"platform": "GNU/Linux",
"description": "ClusterShell is an event-driven open source Python framework, designed to run\nlocal or distant commands in parallel on server farms or on large Linux\nclusters. It will take care of common issues encountered on HPC clusters, such\nas operating on groups of nodes, running distributed commands using optimized\nexecution algorithms, as well as gathering results and merging identical\noutputs, or retrieving return codes. ClusterShell takes advantage of existing\nremote shell facilities already installed on your systems, like SSH.\n\nUser tools\n----------\n\nClusterShell provides clush, clubak and cluset/nodeset, convenient command-line\ntools that allow traditional shell scripts to benefit from some of the\nlibrary's features:\n\n- **clush**: issue commands to cluster nodes and format output\n\nExample of use:\n\n::\n\n $ clush -abL uname -r\n node[32-49,51-71,80,82-150,156-159]: 2.6.18-164.11.1.el5\n node[3-7,72-79]: 2.6.18-164.11.1.el5_lustre1.10.0.36\n node[2,151-155]: 2.6.31.6-145.fc11.2.x86_64\n\nSee *man clush* for more details.\n\n- **clubak**: improved dshbak to gather and sort dsh-like outputs\n\nSee *man clubak* for more details.\n\n- **nodeset** (or **cluset**): compute advanced nodeset/nodegroup operations\n\nExamples of use:\n\n::\n\n $ echo node160 node161 node162 node163 | nodeset -f\n node[160-163]\n\n $ nodeset -f node[0-7,32-159] node[160-163]\n node[0-7,32-163]\n\n $ nodeset -e node[160-163]\n node160 node161 node162 node163\n\n $ nodeset -f node[32-159] -x node33\n node[32,34-159]\n\n $ nodeset -f node[32-159] -i node[0-7,20-21,32,156-159]\n node[32,156-159]\n\n $ nodeset -f node[33-159] --xor node[32-33,156-159]\n node[32,34-155]\n\n $ nodeset -l\n @oss\n @mds\n @io\n @compute\n\n $ nodeset -e @mds\n node6 node7\n\nSee *man nodeset* (or *man cluset*) for more details.\n\nPlease visit the ClusterShell website_.\n\n.. _website: http://cea-hpc.github.io/clustershell/",
"bugtrack_url": null,
"license": "LGPLv2+",
"summary": "ClusterShell library and tools",
"version": "1.9.1",
"split_keywords": [
"clustershell",
"clush",
"clubak",
"nodeset"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "488cc8eee7aa92fac6605e3ad81a70c0d00a54787bc32736ce10748c0b8e3467",
"md5": "549e645845a0910990c53d49bbc6d4fe",
"sha256": "6f0ab3ca141b508da03ce19bd52f1e5e8d29773fc3062d7bf36450a82207ec1b"
},
"downloads": -1,
"filename": "ClusterShell-1.9.1.tar.gz",
"has_sig": false,
"md5_digest": "549e645845a0910990c53d49bbc6d4fe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 401296,
"upload_time": "2023-02-10T22:31:13",
"upload_time_iso_8601": "2023-02-10T22:31:13.697358Z",
"url": "https://files.pythonhosted.org/packages/48/8c/c8eee7aa92fac6605e3ad81a70c0d00a54787bc32736ce10748c0b8e3467/ClusterShell-1.9.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-10 22:31:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "clustershell"
}