KO
|
EN
gitlite — search
Search
#javascript
#python
#hacktoberfest
#react
#ai
#typescript
#llm
#go
#golang
#android
#machine-learning
#rust
#deep-learning
#linux
runit-man
★ 14
Open GitHub ↗
runit web monitoring tool
Download README (.md)
Explore Similar Repositories
Simulations
:
Various simulations of random processes
jquery-slideshow
:
jQuery plugin for awesome slideshow on your website.
gtkjsonviewer
:
A simple json viewer written in GTK.
zbx-multicheck
:
Execute multiple commands and send multiple values to Zabbix with a single call
Ace
:
SproutCore's theme.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
runit-man
?
Download (.md)
## Description Simple [runit](http://smarden.org/runit/ "runit home page") web management tool with internationalization support. Server will run by **runit-man** script. Take a note that **runit-man** must have privileges like **runsvdir** process ones. ## Screenshot  ## Installation ### Opscode Chef We provide [runit-man cookbook](https://github.com/Undev/runit-man-cookbook) to automate setup of runit-man using [Opscode Chef](http://www.opscode.com/chef/). ### Manual installation Usually You should install both **runit-man** and **thin** gems to run this tool fine. ```bash gem install runit-man thin ``` Pragmatic approach is to setup runit-man as runit service like this: ```bash runit-man -p 14500 -r ``` This command installs runit-man as runit service (using default folders `/etc/sv/` and `/etc/service/`). Look at {file:INSTALL.md} for details. ### rackup configuration Take a note that runit-man gem also provides config.ru rackup configuration file. It's useful for running under unicorn/rainbows etc. `runit-man --rackup=command` option does `cd config.ru directory && set environment && exec command`. ## Customization This tool can provide additional information or actions through it's Web page. ### View names and content of files that related to concrete service For each known runit service this tool looks for `./runit-man/files-to-view/` folder. Every symlink there will be shown as link to view target file content. ### Show links that related to concrete service For each known runit service this tool looks for `./runit-man/urls-to-view/` folder. Every file ended with .url will be shown as link to view target location (location should be written as content of this file). ### Indicate services with any of watched files are modified since service startup For each known runit service this tool looks for `./runit-man/files-to-watch/` folder. Symlink targets there will be tested for its mtime to be less than service start time. Service will be indicated as dangerous (as red color) to restart if any watched file is modified since service startup. ### Show buttons that send signals to concrete service For each known runit service this tool looks for `./runit-man/allowed-signals/` folder. Each one-letter-named file declares that signal button should be shown in Web UI. Signal letters listed below in REST API section. ## REST API ### Get state You can read current state of services in [JSON format](http://www.json.org/ "JSON home page") using `GET /services.json` ### Management You can manage your services using `POST /<service name>/<command>` Supported commands: *up*, *down*, *restart*, *switch_up* (activates service), *switch_down* (deactivates service). You can also send any signal to service using `POST /<service name>/signal/<signal>` Supported signals and their's meaning: | Signal | Meaning | | -------- | ------ | | t | TERM | | k | KILL | | i | INT | | 1 | USR1 | | 2 | USR2 | | a | ALARM | | q | QUIT | | x | EXIT | | p | PAUSE | | c | CONT | | h | HUP | | o | ONCE | ### Read logs #### svlogd You can read tail of service log using `GET /<service name>/log/<count of tailing lines>.txt` Note that to use this feature You must do logging using ```bash exec svlogd <options> $LOG_DIRECTORY_LOCATION ``` #### logger Use logger like: ```bash exec logger -i -t "runit-man" -p local1.info ``` and use option `-l "logger:/var/log/"` where base logs directory shown after period. ## Localization Localization can be done by editing of `./i18n/*.yml` locale files. Contributions are welcome. ## Development Runit-man provides a useful Vagrant file. To have a complete development environment: * Grab [Vagrant](http://vagrantup.com/) and [Oracle VirtualBox](http://virtualbox.org/). * Checkout submodules: `git submodule update --init`. * Setup Vagrant box: `vagrant up`. Now you have an Ubuntu 12.04 system with runit and runit-man running inside your Vagrant box ## Links * [runit home page](http://smarden.org/runit/) * [runit-man home page](https://github.com/akzhan/runit-man)
