https://github.com/google/paramgmt
A parallel SSH-based remote machine management system
https://github.com/google/paramgmt
parallelism python remote-machine ssh
Last synced: 5 months ago
JSON representation
A parallel SSH-based remote machine management system
- Host: GitHub
- URL: https://github.com/google/paramgmt
- Owner: google
- License: apache-2.0
- Archived: true
- Created: 2014-08-13T17:42:32.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2016-01-25T06:31:18.000Z (over 9 years ago)
- Last Synced: 2025-04-19T22:27:32.194Z (6 months ago)
- Topics: parallelism, python, remote-machine, ssh
- Language: Python
- Homepage:
- Size: 43 KB
- Stars: 85
- Watchers: 14
- Forks: 29
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING
- License: LICENSE
Awesome Lists containing this project
README
# ParaMgmt - Parallel Management
## Disclaimer
This is not an official Google product. This project was created by
[Nic McDonald](https://www.github.com/nicmcd) at Google.
## Summary
ParaMgmt is a python package designed to ease the burden of interacting with
many remote machines via SSH. The primary focus is on parallelism, good error
handling, automatic connection retries, and nice viewable output. The abilities
of ParaMgmt include running local commands, running remote commands,
transferring files to and from remote machines, and executing local scripts on
remote machines. This package includes command-line executables that wrap the
functionality provided by the Python package.
## Install
ParaMgmt is compatible with both Python2.7+ and Python3.x. I personally
recommend Python3, so the following installation example will be for that. If
you insist on using Python2, substitute `pip3` with `pip2` and `python3` with
`python2`. If you want ParaMgmt installed in both, install it in Python2 then in
Python3. The command-line executables will then use the latter. The installer
requires the `setuptools` package.
Both installations methods below will install a Python package called `paramgmt`
as well as 6 command-line executables: `rhosts`, `lcmd`, `rcmd`, `rpush`, `rpull`, and
`rscript`.
### Python package manager (PIP)
Install globally:
```bash
sudo pip3 install git+https://github.com/google/paramgmt.git
```
Install locally:
```bash
pip3 install --user git+https://github.com/google/paramgmt.git
```
### Source installation
Install globally:
```bash
sudo python3 setup.py install
```
Install locally:
```bash
python3 setup.py install --user
```
## Uninstall
The following command will uninstall the paramgmt Python package and the
command-line executables.
```bash
sudo pip3 uninstall paramgmt
```
## Test
Create a hosts file
```bash
cat<> hosts.txt
tux.penguin.com
myserver
192.168.200.2
EOF
```
This command tests the `paramgmt` Python package.
```bash
python3 -m paramgmt -f hosts.txt -r 3
```
This command tests the command-line executables.
```bash
test/test.sh hosts.txt 3
```
## Usage
Tutorial here: https://nicisdigital.wordpress.com/2015/06/23/paramgmt-interacting-with-thousands-of-servers-over-ssh-part-1/