Skip to content

Commit 2e09099

Browse files
committed
HBASE-25601 Use ASF-official mailing list archives
Signed-off-by: Peter Somogyi <[email protected]> Signed-off-by: Duo Zhang <[email protected]> Closes #2983
1 parent a43fd04 commit 2e09099

File tree

9 files changed

+23
-37
lines changed

9 files changed

+23
-37
lines changed

pom.xml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,6 @@
109109
<archive>http://mail-archives.apache.org/mod_mbox/hbase-user/</archive>
110110
<otherArchives>
111111
<otherArchive>https://dir.gmane.org/gmane.comp.java.hadoop.hbase.user</otherArchive>
112-
<otherArchive>https://search-hadoop.com/?q=&amp;fc_project=HBase</otherArchive>
113112
</otherArchives>
114113
</mailingList>
115114
<mailingList>
@@ -120,7 +119,6 @@
120119
<archive>http://mail-archives.apache.org/mod_mbox/hbase-dev/</archive>
121120
<otherArchives>
122121
<otherArchive>https://dir.gmane.org/gmane.comp.java.hadoop.hbase.devel</otherArchive>
123-
<otherArchive>https://search-hadoop.com/?q=&amp;fc_project=HBase</otherArchive>
124122
</otherArchives>
125123
</mailingList>
126124
<mailingList>

src/main/asciidoc/_chapters/community.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,13 @@ Just request the name of your branch be added to JIRA up on the developer's mail
3737
Thereafter you can file issues against your feature branch in Apache HBase JIRA.
3838
Your code you keep elsewhere -- it should be public so it can be observed -- and you can update dev mailing list on progress.
3939
When the feature is ready for commit, 3 +1s from committers will get your feature merged.
40-
See link:http://search-hadoop.com/m/asM982C5FkS1[HBase, mail # dev - Thoughts
40+
See link:https://lists.apache.org/thread.html/200513c7e7e4df23c8b9134eeee009d61205c79314e77f222d396006%401346870308%40%3Cdev.hbase.apache.org%3E[HBase, mail # dev - Thoughts
4141
about large feature dev branches]
4242
4343
[[hbase.fix.version.in.jira]]
4444
.How to set fix version in JIRA on issue resolve
4545
46-
Here is how link:http://search-hadoop.com/m/azemIi5RCJ1[we agreed] to set versions in JIRA when we resolve an issue.
46+
Here is how we agreed to set versions in JIRA when we resolve an issue.
4747
If master is going to be 2.0.0, and branch-1 1.4.0 then:
4848
4949
* Commit only to master: Mark with 2.0.0
@@ -54,7 +54,7 @@ If master is going to be 2.0.0, and branch-1 1.4.0 then:
5454
[[hbase.when.to.close.jira]]
5555
.Policy on when to set a RESOLVED JIRA as CLOSED
5656
57-
We link:http://search-hadoop.com/m/4cIKs1iwXMS1[agreed] that for issues that list multiple releases in their _Fix Version/s_ field, CLOSE the issue on the release of any of the versions listed; subsequent change to the issue must happen in a new JIRA.
57+
We agreed that for issues that list multiple releases in their _Fix Version/s_ field, CLOSE the issue on the release of any of the versions listed; subsequent change to the issue must happen in a new JIRA.
5858
5959
[[no.permanent.state.in.zk]]
6060
.Only transient state in ZooKeeper!
@@ -105,7 +105,7 @@ NOTE: End-of-life releases are not included in this list.
105105
[[hbase.commit.msg.format]]
106106
== Commit Message format
107107
108-
We link:http://search-hadoop.com/m/Gwxwl10cFHa1[agreed] to the following Git commit message format:
108+
We agreed to the following Git commit message format:
109109
[source]
110110
----
111111
HBASE-xxxxx <title>. (<contributor>)

src/main/asciidoc/_chapters/compression.adoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,6 @@
3131
NOTE: Codecs mentioned in this section are for encoding and decoding data blocks or row keys.
3232
For information about replication codecs, see <<cluster.replication.preserving.tags,cluster.replication.preserving.tags>>.
3333
34-
Some of the information in this section is pulled from a link:http://search-hadoop.com/m/lL12B1PFVhp1/v=threaded[discussion] on the HBase Development mailing list.
35-
3634
HBase supports several different compression algorithms which can be enabled on a ColumnFamily.
3735
Data block encoding attempts to limit duplication of information in keys, taking advantage of some of the fundamental designs and patterns of HBase, such as sorted row keys and the schema of a given table.
3836
Compressors reduce the size of large, opaque byte arrays in cells, and can significantly reduce the storage space needed to store uncompressed data.
@@ -122,7 +120,7 @@ Prefix Tree::
122120
123121
The compression or codec type to use depends on the characteristics of your data. Choosing the wrong type could cause your data to take more space rather than less, and can have performance implications.
124122
125-
In general, you need to weigh your options between smaller size and faster compression/decompression. Following are some general guidelines, expanded from a discussion at link:http://search-hadoop.com/m/lL12B1PFVhp1[Documenting Guidance on compression and codecs].
123+
In general, you need to weigh your options between smaller size and faster compression/decompression. Following are some general guidelines, expanded from a discussion at link:https://lists.apache.org/thread.html/481e67a61163efaaf4345510447a9244871a8d428244868345a155ff%401378926618%40%3Cdev.hbase.apache.org%3E[Documenting Guidance on compression and codecs].
126124
127125
* If you have long keys (compared to the values) or many columns, use a prefix encoder.
128126
FAST_DIFF is recommended.

src/main/asciidoc/_chapters/configuration.adoc

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -892,8 +892,12 @@ If your working set is such that block cache does you no good, at least size the
892892
==== link:http://en.wikipedia.org/wiki/Nagle's_algorithm[Nagle's] or the small package problem
893893

894894
If a big 40ms or so occasional delay is seen in operations against HBase, try the Nagles' setting.
895-
For example, see the user mailing list thread, link:http://search-hadoop.com/m/pduLg2fydtE/Inconsistent+scan+performance+with+caching+set+&subj=Re+Inconsistent+scan+performance+with+caching+set+to+1[Inconsistent scan performance with caching set to 1] and the issue cited therein where setting `notcpdelay` improved scan speeds.
896-
You might also see the graphs on the tail of link:https://issues.apache.org/jira/browse/HBASE-7008[HBASE-7008 Set scanner caching to a better default] where our Lars Hofhansl tries various data sizes w/ Nagle's on and off measuring the effect.
895+
For example, see the user mailing list thread,
896+
link:https://lists.apache.org/thread.html/3d7ceb41c04a955b1b1c80480cdba95208ca3e97bf6895a40e0c1bbb%401346186127%40%3Cuser.hbase.apache.org%3E[Inconsistent scan performance with caching set to 1]
897+
and the issue cited therein where setting `notcpdelay` improved scan speeds. You might also see the
898+
graphs on the tail of
899+
link:https://issues.apache.org/jira/browse/HBASE-7008[HBASE-7008 Set scanner caching to a better default]
900+
where our Lars Hofhansl tries various data sizes w/ Nagle's on and off measuring the effect.
897901

898902
[[mttr]]
899903
==== Better Mean Time to Recover (MTTR)

src/main/asciidoc/_chapters/developer.adoc

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Being familiar with these guidelines will help the HBase committers to use your
3535
3636
Apache HBase gets better only when people contribute! If you are looking to contribute to Apache HBase, look for link:https://issues.apache.org/jira/issues/?jql=project%20%3D%20HBASE%20AND%20labels%20in%20(beginner)%20AND%20status%20in%20(Open%2C%20%22In%20Progress%22%2C%20Reopened)[issues in JIRA tagged with the label 'beginner'].
3737
These are issues HBase contributors have deemed worthy but not of immediate priority and a good way to ramp on HBase internals.
38-
See link:http://search-hadoop.com/m/DHED43re96[What label
38+
See link:https://lists.apache.org/thread.html/b122265f4e4054cf08f8cd38609fb06af72f398c44f9086b05ef4e21%401407246237%40%3Cdev.hbase.apache.org%3E[What label
3939
is used for issues that are good on ramps for new contributors?] from the dev mailing list for background.
4040
4141
Before you get started submitting code to HBase, please refer to <<developing,developing>>.
@@ -873,7 +873,7 @@ requirements of the ASF policy on releases.
873873
____
874874

875875
Regards the latter, run `mvn apache-rat:check` to verify all files are suitably licensed.
876-
See link:http://search-hadoop.com/m/DHED4dhFaU[HBase, mail # dev - On recent discussion clarifying ASF release policy]
876+
See link:https://mail-archives.apache.org/mod_mbox/hbase-dev/201406.mbox/%3CCA%2BRK%3D_B8EP0JMFV%2Bdt-k1g%3DBmedzyq2z1GSqrnMMiH6%3DcdoiAA%40mail.gmail.com%3E[HBase, mail # dev - On recent discussion clarifying ASF release policy]
877877
for how we arrived at this process.
878878

879879
[[hbase.release.announcement]]
@@ -2290,10 +2290,8 @@ We've established the practice of committing to master and then cherry picking b
22902290

22912291
When there is a minor conflict we can fix it up and just proceed with the commit.
22922292
The resulting commit retains the original author.
2293-
When the amending author is different from the original committer, add notice of this at the end of the commit message as: `Amending-Author: Author
2294-
<committer&apache>` See discussion at link:http://search-hadoop.com/m/DHED4wHGYS[HBase, mail # dev
2295-
- [DISCUSSION] Best practice when amending commits cherry picked
2296-
from master to branch].
2293+
When the amending author is different from the original committer, add notice of this at the end of the commit message as:
2294+
`Amending-Author: Author <committer&apache>`. See discussion at link:https://lists.apache.org/thread.html/7f514da8b24785a4a64b9f023692ce1b345eba215e1f622820551ca1%401401821274%40%3Cdev.hbase.apache.org%3E[HBase, mail # dev - [DISCUSSION] Best practice when amending commits cherry picked from master to branch].
22972295

22982296
====== Close related GitHub PRs
22992297

@@ -2311,7 +2309,7 @@ A committer should.
23112309
[[git.patch.flow]]
23122310
====== Patching Etiquette
23132311

2314-
In the thread link:http://search-hadoop.com/m/DHED4EiwOz[HBase, mail # dev - ANNOUNCEMENT: Git Migration In Progress (WAS =>
2312+
In the thread link:https://lists.apache.org/thread.html/186fcd5eb71973a7b282ecdba41606d3d221efd505d533bb729e1fad%401400648690%40%3Cdev.hbase.apache.org%3E[HBase, mail # dev - ANNOUNCEMENT: Git Migration In Progress (WAS =>
23152313
Re: Git Migration)], it was agreed on the following patch flow
23162314

23172315
. Develop and commit the patch against master first.
@@ -2333,7 +2331,7 @@ However any substantive discussion (as with any off-list project-related discuss
23332331

23342332
==== Do not edit JIRA comments
23352333

2336-
Misspellings and/or bad grammar is preferable to the disruption a JIRA comment edit causes: See the discussion at link:http://search-hadoop.com/?q=%5BReopened%5D+%28HBASE-451%29+Remove+HTableDescriptor+from+HRegionInfo&fc_project=HBase[Re:(HBASE-451) Remove HTableDescriptor from HRegionInfo]
2334+
Misspellings and/or bad grammar is preferable to the disruption a JIRA comment edit causes.
23372335

23382336
[[thirdparty]]
23392337
=== The hbase-thirdparty dependency and shading/relocation

src/main/asciidoc/_chapters/ops_mgt.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3000,7 +3000,6 @@ Physical data size on disk is distinct from logical size of your data and is aff
30003000
See <<regions.arch,regions.arch>>.
30013001

30023002
* Decreased by <<compression,compression>> and data block encoding, depending on data.
3003-
See also link:http://search-hadoop.com/m/lL12B1PFVhp1[this thread].
30043003
You might want to test what compression and encoding (if any) make sense for your data.
30053004
* Increased by size of region server <<wal,wal>> (usually fixed and negligible - less than half of RS memory size, per RS).
30063005
* Increased by HDFS replication - usually x3.

src/main/asciidoc/_chapters/performance.adoc

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -593,7 +593,6 @@ See <<precreate.regions>>, as well as <<perf.configurations>>
593593
== Reading from HBase
594594
595595
The mailing list can help if you are having performance issues.
596-
For example, here is a good general thread on what to look at addressing read-time issues: link:http://search-hadoop.com/m/qOo2yyHtCC1[HBase Random Read latency > 100ms]
597596
598597
[[perf.hbase.client.caching]]
599598
=== Scan Caching
@@ -844,7 +843,7 @@ See the link:https://issues.apache.org/jira/browse/HDFS-1599[Umbrella Jira Ticke
844843
Since Hadoop 1.0.0 (also 0.22.1, 0.23.1, CDH3u3 and HDP 1.0) via link:https://issues.apache.org/jira/browse/HDFS-2246[HDFS-2246], it is possible for the DFSClient to take a "short circuit" and read directly from the disk instead of going through the DataNode when the data is local.
845844
What this means for HBase is that the RegionServers can read directly off their machine's disks instead of having to open a socket to talk to the DataNode, the former being generally much faster.
846845
See JD's link:http://files.meetup.com/1350427/hug_ebay_jdcryans.pdf[Performance Talk].
847-
Also see link:http://search-hadoop.com/m/zV6dKrLCVh1[HBase, mail # dev - read short circuit] thread for more discussion around short circuit reads.
846+
Also see link:https://lists.apache.org/thread.html/ce2ce3a3bbd20806d0c017b2e7528e78a46ccb87c063831db051949d%401347548325%40%3Cdev.hbase.apache.org%3E[HBase, mail # dev - read short circuit] thread for more discussion around short circuit reads.
848847
849848
To enable "short circuit" reads, it will depend on your version of Hadoop.
850849
The original shortcircuit read patch was much improved upon in Hadoop 2 in link:https://issues.apache.org/jira/browse/HDFS-347[HDFS-347].

src/main/asciidoc/_chapters/schema_design.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -250,7 +250,7 @@ If your rows and column names are large, especially compared to the size of the
250250
One such is the case described by Marc Limotte at the tail of link:https://issues.apache.org/jira/browse/HBASE-3551?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13005272#comment-13005272[HBASE-3551] (recommended!). Therein, the indices that are kept on HBase storefiles (<<hfile>>) to facilitate random access may end up occupying large chunks of the HBase allotted RAM because the cell value coordinates are large.
251251
Mark in the above cited comment suggests upping the block size so entries in the store file index happen at a larger interval or modify the table schema so it makes for smaller rows and column names.
252252
Compression will also make for larger indices.
253-
See the thread link:http://search-hadoop.com/m/hemBv1LiN4Q1/a+question+storefileIndexSize&subj=a+question+storefileIndexSize[a question storefileIndexSize] up on the user mailing list.
253+
See the thread link:https://lists.apache.org/thread.html/b158eae5d8888d3530be378298bca90c17f80982fdcdfa01d0844c3d%401306240189%40%3Cuser.hbase.apache.org%3E[a question storefileIndexSize] up on the user mailing list.
254254
255255
Most of the time small inefficiencies don't matter all that much. Unfortunately, this is a case where they do.
256256
Whatever patterns are selected for ColumnFamilies, attributes, and rowkeys they could be repeated several billion times in your data.
@@ -639,7 +639,7 @@ However, HBase scales better at larger data volumes, so this is a feature trade-
639639
640640
Pay attention to <<performance>> when implementing any of these approaches.
641641
642-
Additionally, see the David Butler response in this dist-list thread link:http://search-hadoop.com/m/nvbiBp2TDP/Stargate%252Bhbase&subj=Stargate+hbase[HBase, mail # user - Stargate+hbase]
642+
Additionally, see the David Butler response in this dist-list thread link:https://lists.apache.org/thread.html/b0ca33407f010d5b1be67a20d1708e8d8bb1e147770f2cb7182a2e37%401300972712%40%3Cuser.hbase.apache.org%3E[HBase, mail # user - Stargate+hbase]
643643
644644
[[secondary.indexes.filter]]
645645
=== Filter Query

src/main/asciidoc/_chapters/troubleshooting.adoc

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
3333
Always start with the master log (TODO: Which lines?). Normally it's just printing the same lines over and over again.
3434
If not, then there's an issue.
35-
Google or link:http://search-hadoop.com[search-hadoop.com] should return some hits for those exceptions you're seeing.
35+
Google should return some hits for those exceptions you're seeing.
3636
3737
An error rarely comes alone in Apache HBase, usually when something gets screwed up what will follow may be hundreds of exceptions and stack traces coming from all over the place.
3838
The best way to approach this type of problem is to walk the log up to where it all began, for example one trick with RegionServers is that they will print some metrics when aborting so grepping for _Dump_ should get you around the start of the problem.
@@ -221,12 +221,6 @@ For more information on GC pauses, see the link:https://blog.cloudera.com/blog/2
221221
[[trouble.resources]]
222222
== Resources
223223
224-
[[trouble.resources.searchhadoop]]
225-
=== search-hadoop.com
226-
227-
link:http://search-hadoop.com[search-hadoop.com] indexes all the mailing lists and is great for historical searches.
228-
Search here first when you have an issue as its more than likely someone has already had your problem.
229-
230224
[[trouble.resources.lists]]
231225
=== Mailing Lists
232226
@@ -235,7 +229,6 @@ The 'dev' mailing list is aimed at the community of developers actually building
235229
Before going to the mailing list, make sure your question has not already been answered by searching the mailing list
236230
archives first. For those who prefer to communicate in Chinese, they can use the 'user-zh' mailing list instead of the
237231
'user' list.
238-
Use <<trouble.resources.searchhadoop>>.
239232
Take some time crafting your question.
240233
See link:http://www.mikeash.com/getting_answers.html[Getting Answers] for ideas on crafting good questions.
241234
A quality question that includes all context and exhibits evidence the author has tried to find answers in the manual and out on lists is more likely to get a prompt response.
@@ -639,8 +632,6 @@ The upside is that more data is packed into the same region, but performance is
639632
And smaller StoreFiles become targets for compaction.
640633
Without compression the files are much bigger and don't need as much compaction, however this is at the expense of I/O.
641634

642-
For additional information, see this thread on link:http://search-hadoop.com/m/WUnLM6ojHm1/Long+client+pauses+with+compression&subj=Long+client+pauses+with+compression[Long client pauses with compression].
643-
644635
[[trouble.client.security.rpc.krb]]
645636
=== Secure Client Connect ([Caused by GSSException: No valid credentials provided...])
646637

@@ -693,7 +684,7 @@ The utility <<trouble.tools.builtin.zkcli>> may help investigate ZooKeeper issue
693684
[[trouble.client.oome.directmemory.leak]]
694685
=== Client running out of memory though heap size seems to be stable (but the off-heap/direct heap keeps growing)
695686

696-
You are likely running into the issue that is described and worked through in the mail thread link:http://search-hadoop.com/m/ubhrX8KvcH/Suspected+memory+leak&subj=Re+Suspected+memory+leak[HBase, mail # user - Suspected memory leak] and continued over in link:http://search-hadoop.com/m/p2Agc1Zy7Va/MaxDirectMemorySize+Was%253A+Suspected+memory+leak&subj=Re+FeedbackRe+Suspected+memory+leak[HBase, mail # dev - FeedbackRe: Suspected memory leak].
687+
You are likely running into the issue that is described and worked through in the mail thread link:https://lists.apache.org/thread.html/d12bbe56be95cf68478d1528263042730670ff39159a01eaf06d8bc8%401322622090%40%3Cuser.hbase.apache.org%3E[HBase, mail # user - Suspected memory leak] and continued over in link:https://lists.apache.org/thread.html/621dde35479215f0b07b23af93b8fac52ff4729949b5c9af18e3a85b%401322971078%40%3Cuser.hbase.apache.org%3E[HBase, mail # dev - FeedbackRe: Suspected memory leak].
697688
A workaround is passing your client-side JVM a reasonable value for `-XX:MaxDirectMemorySize`.
698689
By default, the `MaxDirectMemorySize` is equal to your `-Xmx` max heapsize setting (if `-Xmx` is set). Try setting it to something smaller (for example, one user had success setting it to `1g` when they had a client-side heap of `12g`). If you set it too small, it will bring on `FullGCs` so keep it a bit hefty.
699690
You want to make this setting client-side only especially if you are running the new experimental server-side off-heap cache since this feature depends on being able to use big direct buffers (You may have to keep separate client-side and server-side config dirs).
@@ -1322,12 +1313,11 @@ Use the internal EC2 host names when configuring the ZooKeeper quorum peer list.
13221313
=== Instability on Amazon EC2
13231314

13241315
Questions on HBase and Amazon EC2 come up frequently on the HBase dist-list.
1325-
Search for old threads using link:http://search-hadoop.com/[Search Hadoop]
13261316

13271317
[[trouble.ec2.connection]]
13281318
=== Remote Java Connection into EC2 Cluster Not Working
13291319

1330-
See Andrew's answer here, up on the user list: link:http://search-hadoop.com/m/sPdqNFAwyg2[Remote Java client connection into EC2 instance].
1320+
See Andrew's answer here, up on the user list: link:https://lists.apache.org/thread.html/666bfa863bc2eb2ec7bbe5ecfbee345e0cbf1d58aaa6c1636dfcb527%401269010842%40%3Cuser.hbase.apache.org%3E[Remote Java client connection into EC2 instance].
13311321

13321322
[[trouble.versions]]
13331323
== HBase and Hadoop version issues

0 commit comments

Comments
 (0)