NAME
chef-server - Start the Chef Server merb application slice.
SYNOPSIS
chef-server [uGdcIpPhmailLerkKX] [argument]
DESCRIPTION
The Chef Server is a Merb application slice. Both chef-server and chef-
server-slice packages should be installed. This man page was generated
for merb and generated for chef-server. The default listen port is
4000. At a minimum, chef-server should be started with -c2 so one
process starts for the webui (4000) and one process starts for openid
(4001).
-u, --user USER
This flag is for having chef-server run as a user other than the
one currently logged in. Note: if you set this you must also
provide a --group option for it to take effect.
-G, --group GROUP
This flag is for having chef-server run as a group other than
the one currently logged in. Note: if you set this you must also
provide a --user option for it to take effect.
-d, --daemonize
This will run a single chef-server in the background.
-N, --no-daemonize
This will allow you to run a cluster in console mode
-c, --cluster-nodes NUM_MERBS
Number of merb daemons to run for chef-server. At least 2 are
required to run, the second is for openid (runs on port 4001).
-I, --init-file FILE
File to use for initialization on load, defaults to
config/init.rb
-p, --port PORTNUM
Port to run chef-server on, defaults to 4000. Additional nodes
(-c) listen on incrementing port numbers.
-o, --socket-file FILE
Socket file to run chef-server on, defaults to
[Merb.root]/log/merb.sock. This is for web servers, like thin,
that use sockets.Specify this *only* if you *must*.
-s, --socket SOCKNUM
Socket number to run chef-server on, defaults to 0.
-n, --name NAME
Set the name of the application. This is used in the process
title and log file names.
-P, --pid 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 should place the port number. For instance: -P
myapp.%s.pid
-h, --host HOSTNAME
Host to bind to (default is 0.0.0.0).
-m, --merb-root /path/to/approot The path to the Merb.root for the app
you want to run (default is current working directory).
-a, --adapter ADAPTER
The rack adapter to use to run chef-server (default is
mongrel)[mongrel, emongrel, thin, ebb, fastcgi, webrick]
-R, --rackup FILE
Load an alternate Rack config file (default is config/rack.rb)
-i, --irb-console
This flag will start chef-server in irb console mode. All your
models and other classes will be available for you in an irb
session.
-S, --sandbox
This flag will enable a sandboxed irb console. If your ORM
supports transactions, all edits will be rolled back on exit.
-l, --log-level LEVEL
Log levels can be set to any of these options: debug < info <
warn < error < fatal (default is info)
-L, --log 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
-e, --environment STRING
Environment to run Merb under [development, production, testing]
(default is development)
-r [’RUBY CODE’| FULL_SCRIPT_PATH]
--script-runner
Command-line option to run scripts and/or code in the chef-
server app.
-K, --graceful PORT or all
Gracefully kill chef-server proceses by port number. Use chef-
server -K all to gracefully kill all merbs.
-k, --kill PORT
Force kill one merb worker by port number. This will cause the
worker tobe respawned.
--fast-deploy
Reload the code, but not yourinit.rb or gems
-X, --mutex on/off
This flag is for turning the mutex lock on and off.
-D, --debugger
Run chef-server using rDebug.
-V, --verbose
Print extra information
-C, --console-trap
Enter an irb console on ^C
-?, -H, --help
Show this help message
SEE ALSO
Full documentation for Chef and chef-server is located on the Chef
wiki, http://wiki.opscode.com/display/chef/Home.
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.