crc-shinigami


Namecrc-shinigami JSON
Version 0.6.1 PyPI version JSON
download
home_pagehttps://github.com/pitt-crc/shinigami
SummaryA stand alone Python application for killing errant processes on Slurm based compute nodes.
upload_time2024-10-01 14:12:08
maintainerNone
docs_urlNone
authorPitt Center for Research Computing
requires_python<4.0.0,>=3.9.0
licenseNone
keywords process terminate slurm
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Shinigami
[![](https://app.codacy.com/project/badge/Grade/d5325904cffc4936b24dd6be0d58a1ee)](https://app.codacy.com/gh/pitt-crc/shinigami/dashboard)
[![](https://app.codacy.com/project/badge/Coverage/d5325904cffc4936b24dd6be0d58a1ee)](https://app.codacy.com/gh/pitt-crc/shinigami/dashboard)

Shinigami is a stand alone Python application for killing errant processes on Slurm based compute nodes.
The application scans for and terminates any running processes not associated with a currently running Slurm job.
Processes associated with whitelisted users (root, administrators, service accounts, etc.) are ignored.

## Installation and Setup

The `shinigami` command line utility is installable via the pip (or pipx) package manager:

```bash
pipx install shinigami
```

To be of maximal use, it is recommended to run the utility every half hour.
However, you may find a different cadence more appropriate depending on your cluster size and use case.
Running the utility automatically is accomplished via a simple cron job:

```cron
0,30 * * * * shinigami
```

You may wish to configure the cron job to run under a dedicated service account.
When doing so, ensure the user is added to the admin list and satisfies the following criteria:

- Exists on all compute nodes
- Has appropriate permissions to terminate system processes on compute nodes
- Has established SSH keys for connecting to compute nodes


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pitt-crc/shinigami",
    "name": "crc-shinigami",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0.0,>=3.9.0",
    "maintainer_email": null,
    "keywords": "process, terminate, slurm",
    "author": "Pitt Center for Research Computing",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/29/f2/0de8621161435279575791eb8bd6cc001eeb1a56ef612ff7131cde43ce46/crc_shinigami-0.6.1.tar.gz",
    "platform": null,
    "description": "# Shinigami\n[![](https://app.codacy.com/project/badge/Grade/d5325904cffc4936b24dd6be0d58a1ee)](https://app.codacy.com/gh/pitt-crc/shinigami/dashboard)\n[![](https://app.codacy.com/project/badge/Coverage/d5325904cffc4936b24dd6be0d58a1ee)](https://app.codacy.com/gh/pitt-crc/shinigami/dashboard)\n\nShinigami is a stand alone Python application for killing errant processes on Slurm based compute nodes.\nThe application scans for and terminates any running processes not associated with a currently running Slurm job.\nProcesses associated with whitelisted users (root, administrators, service accounts, etc.) are ignored.\n\n## Installation and Setup\n\nThe `shinigami` command line utility is installable via the pip (or pipx) package manager:\n\n```bash\npipx install shinigami\n```\n\nTo be of maximal use, it is recommended to run the utility every half hour.\nHowever, you may find a different cadence more appropriate depending on your cluster size and use case.\nRunning the utility automatically is accomplished via a simple cron job:\n\n```cron\n0,30 * * * * shinigami\n```\n\nYou may wish to configure the cron job to run under a dedicated service account.\nWhen doing so, ensure the user is added to the admin list and satisfies the following criteria:\n\n- Exists on all compute nodes\n- Has appropriate permissions to terminate system processes on compute nodes\n- Has established SSH keys for connecting to compute nodes\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A stand alone Python application for killing errant processes on Slurm based compute nodes.",
    "version": "0.6.1",
    "project_urls": {
        "Homepage": "https://github.com/pitt-crc/shinigami",
        "Repository": "https://github.com/pitt-crc/shinigami"
    },
    "split_keywords": [
        "process",
        " terminate",
        " slurm"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c95be684d9fca7159419c2bbb1d3b0c11cdfb56617b8b26edd10b50a7227968d",
                "md5": "acc2760c4f2b297f08648c9b5c32f1e8",
                "sha256": "4243a04fcb9195645b44000e1baaf2f327f5d23cc8eda517aef1007ffa02969a"
            },
            "downloads": -1,
            "filename": "crc_shinigami-0.6.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "acc2760c4f2b297f08648c9b5c32f1e8",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0.0,>=3.9.0",
            "size": 19953,
            "upload_time": "2024-10-01T14:12:06",
            "upload_time_iso_8601": "2024-10-01T14:12:06.973586Z",
            "url": "https://files.pythonhosted.org/packages/c9/5b/e684d9fca7159419c2bbb1d3b0c11cdfb56617b8b26edd10b50a7227968d/crc_shinigami-0.6.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "29f20de8621161435279575791eb8bd6cc001eeb1a56ef612ff7131cde43ce46",
                "md5": "c592ef3b149754ab727ac45e006b7dab",
                "sha256": "160e55a8dfc401ad43da563138737ed821bbf4897f4b80d926c45b924d2edb16"
            },
            "downloads": -1,
            "filename": "crc_shinigami-0.6.1.tar.gz",
            "has_sig": false,
            "md5_digest": "c592ef3b149754ab727ac45e006b7dab",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0.0,>=3.9.0",
            "size": 18497,
            "upload_time": "2024-10-01T14:12:08",
            "upload_time_iso_8601": "2024-10-01T14:12:08.002027Z",
            "url": "https://files.pythonhosted.org/packages/29/f2/0de8621161435279575791eb8bd6cc001eeb1a56ef612ff7131cde43ce46/crc_shinigami-0.6.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-01 14:12:08",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pitt-crc",
    "github_project": "shinigami",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "crc-shinigami"
}
        
Elapsed time: 0.72980s