You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by bu...@apache.org on 2011/03/09 01:41:30 UTC
svn commit: r786712 - in
/websites/staging/trafficserver/trunk/content/docs/trunk/admin/cluster-howto:
./ index.en.html
Author: buildbot
Date: Wed Mar 9 00:41:30 2011
New Revision: 786712
Log:
Staging update by buildbot
Added:
websites/staging/trafficserver/trunk/content/docs/trunk/admin/cluster-howto/
websites/staging/trafficserver/trunk/content/docs/trunk/admin/cluster-howto/index.en.html
Added: websites/staging/trafficserver/trunk/content/docs/trunk/admin/cluster-howto/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/cluster-howto/index.en.html (added)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/cluster-howto/index.en.html Wed Mar 9 00:41:30 2011
@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!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>
+
+ <link rel="stylesheet" href="/styles/pygments_style.css" />
+ <link rel="stylesheet" href="/styles/ts.css" />
+
+
+ <title>Traffic Server⢠</title>
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at . http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->
+ </head>
+
+ <body>
+ <div id="header" class="header">
+ <table><tr>
+ <td><a href="http://trafficserver.apache.org/"><img class="logo" alt="Apache Traffic Server" src="http://trafficserver.apache.org/images/trans_logo_350x69.png" /></a></td>
+ <td>
+
+ <span class="doc-title">Adminstrator's Guide</span><br />
+
+ <span class="title">Traffic Server⢠</span>
+ </td>
+ </tr></table>
+ </div><!-- header -->
+
+ <div class="nav">
+
+ <span class="nav"><a href="../index.en.html">Top</a></span>
+
+ <span class="nav"><a href="../security-options/index.en.html">Next</a></span>
+
+ <span class="nav"><a href="../configuring-traffic-server/index.en.html">Back</a></span>
+
+ </div>
+
+
+ <div class="main">
+
+ <div id="content">
+ <h2 id="traffic_server_cluster">Traffic Server Cluster</h2>
+<p>Traffic Server scales from a single node to multiple nodes that form a
+cluster allowing you to improve system performance and reliability. This
+chapter discusses the following topics:</p>
+<div class="toc">
+<ul>
+<li><a href="#traffic_server_cluster">Traffic Server Cluster</a><ul>
+<li><a href="#UnderstandingTSClusters">Understanding Traffic Server Clusters</a><ul>
+<li><a href="#ManagementOnlyClustering">Management-Only Clustering</a><ul>
+<li><a href="#FullClustering">Full Clustering</a></li>
+</ul>
+</li>
+<li><a href="#EnableClusteringMode">Enable Clustering Mode</a></li>
+<li><a href="#DeletingNodesFromCluster">Deleting Nodes from a Cluster</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<h3 id="UnderstandingTSClusters">Understanding Traffic Server Clusters</h3>
+<p>A Traffic Server cluster consists of multiple Traffic Server nodes. The
+nodes in a cluster share configuration information and can form a single
+logical cache. Traffic Server detects the addition and deletion of nodes in
+the cluster automatically and can detect when a node is unavailable.
+Traffic Server uses its own protocol for clustering, which is multicast for
+node location and heartbeat, but unicast for all data exchange within the
+cluster. Traffic Server has two clustering modes:</p>
+<ul>
+<li>Management-only mode; refer to Management-Only Clustering below.</li>
+<li>Full-clustering mode; refer to Full Clustering</li>
+</ul>
+<h4 id="ManagementOnlyClustering">Management-Only Clustering</h4>
+<p>In management-only clustering mode, Traffic Server cluster nodes share
+configuration information. You can administer all the nodes at the same
+time. Traffic Server uses a multicast management protocol to provide a
+single system image of your Traffic Server cluster. Information about
+cluster membership, configuration, and exceptions is shared across all
+nodes, and the <code>traffic_manager</code> process automatically propagates
+configuration changes to all the nodes.</p>
+<h4 id="FullClustering">Full Clustering</h4>
+<p>In full-clustering mode, as well as sharing configuration information, a
+Traffic Server cluster distributes its cache across its nodes into a
+single, virtual object store, rather than replicating the cache node by
+node. Traffic Server can provide an enormous aggregate cache size and can
+maximize cache hit rate by storing objects only once across the entire
+cluster.</p>
+<p>A fully clustered Traffic Server maps objects to specific nodes in the
+cluster. When a node receives a request, it checks to see if the request is
+a hit somewhere in the cluster. If the request is a hit on a different
+node, the node handling the request obtains the object from the hit node
+and serves it to the client. Traffic Server uses its own communication
+protocol to obtain an object from sibling cluster nodes.</p>
+<p>If a node fails or is shut down and removed, Traffic Server removes
+references to the missing node on all nodes in the cluster.</p>
+<p>Full clustering recommends a dedicated network interface for cluster
+communication to get better performance.</p>
+<h3 id="EnableClusteringMode">Enable Clustering Mode</h3>
+<p>Before you put a node into a Cluster, please make sure the following thing
+checked:</p>
+<ul>
+<li>you are using the samy Operation System:<ul>
+<li>Using the same distrobution, ie: RHEL 5.5</li>
+<li>Have same kernel, ie: 2.6.18-194.17.1.el5</li>
+<li>The same ARCH, ie: x86_64</li>
+</ul>
+</li>
+<li>install with the same version of Traffic Server</li>
+<li>the same hardware</li>
+<li>on the same switch or same vlan.</li>
+</ul>
+<p>Traffic Server does not apply the clustering mode change to all the nodes
+in the cluster. You must change the clustering mode on each node
+individually. You may following these instructions:</p>
+<ol>
+<li>
+<p>setup the same cluster name, or proxy name(let us name it MyCluster):</p>
+<div class="codehilite"><pre><span class="n">traffic_line</span> <span class="o">-</span><span class="n">s</span> <span class="n">proxy</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">proxy_name</span> <span class="o">-</span><span class="n">v</span> <span class="n">MyCluster</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>enable cluster mode:</p>
+<div class="codehilite"><pre><span class="n">traffic_line</span> <span class="o">-</span><span class="n">s</span> <span class="n">proxy</span><span class="o">.</span><span class="nb">local</span><span class="o">.</span><span class="n">cluster</span><span class="o">.</span><span class="n">type</span> <span class="o">-</span><span class="n">v</span> <span class="mi">1</span>
+</pre></div>
+
+
+<p><strong>Config Variable Description:</strong>
+ <em>proxy.local.cluster.type</em>
+ 1 for full-clustering mode.
+ 2 for management-only mode.
+ 3 for no clustering.</p>
+</li>
+<li>
+<p>enable:</p>
+<p>traffic_line -x</p>
+</li>
+</ol>
+<p>Traffic Server will join into the Cluster in about 10 seconds, you man run
+<code>traffic_line -r proxy.process.cluster.nodes</code> to check the hosts in cluster
+or checkout the cluster.config in config dir.</p>
+<p>after the success join of the cluster, all changes of global config on any
+node, will take effect on this node now.</p>
+<h3 id="DeletingNodesFromCluster">Deleting Nodes from a Cluster</h3>
+<p>To delete a node from the Traffic Server cluster, just roll back
+<code>proxy.config.cluster.type</code> to the default value 3 and reload.</p>
+ </div>
+ </div><!-- main -->
+
+ <div id="footer">
+ Copyright © 2010
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ Licensed under
+ the <a href="http://www.apache.org/licenses/">Apache License</a>,
+ Version 2.0. Apache Traffic Server, Apache,
+ the Apache Traffic Server logo, and the Apache feather logo are
+ trademarks of The Apache Software Foundation.
+ <span id="apache_logo">
+ <a href="http://www.apache.org/"><img alt="The Apache Software Foundation" src="http://www.apache.org/images/feather-small.gif" /></a>
+ </span>
+ </div>
+
+ </body>
+</html>