You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@incubator.apache.org by yu...@apache.org on 2016/12/29 13:36:13 UTC
[06/15] incubator-rocketmq-site git commit: Add faq module
Add faq module
Project: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/commit/173b5e43
Tree: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/tree/173b5e43
Diff: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/diff/173b5e43
Branch: refs/heads/asf-site
Commit: 173b5e43a9ab56110c5c614d747f007016601039
Parents: e268fd1
Author: stevenschew <st...@apache.org>
Authored: Thu Dec 29 17:00:09 2016 +0800
Committer: stevenschew <st...@apache.org>
Committed: Thu Dec 29 17:00:09 2016 +0800
----------------------------------------------------------------------
_data/navigation.yml | 4 +-
_docs/07-frequently-asked-questions.md | 97 +++
content/about/contact/index.html | 2 +-
content/about/team/index.html | 2 +-
content/archive-layout-with-content/index.html | 13 +
content/collection-archive/index.html | 20 +
content/docs/cli-admin-tool/index.html | 19 +-
content/docs/cluster-deployment/index.html | 19 +-
content/docs/code-guidelines/index.html | 22 +-
content/docs/core-concept/index.html | 19 +-
content/docs/faq/index.html | 640 ++++++++++++++++++++
content/docs/motivation/index.html | 19 +-
content/docs/pull-request/index.html | 19 +-
content/docs/quick-start/index.html | 19 +-
content/feed.xml | 2 +-
content/sitemap.xml | 6 +
16 files changed, 860 insertions(+), 62 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/_data/navigation.yml
----------------------------------------------------------------------
diff --git a/_data/navigation.yml b/_data/navigation.yml
index a85e50f..4f20b32 100644
--- a/_data/navigation.yml
+++ b/_data/navigation.yml
@@ -57,8 +57,8 @@ docs:
url: /docs/core-concept/
- title: "Virtualization"
url: /docs/cli-admin-tool/
- - title: "Frequently Asked Questions"
- url: /docs/cluster-deployment/
+ - title: FAQ
+ url: /docs/faq/
about:
- title: Team
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/_docs/07-frequently-asked-questions.md
----------------------------------------------------------------------
diff --git a/_docs/07-frequently-asked-questions.md b/_docs/07-frequently-asked-questions.md
new file mode 100644
index 0000000..8a9ec40
--- /dev/null
+++ b/_docs/07-frequently-asked-questions.md
@@ -0,0 +1,97 @@
+---
+title: "Frequently Asked Questions"
+permalink: /docs/faq/
+modified: 2016-12-27T15:18:43-04:00
+---
+The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the documentation or ask the community.
+
+{% include toc %}
+
+## General
+### 1. Why create rocketmq project instead of selecting other products?
+In some cases, slower consumers can slow down the producers. We tried our best efforts to handle this problems through throttling, circuit breaker or degradation, but it cannot scale out gracefully. So we begin to focus on the popular messaging solution Kafka at that time. Unfortunately, Kafka can not meet our requirements such as low latency and high reliability. So we decided to innovate a new messaging middleware to handle a broad set of use cases, ranging from traditional publish/subscribe scenario to demandingly high volume realtime transaction system that tolerates no message loss.
+
+### 2. Do I have to install other softewares, such as zookeeper, to use RocketMQ?
+No. RocketMQ can run without any other softeware, you can run broker server and name server indepentently. Aslo, the topic can be created by using command, such as sh mqadmin updatetopic etc. After creating successfully, you enjoy yourself with RocketMQ.
+
+## Usage
+### 1. Where does the newly created Consumer ID start consuming messages?
+
+1. If the topic sends a message within three days, then the consumer start consume message from the first message saved in the server.
+2. If the topic sends a message in three days ago, the consumer start consume message from the latest message in the server, in other words, starting to consume the message queue tail.
+3. If such consumer is the second reboot, then start to consumer message from the last consumption location.
+
+### 2. How to reconsume message when consumption fails?
+ 1.Cluster consumption pattern
+ The consumer business logic code return Action.ReconsumerLater, or NULL, or throws an exception, the message will go up to 16 times retry procedure, if still fail to retry 16 times, then such message descarded.
+
+ 2.Broadcast consumption pattern
+ The broadcaset consumption still ensures that a message is consumered at least once, but it is consumed fail without retry.
+
+
+### 3. How to deal with consume message failed?
+
+1. Use topic query by the time range, you can query to a period of time Topic received all the messages.
+2. Using Topic and Message Id to accurately query the message.
+3. Using Topic and Message Key accurately query a class of messages with the same Message Key.
+
+
+### 4. Delivery exactly once?
+
+In most cases, the message is not repeated. As a distributed message middleware, in the network jitter, application processing timeout and other abnormal circumstances, can not guarantee that the message is not repeated, but can ensure that the message is not lost.
+
+### 5. How to add a new broker?
+
+1. Start up a new broker and make it register to the same list of name servers.
+2. On default, only internally system topics and consumer groups are created automatically. If you would like to have your business topic and consumer groups on the new node, remember to replicate them from the existing broker. You may turn to admin tool command to achieve this.
+
+## Configuration related
+### 1. How long the message is saved on the server?
+
+Stored messages are saved for up to 3 days, and messages that are not consumed for more than 3 days will be deleted.
+
+### 2. What is the length limit for message Body?
+Generally 256KB, but can be modified by configuration.
+
+### 3. How to set the number of consumer threads?
+When you start Consumer, set a ConsumeThreadNums property, example as follow.
+
+ properties.put(PropertyKeyConst.ConsumeThreadNums,20);
+
+## Errors
+### 1. Start producer or consumer failed and producer group or consumer repeat?
+Reason\uff1aIn the same JVM inside using the same Producer ID/Consumer ID launched multiple instances of Producer/Consumer, it may cause the client to start failure.
+
+Solution: Ensure that a JVM corresponds to a Producer ID/Consumer ID starts only with a Producer/Consumer instance.
+
+### 2. In broadcast mode, consumer start loading json file failed?
+Reason: Fastjson version is too low to cause the broadcast consumer to load a local offsets.json file failed, which causing the consumer boot failure.
+
+Solution: Fastjson version will be upgraded to rocketmq client dependent version, to ensure that the local offsets.json can be normal loading. By default offsets.json file is in /home/{user}/.rocketmq_offsets.
+
+### 3. What if a broker crashes?
+
+ 1. Master crashes
+ Messages can no longer be sent to this broker set, but if you have another broker set available, messages can be still sent there given the topic is present.Messages can still be consumed from slaves.
+ 2. One slaves crashes
+ As long as there is another working slave, no impact on writing messages;No impact on consuming messages except when the consumer group is set to consume from this slave preferably. By default, it is from master.
+ 3. All slaves crash
+ No impact on writing messages on master, but if master is a SYNC_MASTER, the producer will get a result of SLAVE_NOT_AVAILABLE indicating that the message is not replicated to any slaves.No impact on consuming messages except that if the consumer group is set to consume from slave preferably. By default, it is from master.
+
+### 4. Producer complains "No Topic Route Info", how to diagnose?
+This happens when you are trying to send message to a topic whose route info is not available to the producer.
+
+1. Confirm the producer can connect to a name server and capable of fetching routing meta info from it.
+2. Confirm that name servers do contain routing meta info of the topic. You may query the routing meta info from name server through topicRoute of admin tools or web console.
+3. Confirm your brokers are sending heartbeats to the same list of name servers your producer is connecting to.
+4. Confirm that the topic's perm is 6(rw-), or at least 2(-w-).
+
+If you can't find this topic, create it via admin tools command updateTopic or web console on a broker.
+
+
+## Features
+### 1. What kind of consumption pattern does RocketMQ provide?
+In RocketMQ, it providers two types of consumption patterns, such as Clustering consumption patterns and broadcasting consumption patterns. See the documentation on cluster patterns for details.
+
+### 2. How many kinds of message type are supported?
+There are several types of messages that are currently supported in rocketmq\uff0csuch as common message, timed message, transaction message, sequential message and delay message. User can select the appropriate message type according to the needs of the business.
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/about/contact/index.html
----------------------------------------------------------------------
diff --git a/content/about/contact/index.html b/content/about/contact/index.html
index b1deb54..d8684bc 100644
--- a/content/about/contact/index.html
+++ b/content/about/contact/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/about/team/index.html
----------------------------------------------------------------------
diff --git a/content/about/team/index.html b/content/about/team/index.html
index 676cd87..38aed87 100644
--- a/content/about/team/index.html
+++ b/content/about/team/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/archive-layout-with-content/index.html
----------------------------------------------------------------------
diff --git a/content/archive-layout-with-content/index.html b/content/archive-layout-with-content/index.html
index a57daca..5601e49 100644
--- a/content/archive-layout-with-content/index.html
+++ b/content/archive-layout-with-content/index.html
@@ -682,6 +682,19 @@
<h2 class="archive__item-title" itemprop="headline">
+ <a href="/docs/faq/" rel="permalink">Frequently Asked Questions</a>
+
+ </h2>
+
+
+ </article>
+</div>
+
+<div class="list__item">
+ <article class="archive__item" itemscope="" itemtype="http://schema.org/CreativeWork">
+
+ <h2 class="archive__item-title" itemprop="headline">
+
<a href="/404.html" rel="permalink">Page Not Found</a>
</h2>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/collection-archive/index.html
----------------------------------------------------------------------
diff --git a/content/collection-archive/index.html b/content/collection-archive/index.html
index 9b5f984..1d91468 100644
--- a/content/collection-archive/index.html
+++ b/content/collection-archive/index.html
@@ -486,6 +486,26 @@
</div>
+
+
+
+
+
+<div class="list__item">
+ <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
+
+ <h2 class="archive__item-title" itemprop="headline">
+
+ <a href="/docs/faq/" rel="permalink">Frequently Asked Questions
+</a>
+
+ </h2>
+
+ <p class="archive__item-excerpt" itemprop="description">The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the document...</p>
+ </article>
+</div>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/cli-admin-tool/index.html
----------------------------------------------------------------------
diff --git a/content/docs/cli-admin-tool/index.html b/content/docs/cli-admin-tool/index.html
index 9999a7d..8456417 100644
--- a/content/docs/cli-admin-tool/index.html
+++ b/content/docs/cli-admin-tool/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="active">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="">Frequently Asked Questions</a></li>
-
- </ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/cluster-deployment/index.html
----------------------------------------------------------------------
diff --git a/content/docs/cluster-deployment/index.html b/content/docs/cluster-deployment/index.html
index 53d81a0..670e7f9 100644
--- a/content/docs/cluster-deployment/index.html
+++ b/content/docs/cluster-deployment/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="active">Frequently Asked Questions</a></li>
-
- </ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/code-guidelines/index.html
----------------------------------------------------------------------
diff --git a/content/docs/code-guidelines/index.html b/content/docs/code-guidelines/index.html
index 5817012..a0159ed 100644
--- a/content/docs/code-guidelines/index.html
+++ b/content/docs/code-guidelines/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="">Frequently Asked Questions</a></li>
-
- </ul>
</li>
@@ -450,7 +453,8 @@
">Previous</a>
- <a href="#" class="pagination--pager disabled">Next</a>
+ <a href="/docs/faq/" class="pagination--pager" title="Frequently Asked Questions
+">Next</a>
</nav>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/core-concept/index.html
----------------------------------------------------------------------
diff --git a/content/docs/core-concept/index.html b/content/docs/core-concept/index.html
index b543a4e..dc0e114 100644
--- a/content/docs/core-concept/index.html
+++ b/content/docs/core-concept/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="">Frequently Asked Questions</a></li>
-
- </ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/faq/index.html
----------------------------------------------------------------------
diff --git a/content/docs/faq/index.html b/content/docs/faq/index.html
new file mode 100644
index 0000000..6f03cbb
--- /dev/null
+++ b/content/docs/faq/index.html
@@ -0,0 +1,640 @@
+<!doctype html>
+<html lang="en" class="no-js">
+ <head>
+ <meta charset="utf-8">
+
+<!-- begin SEO -->
+
+
+
+
+
+
+
+
+
+<title>Frequently Asked Questions - Apache RocketMQ</title>
+
+
+
+
+<meta name="description" content="The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the documentation or ask the community.">
+
+
+
+
+<meta property="og:locale" content="en">
+<meta property="og:site_name" content="Apache RocketMQ">
+<meta property="og:title" content="Frequently Asked Questions">
+
+
+
+
+ <meta property="og:description" content="The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the documentation or ask the community.">
+
+
+
+ <meta name="twitter:site" content="@ApacheRocketMQ">
+ <meta name="twitter:title" content="Frequently Asked Questions">
+ <meta name="twitter:description" content="The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the documentation or ask the community.">
+ <meta name="twitter:url" content="">
+
+
+ <meta name="twitter:card" content="summary">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <meta property="og:type" content="article">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
+
+
+
+
+
+
+
+
+ <script type="application/ld+json">
+ {
+ "@context" : "http://schema.org",
+ "@type" : "Person",
+ "name" : "Apache RocketMQ",
+ "url" : null,
+ "sameAs" : null
+ }
+ </script>
+
+
+
+
+
+
+<!-- end SEO -->
+
+
+<link href="/feed.xml" type="application/atom+xml" rel="alternate" title="Apache RocketMQ Feed">
+
+<!-- http://t.co/dKP3o1e -->
+<meta name="HandheldFriendly" content="True">
+<meta name="MobileOptimized" content="320">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<script>
+ document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js ';
+</script>
+
+<!-- For all browsers -->
+<link rel="stylesheet" href="/assets/css/main.css">
+
+<meta http-equiv="cleartype" content="on">
+ <!-- start custom head snippets -->
+
+<!-- insert favicons. use http://realfavicongenerator.net/ -->
+
+<!-- end custom head snippets -->
+ </head>
+
+ <body class="layout--single">
+
+ <!--[if lt IE 9]>
+<div class="notice--danger align-center" style="margin: 0;">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</div>
+<![endif]-->
+ <div class="masthead">
+ <div class="masthead__inner-wrap">
+ <div class="masthead__menu">
+ <nav id="site-nav" class="greedy-nav">
+ <button><div class="navicon"></div></button>
+ <ul class="visible-links">
+ <li class="masthead__menu-item masthead__menu-item--lg"><a href="/">Apache RocketMQ</a></li>
+
+
+ <li class="masthead__menu-item"><a href="/docs/quick-start/">Documentation</a></li>
+
+
+ <li class="masthead__menu-item"><a href="/year-archive/">Blog</a></li>
+
+
+ <li class="masthead__menu-item"><a href="/community/">Community</a></li>
+
+
+ <li class="masthead__menu-item"><a href="/about/team/">About</a></li>
+
+ </ul>
+ <ul class="hidden-links hidden"></ul>
+ </nav>
+ </div>
+ </div>
+</div>
+
+
+
+
+
+<div id="main" role="main">
+
+ <div class="sidebar sticky">
+
+
+
+
+
+
+
+
+
+
+<nav class="nav__list">
+
+ <input id="ac-toc" name="accordion-toc" type="checkbox" />
+ <label for="ac-toc">Toggle Menu</label>
+ <ul class="nav__items">
+
+ <li>
+
+ <span class="nav__sub-title">User Guide</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/docs/quick-start/" class="">Quick Start</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/motivation/" class="">Motivation</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/core-concept/" class="">Core Concept</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/cli-admin-tool/" class="">CLI Admin Tool</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/cluster-deployment/" class="">Cluster Configuration & Deployment</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Contributor Guide</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/docs/code-guidelines/" class="">Code Guidelines</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/pull-request/" class="">Best Practice in PR</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Developer Guide</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/docs/motivation/" class="">Architecture & Design</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/motivation/" class="">Communication Protocol</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/core-concept/" class="">Persistence</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/cli-admin-tool/" class="">Replication</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/cluster-deployment/" class="">Service Discovery & Load Balance</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/cluster-deployment/" class="">Message Filter</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+ <span class="nav__sub-title">Best Practice</span>
+
+
+
+ <ul>
+
+
+
+
+
+
+
+ <li><a href="/docs/motivation/" class="">Broker</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/motivation/" class="">Producer</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/core-concept/" class="">Consumer</a></li>
+
+
+
+
+
+
+
+ <li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
+
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
+
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
+
+
+ </li>
+
+ </ul>
+</nav>
+
+
+ </div>
+
+
+ <article class="page" itemscope itemtype="http://schema.org/CreativeWork">
+ <meta itemprop="headline" content="Frequently Asked Questions">
+ <meta itemprop="description" content="The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the documentation or ask the community.">
+ <meta itemprop="datePublished" content="December 29, 2016">
+ <meta itemprop="dateModified" content="December 28, 2016">
+
+ <div class="page__inner-wrap">
+
+ <header>
+ <h1 class="page__title" itemprop="headline">Frequently Asked Questions
+</h1>
+
+ </header>
+
+
+ <section class="page__content" itemprop="text">
+ <p>The following questions are frequently asked with regard to the RocketMQ project in general. If you have further questions, make sure to consult the documentation or ask the community.</p>
+
+<aside class="sidebar__right">
+<nav class="toc">
+ <header><h4 class="nav__title"><i class="fa fa-file-text"></i> On This Page</h4></header>
+<ul class="toc__menu" id="markdown-toc">
+ <li><a href="#general" id="markdown-toc-general">General</a> <ul>
+ <li><a href="#1-why-create-rocketmq-project-instead-of-selecting-other-products" id="markdown-toc-1-why-create-rocketmq-project-instead-of-selecting-other-products">1. Why create rocketmq project instead of selecting other products?</a></li>
+ <li><a href="#2-do-i-have-to-install-other-softewares-such-as-zookeeper-to-use-rocketmq" id="markdown-toc-2-do-i-have-to-install-other-softewares-such-as-zookeeper-to-use-rocketmq">2. Do I have to install other softewares, such as zookeeper, to use RocketMQ?</a></li>
+ </ul>
+ </li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
+ <li><a href="#1-where-does-the-newly-created-consumer-id-start-consuming-messages" id="markdown-toc-1-where-does-the-newly-created-consumer-id-start-consuming-messages">1. Where does the newly created Consumer ID start consuming messages?</a></li>
+ <li><a href="#2-how-to-reconsume-message-when-consumption-fails" id="markdown-toc-2-how-to-reconsume-message-when-consumption-fails">2. How to reconsume message when consumption fails?</a></li>
+ <li><a href="#3-how-to-deal-with-consume-message-failed" id="markdown-toc-3-how-to-deal-with-consume-message-failed">3. How to deal with consume message failed?</a></li>
+ <li><a href="#4-delivery-exactly-once" id="markdown-toc-4-delivery-exactly-once">4. Delivery exactly once?</a></li>
+ <li><a href="#5-how-to-add-a-new-broker" id="markdown-toc-5-how-to-add-a-new-broker">5. How to add a new broker?</a></li>
+ </ul>
+ </li>
+ <li><a href="#configuration-related" id="markdown-toc-configuration-related">Configuration related</a> <ul>
+ <li><a href="#1-how-long-the-message-is-saved-on-the-server" id="markdown-toc-1-how-long-the-message-is-saved-on-the-server">1. How long the message is saved on the server?</a></li>
+ <li><a href="#2-what-is-the-length-limit-for-message-body" id="markdown-toc-2-what-is-the-length-limit-for-message-body">2. What is the length limit for message Body?</a></li>
+ <li><a href="#3-how-to-set-the-number-of-consumer-threads" id="markdown-toc-3-how-to-set-the-number-of-consumer-threads">3. How to set the number of consumer threads?</a></li>
+ </ul>
+ </li>
+ <li><a href="#errors" id="markdown-toc-errors">Errors</a> <ul>
+ <li><a href="#1-start-producer-or-consumer-failed-and-producer-group-or-consumer-repeat" id="markdown-toc-1-start-producer-or-consumer-failed-and-producer-group-or-consumer-repeat">1. Start producer or consumer failed and producer group or consumer repeat?</a></li>
+ <li><a href="#2-in-broadcast-mode-consumer-start-loading-json-file-failed" id="markdown-toc-2-in-broadcast-mode-consumer-start-loading-json-file-failed">2. In broadcast mode, consumer start loading json file failed?</a></li>
+ <li><a href="#3-what-if-a-broker-crashes" id="markdown-toc-3-what-if-a-broker-crashes">3. What if a broker crashes?</a></li>
+ <li><a href="#4-producer-complains-no-topic-route-info-how-to-diagnose" id="markdown-toc-4-producer-complains-no-topic-route-info-how-to-diagnose">4. Producer complains \u201cNo Topic Route Info\u201d, how to diagnose?</a></li>
+ </ul>
+ </li>
+ <li><a href="#features" id="markdown-toc-features">Features</a> <ul>
+ <li><a href="#1-what-kind-of-consumption-pattern-does-rocketmq-provide" id="markdown-toc-1-what-kind-of-consumption-pattern-does-rocketmq-provide">1. What kind of consumption pattern does RocketMQ provide?</a></li>
+ <li><a href="#2-how-many-kinds-of-message-type-are-supported" id="markdown-toc-2-how-many-kinds-of-message-type-are-supported">2. How many kinds of message type are supported?</a></li>
+ </ul>
+ </li>
+</ul>
+
+ </nav>
+</aside>
+
+<h2 id="general">General</h2>
+<h3 id="1-why-create-rocketmq-project-instead-of-selecting-other-products">1. Why create rocketmq project instead of selecting other products?</h3>
+<p>In some cases, slower consumers can slow down the producers. We tried our best efforts to handle this problems through throttling, circuit breaker or degradation, but it cannot scale out gracefully. So we begin to focus on the popular messaging solution Kafka at that time. Unfortunately, Kafka can not meet our requirements such as low latency and high reliability. So we decided to innovate a new messaging middleware to handle a broad set of use cases, ranging from traditional publish/subscribe scenario to demandingly high volume realtime transaction system that tolerates no message loss.</p>
+
+<h3 id="2-do-i-have-to-install-other-softewares-such-as-zookeeper-to-use-rocketmq">2. Do I have to install other softewares, such as zookeeper, to use RocketMQ?</h3>
+<p>No. RocketMQ can run without any other softeware, you can run broker server and name server indepentently. Aslo, the topic can be created by using command, such as sh mqadmin updatetopic etc. After creating successfully, you enjoy yourself with RocketMQ.</p>
+
+<h2 id="usage">Usage</h2>
+<h3 id="1-where-does-the-newly-created-consumer-id-start-consuming-messages">1. Where does the newly created Consumer ID start consuming messages?</h3>
+
+<ol>
+ <li>If the topic sends a message within three days, then the consumer start consume message from the first message saved in the server.</li>
+ <li>If the topic sends a message in three days ago, the consumer start consume message from the latest message in the server, in other words, starting to consume the message queue tail.</li>
+ <li>If such consumer is the second reboot, then start to consumer message from the last consumption location.</li>
+</ol>
+
+<h3 id="2-how-to-reconsume-message-when-consumption-fails">2. How to reconsume message when consumption fails?</h3>
+<div class="highlighter-rouge"><pre class="highlight"><code>1.Cluster consumption pattern
+The consumer business logic code return Action.ReconsumerLater, or NULL, or throws an exception, the message will go up to 16 times retry procedure, if still fail to retry 16 times, then such message descarded.
+
+2.Broadcast consumption pattern
+The broadcaset consumption still ensures that a message is consumered at least once, but it is consumed fail without retry.
+</code></pre>
+</div>
+
+<h3 id="3-how-to-deal-with-consume-message-failed">3. How to deal with consume message failed?</h3>
+
+<ol>
+ <li>Use topic query by the time range, you can query to a period of time Topic received all the messages.</li>
+ <li>Using Topic and Message Id to accurately query the message.</li>
+ <li>Using Topic and Message Key accurately query a class of messages with the same Message Key.</li>
+</ol>
+
+<h3 id="4-delivery-exactly-once">4. Delivery exactly once?</h3>
+
+<p>In most cases, the message is not repeated. As a distributed message middleware, in the network jitter, application processing timeout and other abnormal circumstances, can not guarantee that the message is not repeated, but can ensure that the message is not lost.</p>
+
+<h3 id="5-how-to-add-a-new-broker">5. How to add a new broker?</h3>
+
+<ol>
+ <li>Start up a new broker and make it register to the same list of name servers.</li>
+ <li>On default, only internally system topics and consumer groups are created automatically. If you would like to have your business topic and consumer groups on the new node, remember to replicate them from the existing broker. You may turn to admin tool command to achieve this.</li>
+</ol>
+
+<h2 id="configuration-related">Configuration related</h2>
+<h3 id="1-how-long-the-message-is-saved-on-the-server">1. How long the message is saved on the server?</h3>
+
+<p>Stored messages are saved for up to 3 days, and messages that are not consumed for more than 3 days will be deleted.</p>
+
+<h3 id="2-what-is-the-length-limit-for-message-body">2. What is the length limit for message Body?</h3>
+<p>Generally 256KB, but can be modified by configuration.</p>
+
+<h3 id="3-how-to-set-the-number-of-consumer-threads">3. How to set the number of consumer threads?</h3>
+<p>When you start Consumer, set a ConsumeThreadNums property, example as follow.</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>properties.put(PropertyKeyConst.ConsumeThreadNums,20);
+</code></pre>
+</div>
+
+<h2 id="errors">Errors</h2>
+<h3 id="1-start-producer-or-consumer-failed-and-producer-group-or-consumer-repeat">1. Start producer or consumer failed and producer group or consumer repeat?</h3>
+<p>Reason\uff1aIn the same JVM inside using the same Producer ID/Consumer ID launched multiple instances of Producer/Consumer, it may cause the client to start failure.</p>
+
+<p>Solution: Ensure that a JVM corresponds to a Producer ID/Consumer ID starts only with a Producer/Consumer instance.</p>
+
+<h3 id="2-in-broadcast-mode-consumer-start-loading-json-file-failed">2. In broadcast mode, consumer start loading json file failed?</h3>
+<p>Reason: Fastjson version is too low to cause the broadcast consumer to load a local offsets.json file failed, which causing the consumer boot failure.</p>
+
+<p>Solution: Fastjson version will be upgraded to rocketmq client dependent version, to ensure that the local offsets.json can be normal loading. By default offsets.json file is in /home/{user}/.rocketmq_offsets.</p>
+
+<h3 id="3-what-if-a-broker-crashes">3. What if a broker crashes?</h3>
+
+<div class="highlighter-rouge"><pre class="highlight"><code>1. Master crashes
+ Messages can no longer be sent to this broker set, but if you have another broker set available, messages can be still sent there given the topic is present.Messages can still be consumed from slaves.
+2. One slaves crashes
+ As long as there is another working slave, no impact on writing messages;No impact on consuming messages except when the consumer group is set to consume from this slave preferably. By default, it is from master.
+3. All slaves crash
+ No impact on writing messages on master, but if master is a SYNC_MASTER, the producer will get a result of SLAVE_NOT_AVAILABLE indicating that the message is not replicated to any slaves.No impact on consuming messages except that if the consumer group is set to consume from slave preferably. By default, it is from master.
+</code></pre>
+</div>
+
+<h3 id="4-producer-complains-no-topic-route-info-how-to-diagnose">4. Producer complains \u201cNo Topic Route Info\u201d, how to diagnose?</h3>
+<p>This happens when you are trying to send message to a topic whose route info is not available to the producer.</p>
+
+<ol>
+ <li>Confirm the producer can connect to a name server and capable of fetching routing meta info from it.</li>
+ <li>Confirm that name servers do contain routing meta info of the topic. You may query the routing meta info from name server through topicRoute of admin tools or web console.</li>
+ <li>Confirm your brokers are sending heartbeats to the same list of name servers your producer is connecting to.</li>
+ <li>Confirm that the topic\u2019s perm is 6(rw-), or at least 2(-w-).</li>
+</ol>
+
+<p>If you can\u2019t find this topic, create it via admin tools command updateTopic or web console on a broker.</p>
+
+<h2 id="features">Features</h2>
+<h3 id="1-what-kind-of-consumption-pattern-does-rocketmq-provide">1. What kind of consumption pattern does RocketMQ provide?</h3>
+<p>In RocketMQ, it providers two types of consumption patterns, such as Clustering consumption patterns and broadcasting consumption patterns. See the documentation on cluster patterns for details.</p>
+
+<h3 id="2-how-many-kinds-of-message-type-are-supported">2. How many kinds of message type are supported?</h3>
+<p>There are several types of messages that are currently supported in rocketmq\uff0csuch as common message, timed message, transaction message, sequential message and delay message. User can select the appropriate message type according to the needs of the business.</p>
+
+
+ </section>
+
+ <footer class="page__meta">
+
+
+
+
+
+ <p class="page__date"><strong><i class="fa fa-fw fa-calendar" aria-hidden="true"></i> Updated:</strong> <time datetime="2016-12-28">December 28, 2016</time></p>
+
+ </footer>
+
+ <section class="page__share">
+
+ <h4 class="page__share-title">Share on</h4>
+
+
+ <a href="https://twitter.com/intent/tweet?via=ApacheRocketMQ&text=Frequently Asked Questions /docs/faq/" class="btn btn--twitter" title="Share on Twitter"><i class="fa fa-fw fa-twitter" aria-hidden="true"></i><span> Twitter</span></a>
+
+ <a href="https://www.facebook.com/sharer/sharer.php?u=/docs/faq/" class="btn btn--facebook" title="Share on Facebook"><i class="fa fa-fw fa-facebook" aria-hidden="true"></i><span> Facebook</span></a>
+
+ <a href="https://plus.google.com/share?url=/docs/faq/" class="btn btn--google-plus" title="Share on Google Plus"><i class="fa fa-fw fa-google-plus" aria-hidden="true"></i><span> Google+</span></a>
+
+ <a href="https://www.linkedin.com/shareArticle?mini=true&url=/docs/faq/" class="btn btn--linkedin" title="Share on LinkedIn"><i class="fa fa-fw fa-linkedin" aria-hidden="true"></i><span> LinkedIn</span></a>
+</section>
+
+
+
+ <nav class="pagination">
+
+ <a href="/docs/code-guidelines/" class="pagination--pager" title="Coding Guidelines
+">Previous</a>
+
+
+ <a href="#" class="pagination--pager disabled">Next</a>
+
+ </nav>
+
+ </div>
+
+
+ <div class="page__comments">
+
+
+ <h4 class="page__comments-title">Leave a Comment</h4>
+ <section id="disqus_thread"></section>
+
+</div>
+
+ </article>
+
+
+
+</div>
+
+ <div class="page__footer">
+ <footer>
+ <!-- start custom footer snippets -->
+
+<!-- end custom footer snippets -->
+ <div class="page__footer-follow">
+ <ul class="social-icons">
+
+ <li><strong>Follow:</strong></li>
+
+
+ <li><a href="https://twitter.com/ApacheRocketMQ"><i class="fa fa-fw fa-twitter-square" aria-hidden="true"></i> Twitter</a></li>
+
+
+
+ <li><a href="http://github.com/apache/incubator-rocketmq"><i class="fa fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li>
+
+
+ <li><a href="/feed.xml"><i class="fa fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li>
+ </ul>
+</div>
+
+<div class="page__footer-copyright">Copyright © 2016 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.</div>
+ </footer>
+ </div>
+
+ <script src="/assets/js/main.min.js"></script>
+
+
+
+
+
+
+ <script type="text/javascript">
+ /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
+ var disqus_shortname = 'rocketmq';
+
+ /* * * DON'T EDIT BELOW THIS LINE * * */
+ (function() {
+ var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
+ dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+ (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
+ })();
+
+ /* * * DON'T EDIT BELOW THIS LINE * * */
+ (function () {
+ var s = document.createElement('script'); s.async = true;
+ s.type = 'text/javascript';
+ s.src = '//' + disqus_shortname + '.disqus.com/count.js';
+ (document.getElementsByTagName('HEAD')[0] || document.getElementsByTagName('BODY')[0]).appendChild(s);
+ }());
+ </script>
+ <noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+
+
+
+
+
+
+ </body>
+</html>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/motivation/index.html
----------------------------------------------------------------------
diff --git a/content/docs/motivation/index.html b/content/docs/motivation/index.html
index e641841..ac0441c 100644
--- a/content/docs/motivation/index.html
+++ b/content/docs/motivation/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="">Frequently Asked Questions</a></li>
-
- </ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/pull-request/index.html
----------------------------------------------------------------------
diff --git a/content/docs/pull-request/index.html b/content/docs/pull-request/index.html
index 41e50e7..25f82a8 100644
--- a/content/docs/pull-request/index.html
+++ b/content/docs/pull-request/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="">Frequently Asked Questions</a></li>
-
- </ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/docs/quick-start/index.html
----------------------------------------------------------------------
diff --git a/content/docs/quick-start/index.html b/content/docs/quick-start/index.html
index f7e053c..3f580de 100644
--- a/content/docs/quick-start/index.html
+++ b/content/docs/quick-start/index.html
@@ -57,7 +57,7 @@
<meta property="og:type" content="article">
- <meta property="article:published_time" content="2016-12-29T14:51:32+08:00">
+ <meta property="article:published_time" content="2016-12-29T16:56:36+08:00">
@@ -341,15 +341,18 @@
<li><a href="/docs/cli-admin-tool/" class="">Virtualization</a></li>
-
-
+ </ul>
+
+ </li>
+
+ <li>
+
+
+
-
-
+ <a href="/docs/faq/"><span class="nav__sub-title">FAQ</span></a>
+
- <li><a href="/docs/cluster-deployment/" class="">Frequently Asked Questions</a></li>
-
- </ul>
</li>
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/feed.xml
----------------------------------------------------------------------
diff --git a/content/feed.xml b/content/feed.xml
index 9c2e8ab..0175f4d 100644
--- a/content/feed.xml
+++ b/content/feed.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xml" href="/feed.xslt.xml"?><feed xmlns="http://www.w3.org/2005/Atom"><generator uri="http://jekyllrb.com" version="3.3.1">Jekyll</generator><link href="/feed.xml" rel="self" type="application/atom+xml" /><link href="/" rel="alternate" type="text/html" /><updated>2016-12-29T14:51:32+08:00</updated><id>//</id><title type="html">Apache RocketMQ</title><subtitle>The homepage of RocketMQ.</subtitle><author><name>{"name"=>nil, "avatar"=>"/assets/images/rmq-logo.png", "bio"=>"A fast, low latency, reliable, scalable, distributed MOM.", "location"=>"Hangzhou, China", "email"=>"dev@rocketmq.incubator.apache.org", "uri"=>"http://incubator.staging.apache.org/projects/rocketmq.html", "bitbucket"=>nil, "codepen"=>nil, "dribbble"=>nil, "flickr"=>nil, &quo
t;facebook"=>nil, "foursquare"=>nil, "github"=>"apache/incubator-rocketmq", "google_plus"=>nil, "keybase"=>nil, "instagram"=>nil, "lastfm"=>nil, "linkedin"=>nil, "pinterest"=>nil, "soundcloud"=>nil, "stackoverflow"=>"http://stackoverflow.com/questions/tagged/rocketmq", "steam"=>nil, "tumblr"=>nil, "twitter"=>"ApacheRocketMQ", "vine"=>nil, "weibo"=>nil, "xing"=>nil, "youtube"=>nil, "quora"=>"topic/RocketMQ"}</name><email>dev@rocketmq.incubator.apache.org</email><uri>http://incubator.staging.apache.org/projects/rocketmq.html</uri></author><entry><title type="html">Mastering Component Compatible Dependency</title><link href="/maven/mastering-component-compatible-dependency/" rel="alternate" type="text/html" t
itle="Mastering Component Compatible Dependency" /><published>2016-12-23T00:00:00+08:00</published><updated>2016-12-23T00:00:00+08:00</updated><id>/maven/mastering-component-compatible-dependency</id><content type="html" xml:base="/maven/mastering-component-compatible-dependency/"><p>This article mainly includes three parts.at first,I will introduce compatibility principle(more details see <a href="http://blog.csdn.net/fengjia10/article/details/7799227">here</a>) briefly.followed by a detailed elaborating about Java component compatible dependency,including the interface-oriented programming,single component signature protection,single component compatibility protection and multi-component compatibility compile time checking.Finally is the review and prospect,especially about <strong>Dependency Mediator</strong> project.</p>
+<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xml" href="/feed.xslt.xml"?><feed xmlns="http://www.w3.org/2005/Atom"><generator uri="http://jekyllrb.com" version="3.3.1">Jekyll</generator><link href="/feed.xml" rel="self" type="application/atom+xml" /><link href="/" rel="alternate" type="text/html" /><updated>2016-12-29T16:56:36+08:00</updated><id>//</id><title type="html">Apache RocketMQ</title><subtitle>The homepage of RocketMQ.</subtitle><author><name>{"name"=>nil, "avatar"=>"/assets/images/rmq-logo.png", "bio"=>"A fast, low latency, reliable, scalable, distributed MOM.", "location"=>"Hangzhou, China", "email"=>"dev@rocketmq.incubator.apache.org", "uri"=>"http://incubator.staging.apache.org/projects/rocketmq.html", "bitbucket"=>nil, "codepen"=>nil, "dribbble"=>nil, "flickr"=>nil, &quo
t;facebook"=>nil, "foursquare"=>nil, "github"=>"apache/incubator-rocketmq", "google_plus"=>nil, "keybase"=>nil, "instagram"=>nil, "lastfm"=>nil, "linkedin"=>nil, "pinterest"=>nil, "soundcloud"=>nil, "stackoverflow"=>"http://stackoverflow.com/questions/tagged/rocketmq", "steam"=>nil, "tumblr"=>nil, "twitter"=>"ApacheRocketMQ", "vine"=>nil, "weibo"=>nil, "xing"=>nil, "youtube"=>nil, "quora"=>"topic/RocketMQ"}</name><email>dev@rocketmq.incubator.apache.org</email><uri>http://incubator.staging.apache.org/projects/rocketmq.html</uri></author><entry><title type="html">Mastering Component Compatible Dependency</title><link href="/maven/mastering-component-compatible-dependency/" rel="alternate" type="text/html" t
itle="Mastering Component Compatible Dependency" /><published>2016-12-23T00:00:00+08:00</published><updated>2016-12-23T00:00:00+08:00</updated><id>/maven/mastering-component-compatible-dependency</id><content type="html" xml:base="/maven/mastering-component-compatible-dependency/"><p>This article mainly includes three parts.at first,I will introduce compatibility principle(more details see <a href="http://blog.csdn.net/fengjia10/article/details/7799227">here</a>) briefly.followed by a detailed elaborating about Java component compatible dependency,including the interface-oriented programming,single component signature protection,single component compatibility protection and multi-component compatibility compile time checking.Finally is the review and prospect,especially about <strong>Dependency Mediator</strong> project.</p>
<aside class="sidebar__right">
<nav class="toc">
http://git-wip-us.apache.org/repos/asf/incubator-rocketmq-site/blob/173b5e43/content/sitemap.xml
----------------------------------------------------------------------
diff --git a/content/sitemap.xml b/content/sitemap.xml
index 84dffef..d063880 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -36,6 +36,9 @@
<loc>/docs/code-guidelines/</loc>
</url>
<url>
+<loc>/docs/faq/</loc>
+</url>
+<url>
<loc>/about/</loc>
</url>
<url>
@@ -86,4 +89,7 @@
<url>
<loc>/docs/code-guidelines/</loc>
</url>
+<url>
+<loc>/docs/faq/</loc>
+</url>
</urlset>