<!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"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>7.1. Server packages — groonga v3.0.5 documentation</title> <link rel="stylesheet" href="../_static/groonga.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '3.0.5', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <link rel="shortcut icon" href="../_static/favicon.ico"/> <link rel="top" title="groonga v3.0.5 documentation" href="../index.html" /> <link rel="up" title="7. Server" href="../server.html" /> <link rel="next" title="7.2. GQTP" href="gqtp.html" /> <link rel="prev" title="7. Server" href="../server.html" /> </head> <body> <div class="header"> <h1 class="title"> <a id="top-link" href="../index.html"> <span class="project">groonga</span> <span class="separator">-</span> <span class="description">An open-source fulltext search engine and column store.</span> </a> </h1> <div class="other-language-links"> <ul> <li><a href="../../../ja/html/server/package.html"><img src="../_static/jp.png" alt="日本語">日本語版はこちら</a></li> </ul> </div> </div> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > <a href="gqtp.html" title="7.2. GQTP" accesskey="N">next</a> |</li> <li class="right" > <a href="../server.html" title="7. Server" accesskey="P">previous</a> |</li> <li><a href="../index.html">groonga v3.0.5 documentation</a> »</li> <li><a href="../server.html" accesskey="U">7. Server</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <div class="section" id="server-packages"> <h1>7.1. Server packages<a class="headerlink" href="#server-packages" title="Permalink to this headline">¶</a></h1> <p>The package <tt class="docutils literal"><span class="pre">groonga</span></tt> is the mininum set of fulltext search engine. If you want to use groonga for server use, you can install additional preconfigured packages.</p> <p>There are three packages for server use.</p> <ul class="simple"> <li><tt class="docutils literal"><span class="pre">groonga-httpd</span></tt> (nginx and HTTP protocol based server package)</li> <li><tt class="docutils literal"><span class="pre">groonga-server-http</span></tt> (simple HTTP protocol based server package)</li> <li><tt class="docutils literal"><span class="pre">groonga-server-gqtp</span></tt> (GQTP protocol based server package)</li> </ul> <p>Note that there is a conflict between <tt class="docutils literal"><span class="pre">groonga-httpd</span></tt> and <tt class="docutils literal"><span class="pre">groonga-server-http</span></tt> package because of port number. See <a class="reference internal" href="http/comparison.html"><em>Comparison</em></a> if you want to know which package meets your demands.</p> <div class="section" id="groonga-httpd"> <h2>7.1.1. groonga-httpd<a class="headerlink" href="#groonga-httpd" title="Permalink to this headline">¶</a></h2> <p><tt class="docutils literal"><span class="pre">groonga-httpd</span></tt> is a nginx and HTTP protocol based server package.</p> <p>Preconfigured setting:</p> <table border="1" class="docutils"> <colgroup> <col width="34%" /> <col width="66%" /> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">Item</th> <th class="head">Default value</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>Port number</td> <td>10041</td> </tr> <tr class="row-odd"><td>Access log path</td> <td>/var/log/groonga/httpd/acccess.log</td> </tr> <tr class="row-even"><td>Error log path</td> <td>/var/log/groonga/http-query.log</td> </tr> <tr class="row-odd"><td>Database</td> <td>/var/lib/groonga/db/*</td> </tr> <tr class="row-even"><td>Configuration file</td> <td>/etc/groonga/httpd/groonga-httpd.conf</td> </tr> </tbody> </table> <div class="section" id="start-http-server"> <h3>7.1.1.1. Start HTTP server<a class="headerlink" href="#start-http-server" title="Permalink to this headline">¶</a></h3> <p>Starting groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-httpd start </pre></div> </div> <p>Starting groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl start groonga-httpd </pre></div> </div> </div> <div class="section" id="stop-http-server"> <h3>7.1.1.2. Stop HTTP server<a class="headerlink" href="#stop-http-server" title="Permalink to this headline">¶</a></h3> <p>Stopping groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-httpd stop </pre></div> </div> <p>Starting groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl stop groonga-httpd </pre></div> </div> </div> <div class="section" id="restart-http-server"> <h3>7.1.1.3. Restart HTTP server<a class="headerlink" href="#restart-http-server" title="Permalink to this headline">¶</a></h3> <p>Restarting groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-httpd restart </pre></div> </div> <p>Restarting groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl restart groonga-httpd </pre></div> </div> </div> </div> <div class="section" id="groonga-server-http"> <h2>7.1.2. groonga-server-http<a class="headerlink" href="#groonga-server-http" title="Permalink to this headline">¶</a></h2> <p><tt class="docutils literal"><span class="pre">groonga-server-http</span></tt> is a simple HTTP protocol based server package.</p> <p>Preconfigured setting:</p> <table border="1" class="docutils"> <colgroup> <col width="34%" /> <col width="66%" /> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">Item</th> <th class="head">Default value</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>Port number</td> <td>10041</td> </tr> <tr class="row-odd"><td><a class="reference internal" href="../reference/log.html#process-log"><em>Process log</em></a></td> <td>/var/log/groonga/groonga-http.log</td> </tr> <tr class="row-even"><td><a class="reference internal" href="../reference/log.html#query-log"><em>Query log</em></a></td> <td>/var/log/groonga/http-query.log</td> </tr> <tr class="row-odd"><td>Database</td> <td>/var/lib/groonga/db/*</td> </tr> </tbody> </table> <p>Configuration file for server setting (Debian/Ubuntu):</p> <div class="highlight-none"><div class="highlight"><pre>/etc/default/groonga/groonga-server-http </pre></div> </div> <p>Configuration file for server setting (CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>/etc/sysconfig/groonga-server-http </pre></div> </div> <div class="section" id="id1"> <h3>7.1.2.1. Start HTTP server<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3> <p>Starting groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-server-http start </pre></div> </div> <p>Starting groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl start groonga-server-http </pre></div> </div> </div> <div class="section" id="id2"> <h3>7.1.2.2. Stop HTTP server<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3> <p>Stopping groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-server-http stop </pre></div> </div> <p>Stopping groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl stop groonga-server-http </pre></div> </div> </div> <div class="section" id="id3"> <h3>7.1.2.3. Restart HTTP server<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3> <p>Restarting groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-server-http restart </pre></div> </div> <p>Restarting groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl restart groonga-server-http </pre></div> </div> </div> </div> <div class="section" id="groonga-server-gqtp"> <h2>7.1.3. groonga-server-gqtp<a class="headerlink" href="#groonga-server-gqtp" title="Permalink to this headline">¶</a></h2> <p><tt class="docutils literal"><span class="pre">groonga-server-gqtp</span></tt> is a GQTP protocol based server package.</p> <table border="1" class="docutils"> <colgroup> <col width="34%" /> <col width="66%" /> </colgroup> <thead valign="bottom"> <tr class="row-odd"><th class="head">Item</th> <th class="head">Default value</th> </tr> </thead> <tbody valign="top"> <tr class="row-even"><td>Port number</td> <td>10043</td> </tr> <tr class="row-odd"><td><a class="reference internal" href="../reference/log.html#process-log"><em>Process log</em></a></td> <td>/var/log/groonga/groonga-gqtp.log</td> </tr> <tr class="row-even"><td><a class="reference internal" href="../reference/log.html#query-log"><em>Query log</em></a></td> <td>/var/log/groonga/gqtp-query.log</td> </tr> <tr class="row-odd"><td>Database</td> <td>/var/lib/groonga/db/*</td> </tr> </tbody> </table> <p>Configuration file for server setting (Debian/Ubuntu):</p> <div class="highlight-none"><div class="highlight"><pre>/etc/default/groonga/groonga-server-gqtp </pre></div> </div> <p>Configuration file for server setting (CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>/etc/sysconfig/groonga-server-gqtp </pre></div> </div> <div class="section" id="start-gqtp-server"> <h3>7.1.3.1. Start GQTP server<a class="headerlink" href="#start-gqtp-server" title="Permalink to this headline">¶</a></h3> <p>Starting groonga GQTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-server-gqtp start </pre></div> </div> <p>Starting groonga GQTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl start groonga-server-gqtp </pre></div> </div> </div> <div class="section" id="stop-gqtp-server"> <h3>7.1.3.2. Stop GQTP server<a class="headerlink" href="#stop-gqtp-server" title="Permalink to this headline">¶</a></h3> <p>Stopping groonga GQTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-server-http stop </pre></div> </div> <p>Stopping groonga GQTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl stop groonga-server-gqtp </pre></div> </div> </div> <div class="section" id="restart-gqtp-server"> <h3>7.1.3.3. Restart GQTP server<a class="headerlink" href="#restart-gqtp-server" title="Permalink to this headline">¶</a></h3> <p>Restarting groonga HTTP server(Debian/Ubuntu/CentOS):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo service groonga-server-gqtp restart </pre></div> </div> <p>Restarting groonga HTTP server(Fedora):</p> <div class="highlight-none"><div class="highlight"><pre>% sudo systemctl restart groonga-server-gqtp </pre></div> </div> </div> </div> </div> </div> </div> </div> <div class="sphinxsidebar"> <div class="sphinxsidebarwrapper"> <h3><a href="../index.html">Table Of Contents</a></h3> <ul> <li><a class="reference internal" href="#">7.1. Server packages</a><ul> <li><a class="reference internal" href="#groonga-httpd">7.1.1. groonga-httpd</a><ul> <li><a class="reference internal" href="#start-http-server">7.1.1.1. Start HTTP server</a></li> <li><a class="reference internal" href="#stop-http-server">7.1.1.2. Stop HTTP server</a></li> <li><a class="reference internal" href="#restart-http-server">7.1.1.3. Restart HTTP server</a></li> </ul> </li> <li><a class="reference internal" href="#groonga-server-http">7.1.2. groonga-server-http</a><ul> <li><a class="reference internal" href="#id1">7.1.2.1. Start HTTP server</a></li> <li><a class="reference internal" href="#id2">7.1.2.2. Stop HTTP server</a></li> <li><a class="reference internal" href="#id3">7.1.2.3. Restart HTTP server</a></li> </ul> </li> <li><a class="reference internal" href="#groonga-server-gqtp">7.1.3. groonga-server-gqtp</a><ul> <li><a class="reference internal" href="#start-gqtp-server">7.1.3.1. Start GQTP server</a></li> <li><a class="reference internal" href="#stop-gqtp-server">7.1.3.2. Stop GQTP server</a></li> <li><a class="reference internal" href="#restart-gqtp-server">7.1.3.3. Restart GQTP server</a></li> </ul> </li> </ul> </li> </ul> <h4>Previous topic</h4> <p class="topless"><a href="../server.html" title="previous chapter">7. Server</a></p> <h4>Next topic</h4> <p class="topless"><a href="gqtp.html" title="next chapter">7.2. GQTP</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="../_sources/server/package.txt" rel="nofollow">Show Source</a></li> </ul> <div id="searchbox" style="display: none"> <h3>Quick search</h3> <form class="search" action="../search.html" method="get"> <input type="text" name="q" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> <p class="searchtip" style="font-size: 90%"> Enter search terms or a module, class or function name. </p> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../genindex.html" title="General Index" >index</a></li> <li class="right" > <a href="gqtp.html" title="7.2. GQTP" >next</a> |</li> <li class="right" > <a href="../server.html" title="7. Server" >previous</a> |</li> <li><a href="../index.html">groonga v3.0.5 documentation</a> »</li> <li><a href="../server.html" >7. Server</a> »</li> </ul> </div> <div class="footer"> © Copyright 2009-2013, Brazil, Inc. </div> </body> </html>