<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Language" content="en-us" />
<meta name="ROBOTS" content="ALL" />
<meta http-equiv="imagetoolbar" content="no" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="Keywords" content="cherokee web server httpd http" />
<meta name="Description" content="Cherokee is a flexible, very fast, lightweight Web server. It is implemented entirely in C, and has no dependencies beyond a standard C library. It is embeddable and extensible with plug-ins. It supports on-the-fly configuration by reading files or strings, TLS/SSL (via GNUTLS or OpenSSL), virtual hosts, authentication, cache friendly features, PHP, custom error management, and much more." />
<link href="media/css/cherokee_doc.css" rel="stylesheet" type="text/css" media="all" />
</head>
<body>
<h2 id="_a_href_index_html_index_a_8594_a_href_other_html_other_information_a_8594_a_href_other_bundle_html_man_pages_a"><a href="index.html">Index</a> → <a href="other.html">Other information</a> → <a href="other_bundle.html">Man pages</a></h2>
<div class="sectionbody">
</div>
<h2 id="_man_pages_cherokee_tweak">Man pages: cherokee-tweak</h2>
<div class="sectionbody">
<div class="paragraph"><p>This command-line tool is also not as well known as it would. Again
this is not by lack of merits, which in fact are considerable. Its
intended audience are also system administrators and developers.</p></div>
<div class="paragraph"><p><tt>cherokee-tweak</tt> is a swiss army knife that allows to perform several
administrative tasks from the command line. It can connect to a
running Cherokee instance, be it in the local computer or at a remote
location, and request it to perform several actions.</p></div>
<div class="paragraph"><p>These actions are:</p></div>
<div class="ulist"><ul>
<li>
<p>
Log rotation: <tt>logrotate</tt>.
</p>
</li>
<li>
<p>
Live tracing: <tt>trace</tt>.
</p>
</li>
<li>
<p>
Provide information: <tt>info</tt>.
</p>
</li>
</ul></div>
<div class="paragraph"><p>This is the full information provided by the manpage.</p></div>
<div class="sidebarblock">
<div class="sidebar-content">
<div class="dlist"><dl>
<dt class="hdlist1">
<strong>NAME</strong>
</dt>
<dd>
<p>
cherokee-tweak - Command-line interface to the Cherokee administrative
interface
</p>
</dd>
<dt class="hdlist1">
<strong>SYNOPSIS</strong>
</dt>
<dd>
<p>
cherokee-tweak -c command -a url [options]
</p>
</dd>
<dt class="hdlist1">
<strong>DESCRIPTION</strong>
</dt>
<dd>
<p>
cherokee-tweak connects to running cherokee instance, either local or
remote, and requests it to perform one of several actions.
</p>
</dd>
<dt class="hdlist1">
<strong>OPTIONS</strong>
</dt>
<dd>
<p>
cherokee-tweak accepts the following options:
</p>
<div class="dlist"><dl>
<dt class="hdlist1">
-h, --help
</dt>
<dd>
<p>
Shows brief usage information
</p>
</dd>
<dt class="hdlist1">
-V, --version
</dt>
<dd>
<p>
Prints version and exits
</p>
</dd>
<dt class="hdlist1">
-u, --user= STRING
</dt>
<dd>
<p>
Specifies the user name with which to identify to the server
</p>
</dd>
<dt class="hdlist1">
-p, --password=STRING
</dt>
<dd>
<p>
Specifies the password with which to identify to the server
</p>
</dd>
<dt class="hdlist1">
-c, --command=STRING
</dt>
<dd>
<p>
Required option. Command to execute: logrotate, trace or info
</p>
</dd>
<dt class="hdlist1">
-a, --url=URL
</dt>
<dd>
<p>
Required option. URL where the administrative interface
can be found. This target must be defined previously
in cherokee- admin, enabling a "Remote Administration"
type handler (Virtual Servers→Behavior→Rule
Management→Add new rule, and then Handler→"Remote
Administration"). The definition of a security
mechanism is highly encouraged.
</p>
</dd>
<dt class="hdlist1">
-l, --log=PATH
</dt>
<dd>
<p>
Log file to be rotated (Only to be used when -c is logrotate)
</p>
</dd>
<dt class="hdlist1">
-t, --trace=STRING
</dt>
<dd>
<p>
Modules to be traced (Only to be used when -c is trace). Chero‐
kee must have been compiled with the --enable-trace for this to
work. Everything traceable with CHEROKEE_TRACE can also be
traced this way.
</p>
</dd>
</dl></div>
</dd>
</dl></div>
</div></div>
<div class="paragraph"><p>To use <tt>cherokee-tweak</tt>, an administrative interface must be defined
within <a href="other_bundle_cherokee-admin.html">cherokee-admin</a>. That is, you
must define a path managed by the handler <tt>Remote
Administration</tt>. This can be done through the <em>Virtual Servers</em> option,
in <em>Behavior</em> and using the <em>Add new rule</em> option.</p></div>
<div class="imageblock">
<div class="content">
<img src="media/images/admin_handler_admin.png" alt="media/images/admin_handler_admin.png" />
</div>
</div>
<div class="paragraph"><p>Please note that while you are at it, the definition of a security
(through the <em>Security</em> tab) is highly encouraged. Although you have
the choice to, you should never use <em>None</em> as security mechanism
since this would leave your system exposed to third parties using
<tt>cherokee-tweak</tt>.</p></div>
<div class="paragraph"><p>Also note that the usage of the <tt>trace</tt> command has no effect unless
Cherokee is compiled with the <tt>--enable-trace</tt>. This is a debugging
option and it is unlikely to be present in binary version of Cherokee
not specifically compiled with this in mind.</p></div>
<div class="paragraph"><p>Every module traceable with CHEROKEE_TRACE can also be traced this
way. Refer to the <a href="dev_debug.html">"Debugging"</a> section of the
documentation for more information on this matter.</p></div>
<div class="paragraph"><p>Keep in mind one important thing: when the <tt>-t</tt> option is specified,
<tt>cherokee-tweak</tt> activates the tracing functionality within the
<tt>cherokee</tt> instance. It does not provide tracing of its own. This
means the debugging information will appear in the machine that is
actually running the <tt>cherokee</tt> instance. This may or may not be the
same that is running the <tt>cherokee-tweak</tt> process.</p></div>
</div>
<div id="footer">
<div id="footer-text">
</div>
</div>
</body>
</html>
distrib
>
Mandriva
>
2010.1
>
i586
>
media
>
contrib-updates
>
by-pkgid
>
02e45b2cd6a4a47c88f15dd2f64cf46c
>
files
>
911
