# Introduction
The p_cmd_runner package was born from the need to run local commands (taken from
local files) on any number of remote nodes accessible via SSH(/AMOS/MOSHELL).
It is written in Python 3, and is based on the Paramiko package.
As of **version 0.1.0**, SSH security key files are supported as an alternative to
password authentication.
See this [tutorial](https://phoenixnap.com/kb/setup-passwordless-ssh) on how to setup your SSH security key files.
In general, you would generate public and private key-pair(s) on your local
machine, then transfer the public key(s) to your remote node(s).
### To install the package:
**python -m pip install p_cmd_runr**
or
**python3 -m pip install --user p_cmd_runr**
### The p_cmd_runr package provides access to:
- an API composed of a ConfigGrabber class, a CmdRunner class, a main function
called boxjumper, and other utility functions.
- the gp_cmd_runr a general purpose command runner script.
Whether you will be implementing your own script with the help of the API, or
running the gp_cmd_runr script, you will have to provide 2 types of files:
- at least one configuration file stating which nodes to access, their login
information, along with references to the files containing the commands to run on
those nodes.
- at least one command file containing the commands you would normally run on the
above node(s).
# The Main API Classes And Functions
The **ConfigGrabber** class creates an iterator type object. You provide it with
the filename of your local configuration file.
```
__init__(self, filename="config.txt", separator="=", comment="#", mvs=",",
delay="0", cmd_timeout="0.5", prompts="$#?<>")
Description:
Initializer of a ConfigGrabber object. Reads a configuration file and makes
available a dictionary of key-value pairs taken from that configuration file.
Parameters:
- Filename specifies the name of the configuration file to process.
- separator defines the character or string used as separator between
key-value pairs.
- comment defines the character or string used for line comments.
- mvs (or multi-value seperator): defines the character or string that
seperates multiple values.
- delay pause time (in seconds) before running the next command.
- cmd_timeout maximum time (in seconds) to wait for a command to finish
executing.
- prompts string of characters representing command line prompts.
Returns:
ConfigGrabber object (which contains the jumpboxes used by the boxjumper
function).
```
The **CmdRunner** class creates an object that logs into a node *jumpbox-style*
and runs commands taken from cmd_file. It outputs the results in log_file.
```
__init__(self, jumpbox, node, cmd_file, log_file, blocking, key_file=None)
Description:
Initializer of CmdRunner object.
Parameters:
- jumpbox defines parameters needed to login to node.
- node hostname or IP address of the node.
- cmd_file file containing the commands to execute on node.
- log_file name of file in which activity is logged. If log_file is not given,
a log file will be created.
- blocking determines whether to block and wait for a command to finish
executing.
- key_file optional SSH security key file.
Returns:
CmdRunner object.
```
The **boxjumper** function internally creates CmdRunner objects from jumpboxes, and
recursively logs into those boxes/nodes. If commands happen to be defined for a node,
they are executed.
```
boxjumper(jumpboxes, count, fp=None, channelstack=None, print_output=False, blocking=True)
Description:
boxjumper recursively logs into the boxes/nodes defined in jumpboxes.
And optionally executes the commands for the current node if it's defined.
Parameters:
- jumpboxes list of jumpbox objects (contained within a ConfigGrabber object).
- count number of jumpboxes.
- fp boxjumper's log file pointer.
- channelstack optional channel created by the previous node (if there was a
previous node).
- print_output determines whether or not to print command output on the screen.
- blocking determines whether to block and wait for a command to finish
executing.
Returns:
fp boxjumper's log file pointer.
```
## A Very Simple Example On How To Use The API
```
from p_cmd_runr.p_cmd_runr import ConfigGrabber
from p_cmd_runr.p_cmd_runr import boxjumper
# your local configuration file
filename="config.txt"
# parse the configuration file and create a ConfigGrabber object, which contains
one or more jumpboxes and their associated parameters
cfo = ConfigGrabber(filename)
# boxjumper will create a CmdRunner object from each jumpbox contained in cfo, and
use the CmdRunner objects to remote into its corresponding node and optionally run
commands on it.
fp = boxjumper(cfo, len(cfo))
if fp:
fp.close()
```
For more information on other functions and class methods, load the package and use
the Python help() function to inspect them, or check the [source code](https://github.com/kaiyoux/p_cmd_runr).
# How To Use The gp_cmd_runr Script
The gp_cmd_runr script is a general purpose and flexible means of automatically
running commands remotely on one or more service node(s) using SSH(/AMOS/MOSHELL).
It allows you to jump from node to node, with the option of running commands on
each node.
**PLEASE MAKE SURE THAT YOU MANUALLY TEST THE COMMANDS ON THE INTENDED NODE(S) BEFORE
RUNNING THEM AUTOMATICALLY WITH THIS SCRIPT.**
The script is controlled by one or more configuration files. See Definitions and
the Example Configuration Files section below to have an idea on how to write your
own configuration file(s).
### To run the scrpit:
**python -m gp_cmd_runr [-h] [-d] [-t] [-p] [-r|-n|-f] [-c CONFIG1 [CONFIG2 ...]]**
```
general purpose command runner
optional arguments:
-h, --help show this help message and exit
-d, --dry_run display loaded configuration, but do not execute
-t, --timeout sets command execution to non-blocking. default is blocking
-p, --print_output flag to print command output to the screen. default is not to print
-r, --raw no manipulation of output file(s)
-n, --normal remove duplicate '\n' between lines in output file(s). this "normal" appearance is the default behavior
-f, --flatten only have output file(s) containing a single '\n' between lines
-c CONFIG1 [CONFIG2 ...], --config CONFIG1 [CONFIG2 ...]
list of one or many configuration files. default is config.txt
```
# Definitions
```
# This defines the structure of a configuration file.
# # character is a comment
# [] encloses an optional entry or block of entries
# <> value to specify. Note that the terms file, filename and filepath within <>
# are synonymous
[
# optional jumpboxes. these are potentially intermediary nodes, and can only be
# accessed through ssh
# example: ssh [-i key_file] [username@]node [-p port]
# jumbox1
jump_cmd = ssh
node = <node>
[username = <username>] # will be prompted if not provided
[
[
[key_file = <ssh security key file>] # will not be prompted if not provided.
# the private key file required to access the next node (to hop on) should reside
# on the node from which the hop will occur
[passphrase = <passphrase of key_file>] # if your private key file was created
# with a passphrase for additional security, you will have to specify it here.
# Note that this entry is optional if you are not using a passphrase
]
# or
[password = <password>] # will be prompted if not provided. meaningless if
# key_file is provided
]
[port = <port number>] # specify a custom ssh port number. default is 22
[cmd_file = <filepath>]
[log_file = <log filename>]
[delay = <pause time before running next command>] # defaults to 0 sec
[cmd_timeout = <maximum time to wait for command execution>] # maximum amount of
# time to wait (in seconds) for output from a command. it defaults to 0.5 sec.
# increase this value if you are missing some output. meaningless in blocking mode
[prompts = <string of characters representing prompts on the node>] # for blocking
# execution, the script blocks until it detects one of the prompts specified here.
# default is $#?<> . meaningless in non-blocking mode
end
#jumpbox2
...
#jumpboxN
...
]
# and/or
[
# optional final node(s). these are similar nodes sharing the same login username,
# the same password (if key files are not used), and understanding the same
# commands. can either be accessed through ssh or amos/moshell
# the name of each log file will be a combination of its corresponding IP/node
# name with date and timestamp.
# Note that if there happens to be a local tmp/ folder, the script will silently
# move the logs files to that tmp/ folder as a measure to avoid cludder in
# the working directory
nodes = <comma seperated list of nodes (either node names or IP addresses)>
[
# optional ssh security key files for the above final nodes
# the first key file is for the secure login to the first node, the second key
# file to the second node, etc.
# if there are more nodes than key files, the last key file will be used to login
# to the remaining nodes
# if there are less nodes than key files, the excess key files are ignored
# Note that individual passphrases are not allowed in this section for each final
# node
key_files = <comma seperated list of ssh security key files>
]
# command files for the above final nodes
# the first command file is run on the first node, the second command file on the
# second node, etc.
# if there are more nodes than command files, the last command file will be run on
# the remaining nodes
# if there are less nodes than command files, the excess command files are ignored
cmd_files = <comma seperated list of filepaths>
# defines common parameters for the final nodes
jump_cmd = amos or moshell or ssh # examples: amos node or moshell node or
# ssh [-i key_file] [username@]node [-p port]
[username = <username>] # mandatory if using ssh. my amos/moshell does not use
# username
[password = <password>] # mandatory if using ssh and no key_files have been
# specified. this password will be used to login on all final nodes. meaningless
# if key_files are provided. my amos/moshell does not use password authentication
[passphrase = <passphrase for one, some or all key_files>] # you may define and
# use a common passphrase for one, all or some of the final nodes/key files.
# specifying a passcode here for some of the key files will not interfere with
# the other key files that do not require a passphrase
[port = <port number>] # specify a custom ssh port number. default is 22
[delay = <pause time before running next command>] # defaults to 0 sec
[cmd_timeout = <maximum time to wait for command execution>] # maximum amount of
# time to wait (in seconds) for output from a command. it defaults to 0.5 sec.
# increase this value if you are missing some output. meaningless in blocking mode
[prompts = <string of characters representing prompts on the nodes>] # for
# blocking execution, the script blocks until it detects one of the prompts
# specified here.
# default is $#?<> . meaningless in non-blocking mode
end
]
```
# Example Confiuration Files
```
# The below configuration will ssh to node 99.99.99.99, and from there ssh to node
# 88.88.88.88.
# It will run the commands in linux_commands_2.txt on node 88.88.88.88, and save
# the output in EMM.txt under tmp/ folder.
# Once done, it will backtrack and run the commands in linux_cmds.txt on node
# 99.99.99.99, and save the output in cubevm.txt.
jump_cmd = ssh
node = 99.99.99.99
username =
password =
#cmd_timeout = 0.5
#delay = 0
log_file = cubevm.txt
cmd_file = linux_cmds.txt
end
jump_cmd = ssh
node = 88.88.88.88
username = iTsm3
password = my5ecr3t#Cu8#passw # yes, you may use '#' characters as part of your
# password
log_file = tmp/EMM.txt # note: log file will be placed in tmp folder, if tmp/
# exists
cmd_file = linux_commands_2.txt
cmd_timeout = 1
end
```
```
# The below configuration will ssh to 4 nodes: cube5, cube6, 3.3.3.3, cube1. Note
# that they must all accept the same login username and password credentials.
# It will run the commands in linux2_commands on all 4 nodes and save the output
# locally in text files named after each node with a date and timestamp.
nodes = cube5, cube6, 3.3.3.3, cube1
cmd_files = linux2_commands
jump_cmd = ssh
username = iTsm3
password = my5ecr3tCu8passw
#delay = 0
#cmd_timeout = 1
end
```
```
# The below configuration will ssh to node 1.2.3.4, and from there amos to node
# box1, then box3.
# It will run the commands in amos2_commands.txt on box1, run the commands in
# generic_cmds.txt on box3, and save the output files locally in a text files
# named after each node with a date and timestamp.
# It will ignore the excess command files: DOES_NOT_EXIST.txt, RANDOM.txt.
jump_cmd = ssh
node = 1.2.3.4
port = 22
username = iTsm3
password = my5ecr3tCu8passw
prompts = $
end
#nodes = box2??
nodes = box1, box3
cmd_files = amos2_commands.txt, generic_cmds.txt, DOES_NOT_EXIST.txt, RANDOM.txt
jump_cmd = amos
#delay = 1
prompts = <>
end
```
```
# The below configuration will ssh to cubeX node using the private key in
# C:/Users/jd/ssh-keys/id_rsa (which does not require a passphrase),
# and execute the commands in C:/Users/jd/work/commands_to_run_on_cubeX.
jump_cmd = ssh
node = cubeX
port = 2233
username = jane-doe
key_file = C:/Users/jd/ssh-keys/id_rsa # was not generated with a passphrase
#key_file = C:/Users/jd/ssh-keys/pp_id_dsa # was generated with the below
# passphrase
#passphrase = passphrase-for-pp_id_dsa
prompts = $
cmd_file = C:/Users/jd/work/commands_to_run_on_cubeX
end
```
```
# The below configuration will successively ssh to the 2 nodes (aServer and
# 721.9.0.5) using the private key in pp_id_ed25519, along with passphrase
# "common_pp*", and execute the commands in cmd1 on aServer, and commands in
# cmd2 on 721.9.0.5.
nodes = aServer, 721.9.0.5
key_files = pp_id_ed25519
cmd_files = cmd1, cmd2, cmd3, cmd4
jump_cmd = ssh
username = admin
passphrase = common_pp*
port = 2222
prompts = $
end
```
```
# The below configuration will ssh to sales node using the private key in id_rsa
# and execute the commands in cmd1.txt.
# Then ssh to dmz node using the private key in pp_id_rsa, along with its
# corresponding passphrase "the_passphrase_of_pp_id_rsa", and execute the commands
# in /home/billy/special/dmz/cmd2.
# And finally, ssh to production node using the private key in id_ed25519, and
# execute the commands in cmd1.txt.
nodes = sales, dmz, production
key_files = id_rsa, pp_id_rsa, id_ed25519
cmd_files = cmd1.txt, /home/billy/special/dmz/cmd2, cmd1.txt, cmd.txt
jump_cmd = ssh
username = admin
passphrase = the_passphrase_of_pp_id_rsa
port = 2222
prompts = $
end
```
```
# The below configuration will ssh to node 99.99.99.99, and from there ssh to node
# 88.88.88.88.
# From node 88.88.88.88, it will ssh to nodes cube5, cube6, 3.3.3.3, cube1.
# It will run the commands in linux2_commands.txt on cube5, cube6, 3.3.3.3 and
# cube1, and save the output locally in text files named after each node with
# a date and timestamp.
# It will backtrack and run the commands in linux_TEST_commands on node
# 88.88.88.88, and save the output in EMM.txt under tmp/ folder.
# Once done, it will backtrack and run the commands in linux_cmds.txt on node
# 99.99.99.99, and save the output in cubevm.txt.
jump_cmd = ssh
node = 99.99.99.99
username =
key_file = /home/john/.ssh/id_to_login_to_99-99-99-99
cmd_timeout = 10.0
#delay = 0
log_file = cubevm.txt
cmd_file = linux_cmds.txt
end
jump_cmd = ssh
node = 88.88.88.88
username = ITteam
key_file = /home/john/.ssh/id_to_login_to_88-88-88-88
log_file = tmp/EMM.txt # note: log file EMM.txt as well as the logs from
# the below nodes will be placed in the tmp/ folder, if it exists
cmd_file = linux_TEST_commands
cmd_timeout = 1
end
nodes = cube5, cube6, 3.3.3.3, cube1
key_files = /home/john/.ssh/id_to_login_to_cube5, /home/john/.ssh/id_to_login_to_cube6,
/home/john/.ssh/id_to_login_to_3-3-3-3_and_cube1
cmd_files = linux2_commands.txt
jump_cmd = ssh
username = admin
#delay = 0
#cmd_timeout = 1
end
```
# Command File Special Notation:
The command file(s) would contain the typical commands that you would run, line
by line, while logged in on the remote host(s).
As of **version 0.0.6**, a special notation
**:<number of seconds>[sS]:**
can be used in your command files.
The purpose of this special notation is to wait for the output of the previous
command that was issued, for which a prompt was returned but the expected output
has yet to be received, as it is still being processed and will be returned in a
few seconds or minutes.
**Note that this special notation must appear on a seperate line, in order to keep
it distinct from your regular commands. Any other command(s) that appear on
the same line as this special notation will be ignored.**
```
Examples of valid notations:
:2: (same as :2s: or :2S:) to wait for 2 seconds.
:063: (same as :63: or :63s:) to wait for 63 seconds.
Examples of non-valid notations:
:: (same as :s: or :S:) will be ignored
:5.9: will be ignored
:1m5s: will be ignored, use :65: instead
```
# Limitations/Known Issues:
- Pagination type commands like `more` or `less` will lock after the first output.
It is best to avoid such commands.
You may try to run gp_cmd_runr with the -t or --timeout option. This will force
the script to send the next command after the delay you specify, which may result
in unexpected behavior on the remote node.
- Given that my AMOS/MOSHELL environments do not require login credentials,
the script does not provide the option of specifying such login credentials
for AMOS/MOSHELL access.
Let me know if you have any questions: <kaiyoux@gmail.com>
Raw data
{
"_id": null,
"home_page": "https://github.com/kaiyoux/p_cmd_runr",
"name": "p-cmd-runr",
"maintainer": "Issa Lompo",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "kaiyoux@gmail.com",
"keywords": "ssh, automation, automate, amos, moshell, remote, command, runner, run, execution, execute, paramiko, based, jumpbox, simple, easy, jump, hop",
"author": "Issa Lompo",
"author_email": "kaiyoux@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/41/ca/5245973ea99b213462e1ae12871f11b01f86fd3f011a22987c7ce866b84e/p_cmd_runr-0.1.5.tar.gz",
"platform": null,
"description": "# Introduction\r\n\r\nThe p_cmd_runner package was born from the need to run local commands (taken from\r\nlocal files) on any number of remote nodes accessible via SSH(/AMOS/MOSHELL).\r\nIt is written in Python 3, and is based on the Paramiko package.\r\n\r\nAs of **version 0.1.0**, SSH security key files are supported as an alternative to\r\npassword authentication.\r\nSee this [tutorial](https://phoenixnap.com/kb/setup-passwordless-ssh) on how to setup your SSH security key files.\r\nIn general, you would generate public and private key-pair(s) on your local \r\nmachine, then transfer the public key(s) to your remote node(s).\r\n\r\n### To install the package:\r\n**python -m pip install p_cmd_runr**\r\nor\r\n**python3 -m pip install --user p_cmd_runr**\r\n\r\n\r\n### The p_cmd_runr package provides access to:\r\n- an API composed of a ConfigGrabber class, a CmdRunner class, a main function \r\ncalled boxjumper, and other utility functions.\r\n- the gp_cmd_runr a general purpose command runner script.\r\n\r\nWhether you will be implementing your own script with the help of the API, or \r\nrunning the gp_cmd_runr script, you will have to provide 2 types of files:\r\n- at least one configuration file stating which nodes to access, their login \r\ninformation, along with references to the files containing the commands to run on \r\nthose nodes.\r\n- at least one command file containing the commands you would normally run on the \r\nabove node(s).\r\n\r\n\r\n# The Main API Classes And Functions\r\n\r\nThe **ConfigGrabber** class creates an iterator type object. You provide it with\r\nthe filename of your local configuration file.\r\n```\r\n__init__(self, filename=\"config.txt\", separator=\"=\", comment=\"#\", mvs=\",\", \r\ndelay=\"0\", cmd_timeout=\"0.5\", prompts=\"$#?<>\")\r\nDescription:\r\n Initializer of a ConfigGrabber object. Reads a configuration file and makes \r\n available a dictionary of key-value pairs taken from that configuration file.\r\nParameters:\r\n - Filename specifies the name of the configuration file to process.\r\n - separator defines the character or string used as separator between \r\n key-value pairs.\r\n - comment defines the character or string used for line comments.\r\n - mvs (or multi-value seperator): defines the character or string that \r\n seperates multiple values.\r\n - delay pause time (in seconds) before running the next command.\r\n - cmd_timeout maximum time (in seconds) to wait for a command to finish \r\n executing.\r\n - prompts string of characters representing command line prompts.\r\nReturns:\r\n ConfigGrabber object (which contains the jumpboxes used by the boxjumper \r\n function).\r\n```\r\n\r\n\r\nThe **CmdRunner** class creates an object that logs into a node *jumpbox-style* \r\nand runs commands taken from cmd_file. It outputs the results in log_file.\r\n```\r\n__init__(self, jumpbox, node, cmd_file, log_file, blocking, key_file=None)\r\nDescription:\r\n Initializer of CmdRunner object.\r\nParameters:\r\n - jumpbox defines parameters needed to login to node.\r\n - node hostname or IP address of the node.\r\n - cmd_file file containing the commands to execute on node.\r\n - log_file name of file in which activity is logged. If log_file is not given, \r\n a log file will be created.\r\n - blocking determines whether to block and wait for a command to finish \r\n executing.\r\n - key_file optional SSH security key file.\r\nReturns:\r\n CmdRunner object.\r\n```\r\n\r\n\r\nThe **boxjumper** function internally creates CmdRunner objects from jumpboxes, and\r\nrecursively logs into those boxes/nodes. If commands happen to be defined for a node,\r\nthey are executed.\r\n```\r\nboxjumper(jumpboxes, count, fp=None, channelstack=None, print_output=False, blocking=True)\r\nDescription:\r\n boxjumper recursively logs into the boxes/nodes defined in jumpboxes.\r\n And optionally executes the commands for the current node if it's defined.\r\nParameters:\r\n - jumpboxes list of jumpbox objects (contained within a ConfigGrabber object).\r\n - count number of jumpboxes.\r\n - fp boxjumper's log file pointer.\r\n - channelstack optional channel created by the previous node (if there was a \r\n previous node).\r\n - print_output determines whether or not to print command output on the screen.\r\n - blocking determines whether to block and wait for a command to finish \r\n executing.\r\nReturns:\r\n fp boxjumper's log file pointer.\r\n```\r\n\r\n\r\n## A Very Simple Example On How To Use The API\r\n```\r\nfrom p_cmd_runr.p_cmd_runr import ConfigGrabber\r\nfrom p_cmd_runr.p_cmd_runr import boxjumper\r\n\r\n# your local configuration file\r\nfilename=\"config.txt\"\r\n# parse the configuration file and create a ConfigGrabber object, which contains\r\none or more jumpboxes and their associated parameters\r\ncfo = ConfigGrabber(filename)\r\n# boxjumper will create a CmdRunner object from each jumpbox contained in cfo, and\r\nuse the CmdRunner objects to remote into its corresponding node and optionally run\r\ncommands on it.\r\nfp = boxjumper(cfo, len(cfo))\r\nif fp:\r\nfp.close()\r\n```\r\n\r\n\r\nFor more information on other functions and class methods, load the package and use\r\nthe Python help() function to inspect them, or check the [source code](https://github.com/kaiyoux/p_cmd_runr).\r\n\r\n\r\n# How To Use The gp_cmd_runr Script\r\n\r\nThe gp_cmd_runr script is a general purpose and flexible means of automatically \r\nrunning commands remotely on one or more service node(s) using SSH(/AMOS/MOSHELL).\r\nIt allows you to jump from node to node, with the option of running commands on \r\neach node.\r\n**PLEASE MAKE SURE THAT YOU MANUALLY TEST THE COMMANDS ON THE INTENDED NODE(S) BEFORE\r\nRUNNING THEM AUTOMATICALLY WITH THIS SCRIPT.**\r\n\r\n\r\nThe script is controlled by one or more configuration files. See Definitions and \r\nthe Example Configuration Files section below to have an idea on how to write your \r\nown configuration file(s).\r\n\r\n\r\n### To run the scrpit:\r\n**python -m gp_cmd_runr [-h] [-d] [-t] [-p] [-r|-n|-f] [-c CONFIG1 [CONFIG2 ...]]**\r\n```\r\ngeneral purpose command runner\r\n\r\noptional arguments:\r\n -h, --help show this help message and exit\r\n -d, --dry_run display loaded configuration, but do not execute\r\n -t, --timeout sets command execution to non-blocking. default is blocking\r\n -p, --print_output flag to print command output to the screen. default is not to print\r\n -r, --raw\t\tno manipulation of output file(s)\r\n -n, --normal\t\tremove duplicate '\\n' between lines in output file(s). this \"normal\" appearance is the default behavior\r\n -f, --flatten\t\tonly have output file(s) containing a single '\\n' between lines\r\n -c CONFIG1 [CONFIG2 ...], --config CONFIG1 [CONFIG2 ...]\r\n list of one or many configuration files. default is config.txt\r\n```\r\n\r\n\r\n# Definitions\r\n```\r\n# This defines the structure of a configuration file.\r\n# # character is a comment\r\n# [] encloses an optional entry or block of entries\r\n# <> value to specify. Note that the terms file, filename and filepath within <>\r\n# are synonymous\r\n\r\n[\r\n# optional jumpboxes. these are potentially intermediary nodes, and can only be \r\n# accessed through ssh\r\n# example: ssh [-i key_file] [username@]node [-p port]\r\n# jumbox1\r\njump_cmd = ssh\r\nnode = <node>\r\n[username = <username>] # will be prompted if not provided\r\n[\r\n[\r\n[key_file = <ssh security key file>] # will not be prompted if not provided. \r\n# the private key file required to access the next node (to hop on) should reside \r\n# on the node from which the hop will occur\r\n[passphrase = <passphrase of key_file>] # if your private key file was created \r\n# with a passphrase for additional security, you will have to specify it here. \r\n# Note that this entry is optional if you are not using a passphrase\r\n]\r\n# or\r\n[password = <password>] # will be prompted if not provided. meaningless if \r\n# key_file is provided\r\n]\r\n[port = <port number>] # specify a custom ssh port number. default is 22\r\n[cmd_file = <filepath>]\r\n[log_file = <log filename>]\r\n[delay = <pause time before running next command>] # defaults to 0 sec\r\n[cmd_timeout = <maximum time to wait for command execution>] # maximum amount of\r\n# time to wait (in seconds) for output from a command. it defaults to 0.5 sec. \r\n# increase this value if you are missing some output. meaningless in blocking mode\r\n[prompts = <string of characters representing prompts on the node>] # for blocking\r\n# execution, the script blocks until it detects one of the prompts specified here.\r\n# default is $#?<> . meaningless in non-blocking mode\r\nend\r\n\r\n\r\n#jumpbox2\r\n...\r\n\r\n#jumpboxN\r\n...\r\n]\r\n\r\n# and/or\r\n\r\n[\r\n# optional final node(s). these are similar nodes sharing the same login username,\r\n# the same password (if key files are not used), and understanding the same \r\n# commands. can either be accessed through ssh or amos/moshell\r\n# the name of each log file will be a combination of its corresponding IP/node \r\n# name with date and timestamp.\r\n# Note that if there happens to be a local tmp/ folder, the script will silently\r\n# move the logs files to that tmp/ folder as a measure to avoid cludder in \r\n# the working directory\r\nnodes = <comma seperated list of nodes (either node names or IP addresses)>\r\n\r\n[\r\n# optional ssh security key files for the above final nodes\r\n# the first key file is for the secure login to the first node, the second key \r\n# file to the second node, etc.\r\n# if there are more nodes than key files, the last key file will be used to login \r\n# to the remaining nodes\r\n# if there are less nodes than key files, the excess key files are ignored\r\n# Note that individual passphrases are not allowed in this section for each final\r\n# node\r\nkey_files = <comma seperated list of ssh security key files>\r\n]\r\n\r\n# command files for the above final nodes\r\n# the first command file is run on the first node, the second command file on the\r\n# second node, etc.\r\n# if there are more nodes than command files, the last command file will be run on\r\n# the remaining nodes\r\n# if there are less nodes than command files, the excess command files are ignored\r\ncmd_files = <comma seperated list of filepaths>\r\n\r\n# defines common parameters for the final nodes\r\njump_cmd = amos or moshell or ssh # examples: amos node or moshell node or \r\n# ssh [-i key_file] [username@]node [-p port]\r\n[username = <username>] # mandatory if using ssh. my amos/moshell does not use \r\n# username\r\n[password = <password>] # mandatory if using ssh and no key_files have been \r\n# specified. this password will be used to login on all final nodes. meaningless \r\n# if key_files are provided. my amos/moshell does not use password authentication\r\n[passphrase = <passphrase for one, some or all key_files>] # you may define and \r\n# use a common passphrase for one, all or some of the final nodes/key files. \r\n# specifying a passcode here for some of the key files will not interfere with \r\n# the other key files that do not require a passphrase\r\n[port = <port number>] # specify a custom ssh port number. default is 22\r\n[delay = <pause time before running next command>] # defaults to 0 sec\r\n[cmd_timeout = <maximum time to wait for command execution>] # maximum amount of\r\n# time to wait (in seconds) for output from a command. it defaults to 0.5 sec. \r\n# increase this value if you are missing some output. meaningless in blocking mode\r\n[prompts = <string of characters representing prompts on the nodes>] # for \r\n# blocking execution, the script blocks until it detects one of the prompts \r\n# specified here.\r\n# default is $#?<> . meaningless in non-blocking mode\r\nend\r\n]\r\n```\r\n\r\n# Example Confiuration Files\r\n```\r\n# The below configuration will ssh to node 99.99.99.99, and from there ssh to node\r\n# 88.88.88.88.\r\n# It will run the commands in linux_commands_2.txt on node 88.88.88.88, and save\r\n# the output in EMM.txt under tmp/ folder.\r\n# Once done, it will backtrack and run the commands in linux_cmds.txt on node \r\n# 99.99.99.99, and save the output in cubevm.txt.\r\n\r\njump_cmd = ssh\r\nnode = 99.99.99.99\r\nusername =\r\npassword =\r\n#cmd_timeout = 0.5\r\n#delay = 0\r\nlog_file = cubevm.txt\r\ncmd_file = linux_cmds.txt\r\nend\r\n\r\njump_cmd = ssh\r\nnode = 88.88.88.88\r\nusername = iTsm3\r\npassword = my5ecr3t#Cu8#passw # yes, you may use '#' characters as part of your \r\n# password\r\nlog_file = tmp/EMM.txt # note: log file will be placed in tmp folder, if tmp/ \r\n# exists\r\ncmd_file = linux_commands_2.txt\r\ncmd_timeout = 1\r\nend\r\n```\r\n\r\n```\r\n# The below configuration will ssh to 4 nodes: cube5, cube6, 3.3.3.3, cube1. Note\r\n# that they must all accept the same login username and password credentials.\r\n# It will run the commands in linux2_commands on all 4 nodes and save the output\r\n# locally in text files named after each node with a date and timestamp.\r\n\r\nnodes = cube5, cube6, 3.3.3.3, cube1\r\n\r\ncmd_files = linux2_commands\r\n\r\njump_cmd = ssh\r\nusername = iTsm3\r\npassword = my5ecr3tCu8passw\r\n#delay = 0\r\n#cmd_timeout = 1\r\nend\r\n```\r\n\r\n```\r\n# The below configuration will ssh to node 1.2.3.4, and from there amos to node \r\n# box1, then box3.\r\n# It will run the commands in amos2_commands.txt on box1, run the commands in \r\n# generic_cmds.txt on box3, and save the output files locally in a text files \r\n# named after each node with a date and timestamp.\r\n# It will ignore the excess command files: DOES_NOT_EXIST.txt, RANDOM.txt.\r\n\r\n\r\njump_cmd = ssh\r\nnode = 1.2.3.4\r\nport = 22\r\nusername = iTsm3\r\npassword = my5ecr3tCu8passw\r\nprompts = $\r\nend\r\n\r\n#nodes = box2??\r\nnodes = box1, box3\r\n\r\ncmd_files = amos2_commands.txt, generic_cmds.txt, DOES_NOT_EXIST.txt, RANDOM.txt\r\n\r\njump_cmd = amos\r\n#delay = 1\r\nprompts = <>\r\nend\r\n```\r\n\r\n```\r\n# The below configuration will ssh to cubeX node using the private key in \r\n# C:/Users/jd/ssh-keys/id_rsa (which does not require a passphrase),\r\n# and execute the commands in C:/Users/jd/work/commands_to_run_on_cubeX.\r\n\r\njump_cmd = ssh\r\nnode = cubeX\r\nport = 2233\r\nusername = jane-doe\r\nkey_file = C:/Users/jd/ssh-keys/id_rsa # was not generated with a passphrase\r\n#key_file = C:/Users/jd/ssh-keys/pp_id_dsa # was generated with the below \r\n# passphrase\r\n#passphrase = passphrase-for-pp_id_dsa\r\nprompts = $\r\ncmd_file = C:/Users/jd/work/commands_to_run_on_cubeX\r\nend\r\n```\r\n\r\n```\r\n# The below configuration will successively ssh to the 2 nodes (aServer and \r\n# 721.9.0.5) using the private key in pp_id_ed25519, along with passphrase \r\n# \"common_pp*\", and execute the commands in cmd1 on aServer, and commands in \r\n# cmd2 on 721.9.0.5.\r\n\r\nnodes = aServer, 721.9.0.5\r\nkey_files = pp_id_ed25519\r\ncmd_files = cmd1, cmd2, cmd3, cmd4\r\n\r\njump_cmd = ssh\r\nusername = admin\r\npassphrase = common_pp*\r\nport = 2222\r\nprompts = $\r\nend\r\n```\r\n\r\n```\r\n# The below configuration will ssh to sales node using the private key in id_rsa\r\n# and execute the commands in cmd1.txt.\r\n# Then ssh to dmz node using the private key in pp_id_rsa, along with its \r\n# corresponding passphrase \"the_passphrase_of_pp_id_rsa\", and execute the commands \r\n# in /home/billy/special/dmz/cmd2.\r\n# And finally, ssh to production node using the private key in id_ed25519, and \r\n# execute the commands in cmd1.txt.\r\n\r\nnodes = sales, dmz, production\r\n\r\nkey_files = id_rsa, pp_id_rsa, id_ed25519\r\n\r\ncmd_files = cmd1.txt, /home/billy/special/dmz/cmd2, cmd1.txt, cmd.txt\r\n\r\njump_cmd = ssh\r\nusername = admin\r\npassphrase = the_passphrase_of_pp_id_rsa\r\nport = 2222\r\nprompts = $\r\nend\r\n```\r\n\r\n```\r\n# The below configuration will ssh to node 99.99.99.99, and from there ssh to node\r\n# 88.88.88.88.\r\n# From node 88.88.88.88, it will ssh to nodes cube5, cube6, 3.3.3.3, cube1.\r\n# It will run the commands in linux2_commands.txt on cube5, cube6, 3.3.3.3 and \r\n# cube1, and save the output locally in text files named after each node with \r\n# a date and timestamp.\r\n# It will backtrack and run the commands in linux_TEST_commands on node \r\n# 88.88.88.88, and save the output in EMM.txt under tmp/ folder.\r\n# Once done, it will backtrack and run the commands in linux_cmds.txt on node \r\n# 99.99.99.99, and save the output in cubevm.txt.\r\n\r\njump_cmd = ssh\r\nnode = 99.99.99.99\r\nusername =\r\nkey_file = /home/john/.ssh/id_to_login_to_99-99-99-99\r\ncmd_timeout = 10.0\r\n#delay = 0\r\nlog_file = cubevm.txt\r\ncmd_file = linux_cmds.txt\r\nend\r\n\r\njump_cmd = ssh\r\nnode = 88.88.88.88\r\nusername = ITteam\r\nkey_file = /home/john/.ssh/id_to_login_to_88-88-88-88\r\nlog_file = tmp/EMM.txt # note: log file EMM.txt as well as the logs from \r\n# the below nodes will be placed in the tmp/ folder, if it exists\r\ncmd_file = linux_TEST_commands\r\ncmd_timeout = 1\r\nend\r\n\r\nnodes = cube5, cube6, 3.3.3.3, cube1\r\n\r\nkey_files = /home/john/.ssh/id_to_login_to_cube5, /home/john/.ssh/id_to_login_to_cube6,\r\n/home/john/.ssh/id_to_login_to_3-3-3-3_and_cube1\r\n\r\ncmd_files = linux2_commands.txt\r\n\r\njump_cmd = ssh\r\nusername = admin\r\n#delay = 0\r\n#cmd_timeout = 1\r\nend\r\n```\r\n\r\n# Command File Special Notation:\r\n\r\nThe command file(s) would contain the typical commands that you would run, line \r\nby line, while logged in on the remote host(s).\r\nAs of **version 0.0.6**, a special notation\r\n\r\n**:<number of seconds>[sS]:**\r\n\r\ncan be used in your command files.\r\nThe purpose of this special notation is to wait for the output of the previous \r\ncommand that was issued, for which a prompt was returned but the expected output \r\nhas yet to be received, as it is still being processed and will be returned in a \r\nfew seconds or minutes.\r\n**Note that this special notation must appear on a seperate line, in order to keep\r\nit distinct from your regular commands. Any other command(s) that appear on \r\nthe same line as this special notation will be ignored.**\r\n```\r\nExamples of valid notations:\r\n:2: (same as :2s: or :2S:) to wait for 2 seconds.\r\n:063: (same as :63: or :63s:) to wait for 63 seconds.\r\n\r\nExamples of non-valid notations:\r\n:: (same as :s: or :S:) will be ignored\r\n:5.9: will be ignored\r\n:1m5s: will be ignored, use :65: instead\r\n```\r\n\r\n# Limitations/Known Issues:\r\n\r\n- Pagination type commands like `more` or `less` will lock after the first output.\r\nIt is best to avoid such commands.\r\nYou may try to run gp_cmd_runr with the -t or --timeout option. This will force \r\nthe script to send the next command after the delay you specify, which may result \r\nin unexpected behavior on the remote node.\r\n\r\n- Given that my AMOS/MOSHELL environments do not require login credentials, \r\nthe script does not provide the option of specifying such login credentials \r\nfor AMOS/MOSHELL access.\r\n\r\n\r\n\r\n\r\nLet me know if you have any questions: <kaiyoux@gmail.com>\r\n\r\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 (GPLv3)",
"summary": "A multi-purpose and flexible way to run commands on remote hosts.",
"version": "0.1.5",
"project_urls": {
"Bug Tracker": "https://github.com/kaiyoux/p_cmd_runr/issues",
"Homepage": "https://github.com/kaiyoux/p_cmd_runr"
},
"split_keywords": [
"ssh",
" automation",
" automate",
" amos",
" moshell",
" remote",
" command",
" runner",
" run",
" execution",
" execute",
" paramiko",
" based",
" jumpbox",
" simple",
" easy",
" jump",
" hop"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "37ffd45a5d4a88047aee956e841fd13badb5e4b378a6b47318a51b503617a600",
"md5": "6029122ec3e498016c68b535c8fc795a",
"sha256": "a4dbff4e067db5ed0421b222765fcb5aeb59e33be6fc09d33fef154321d7f5af"
},
"downloads": -1,
"filename": "p_cmd_runr-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6029122ec3e498016c68b535c8fc795a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 55076,
"upload_time": "2024-04-02T03:16:21",
"upload_time_iso_8601": "2024-04-02T03:16:21.432807Z",
"url": "https://files.pythonhosted.org/packages/37/ff/d45a5d4a88047aee956e841fd13badb5e4b378a6b47318a51b503617a600/p_cmd_runr-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "41ca5245973ea99b213462e1ae12871f11b01f86fd3f011a22987c7ce866b84e",
"md5": "54e7c976ef9cc4afd008f72c0d5fae61",
"sha256": "da2d78af2fc0aed89b6e952ab5aeafb9149b199d4e7eb82cd45cf4577903c37e"
},
"downloads": -1,
"filename": "p_cmd_runr-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "54e7c976ef9cc4afd008f72c0d5fae61",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 55492,
"upload_time": "2024-04-02T03:16:27",
"upload_time_iso_8601": "2024-04-02T03:16:27.893854Z",
"url": "https://files.pythonhosted.org/packages/41/ca/5245973ea99b213462e1ae12871f11b01f86fd3f011a22987c7ce866b84e/p_cmd_runr-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-02 03:16:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kaiyoux",
"github_project": "p_cmd_runr",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "paramiko",
"specs": [
[
">=",
"2.7.2"
]
]
},
{
"name": "pynacl",
"specs": [
[
">=",
"1.0.1"
]
]
},
{
"name": "cryptography",
"specs": [
[
">=",
"2.5"
]
]
},
{
"name": "six",
"specs": [
[
">=",
"1.4.1"
]
]
},
{
"name": "cffi",
"specs": [
[
">=",
"1.1"
]
]
},
{
"name": "pycparser",
"specs": []
}
],
"lcname": "p-cmd-runr"
}
JSON
