You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by so...@apache.org on 2015/06/12 04:22:57 UTC
[1/2] trafficserver git commit: TS-436: Added documentation for
hardware sector size support
Repository: trafficserver
Updated Branches:
refs/heads/master 4a8ce3403 -> 5eaea5104
TS-436: Added documentation for hardware sector size support
Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/620e61dc
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/620e61dc
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/620e61dc
Branch: refs/heads/master
Commit: 620e61dc44e08a8ee0cbc08a0b2c668f4ad63d13
Parents: 4a8ce34
Author: Crystal Qian <cr...@cable.comcast.net>
Authored: Thu Jun 11 11:12:00 2015 -0600
Committer: Phil Sorber <so...@apache.org>
Committed: Thu Jun 11 20:16:43 2015 -0600
----------------------------------------------------------------------
doc/reference/configuration/records.config.en.rst | 14 ++++++++++++--
1 file changed, 12 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/620e61dc/doc/reference/configuration/records.config.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/configuration/records.config.en.rst b/doc/reference/configuration/records.config.en.rst
index 3d7f74f..bf34a43 100644
--- a/doc/reference/configuration/records.config.en.rst
+++ b/doc/reference/configuration/records.config.en.rst
@@ -1276,10 +1276,20 @@ Cache Control
usable. See :ref:`Reducing Origin Server Requests
<http-proxy-caching.en.html#reducing-origin-server-requests-avoiding-the-thundering-herd>`.
-.. ts:cv:: CONFIG proxy.config.cache.force_sector_size INT 0
+.. ts:cv:: CONFIG proxy.config.cache.force_sector_size INT 4096
:reloadable:
- Forces the use of a specific hardware sector size (512 - 8192 bytes).
+ Forces the use of a specific hardware sector size, 4096, for all disks.
+
+ SSDs and "advanced format” drives claim a sector size of 512; however, it is safe to force a higher size than the hardware supports natively as we count atomicity in 512 byte increments.
+
+ 4096-sized drives formatted for Windows will have partitions aligned on 63 512-byte sector boundaries, so they will be unaligned. There are workarounds, but you need to do some research on your particular drive. Some drives have a one-time option to switch the partition boundary, while others might require reformatting or repartitioning.
+
+ To be safe in Linux, you could just use the entire drive: ``/dev/sdb`` instead of ``/dev/sdb1`` and Traffic Server will do the right thing. Misaligned partitions on Linux are auto-detected.
+
+ For example: If ``/sys/block/sda/sda1/alignment_offset`` is non-zero, ATS will offset reads/writes to that disk by that alignment. If Linux knows about any existing partition misalignments, ATS will compensate.
+
+ Partitions formatted to support hardware sector size of more than 512 (e.g. 4096) will result in all objects stored in the cache to be integral multiples of 4096 bytes, which will result in some waste for small files.
.. ts:cv:: CONFIG proxy.config.http.cache.http INT 1
:reloadable:
[2/2] trafficserver git commit: TS-436: Add to CHANGES,
fix line length, and remove trailing space
Posted by so...@apache.org.
TS-436: Add to CHANGES, fix line length, and remove trailing space
This closes #219
Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/5eaea510
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/5eaea510
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/5eaea510
Branch: refs/heads/master
Commit: 5eaea5104e4a937085911dc0beb310446c832a4a
Parents: 620e61d
Author: Phil Sorber <so...@apache.org>
Authored: Thu Jun 11 20:15:25 2015 -0600
Committer: Phil Sorber <so...@apache.org>
Committed: Thu Jun 11 20:17:21 2015 -0600
----------------------------------------------------------------------
CHANGES | 2 ++
doc/reference/configuration/records.config.en.rst | 18 +++++++++++++-----
2 files changed, 15 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/5eaea510/CHANGES
----------------------------------------------------------------------
diff --git a/CHANGES b/CHANGES
index f30c1a1..5474b2e 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,6 +1,8 @@
-*- coding: utf-8 -*-
Changes with Apache Traffic Server 6.0.0
+ *) [TS-436] Added documentation for hardware sector size support.
+
*) [TS-3555] Add a new API TSHttpTxnCacheLookupUrlSet().
*) [TS-3684] Support TSHttpTxnServerRespNoStoreSet in ts_lua plugin.
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/5eaea510/doc/reference/configuration/records.config.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/configuration/records.config.en.rst b/doc/reference/configuration/records.config.en.rst
index bf34a43..473dcaa 100644
--- a/doc/reference/configuration/records.config.en.rst
+++ b/doc/reference/configuration/records.config.en.rst
@@ -1281,15 +1281,23 @@ Cache Control
Forces the use of a specific hardware sector size, 4096, for all disks.
- SSDs and "advanced format” drives claim a sector size of 512; however, it is safe to force a higher size than the hardware supports natively as we count atomicity in 512 byte increments.
+ SSDs and "advanced format” drives claim a sector size of 512; however, it is safe to force a higher
+ size than the hardware supports natively as we count atomicity in 512 byte increments.
- 4096-sized drives formatted for Windows will have partitions aligned on 63 512-byte sector boundaries, so they will be unaligned. There are workarounds, but you need to do some research on your particular drive. Some drives have a one-time option to switch the partition boundary, while others might require reformatting or repartitioning.
+ 4096-sized drives formatted for Windows will have partitions aligned on 63 512-byte sector boundaries,
+ so they will be unaligned. There are workarounds, but you need to do some research on your particular
+ drive. Some drives have a one-time option to switch the partition boundary, while others might require
+ reformatting or repartitioning.
- To be safe in Linux, you could just use the entire drive: ``/dev/sdb`` instead of ``/dev/sdb1`` and Traffic Server will do the right thing. Misaligned partitions on Linux are auto-detected.
+ To be safe in Linux, you could just use the entire drive: ``/dev/sdb`` instead of ``/dev/sdb1`` and
+ Traffic Server will do the right thing. Misaligned partitions on Linux are auto-detected.
- For example: If ``/sys/block/sda/sda1/alignment_offset`` is non-zero, ATS will offset reads/writes to that disk by that alignment. If Linux knows about any existing partition misalignments, ATS will compensate.
+ For example: If ``/sys/block/sda/sda1/alignment_offset`` is non-zero, ATS will offset reads/writes to
+ that disk by that alignment. If Linux knows about any existing partition misalignments, ATS will compensate.
- Partitions formatted to support hardware sector size of more than 512 (e.g. 4096) will result in all objects stored in the cache to be integral multiples of 4096 bytes, which will result in some waste for small files.
+ Partitions formatted to support hardware sector size of more than 512 (e.g. 4096) will result in all
+ objects stored in the cache to be integral multiples of 4096 bytes, which will result in some waste for
+ small files.
.. ts:cv:: CONFIG proxy.config.http.cache.http INT 1
:reloadable: