rocketmq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From huzongt...@apache.org
Subject [rocketmq] branch develop updated: [RIP-9] update FAQ.md in RocketMQ docs/en
Date Thu, 07 Mar 2019 13:48:45 GMT
This is an automated email from the ASF dual-hosted git repository.

huzongtang pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/rocketmq.git


The following commit(s) were added to refs/heads/develop by this push:
     new 3bf799c  [RIP-9] update FAQ.md in RocketMQ docs/en
3bf799c is described below

commit 3bf799c637a40e8884f28a6510cdf95ba718e35d
Author: wubiqing <48171788+wubiqing@users.noreply.github.com>
AuthorDate: Thu Mar 7 21:48:41 2019 +0800

    [RIP-9] update FAQ.md in RocketMQ docs/en
---
 docs/en/FAQ.md | 59 +++++++++++++++++++++++++++++++++-------------------------
 1 file changed, 34 insertions(+), 25 deletions(-)

diff --git a/docs/en/FAQ.md b/docs/en/FAQ.md
index d56c38e..a08315c 100644
--- a/docs/en/FAQ.md
+++ b/docs/en/FAQ.md
@@ -2,34 +2,39 @@
 
 The following questions are frequently asked with regard to the RocketMQ project in general.
 
-## General
+## 1 General
 
-### 1. Why did we create rocketmq project instead of selecting other products?
+1. Why did we create rocketmq project instead of selecting other products?
 
-Please refer to [Why RocketMQ](http://rocketmq.apache.org/docs/motivation)
+   Please refer to [Why RocketMQ](http://rocketmq.apache.org/docs/motivation)
 
-### 2. Do I have to install other softeware, such as zookeeper, to use RocketMQ?
+2. Do I have to install other softeware, such as zookeeper, to use RocketMQ?
 
-No. RocketMQ can run independently.
+   No. RocketMQ can run independently.
 
-## Usage
+## 2 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 consuming messages
from the first message saved in the server.
-2. If the topic sends a message three days ago, the consumer starts to consume messages from
the latest message in the server, in other words, starting from the tail of message queue.
-3. If such consumer is rebooted, then it starts to consume messages from the last consumption
location.
+&#8195;1) If the topic sends a message within three days, then the consumer start consuming
messages from the first message saved in the server.
+  
+&#8195;2) If the topic sends a message three days ago, the consumer starts to consume
messages from the latest message in the server, in other words, starting from the tail of
message queue.
+  
+&#8195;3) If such consumer is rebooted, then it starts to consume messages from the last
consumption location.
 
 ### 2. How to reconsume message when consumption fails?
 
-1. Cluster consumption pattern, The consumer business logic code returns Action.ReconsumerLater,
NULL, or throws an exception, if a message failed to be consumed, it will retry for up to
16 times, after that, the message would be descarded.
-2. Broadcast consumption patternThe broadcaset consumption still ensures that a message is
consumered at least once, but no resend option is provided.
+&#8195;1) Cluster consumption pattern, The consumer business logic code returns Action.ReconsumerLater,
NULL, or throws an exception, if a message failed to be consumed, it will retry for up to
16 times, after that, the message would be descarded.
+  
+&#8195;2) Broadcast consumption patternThe broadcaset consumption still ensures that
a message is consumered at least once, but no resend option is provided.
 
 ### 3. How to query the failed message if there is a consumption failure?
 
-1. Using topic query by time, you can query messages within a period of time.
-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.
+&#8195;1) Using topic query by time, you can query messages within a period of time.
+  
+&#8195;2) Using Topic and Message Id to accurately query the message.
+  
+&#8195;3) Using Topic and Message Key accurately query a class of messages with the same
Message Key.
 
 ### 4. Are messages delivered exactly once?
 
@@ -37,10 +42,11 @@ RocketMQ ensures that all messages are delivered at least once. In most
cases, t
 
 ### 5. How to add a new broker?
 
-1. Start up a new broker and register it to the same list of name servers.
-2. By default, only internal system topics and consumer groups are created automatically.
If you would like to have your business topic and consumer groups on the new node, please
replicate them from the existing broker. Admin tool and command lines are provided to handle
this.
+&#8195;1) Start up a new broker and register it to the same list of name servers.
+  
+&#8195;2) By default, only internal system topics and consumer groups are created automatically.
If you would like to have your business topic and consumer groups on the new node, please
replicate them from the existing broker. Admin tool and command lines are provided to handle
this.
 
-## Configuration related
+## 3 Configuration related
 
 The following answers are all default values and can be modified by configuration.
 
@@ -60,7 +66,7 @@ consumer.setConsumeThreadMin(20);
 consumer.setConsumeThreadMax(20);
 ```
 
-## Errors
+## 4 Errors
 
 ### 1. If you start a producer or consumer failed and the error message is producer group
or consumer repeat.
 
@@ -76,15 +82,15 @@ Solution: Fastjson version has to be upgraded to rocketmq client dependent
versi
 
 ### 3. What is the impact of a broker crash.
 
-1. Master crashes
+&#8195;1) Master crashes
 
 Messages can no longer be sent to this broker set, but if you have another broker set available,
messages can still be sent given the topic is present. Messages can still be consumed from
slaves.
 
-2. Some slave crash
+&#8195;2) Some slave crash
 
 As long as there is another working slave, there will be no impact on sending messages. There
will also be no impact on consuming messages except when the consumer group is set to consume
from this slave preferably. By default, comsumer group consumes from master.
 
-3. All slaves crash
+&#8195;3) All slaves crash
 
 There will be no impact on sending messages to master, but, if the master is SYNC_MASTER,
producer will get a SLAVE_NOT_AVAILABLE indicating that the message is not sent to any slaves.
There will also be no impact on consuming messages except that if the consumer group is set
to consume from slave preferably. By default, comsumer group consumes from master.
 
@@ -92,9 +98,12 @@ There will be no impact on sending messages to master, but, if the master
is SYN
 
 This happens when you are trying to send messages to a topic whose routing info is not available
to the producer.
 
-1. Make sure that the producer can connect to a name server and is capable of fetching routing
meta info from it.
-2. Make sure that name servers do contain routing meta info of the topic. You may query the
routing meta info from name server through topicRoute using admin tools or web console.
-3. Make sure that your brokers are sending heartbeats to the same list of name servers your
producer is connecting to.
-4. Make sure that the topic’s permssion is 6(rw-), or at least 2(-w-).
+&#8195;1) Make sure that the producer can connect to a name server and is capable of
fetching routing meta info from it.
+  
+&#8195;2) Make sure that name servers do contain routing meta info of the topic. You
may query the routing meta info from name server through topicRoute using admin tools or web
console.
+  
+&#8195;3) Make sure that your brokers are sending heartbeats to the same list of name
servers your producer is connecting to.
+  
+&#8195;4) Make sure that the topic’s permssion is 6(rw-), or at least 2(-w-).
 
 If you can’t find this topic, create it on a broker via admin tools command updateTopic
or web console.


Mime
View raw message