{"id":20572064,"url":"https://github.com/netease/erlyssh","last_synced_at":"2025-04-14T17:08:14.397Z","repository":{"id":4281447,"uuid":"5410610","full_name":"NetEase/erlyssh","owner":"NetEase","description":"A Parallel SSH Execution Tool","archived":false,"fork":false,"pushed_at":"2014-07-03T06:39:18.000Z","size":161,"stargazers_count":45,"open_issues_count":0,"forks_count":18,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-14T17:08:03.326Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Erlang","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NetEase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-08-14T09:09:37.000Z","updated_at":"2025-04-04T10:32:50.000Z","dependencies_parsed_at":"2022-08-25T11:51:15.241Z","dependency_job_id":null,"html_url":"https://github.com/NetEase/erlyssh","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEase%2Ferlyssh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEase%2Ferlyssh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEase%2Ferlyssh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NetEase%2Ferlyssh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NetEase","download_url":"https://codeload.github.com/NetEase/erlyssh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248923764,"owners_count":21183953,"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-11-16T05:18:12.098Z","updated_at":"2025-04-14T17:08:14.374Z","avatar_url":"https://github.com/NetEase.png","language":"Erlang","funding_links":[],"categories":[],"sub_categories":[],"readme":"erlyssh - A Parallel SSH Execution Tool\n=======\n\nThis is an Erlang Powered linux command line tool.You can use this tool to \nconnect to mass of servers through SSH client simultaneously and parallel \nexecute noninteractive shell commands on every connected server. \n\n* Homepage: \u003chttps://github.com/NetEase/erlyssh\u003e\n* Tags: tools, ssh, operation, erlang\n\n\nRequirements:\n--------\n1. openssh client with agent foward enabled\n2. GNU lib readline(libreadline.so,libhistory.so)\n3. Erlang 5.6/OTP R12B or later\n4. Linux or Mac OSX\n5. autoconf automake libtool required for building\n\nInstall:\n--------\nrun autoreconf -i to generate configure Makefile.in etc.\n\nrun ./configure\n\nrun sudo make install\n\nor you can provide --prefix=/custom-install-path/ as ./configure option\n\nif any buid error occurs, try to check\n\n1. Is libreadline's arch compatible with your erlang runtime\n2. Check include path and library path, add your custom -I -L to CFLAGS env\n3. Is your default system arch compatible with your erlang runtime, otherwise\nadd -arch parameter to CFLAGS env\n\nUsage:\n--------\n###configure server list\nexport ESSH_LIST_HOME = /your-path-to-put-server-list-files\n\nin ESSH_HOME_DIR put your server list files, Use the following format:\n\n\twww-11.internal.org\n\twww-15.internal.org\n\t172.19.0.86\n\t-p1046 172.19.1.87\n\t#comment: each server address(domain or ip) a line \n\t#as ssh command's paras`\n\n\n###run shell script\nStart erlyssh with:\n\n\tradiumce@app-88:~$ essh cometd                                             \n\t-----------------www-11 connected-------------------                    \n\t-----------------www-15 connected------------------- \n\n\tessh\u003e: \nAfter 'essh\u003e:'  prompt, you can run any non-interactive commands.\nfor exmaple:\n\n\tradiumce@app-88:~$ essh cometd\n\t-----------------www-11 connected-------------------\n\t-----------------www-15 connected-------------------\n\n\tessh\u003e: ls\n\t--------------www-11---------------\n\terlang\n\n\n\t[primary server done]\n\t-\u003e\u003e\n\n\tessh\u003e:\nInput a 'ls' command, and it will parallel executed on www-11,www-15.\nIn erlyssh the first server on the list will be the primary server. Its output is \nrealtime(it is useful when running some long duration commands, such as 'svn up').\nwhen the command on www-15 is done, it will compare with the out put of www-11.\nwhen their output is identical, erlssh just print a '-\u003e\u003e' as www-15's output.\n\n\t\n\tessh\u003e: #con 5\n\tset concurrent execution limits = 5\n\tessh\u003e: \nSchedule parameter 'con'(limit of parallel connections, default 256) can be set by '#con number'\n\n\n\tessh\u003e: #intv 5\n\tset execution interval = 5s\n\tessh\u003e: \nSchedule parameter 'intv'(execution interval, default 0) can be set by '#intv ${seconds}'\n\n\tessh\u003e: exit;\n\tThanks for using essh, bye.\nUse command 'exit;'(ends with ';') to exit the shell.\n\nTips:\n--------\n1. erlyssh is interactive(you can use 'cd' to change path) but it can only \nexecute non-interactive commands.\n2. When there is mass of servers, add\n\n\tCheckHostIP no\n\n\tStrictHostKeyChecking no\n\n   to your .ssh/config can avoid some yes/no security confirm\n3. Many shell commands have their non-interactive mode or corresponded \nnon-interactive commands. Such as 'svn' commands have non-interactive\nmode and 'sed' can help you to perform plain text processing.\n\n\nHow Can I Contribute\n--------------------\nFork this project on [GitHub](https://github.com/NetEase/erlyssh), add your improvement, push it to a branch in your fork named for the topic, send a pull request.\n\nYou can also file bugs or feature requests under the [issues](https://github.com/NetEase/erlyssh/issues/) page on GitHub.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetease%2Ferlyssh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetease%2Ferlyssh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetease%2Ferlyssh/lists"}