-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathREADME
38 lines (28 loc) · 2.25 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
merb-manage: a tool for controlling and configuring Merb applications
Usage:
merb-manage-ctl [start|stop|restart] (-c CONFIG_DIR)
start: starts any instances of Merb applications configured within the CONFIG_DIR (defaults to /etc/merb-manage)
stop: stops any instances of Merb applications configured within the CONFIG_DIR
restart: stops, then starts any instances of Merb applications configured within the CONFIG_DIR
merb-manage [start|stop|restart]
this script can be used as a startup script, for example within /etc/init.d, to call out to merb-manage-ctl to start Merb applications when a server starts
Configuration:
YAML configuration files define the Merb application settings for merb-manage. Generally you can store the configuration within the config directory of your Merb application (config/merb-manage.yml), and then symlink this to a file within the configuration directory (/etc/merb-manage/myapp.yml).
Configuration might look like the following:
path: /var/www/sample_app
adapter: thin
environment: production
port: 5000
servers: 3
user: www-data
group: www-data
logging: info
Here are the supported parameters:
user: the user that the application should run as - if specified, the Merb application is started with an su USER -c "COMMAND", and the user is passed through to the Merb startup command
group: the group that the application runs under, passed through to the Merb startup command
adapter: the web application server adapter, such as mongrel, thin etc - anything that your installation of Merb supports
environment: the Merb environment to run as, development, test or production
servers: the amount of servers to start (for clustering/load balancing etc)
port: the port to start the Merb application on (in the case of multiple servers, the ports will be sequential from the port specified, i.e. servers set to 3, with port set to 5000, would start the application on 5000, 5001 and 5002)
logging: the logging level to pass through to Merb - debug, info, warn, error and fatal
Most of these options can be left off if you simply want the Merb defaults - if "servers" isn't specified however, then Merb will be passed the "-d" flag to ensure that the single Merb server will run in daemonized mode.