.TH CHEF-SERVER-WEBUI "1" "March 2010" "chef-server-webui" "User Commands"
.SH NAME
chef-server-webui \- Start the Chef Server merb application slice providing Web User Interface.
.SH SYNOPSIS
.B chef-server-webui
[\fIuGdcIpPhmailLerkKX\fR] [\fIargument\fR]
.SH DESCRIPTION
The Chef Server WebUI is a Merb application slice. The default listen port is 4040.
.TP
\fB\-u\fR, \fB\-\-user\fR USER
This flag is for having chef-server-webui run as a user other than the one currently logged in. Note: if you set this you must also provide a \fB\-\-group\fR option for it to take effect.
.TP
\fB\-G\fR, \fB\-\-group\fR GROUP
This flag is for having chef-server-webui run as a group other than the one currently logged in. Note: if you set this you must also provide a \fB\-\-user\fR option for it to take effect.
.TP
\fB\-d\fR, \fB\-\-daemonize\fR
This will run a single chef-server-webui in the background.
.TP
\fB\-N\fR, \fB\-\-no\-daemonize\fR
This will allow you to run a cluster in console mode
.TP
\fB\-c\fR, \fB\-\-cluster\-nodes\fR NUM_MERBS
Number of merb daemons to run for chef-server-webui.
.TP
\fB\-I\fR, \fB\-\-init\-file\fR FILE
File to use for initialization on load, defaults to config/init.rb
.TP
\fB\-p\fR, \fB\-\-port\fR PORTNUM
Port to run chef-server-webui on, defaults to 4040. Additional nodes (\-c) listen on incrementing port numbers.
.TP
\fB\-o\fR, \fB\-\-socket\-file\fR FILE
Socket file to run chef-server-webui on, defaults to [Merb.root]/log/merb.sock. This is for web servers, like thin, that use sockets.Specify this *only* if you *must*.
.TP
\fB\-s\fR, \fB\-\-socket\fR SOCKNUM
Socket number to run chef-server-webui on, defaults to 0.
.TP
\fB\-n\fR, \fB\-\-name\fR NAME
Set the name of the application. This is used in the process title and log file names.
.TP
\fB\-P\fR, \fB\-\-pid\fR PIDFILE
PID file, defaults to [Merb.root]/log/merb.main.pid for the master process and[Merb.root]/log/merb.[port number].pid for worker processes. For clusters, use %s to specify where in the file chef-server-webui should place the port number. For instance: \fB\-P\fR myapp.%s.pid
.TP
\fB\-h\fR, \fB\-\-host\fR HOSTNAME
Host to bind to (default is 0.0.0.0).
.HP
\fB\-m\fR, \fB\-\-merb\-root\fR /path/to/approot The path to the Merb.root for the app you want to run (default is current working directory).
.TP
\fB\-a\fR, \fB\-\-adapter\fR ADAPTER
The rack adapter to use to run chef-server-webui (default is mongrel)[mongrel, emongrel, thin, ebb, fastcgi, webrick]
.TP
\fB\-R\fR, \fB\-\-rackup\fR FILE
Load an alternate Rack config file (default is config/rack.rb)
.TP
\fB\-i\fR, \fB\-\-irb\-console\fR
This flag will start chef-server-webui in irb console mode. All your models and other classes will be available for you in an irb session.
.TP
\fB\-S\fR, \fB\-\-sandbox\fR
This flag will enable a sandboxed irb console. If your ORM supports transactions, all edits will be rolled back on exit.
.TP
\fB\-l\fR, \fB\-\-log\-level\fR LEVEL
Log levels can be set to any of these options: debug < info < warn < error < fatal (default is info)
.TP
\fB\-L\fR, \fB\-\-log\fR LOGFILE
A string representing the logfile to use. Defaults to [Merb.root]/log/merb.[main].log for the master process and [Merb.root]/log/merb[port number].logfor worker processes
.TP
\fB\-e\fR, \fB\-\-environment\fR STRING
Environment to run Merb under [development, production, testing] (default is development)
.HP
\fB\-r\fR ['RUBY CODE'| FULL_SCRIPT_PATH]
.TP
\fB\-\-script\-runner\fR
Command\-line option to run scripts and/or code in the chef-server-webui app.
.TP
\fB\-K\fR, \fB\-\-graceful\fR PORT or all
Gracefully kill chef-server-webui proceses by port number.  Use chef-server \fB\-K\fR all to gracefully kill all merbs.
.TP
\fB\-k\fR, \fB\-\-kill\fR PORT
Force kill one merb worker by port number. This will cause the worker tobe respawned.
.TP
\fB\-\-fast\-deploy\fR
Reload the code, but not yourinit.rb or gems
.TP
\fB\-X\fR, \fB\-\-mutex\fR on/off
This flag is for turning the mutex lock on and off.
.TP
\fB\-D\fR, \fB\-\-debugger\fR
Run chef-server-webui using rDebug.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
Print extra information
.TP
\fB\-C\fR, \fB\-\-console\-trap\fR
Enter an irb console on ^C
.TP
\-?, \fB\-H\fR, \fB\-\-help\fR
Show this help message
.SH "SEE ALSO"
Full documentation for Chef and chef-server-webui is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.
.SH AUTHOR
Chef was written by Adam Jacob <adam@ospcode.com> of Opscode (http://www.opscode.com), with contributions from the community.
This manual page was written by Joshua Timberman <joshua@opscode.com> with help2man
for the Debian project (but may be used by others).. Permission is granted
  to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.

  On Debian systems, the complete text of the Apache 2.0 License can be found in
  /usr/share/common-licenses/Apache-2.0.