Author: buildbot
Date: Tue Jun 25 00:22:01 2013
New Revision: 867300
Log:
Staging update by buildbot for trafficserver
Modified:
websites/staging/trafficserver/trunk/cgi-bin/ (props changed)
websites/staging/trafficserver/trunk/content/ (props changed)
websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html
Propchange: websites/staging/trafficserver/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Jun 25 00:22:01 2013
@@ -1 +1 @@
-1496303
+1496304
Propchange: websites/staging/trafficserver/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Jun 25 00:22:01 2013
@@ -1 +1 @@
-1496303
+1496304
Modified:
websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html
==============================================================================
---
websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html
(original)
+++
websites/staging/trafficserver/trunk/content/docs/trunk/admin/getting-started/index.en.html
Tue Jun 25 00:22:01 2013
@@ -113,63 +113,54 @@ that you can also use to submit pull req
<li>automake</li>
</ul>
<p>We will show-case a build from git:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="n">git</span> <span class="n">clone</span> <span
class="n">https</span><span class="p">:</span><span class="o">//</span><span
class="n">git</span><span class="o">-</span><span class="n">wip</span><span
class="o">-</span><span class="n">us</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="o">/</span><span class="n">repos</span><span class="o">/</span><span
class="n">asf</span><span class="o">/</span><span
class="n">trafficserver</span><span class="p">.</span><span class="n">git</span>
+<div class="codehilite"><pre><span class="n">git</span> <span
class="n">clone</span> <span class="n">https</span><span
class="p">:</span><span class="o">//</span><span class="n">git</span><span
class="o">-</span><span class="n">wip</span><span class="o">-</span><span
class="n">us</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">org</span><span class="o">/</span><span
class="n">repos</span><span class="o">/</span><span class="n">asf</span><span
class="o">/</span><span class="n">trafficserver</span><span
class="p">.</span><span class="n">git</span>
</pre></div>
<p>Next, we <code>cd trafficserver</code> and run:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="n">autoreconf</span> <span class="o">-</span><span
class="k">if</span>
+<div class="codehilite"><pre><span class="n">autoreconf</span> <span
class="o">-</span><span class="k">if</span>
</pre></div>
<p>This will generate a <code>configure</code> file from
<code>configure.ac</code>, so now we can run that:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="o">./</span><span class="n">configure</span> <span
class="o">--</span><span class="n">prefix</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">ats</span>
+<div class="codehilite"><pre><span class="o">./</span><span
class="n">configure</span> <span class="o">--</span><span
class="n">prefix</span><span class="p">=</span><span class="o">/</span><span
class="n">opt</span><span class="o">/</span><span class="n">ats</span>
</pre></div>
<p>Note well, that by default Traffic Server uses the user
<code>nobody</code>, as well as user's
primary group as Traffic Server user. If you want to change that, you can
override it here:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="o">./</span><span class="n">configure</span> <span
class="o">--</span><span class="n">prefix</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">ats</span> <span class="o">--</span><span class="n">with</span><span
class="o">-</span><span class="n">user</span><span class="p">=</span><span
class="n">tserver</span>
+<div class="codehilite"><pre><span class="o">./</span><span
class="n">configure</span> <span class="o">--</span><span
class="n">prefix</span><span class="p">=</span><span class="o">/</span><span
class="n">opt</span><span class="o">/</span><span class="n">ats</span> <span
class="o">--</span><span class="n">with</span><span class="o">-</span><span
class="n">user</span><span class="p">=</span><span class="n">tserver</span>
</pre></div>
<p>If dependencies are not in standard paths (<code>/usr/local</code> or
<code>/usr</code>), you need to pass options
to <code>configure</code> to account for that:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="o">./</span><span class="n">configure</span> <span
class="o">--</span><span class="n">prefix</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">ats</span> <span class="o">--</span><span class="n">with</span><span
class="o">-</span><span class="n">user</span><span class="p">=</span><span
class="n">tserver</span> <span class="o">--</span><span
class="n">with</span><span class="o">-</span><span class="n">lua</span><span
class="p">=</span><span class="o">/</span><span class="n">opt</span><span
class="o">/</span><span class="n">csw</span>
+<div class="codehilite"><pre><span class="o">./</span><span
class="n">configure</span> <span class="o">--</span><span
class="n">prefix</span><span class="p">=</span><span class="o">/</span><span
class="n">opt</span><span class="o">/</span><span class="n">ats</span> <span
class="o">--</span><span class="n">with</span><span class="o">-</span><span
class="n">user</span><span class="p">=</span><span class="n">tserver</span>
<span class="o">--</span><span class="n">with</span><span
class="o">-</span><span class="n">lua</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">csw</span>
</pre></div>
<p>Most <code>configure</code> path-options accept a format of
<code>"INCLUDE_PATH:LIBRARY_PATH"</code>:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="o">./</span><span class="n">configure</span> <span
class="o">--</span><span class="n">prefix</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">ats</span> <span class="o">--</span><span class="n">with</span><span
class="o">-</span><span class="n">user</span><span class="p">=</span><span
class="n">tserver</span> <span class="o">--</span><span
class="n">with</span><span class="o">-</span><span class="n">lua</span><span
class="p">=</span><span class="o">/</span><span class="n">opt</span><span
class="o">/</span><span class="n">csw</span> <span class="o">\</span>
+<div class="codehilite"><pre><span class="o">./</span><span
class="n">configure</span> <span class="o">--</span><span
class="n">prefix</span><span class="p">=</span><span class="o">/</span><span
class="n">opt</span><span class="o">/</span><span class="n">ats</span> <span
class="o">--</span><span class="n">with</span><span class="o">-</span><span
class="n">user</span><span class="p">=</span><span class="n">tserver</span>
<span class="o">--</span><span class="n">with</span><span
class="o">-</span><span class="n">lua</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">csw</span> <span class="o">\</span>
<span class="o">--</span><span class="n">with</span><span
class="o">-</span><span class="n">pcre</span><span class="p">=</span><span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">csw</span><span class="o">/</span><span class="n">include</span><span
class="p">:</span><span class="o">/</span><span class="n">opt</span><span
class="o">/</span><span class="n">csw</span><span class="o">/</span><span
class="n">lib</span><span class="o">/</span><span class="n">amd64</span>
</pre></div>
<p>We can run <code>make</code> to build the project. We highly recommend to
run <code>make check</code>
to verify the build's general sanity:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="n">make</span>
- <span class="n">make</span> <span class="n">check</span>
+<div class="codehilite"><pre><span class="n">make</span>
+<span class="n">make</span> <span class="n">check</span>
</pre></div>
<p>We can finally run <code>make install</code> to install (you may have to
switch to root to do this):</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="n">sudo</span> <span class="n">make</span> <span
class="n">install</span>
+<div class="codehilite"><pre><span class="n">sudo</span> <span
class="n">make</span> <span class="n">install</span>
</pre></div>
<p>We also recommend to run a regression test. Please note that this will only
work
successfully with the default <code>layout</code>:</p>
-<div class="codehilite"><pre> <span class="p">:::</span><span
class="n">text</span>
- <span class="n">cd</span> <span class="o">/</span><span
class="n">opt</span><span class="o">/</span><span class="n">ats</span>
- <span class="n">sudo</span> <span class="n">bin</span><span
class="o">/</span><span class="n">traffic_server</span> <span
class="o">-</span><span class="n">R</span> 1
+<div class="codehilite"><pre><span class="n">cd</span> <span
class="o">/</span><span class="n">opt</span><span class="o">/</span><span
class="n">ats</span>
+<span class="n">sudo</span> <span class="n">bin</span><span
class="o">/</span><span class="n">traffic_server</span> <span
class="o">-</span><span class="n">R</span> 1
</pre></div>
@@ -181,7 +172,7 @@ in the attribute <code>start</code>. Thi
to process Traffic Server requests as well as manage, control, and monitor
the health of the Traffic Server system.</p>
<p>To run the <code>trafficserver start</code> command, e.g.:</p>
-<div class="codehilite"><pre> <span class="n">bin</span><span
class="o">/</span><span class="n">trafficserver</span> <span
class="n">start</span>
+<div class="codehilite"><pre><span class="n">bin</span><span
class="o">/</span><span class="n">trafficserver</span> <span
class="n">start</span>
</pre></div>
@@ -192,12 +183,12 @@ the health of the Traffic Server system.
configuring the Traffic Server system via command-line interface. To execute
individual commands or script multiple commands, refer to <a
href="../traffic-line-commands">Traffic Line Commands</a>.</p>
<p>Traffic Line commands take the following form:</p>
-<div class="codehilite"><pre> <span class="n">bin</span><span
class="o">/</span><span class="n">traffic_line</span> <span
class="o">-</span><span class="n">command</span> <span class="n">argument</span>
+<div class="codehilite"><pre><span class="n">bin</span><span
class="o">/</span><span class="n">traffic_line</span> <span
class="o">-</span><span class="n">command</span> <span class="n">argument</span>
</pre></div>
<p>For a list of <code>traffic_line</code> commands, enter:</p>
-<div class="codehilite"><pre> <span class="n">bin</span><span
class="o">/</span><span class="n">traffic_line</span> <span
class="o">-</span><span class="n">h</span>
+<div class="codehilite"><pre><span class="n">bin</span><span
class="o">/</span><span class="n">traffic_line</span> <span
class="o">-</span><span class="n">h</span>
</pre></div>