You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by il...@apache.org on 2018/07/04 07:42:56 UTC
[incubator-dubbo-website] branch asf-site updated: update admin
manual
This is an automated email from the ASF dual-hosted git repository.
iluo pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-dubbo-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new e9535df update admin manual
e9535df is described below
commit e9535dfdfad8b1119b0e870a0c4c2060072738c2
Author: beiwei30 <ia...@gmail.com>
AuthorDate: Wed Jul 4 15:42:36 2018 +0800
update admin manual
---
build/page.js | 4 +-
docs/en-us/admin/README.md | 4 +
docs/en-us/admin/SUMMARY.md | 10 +
docs/en-us/admin/install/admin-console.md | 50 +++++
docs/en-us/admin/install/consumer-demo.md | 18 ++
docs/en-us/admin/install/introduction.md | 13 ++
docs/en-us/admin/install/provider-demo.md | 17 ++
docs/en-us/admin/install/redis.md | 54 ++++++
docs/en-us/admin/install/simple-monitor-center.md | 94 ++++++++++
docs/en-us/admin/install/simple-registry-center.md | 78 ++++++++
docs/en-us/admin/install/zookeeper.md | 98 ++++++++++
docs/en-us/admin/ops/dubbo-ops.md | 36 ++++
docs/en-us/admin/ops/introduction.md | 1 +
docs/en-us/admin/sources/images/check.gif | Bin 0 -> 604 bytes
.../admin/sources/images/dubbo-add-config.png | Bin 0 -> 100926 bytes
.../en-us/admin/sources/images/dubbo-add-route.png | Bin 0 -> 139777 bytes
.../admin/sources/images/dubbo-applications.png | Bin 0 -> 93036 bytes
.../en-us/admin/sources/images/dubbo-consumers.png | Bin 0 -> 101859 bytes
.../admin/sources/images/dubbo-monitor-simple.jpg | Bin 0 -> 87670 bytes
.../en-us/admin/sources/images/dubbo-providers.png | Bin 0 -> 98504 bytes
docs/en-us/admin/sources/images/dubbo-search.png | Bin 0 -> 65761 bytes
docs/en-us/admin/sources/images/tip.png | Bin 0 -> 876 bytes
docs/en-us/admin/sources/images/warning-3.gif | Bin 0 -> 569 bytes
docs/zh-cn/admin/LICENSE | 201 +++++++++++++++++++++
docs/zh-cn/admin/README.md | 1 +
docs/zh-cn/admin/SUMMARY.md | 10 +
docs/zh-cn/admin/install/admin-console.md | 50 +++++
docs/zh-cn/admin/install/consumer-demo.md | 20 ++
docs/zh-cn/admin/install/introduction.md | 13 ++
docs/zh-cn/admin/install/provider-demo.md | 18 ++
docs/zh-cn/admin/install/redis.md | 54 ++++++
docs/zh-cn/admin/install/simple-monitor-center.md | 95 ++++++++++
docs/zh-cn/admin/install/simple-registry-center.md | 79 ++++++++
docs/zh-cn/admin/install/zookeeper.md | 98 ++++++++++
docs/zh-cn/admin/ops/dubbo-ops.md | 36 ++++
docs/zh-cn/admin/ops/introduction.md | 1 +
.../admin/sources/images/dubbo-add-config.png | Bin 0 -> 100926 bytes
.../zh-cn/admin/sources/images/dubbo-add-route.png | Bin 0 -> 139777 bytes
.../admin/sources/images/dubbo-applications.png | Bin 0 -> 93036 bytes
.../zh-cn/admin/sources/images/dubbo-consumers.png | Bin 0 -> 101859 bytes
.../admin/sources/images/dubbo-monitor-simple.jpg | Bin 0 -> 87670 bytes
.../zh-cn/admin/sources/images/dubbo-providers.png | Bin 0 -> 98504 bytes
docs/zh-cn/admin/sources/images/dubbo-search.png | Bin 0 -> 65761 bytes
md_json/docs.json | 96 ++++++++++
site_config/docs.js | 96 ++++++++++
site_config/site.js | 16 +-
46 files changed, 1353 insertions(+), 8 deletions(-)
diff --git a/build/page.js b/build/page.js
index db09e47..40d363a 100644
--- a/build/page.js
+++ b/build/page.js
@@ -1,6 +1,6 @@
-!function(s){function n(a){if(e[a])return e[a].exports;var t=e[a]={i:a,l:!1,exports:{}};return s[a].call(t.exports,t,t.exports,n),t.l=!0,t.exports}var e={};n.m=s,n.c=e,n.i=function(s){return s},n.d=function(s,e,a){n.o(s,e)||Object.defineProperty(s,e,{configurable:!1,enumerable:!0,get:a})},n.n=function(s){var e=s&&s.__esModule?function(){return s.default}:function(){return s};return n.d(e,"a",e),e},n.o=function(s,n){return Object.prototype.hasOwnProperty.call(s,n)},n.p="/build/",n(n.s=43) [...]
+!function(s){function n(a){if(e[a])return e[a].exports;var t=e[a]={i:a,l:!1,exports:{}};return s[a].call(t.exports,t,t.exports,n),t.l=!0,t.exports}var e={};n.m=s,n.c=e,n.i=function(s){return s},n.d=function(s,e,a){n.o(s,e)||Object.defineProperty(s,e,{configurable:!1,enumerable:!0,get:a})},n.n=function(s){var e=s&&s.__esModule?function(){return s.default}:function(){return s};return n.d(e,"a",e),e},n.o=function(s,n){return Object.prototype.hasOwnProperty.call(s,n)},n.p="/build/",n(n.s=43) [...]
Copyright (c) 2016 Jed Watson.
Licensed under the MIT License (MIT), see
http://jedwatson.github.io/classnames
*/
-!function(){"use strict";function e(){for(var s=[],n=0;n<arguments.length;n++){var a=arguments[n];if(a){var t=typeof a;if("string"===t||"number"===t)s.push(a);else if(Array.isArray(a))s.push(e.apply(null,a));else if("object"===t)for(var o in a)l.call(a,o)&&a[o]&&s.push(o)}}return s.join(" ")}var l={}.hasOwnProperty;void 0!==s&&s.exports?s.exports=e:(a=[],void 0!==(t=function(){return e}.apply(n,a))&&(s.exports=t))}()},function(s,n,e){"use strict";n.decode=n.parse=e(85),n.encode=n.stringi [...]
\ No newline at end of file
+!function(){"use strict";function e(){for(var s=[],n=0;n<arguments.length;n++){var a=arguments[n];if(a){var t=typeof a;if("string"===t||"number"===t)s.push(a);else if(Array.isArray(a))s.push(e.apply(null,a));else if("object"===t)for(var o in a)l.call(a,o)&&a[o]&&s.push(o)}}return s.join(" ")}var l={}.hasOwnProperty;void 0!==s&&s.exports?s.exports=e:(a=[],void 0!==(t=function(){return e}.apply(n,a))&&(s.exports=t))}()},function(s,n,e){"use strict";n.decode=n.parse=e(85),n.encode=n.stringi [...]
\ No newline at end of file
diff --git a/docs/en-us/admin/README.md b/docs/en-us/admin/README.md
new file mode 100644
index 0000000..f831dfb
--- /dev/null
+++ b/docs/en-us/admin/README.md
@@ -0,0 +1,4 @@
+# dubbo-admin-book
+The installation and maintenance guidance of registry center and dubbo-admin.
+
+
diff --git a/docs/en-us/admin/SUMMARY.md b/docs/en-us/admin/SUMMARY.md
new file mode 100644
index 0000000..9713d94
--- /dev/null
+++ b/docs/en-us/admin/SUMMARY.md
@@ -0,0 +1,10 @@
+* [1 install manual](install/introduction.md)
+ * [1.1 install provider demo](install/provider-demo.md)
+ * [1.2 install consumer demo](install/consumer-demo.md)
+ * [1.3 install Zookeeper configuration center](install/zookeeper.md)
+ * [1.4 install Redis configuration center](install/redis.md)
+ * [1.5 install Simple configuration center](install/simple-registry-center.md)
+ * [1.6 install Simple monitor center](install/simple-monitor-center.md)
+ * [1.7 install admin console](install/admin-console.md)
+* [2 Ops manual]()
+ * [2.1 admin-console Ops](ops/dubbo-ops.md)
diff --git a/docs/en-us/admin/install/admin-console.md b/docs/en-us/admin/install/admin-console.md
new file mode 100644
index 0000000..516a4f6
--- /dev/null
+++ b/docs/en-us/admin/install/admin-console.md
@@ -0,0 +1,50 @@
+# Install admin console
+
+Include: route rule, dynamic configuration, service downgrade, access control, weight adjustment, load balance, etc.
+
+Install:
+
+```sh
+wget http://apache.etoak.com/tomcat/tomcat-6/v6.0.35/bin/apache-tomcat-6.0.35.tar.gz
+tar zxvf apache-tomcat-6.0.35.tar.gz
+cd apache-tomcat-6.0.35
+rm -rf webapps/ROOT
+
+git clone https://github.com/dubbo/dubbo-ops.git /var/tmp/dubbo-ops
+pushd /var/tmp/dubbo-ops
+mvn clean package
+popd
+
+unzip /var/tmp/dubbo-ops/dubbo-admin/target/dubbo-admin-2.0.0.war -d webapps/ROOT
+```
+
+Configuration [^1]:
+
+```sh
+vi webapps/ROOT/WEB-INF/dubbo.properties
+dubbo.properties
+dubbo.registry.address=zookeeper://127.0.0.1:2181
+dubbo.admin.root.password=root
+dubbo.admin.guest.password=guest
+```
+
+Start:
+
+```sh
+./bin/startup.sh
+```
+
+Stop:
+
+```sh
+./bin/shutdown.sh
+```
+
+Visit [^2]:
+
+```
+http://127.0.0.1:8080/
+```
+
+[^1]: Or put `dubbo.properties` in current user directory
+[^2]: User: root, password: root or user: guest, password: guest
diff --git a/docs/en-us/admin/install/consumer-demo.md b/docs/en-us/admin/install/consumer-demo.md
new file mode 100644
index 0000000..b6e1bf1
--- /dev/null
+++ b/docs/en-us/admin/install/consumer-demo.md
@@ -0,0 +1,18 @@
+
+# install demo consumer
+
+install:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo.git
+cd incubator-dubbo
+Please start Provider first
+add -Djava.net.preferIPv4Stack=true if your IDE is Intellij Idea
+```
+
+configuration:
+
+```sh
+resource/META-INFO.spring/dubbo-demo-consumer.xml
+change dubbo:registery to the real registery center address
+```
diff --git a/docs/en-us/admin/install/introduction.md b/docs/en-us/admin/install/introduction.md
new file mode 100644
index 0000000..e2bc8af
--- /dev/null
+++ b/docs/en-us/admin/install/introduction.md
@@ -0,0 +1,13 @@
+# Install manual
+
+You can run Demo Provider and Demo Consumer only, the default discovery strategy is Multicast by configuration center broadcast, do not run the two parts on the same machine, if you have to do so, set `unicast=false`, like `multicast://224.5.6.7:1234?unicast=false`, or the unicast send to consumer will be taken by provider, and the same for consumers. Only multicast has this issue
+
+You can run multiple Demo Provider and Demo consumer to verify load balance. Demo Consumer can run multi instance directly. Because of port conflict, you can either run multi Demo Providers on different machines or modify the value of `dubbo.protocol.port` in `conf/dubbo.properties` under the install directory of `conf/dubbo.properties`
+
+You can add Simple Monitor as a monitor center, the default discovery strategy is Multicast by configuration center broadcast, display the dependency relationship, call times and cost
+
+You can use Zookeeper instead of Multicast as the configuration center, after Zookeeper Registry installation, modify `conf/dubbo.properties` under the installation directory of Demo Provider, Demo Consumer and Simple Monitor, change the value of `dubbo.registry.address` to `zookeeper://127.0.0.1:2181`(`redis://127.0.0.1:6379` for Redis Registry). the value for Simple Registry is `dubbo://127.0.0.1:9090`
+
+Zookeeper configuration address is recommended
+
+[^1]: NOTICE: multicast can be neither 127.0.0.1 nor the machine's IP address, it must be a type D broadcast address, from 224.0.0.0 to 239.255.255.255
diff --git a/docs/en-us/admin/install/provider-demo.md b/docs/en-us/admin/install/provider-demo.md
new file mode 100644
index 0000000..a41892a
--- /dev/null
+++ b/docs/en-us/admin/install/provider-demo.md
@@ -0,0 +1,17 @@
+# install demo provider
+
+install:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo.git
+cd incubator-dubbo
+run com.alibaba.dubbo.demo.provider.Provider under dubbo-demo-provider module
+add -Djava.net.preferIPv4Stack=true if your IDE is Intellij Idea
+```
+
+configuration:
+
+```sh
+resource/META-INFO.spring/dubbo-demo-provider.xml
+change dubbo:registery to a real registery server address, zookeeper is recommanded
+```
diff --git a/docs/en-us/admin/install/redis.md b/docs/en-us/admin/install/redis.md
new file mode 100644
index 0000000..ce48780
--- /dev/null
+++ b/docs/en-us/admin/install/redis.md
@@ -0,0 +1,54 @@
+# install Redis register center
+
+
+
+Redis [^1] introductions, please refer to: [Redis application center manual](http://dubbo.apache.org/books/dubbo-user-book-en/references/registry/redis.html)。
+
+you need an origin Redis server only, and change the value from `dubbo.registry.addrss` to `redis://127.0.0.1:6379` in `conf/dubbo.properties` of [quick start](http://dubbo.apache.org/books/dubbo-user-book-en/quick-start.html)
+
+Redis configuration center cluster [^2] write multiple server in client side and read from a single server.
+
+Install:
+
+```sh
+wget http://redis.googlecode.com/files/redis-2.4.8.tar.gz
+tar xzf redis-2.4.8.tar.gz
+cd redis-2.4.8
+make
+```
+
+Configuration:
+
+```sh
+vi redis.conf
+```
+
+Start:
+
+```sh
+nohup ./src/redis-server redis.conf &
+```
+
+Stop:
+
+```sh
+killall redis-server
+```
+
+* Command line [^3]:
+
+```sh
+./src/redis-cli
+hgetall /dubbo/com.foo.BarService/providers
+```
+
+Or:
+
+```sh
+telnet 127.0.0.1 6379
+hgetall /dubbo/com.foo.BarService/providers
+```
+
+[^1]: Redis is a high performance KV store server, please refer to: http://redis.io/topics/quickstart
+[^2]: Support for version `2.1.0` and higher
+[^3]: Please refer to: http://redis.io/commands
\ No newline at end of file
diff --git a/docs/en-us/admin/install/simple-monitor-center.md b/docs/en-us/admin/install/simple-monitor-center.md
new file mode 100644
index 0000000..7e9a715
--- /dev/null
+++ b/docs/en-us/admin/install/simple-monitor-center.md
@@ -0,0 +1,94 @@
+# install Simple monitor center
+
+## Step
+
+install:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo-ops
+cd incubator-dubbo-ops && mvn package
+cd dubbo-monitor-simple/target && tar xvf dubbo-monitor-simple-2.0.0-assembly.tar.gz
+cd dubbo-monitor-simple-2.0.0
+```
+
+configuration:
+
+```sh
+vi conf/dubbo.properties
+```
+
+start:
+
+```sh
+./assembly.bin/start.sh
+```
+
+stop:
+
+```sh
+./assembly.bin/stop.sh
+```
+
+restart:
+
+```sh
+./assembly.bin/restart.sh
+```
+
+debug:
+
+```sh
+./assembly.bin/start.sh debug
+```
+
+system status:
+
+```sh
+./assembly.bin/dump.sh
+```
+
+General control entrance:
+
+```sh
+./assembly.bin/server.sh start
+./assembly.bin/server.sh stop
+./assembly.bin/server.sh restart
+./assembly.bin/server.sh debug
+./assembly.bin/server.sh dump
+```
+
+Stdout:
+
+```sh
+tail -f logs/stdout.log
+```
+
+Command line [^1]:
+
+```sh
+telnet 127.0.0.1 7070
+help
+```
+
+Or:
+
+```sh
+echo status | nc -i 1 127.0.0.1 7070
+```
+
+Visit:
+
+```
+http://127.0.0.1:8080
+```
+
+
+
+## NOTICE
+The failure of Simple Monitor will not effect on consumer and provider's running, therefore there would be no risk in production environment
+Simple Monitor use disk to store statistics information, please focus on the limitation of your machine. Mount share disk is recommended if cluster is needed
+
+Charts directory must be in `jetty.directory`, or it can not be accessed by web page.
+
+[^1]: Please refer to [Telnet command reference manual](http://dubbo.apache.org/books/dubbo-user-book-en/references/telnet.html)
+
diff --git a/docs/en-us/admin/install/simple-registry-center.md b/docs/en-us/admin/install/simple-registry-center.md
new file mode 100644
index 0000000..752e00b
--- /dev/null
+++ b/docs/en-us/admin/install/simple-registry-center.md
@@ -0,0 +1,78 @@
+# install Simple configuration center
+
+Simple Registry has not been well tested, may have bug, cluster is not supported, not recommended to use in production environment
+
+Install:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo-ops
+cd incubator-dubbo-ops && mvn package
+cd dubbo-registry-simple/target && tar xvf dubbo-registry-simple-2.0.0-assembly.tar.gz
+cd dubbo-registry-simple-2.0.0
+```
+
+Configuration:
+
+```sh
+vi conf/dubbo.properties
+```
+
+Start:
+
+```sh
+./assembly.bin/start.sh
+```
+
+Stop:
+
+```sh
+./assembly.bin/stop.sh
+```
+
+Restart:
+
+```sh
+./assembly.bin/restart.sh
+```
+
+Debug:
+
+```sh
+./assembly.bin/start.sh debug
+```
+
+System status:
+
+```sh
+./assembly.bin/dump.sh
+```
+
+General control entrance:
+```sh
+./assembly.bin/server.sh start
+./assembly.bin/server.sh stop
+./assembly.bin/server.sh restart
+./assembly.bin/server.sh debug
+./assembly.bin/server.sh dump
+```
+
+Stdout:
+
+```sh
+tail -f logs/stdout.log
+```
+
+Command line [^1]:
+
+```shell
+telnet 127.0.0.1 9090
+help
+```
+
+Or:
+
+```sh
+echo status | nc -i 1 127.0.0.1 9090
+```
+
+[^1]: Please refer to [Telnet command manual](http://dubbo.apache.org/books/dubbo-user-book-en/references/telnet.html)
diff --git a/docs/en-us/admin/install/zookeeper.md b/docs/en-us/admin/install/zookeeper.md
new file mode 100644
index 0000000..a1fb924
--- /dev/null
+++ b/docs/en-us/admin/install/zookeeper.md
@@ -0,0 +1,98 @@
+# install Zookeeper configuration center
+
+zookeeper register center client version: `dubbo-2.3.3` and above[^1]
+
+Dubbo changes nothing of Zookeeper's server side, an original Zookeeper server is fine. All change happens while calling Zookeeper's client side
+
+install:
+
+```sh
+wget http://archive.apache.org/dist/zookeeper/zookeeper-3.3.3/zookeeper-3.3.3.tar.gz
+tar zxvf zookeeper-3.3.3.tar.gz
+cd zookeeper-3.3.3
+cp conf/zoo_sample.cfg conf/zoo.cfg
+```
+
+configuration:
+
+```sh
+vi conf/zoo.cfg
+```
+
+If cluster is not needed, the content of `zoo.cfg` is as below [^2]:
+
+```properties
+tickTime=2000
+initLimit=10
+syncLimit=5
+dataDir=/home/dubbo/zookeeper-3.3.3/data
+clientPort=2181
+```
+
+If cluster is needed, the content of `zoo.cfg` is as below [^3]:
+
+```properties
+tickTime=2000
+initLimit=10
+syncLimit=5
+dataDir=/home/dubbo/zookeeper-3.3.3/data
+clientPort=2181
+server.1=10.20.153.10:2555:3555
+server.2=10.20.153.11:2555:3555
+```
+
+Put myid file in data directory [^4]:
+
+```sh
+mkdir data
+vi myid
+```
+
+Myid is the number after `server` in `zoo.cfg`. The first one's content is 1, the second one's content is 2:
+
+```
+1
+```
+
+Start:
+
+```sh
+./bin/zkServer.sh start
+```
+
+Stop:
+
+```sh
+./bin/zkServer.sh stop
+```
+
+Command line [^5]:
+
+```sh
+telnet 127.0.0.1 2181
+dump
+```
+
+Or:
+
+```shell
+echo dump | nc 127.0.0.1 2181
+```
+
+Usage:
+
+```xml
+dubbo.registry.address=zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181
+```
+
+Or:
+
+```xml
+<dubbo:registry protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181" />
+```
+
+[^1]: Zookeeper is a sub project of Apache Hadoop.As it is robust, we recommend to use in production environment.
+[^2]: Data directory should be changed into your real output directory
+[^3]: Data directory and server address should be changed into your real machine information
+[^4]: `dataDir` in `zoo.cfg`
+[^5]: http://zookeeper.apache.org/doc/r3.3.3/zookeeperAdmin.html
diff --git a/docs/en-us/admin/ops/dubbo-ops.md b/docs/en-us/admin/ops/dubbo-ops.md
new file mode 100644
index 0000000..8d48792
--- /dev/null
+++ b/docs/en-us/admin/ops/dubbo-ops.md
@@ -0,0 +1,36 @@
+# Ops console management
+
+## Page search
+
+If you need to manage a Dubbo service, you need to search it first and open it's management page
+
+
+
+## Service provider page
+
+
+
+## Service consumer page
+
+
+
+## Service application page
+
+
+
+## Add route rule page
+
+
+
+## Add dynamic configuration page
+
+
+
+##### Service register
+##### Service downgrade
+##### Route rule
+##### Access control
+##### Dynamic configuration
+##### Weight adjustment
+##### Load balance
+##### Service owner
diff --git a/docs/en-us/admin/ops/introduction.md b/docs/en-us/admin/ops/introduction.md
new file mode 100644
index 0000000..c44f2b5
--- /dev/null
+++ b/docs/en-us/admin/ops/introduction.md
@@ -0,0 +1 @@
+# Ops manual
\ No newline at end of file
diff --git a/docs/en-us/admin/sources/images/check.gif b/docs/en-us/admin/sources/images/check.gif
new file mode 100644
index 0000000..28bb999
Binary files /dev/null and b/docs/en-us/admin/sources/images/check.gif differ
diff --git a/docs/en-us/admin/sources/images/dubbo-add-config.png b/docs/en-us/admin/sources/images/dubbo-add-config.png
new file mode 100644
index 0000000..4edfa43
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-add-config.png differ
diff --git a/docs/en-us/admin/sources/images/dubbo-add-route.png b/docs/en-us/admin/sources/images/dubbo-add-route.png
new file mode 100644
index 0000000..ff0243c
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-add-route.png differ
diff --git a/docs/en-us/admin/sources/images/dubbo-applications.png b/docs/en-us/admin/sources/images/dubbo-applications.png
new file mode 100644
index 0000000..60a95e9
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-applications.png differ
diff --git a/docs/en-us/admin/sources/images/dubbo-consumers.png b/docs/en-us/admin/sources/images/dubbo-consumers.png
new file mode 100644
index 0000000..d10982f
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-consumers.png differ
diff --git a/docs/en-us/admin/sources/images/dubbo-monitor-simple.jpg b/docs/en-us/admin/sources/images/dubbo-monitor-simple.jpg
new file mode 100644
index 0000000..66967e5
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-monitor-simple.jpg differ
diff --git a/docs/en-us/admin/sources/images/dubbo-providers.png b/docs/en-us/admin/sources/images/dubbo-providers.png
new file mode 100644
index 0000000..172cebb
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-providers.png differ
diff --git a/docs/en-us/admin/sources/images/dubbo-search.png b/docs/en-us/admin/sources/images/dubbo-search.png
new file mode 100644
index 0000000..5bbafe4
Binary files /dev/null and b/docs/en-us/admin/sources/images/dubbo-search.png differ
diff --git a/docs/en-us/admin/sources/images/tip.png b/docs/en-us/admin/sources/images/tip.png
new file mode 100644
index 0000000..15064c0
Binary files /dev/null and b/docs/en-us/admin/sources/images/tip.png differ
diff --git a/docs/en-us/admin/sources/images/warning-3.gif b/docs/en-us/admin/sources/images/warning-3.gif
new file mode 100644
index 0000000..1c9883b
Binary files /dev/null and b/docs/en-us/admin/sources/images/warning-3.gif differ
diff --git a/docs/zh-cn/admin/LICENSE b/docs/zh-cn/admin/LICENSE
new file mode 100644
index 0000000..8dada3e
--- /dev/null
+++ b/docs/zh-cn/admin/LICENSE
@@ -0,0 +1,201 @@
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "{}"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright {yyyy} {name of copyright owner}
+
+ Licensed 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.
diff --git a/docs/zh-cn/admin/README.md b/docs/zh-cn/admin/README.md
new file mode 100644
index 0000000..8cd058e
--- /dev/null
+++ b/docs/zh-cn/admin/README.md
@@ -0,0 +1 @@
+这篇文档详细讲解了 dubbo 注册中心、管理控制台的安装和使用。
\ No newline at end of file
diff --git a/docs/zh-cn/admin/SUMMARY.md b/docs/zh-cn/admin/SUMMARY.md
new file mode 100644
index 0000000..eb654c9
--- /dev/null
+++ b/docs/zh-cn/admin/SUMMARY.md
@@ -0,0 +1,10 @@
+* [1 安装手册](install/introduction.md)
+ * [1.1 示例提供者安装](install/provider-demo.md)
+ * [1.2 示例消费者安装](install/consumer-demo.md)
+ * [1.3 Zookeeper 注册中心安装](install/zookeeper.md)
+ * [1.4 Redis 注册中心安装](install/redis.md)
+ * [1.5 Simple 注册中心安装](install/simple-registry-center.md)
+ * [1.6 Simple 监控中心安装](install/simple-monitor-center.md)
+ * [1.7 管理控制台安装](install/admin-console.md)
+* [2 运维手册](ops/introduction.md)
+ * [2.1 管理控制台运维](ops/dubbo-ops.md)
diff --git a/docs/zh-cn/admin/install/admin-console.md b/docs/zh-cn/admin/install/admin-console.md
new file mode 100644
index 0000000..d93f0f7
--- /dev/null
+++ b/docs/zh-cn/admin/install/admin-console.md
@@ -0,0 +1,50 @@
+# 管理控制台安装
+
+管理控制台为内部裁剪版本，开源部分主要包含：路由规则，动态配置，服务降级，访问控制，权重调整，负载均衡，等管理功能。
+
+安装:
+
+```sh
+wget http://apache.etoak.com/tomcat/tomcat-6/v6.0.35/bin/apache-tomcat-6.0.35.tar.gz
+tar zxvf apache-tomcat-6.0.35.tar.gz
+cd apache-tomcat-6.0.35
+rm -rf webapps/ROOT
+
+git clone https://github.com/dubbo/dubbo-ops.git /var/tmp/dubbo-ops
+pushd /var/tmp/dubbo-ops
+mvn clean package
+popd
+
+unzip /var/tmp/dubbo-ops/dubbo-admin/target/dubbo-admin-2.0.0.war -d webapps/ROOT
+```
+
+配置 [^1]:
+
+```sh
+vi webapps/ROOT/WEB-INF/dubbo.properties
+dubbo.properties
+dubbo.registry.address=zookeeper://127.0.0.1:2181
+dubbo.admin.root.password=root
+dubbo.admin.guest.password=guest
+```
+
+启动:
+
+```sh
+./bin/startup.sh
+```
+
+停止:
+
+```sh
+./bin/shutdown.sh
+```
+
+访问 [^2]:
+
+```
+http://127.0.0.1:8080/
+```
+
+[^1]: 或将 `dubbo.properties` 放在当前用户目录下
+[^2]: 用户: root, 密码: root 或者 用户: guest, 密码: guest
\ No newline at end of file
diff --git a/docs/zh-cn/admin/install/consumer-demo.md b/docs/zh-cn/admin/install/consumer-demo.md
new file mode 100644
index 0000000..c68e11f
--- /dev/null
+++ b/docs/zh-cn/admin/install/consumer-demo.md
@@ -0,0 +1,20 @@
+
+# 示例消费者安装
+
+安装:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo.git
+cd incubator-dubbo
+运行 dubbo-demo-consumer中的com.alibaba.dubbo.demo.consumer.Consumer
+请确保先启动Provider
+如果使用Intellij Idea 请加上-Djava.net.preferIPv4Stack=true
+```
+
+配置:
+
+```sh
+resource/META-INFO.spring/dubbo-demo-consumer.xml
+修改其中的dubbo:registery，替换成Provider提供的注册中心地址
+```
+
diff --git a/docs/zh-cn/admin/install/introduction.md b/docs/zh-cn/admin/install/introduction.md
new file mode 100644
index 0000000..53e8d43
--- /dev/null
+++ b/docs/zh-cn/admin/install/introduction.md
@@ -0,0 +1,13 @@
+# 安装手册
+
+你可以只运行 Demo Provider 和 Demo Consumer，它们缺省配置为通过 Multicast [^1] 注册中心广播互相发现，建议在不同机器上运行，如果在同一机器上，需设置 `unicast=false`：即： `multicast://224.5.6.7:1234?unicast=false`，否则发给消费者的单播消息可能被提供者抢占，两个消费者在同一台机器也一样，只有 multicast 注册中心有此问题。
+
+你也可以运行多个 Demo Provider 和 Demo Consumer，来验证软负载均衡，Demo Consumer 可以直接启动多个实例，而多个 Demo Provider 因有端口冲突，可在不同机器上运行，或者修改 Demo Provider 安装目录下 `conf/dubbo.properties` 配置中的 `dubbo.protocol.port` 的值。
+
+你也可以增加运行 Simple Monitor 监控中心，它缺省配置为通过 Multicast 注册中心广播发现 Provider 和 Consumer，并展示出它们的依赖关系，以及它们之间调用的次数和时间。
+
+你也可以将 Multicast 注册中心换成 Zookeeper 注册中心，安装 Zookeeper Registry 后，修改 Demo Proivder，Demo Consumer，Simple Monitor 三者安装目录下的 `conf/dubbo.properties`，将 `dubbo.registry.address` 的值改为 `zookeeper://127.0.0.1:2181`，同理，如果换成 Redis Registry，值改为 `redis://127.0.0.1:6379`，如果换成 Simple Registry，值改为 `dubbo://127.0.0.1:9090`
+
+推荐使用 Zookeeper 注册中心
+
+[^1]: 注意：multicast 地址不能配成 127.0.0.1，也不能配成机器的 IP 地址，必须是 D 段广播地址，也就是：224.0.0.0 到 239.255.255.255 之间的任意地址
\ No newline at end of file
diff --git a/docs/zh-cn/admin/install/provider-demo.md b/docs/zh-cn/admin/install/provider-demo.md
new file mode 100644
index 0000000..50da3f5
--- /dev/null
+++ b/docs/zh-cn/admin/install/provider-demo.md
@@ -0,0 +1,18 @@
+# 示例提供者安装
+
+安装：
+
+```sh
+git clone https://github.com/apache/incubator-dubbo.git
+cd incubator-dubbo
+运行 dubbo-demo-provider中的com.alibaba.dubbo.demo.provider.Provider
+如果使用Intellij Idea 请加上-Djava.net.preferIPv4Stack=true
+```
+
+配置：
+
+```sh
+resource/META-INFO.spring/dubbo-demo-provider.xml
+修改其中的dubbo:registery，替换成真实的注册中心地址，推荐使用zookeeper
+```
+
diff --git a/docs/zh-cn/admin/install/redis.md b/docs/zh-cn/admin/install/redis.md
new file mode 100644
index 0000000..b7b518c
--- /dev/null
+++ b/docs/zh-cn/admin/install/redis.md
@@ -0,0 +1,54 @@
+# Redis 注册中心安装
+
+
+
+Redis [^1] 使用方式参见: [Redis 注册中心参考手册](http://dubbo.apache.org/books/dubbo-user-book/references/registry/redis.html)。
+
+只需搭一个原生的 Redis 服务器，并将[快速启动](http://dubbo.apache.org/books/dubbo-user-book/quick-start.html)中 Provider 和 Consumer 里的 `conf/dubbo.properties` 中的 `dubbo.registry.addrss` 的值改为 `redis://127.0.0.1:6379` 即可使用。
+
+Redis 注册中心集群 [^2] 采用在客户端同时写入多个服务器，读取单个服务器的策略实现。
+
+安装:
+
+```sh
+wget http://redis.googlecode.com/files/redis-2.4.8.tar.gz
+tar xzf redis-2.4.8.tar.gz
+cd redis-2.4.8
+make
+```
+
+配置:
+
+```sh
+vi redis.conf
+```
+
+启动:
+
+```sh
+nohup ./src/redis-server redis.conf &
+```
+
+停止:
+
+```sh
+killall redis-server
+```
+
+* 命令行 [^3]:
+
+```sh
+./src/redis-cli
+hgetall /dubbo/com.foo.BarService/providers
+```
+
+或者：
+
+```sh
+telnet 127.0.0.1 6379
+hgetall /dubbo/com.foo.BarService/providers
+```
+
+[^1]: Redis 是一个高效的 KV 存储服务器，参见：http://redis.io/topics/quickstart
+[^2]: `2.1.0` 以上版本支持
+[^3]: 参见: http://redis.io/commands
diff --git a/docs/zh-cn/admin/install/simple-monitor-center.md b/docs/zh-cn/admin/install/simple-monitor-center.md
new file mode 100644
index 0000000..28ab3bc
--- /dev/null
+++ b/docs/zh-cn/admin/install/simple-monitor-center.md
@@ -0,0 +1,95 @@
+# Simple 监控中心安装
+
+## 安装步骤
+
+安装:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo-ops
+cd incubator-dubbo-ops && mvn package
+cd dubbo-monitor-simple/target && tar xvf dubbo-monitor-simple-2.0.0-assembly.tar.gz
+cd dubbo-monitor-simple-2.0.0
+```
+
+配置:
+
+```sh
+vi conf/dubbo.properties
+```
+
+启动:
+
+```sh
+./assembly.bin/start.sh
+```
+
+停止:
+
+```sh
+./assembly.bin/stop.sh
+```
+
+重启:
+
+```sh
+./assembly.bin/restart.sh
+```
+
+调试:
+
+```sh
+./assembly.bin/start.sh debug
+```
+
+系统状态:
+
+```sh
+./assembly.bin/dump.sh
+```
+
+总控入口:
+
+```sh
+./assembly.bin/server.sh start
+./assembly.bin/server.sh stop
+./assembly.bin/server.sh restart
+./assembly.bin/server.sh debug
+./assembly.bin/server.sh dump
+```
+
+标准输出:
+
+```sh
+tail -f logs/stdout.log
+```
+
+命令行 [^1]:
+
+```sh
+telnet 127.0.0.1 7070
+help
+```
+
+或者:
+
+```sh
+echo status | nc -i 1 127.0.0.1 7070
+```
+
+访问:
+
+```
+http://127.0.0.1:8080
+```
+
+
+
+## 注意事项
+Simple Monitor 挂掉不会影响到 Consumer 和 Provider 之间的调用，所以用于生产环境不会有风险。
+
+Simple Monitor 采用磁盘存储统计信息，请注意安装机器的磁盘限制，如果要集群，建议用mount共享磁盘。
+
+charts 目录必须放在 `jetty.directory` 下，否则页面上访问不了。
+
+[^1]: 请参考 [Telnet 命令参考手册](http://dubbo.apache.org/books/dubbo-user-book/references/telnet.html)
+
diff --git a/docs/zh-cn/admin/install/simple-registry-center.md b/docs/zh-cn/admin/install/simple-registry-center.md
new file mode 100644
index 0000000..6eef802
--- /dev/null
+++ b/docs/zh-cn/admin/install/simple-registry-center.md
@@ -0,0 +1,79 @@
+# Simple 注册中心安装
+
+Simple Registry 没有经过严格测试，可能不健状，并且不支持集群，不建议用于生产环境。
+
+安装:
+
+```sh
+git clone https://github.com/apache/incubator-dubbo-ops
+cd incubator-dubbo-ops && mvn package
+cd dubbo-registry-simple/target && tar xvf dubbo-registry-simple-2.0.0-assembly.tar.gz
+cd dubbo-registry-simple-2.0.0
+```
+
+配置:
+
+```sh
+vi conf/dubbo.properties
+```
+
+启动:
+
+```sh
+./assembly.bin/start.sh
+```
+
+停止:
+
+```sh
+./assembly.bin/stop.sh
+```
+
+重启:
+
+```sh
+./assembly.bin/restart.sh
+```
+
+调试:
+
+```sh
+./assembly.bin/start.sh debug
+```
+
+系统状态:
+
+```sh
+./assembly.bin/dump.sh
+```
+
+总控入口:
+
+```sh
+./assembly.bin/server.sh start
+./assembly.bin/server.sh stop
+./assembly.bin/server.sh restart
+./assembly.bin/server.sh debug
+./assembly.bin/server.sh dump
+```
+
+标准输出:
+
+```sh
+tail -f logs/stdout.log
+```
+
+命令行 [^1]:
+
+```shell
+telnet 127.0.0.1 9090
+help
+```
+
+或者:
+
+```sh
+echo status | nc -i 1 127.0.0.1 9090
+```
+
+[^1]: 请参考 [Telnet 命令参考手册](http://dubbo.apache.org/books/dubbo-user-book/references/telnet.html)
diff --git a/docs/zh-cn/admin/install/zookeeper.md b/docs/zh-cn/admin/install/zookeeper.md
new file mode 100644
index 0000000..1cafbf8
--- /dev/null
+++ b/docs/zh-cn/admin/install/zookeeper.md
@@ -0,0 +1,98 @@
+# Zookeeper 注册中心安装
+
+建议使用 `dubbo-2.3.3` 以上版本的 zookeeper [^1] 注册中心客户端。
+
+Dubbo 未对 Zookeeper 服务器端做任何侵入修改，只需安装原生的 Zookeeper 服务器即可，所有注册中心逻辑适配都在调用 Zookeeper 客户端时完成。
+
+安装:
+
+```sh
+wget http://archive.apache.org/dist/zookeeper/zookeeper-3.3.3/zookeeper-3.3.3.tar.gz
+tar zxvf zookeeper-3.3.3.tar.gz
+cd zookeeper-3.3.3
+cp conf/zoo_sample.cfg conf/zoo.cfg
+```
+
+配置:
+
+```sh
+vi conf/zoo.cfg
+```
+
+如果不需要集群，`zoo.cfg` 的内容如下 [^2]：
+
+```properties
+tickTime=2000
+initLimit=10
+syncLimit=5
+dataDir=/home/dubbo/zookeeper-3.3.3/data
+clientPort=2181
+```
+
+如果需要集群，`zoo.cfg` 的内容如下 [^3]：
+
+```properties
+tickTime=2000
+initLimit=10
+syncLimit=5
+dataDir=/home/dubbo/zookeeper-3.3.3/data
+clientPort=2181
+server.1=10.20.153.10:2555:3555
+server.2=10.20.153.11:2555:3555
+```
+
+并在 data 目录 [^4] 下放置 myid 文件：
+
+```sh
+mkdir data
+vi myid
+```
+
+myid 指明自己的 id，对应上面 `zoo.cfg` 中 `server.` 后的数字，第一台的内容为 1，第二台的内容为 2，内容如下：
+
+```
+1
+```
+
+启动:
+
+```sh
+./bin/zkServer.sh start
+```
+
+停止:
+
+```sh
+./bin/zkServer.sh stop
+```
+
+命令行 [^5]:
+
+```sh
+telnet 127.0.0.1 2181
+dump
+```
+
+或者:
+
+```shell
+echo dump | nc 127.0.0.1 2181
+```
+
+用法:
+
+```xml
+dubbo.registry.address=zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181
+```
+
+或者:
+
+```xml
+<dubbo:registry protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181" />
+```
+
+[^1]: Zookeeper是 Apache Hadoop 的子项目，强度相对较好，建议生产环境使用该注册中心
+[^2]: 其中 data 目录需改成你真实输出目录
+[^3]: 其中 data 目录和 server 地址需改成你真实部署机器的信息
+[^4]: 上面 `zoo.cfg` 中的 `dataDir`
+[^5]: http://zookeeper.apache.org/doc/r3.3.3/zookeeperAdmin.html
diff --git a/docs/zh-cn/admin/ops/dubbo-ops.md b/docs/zh-cn/admin/ops/dubbo-ops.md
new file mode 100644
index 0000000..d31f0ed
--- /dev/null
+++ b/docs/zh-cn/admin/ops/dubbo-ops.md
@@ -0,0 +1,36 @@
+# 管理控制台运维
+
+## 搜索页面
+
+当你需要管理 Dubbo 的服务时，首先要搜索到这个服务，然后打开它的管理页面
+
+
+
+## 服务提供者页面
+
+
+
+## 服务消费者页面
+
+
+
+## 服务应用页面
+
+
+
+## 添加路由规则页面
+
+
+
+## 添加动态配置页面
+
+
+
+##### 服务注册
+##### 服务降级
+##### 路由规则
+##### 访问控制
+##### 动态配置
+##### 权重调节
+##### 负载均衡
+##### 服务负责人
\ No newline at end of file
diff --git a/docs/zh-cn/admin/ops/introduction.md b/docs/zh-cn/admin/ops/introduction.md
new file mode 100644
index 0000000..24561bf
--- /dev/null
+++ b/docs/zh-cn/admin/ops/introduction.md
@@ -0,0 +1 @@
+# 运维手册
\ No newline at end of file
diff --git a/docs/zh-cn/admin/sources/images/dubbo-add-config.png b/docs/zh-cn/admin/sources/images/dubbo-add-config.png
new file mode 100644
index 0000000..4edfa43
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-add-config.png differ
diff --git a/docs/zh-cn/admin/sources/images/dubbo-add-route.png b/docs/zh-cn/admin/sources/images/dubbo-add-route.png
new file mode 100644
index 0000000..ff0243c
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-add-route.png differ
diff --git a/docs/zh-cn/admin/sources/images/dubbo-applications.png b/docs/zh-cn/admin/sources/images/dubbo-applications.png
new file mode 100644
index 0000000..60a95e9
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-applications.png differ
diff --git a/docs/zh-cn/admin/sources/images/dubbo-consumers.png b/docs/zh-cn/admin/sources/images/dubbo-consumers.png
new file mode 100644
index 0000000..d10982f
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-consumers.png differ
diff --git a/docs/zh-cn/admin/sources/images/dubbo-monitor-simple.jpg b/docs/zh-cn/admin/sources/images/dubbo-monitor-simple.jpg
new file mode 100644
index 0000000..66967e5
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-monitor-simple.jpg differ
diff --git a/docs/zh-cn/admin/sources/images/dubbo-providers.png b/docs/zh-cn/admin/sources/images/dubbo-providers.png
new file mode 100644
index 0000000..172cebb
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-providers.png differ
diff --git a/docs/zh-cn/admin/sources/images/dubbo-search.png b/docs/zh-cn/admin/sources/images/dubbo-search.png
new file mode 100644
index 0000000..5bbafe4
Binary files /dev/null and b/docs/zh-cn/admin/sources/images/dubbo-search.png differ
diff --git a/md_json/docs.json b/md_json/docs.json
index ca4ad60..fdc5e0d 100644
--- a/md_json/docs.json
+++ b/md_json/docs.json
@@ -1,6 +1,54 @@
{
"zh-cn": [
{
+ "filename": "admin/README.md",
+ "__html": "<p>这篇文档详细讲解了 dubbo 注册中心、管理控制台的安装和使用。</p>\n"
+ },
+ {
+ "filename": "admin/SUMMARY.md",
+ "__html": "<ul>\n<li><a href=\"install/introduction.md\">1 安装手册</a>\n<ul>\n<li><a href=\"install/provider-demo.md\">1.1 示例提供者安装</a></li>\n<li><a href=\"install/consumer-demo.md\">1.2 示例消费者安装</a></li>\n<li><a href=\"install/zookeeper.md\">1.3 Zookeeper 注册中心安装</a></li>\n<li><a href=\"install/redis.md\">1.4 Redis 注册中心安装</a></li>\n<li><a href=\"install/simple-registry-center.md\">1.5 Simple 注册中心安装</a></li>\n<li><a href=\"install/simple-monitor-center.md\">1.6 Simple 监控中心安装</a></li>\n<l [...]
+ },
+ {
+ "filename": "admin/install/admin-console.md",
+ "__html": "<h1>管理控制台安装</h1>\n<p>管理控制台为内部裁剪版本，开源部分主要包含：路由规则，动态配置，服务降级，访问控制，权重调整，负载均衡，等管理功能。</p>\n<p>安装:</p>\n<pre><code class=\"language-sh\">wget http://apache.etoak.com/tomcat/tomcat-6/v6.0.35/bin/apache-tomcat-6.0.35.tar.gz\ntar zxvf apache-tomcat-6.0.35.tar.gz\n<span class=\"hljs-built_in\">cd</span> apache-tomcat-6.0.35\nrm -rf webapps/ROOT\n\ngit <span class=\"hljs-built_in\">clone</span> https://github.com/dubbo/dubbo-ops.git /var/tmp/dubbo-ops\n<span class=\"hljs-built_in\"> [...]
+ },
+ {
+ "filename": "admin/install/consumer-demo.md",
+ "__html": "<h1>示例消费者安装</h1>\n<p>安装:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo.git\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo\n运行 dubbo-demo-consumer中的com.alibaba.dubbo.demo.consumer.Consumer\n请确保先启动Provider\n如果使用Intellij Idea 请加上-Djava.net.preferIPv4Stack=<span class=\"hljs-literal\">true</span>\n</code></pre>\n<p>配置:</p>\n<pre><code class=\"language-sh\">resource/META-INFO.spring/dub [...]
+ },
+ {
+ "filename": "admin/install/introduction.md",
+ "__html": "<h1>安装手册</h1>\n<p>你可以只运行 Demo Provider 和 Demo Consumer，它们缺省配置为通过 Multicast <sup class=\"footnote-ref\"><a href=\"#fn1\" id=\"fnref1\">[1]</a></sup> 注册中心广播互相发现，建议在不同机器上运行，如果在同一机器上，需设置 <code>unicast=false</code>：即： <code>multicast://224.5.6.7:1234?unicast=false</code>，否则发给消费者的单播消息可能被提供者抢占，两个消费者在同一台机器也一样，只有 multicast 注册中心有此问题。</p>\n<p>你也可以运行多个 Demo Provider 和 Demo Consumer，来验证软负载均衡，Demo Consumer 可以直接启动多个实例，而多个 Demo Provider 因有端口冲突，可在不同机器上运行，或者修改 Demo Provider 安装目录下 <code>c [...]
+ },
+ {
+ "filename": "admin/install/provider-demo.md",
+ "__html": "<h1>示例提供者安装</h1>\n<p>安装：</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo.git\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo\n运行 dubbo-demo-provider中的com.alibaba.dubbo.demo.provider.Provider\n如果使用Intellij Idea 请加上-Djava.net.preferIPv4Stack=<span class=\"hljs-literal\">true</span>\n</code></pre>\n<p>配置：</p>\n<pre><code class=\"language-sh\">resource/META-INFO.spring/dubbo-demo-provider [...]
+ },
+ {
+ "filename": "admin/install/redis.md",
+ "__html": "<h1>Redis 注册中心安装</h1>\n<p>Redis <sup class=\"footnote-ref\"><a href=\"#fn1\" id=\"fnref1\">[1]</a></sup> 使用方式参见: <a href=\"http://dubbo.apache.org/books/dubbo-user-book/references/registry/redis.html\">Redis 注册中心参考手册</a>。</p>\n<p>只需搭一个原生的 Redis 服务器，并将<a href=\"http://dubbo.apache.org/books/dubbo-user-book/quick-start.html\">快速启动</a>中 Provider 和 Consumer 里的 <code>conf/dubbo.properties</code> 中的 <code>dubbo.registry.addrss</code> 的值改为 <code>redis://127.0.0.1:6379</code> 即可 [...]
+ },
+ {
+ "filename": "admin/install/simple-monitor-center.md",
+ "__html": "<h1>Simple 监控中心安装</h1>\n<h2>安装步骤</h2>\n<p>安装:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo-ops\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo-ops && mvn package\n<span class=\"hljs-built_in\">cd</span> dubbo-monitor-simple/target && tar xvf dubbo-monitor-simple-2.0.0-assembly.tar.gz\n<span class=\"hljs-built_in\">cd</span> dubbo-monitor-simple-2.0.0\n</code></pre>\ [...]
+ },
+ {
+ "filename": "admin/install/simple-registry-center.md",
+ "__html": "<h1>Simple 注册中心安装</h1>\n<p>Simple Registry 没有经过严格测试，可能不健状，并且不支持集群，不建议用于生产环境。</p>\n<p>安装:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo-ops\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo-ops && mvn package\n<span class=\"hljs-built_in\">cd</span> dubbo-registry-simple/target && tar xvf dubbo-registry-simple-2.0.0-assembly.tar.gz\n<span class=\"hljs-built_in\">cd</spa [...]
+ },
+ {
+ "filename": "admin/install/zookeeper.md",
+ "__html": "<h1>Zookeeper 注册中心安装</h1>\n<p>建议使用 <code>dubbo-2.3.3</code> 以上版本的 zookeeper <sup class=\"footnote-ref\"><a href=\"#fn1\" id=\"fnref1\">[1]</a></sup> 注册中心客户端。</p>\n<p>Dubbo 未对 Zookeeper 服务器端做任何侵入修改，只需安装原生的 Zookeeper 服务器即可，所有注册中心逻辑适配都在调用 Zookeeper 客户端时完成。</p>\n<p>安装:</p>\n<pre><code class=\"language-sh\">wget http://archive.apache.org/dist/zookeeper/zookeeper-3.3.3/zookeeper-3.3.3.tar.gz\ntar zxvf zookeeper-3.3.3.tar.gz\n<span class=\"hljs-built_in\">cd</span> zookeeper-3. [...]
+ },
+ {
+ "filename": "admin/ops/dubbo-ops.md",
+ "__html": "<h1>管理控制台运维</h1>\n<h2>搜索页面</h2>\n<p>当你需要管理 Dubbo 的服务时，首先要搜索到这个服务，然后打开它的管理页面</p>\n<p><img src=\"../sources/images/dubbo-search.png\" alt=\"/admin-guide/images/dubbo-search.png\"></p>\n<h2>服务提供者页面</h2>\n<p><img src=\"../sources/images/dubbo-providers.png\" alt=\"/admin-guide/images/dubbo-providers.png\"></p>\n<h2>服务消费者页面</h2>\n<p><img src=\"../sources/images/dubbo-consumers.png\" alt=\"/admin-guide/images/dubbo-consumers.png\"></p>\n<h2>服务应用页面</h2>\n<p><img src=\"../source [...]
+ },
+ {
+ "filename": "admin/ops/introduction.md",
+ "__html": "<h1>运维手册</h1>\n"
+ },
+ {
"filename": "dev/README.md",
"__html": "<p>这篇文档的目标读者是对 dubbo 源码、设计有兴趣的，或者有意愿加入 dubbo 开发的人群。主要涵盖了 dubbo 的框架设计、扩展机制、编码规范、版本管理、构建等话题。</p>\n"
},
@@ -611,6 +659,54 @@
],
"en-us": [
{
+ "filename": "admin/README.md",
+ "__html": "<h1>dubbo-admin-book</h1>\n<p>The installation and maintenance guidance of registry center and dubbo-admin.</p>\n"
+ },
+ {
+ "filename": "admin/SUMMARY.md",
+ "__html": "<ul>\n<li><a href=\"install/introduction.md\">1 install manual</a>\n<ul>\n<li><a href=\"install/provider-demo.md\">1.1 install provider demo</a></li>\n<li><a href=\"install/consumer-demo.md\">1.2 install consumer demo</a></li>\n<li><a href=\"install/zookeeper.md\">1.3 install Zookeeper configuration center</a></li>\n<li><a href=\"install/redis.md\">1.4 install Redis configuration center</a></li>\n<li><a href=\"install/simple-registry-center.md\">1.5 install Simple config [...]
+ },
+ {
+ "filename": "admin/install/admin-console.md",
+ "__html": "<h1>Install admin console</h1>\n<p>Include: route rule, dynamic configuration, service downgrade, access control, weight adjustment, load balance, etc.</p>\n<p>Install:</p>\n<pre><code class=\"language-sh\">wget http://apache.etoak.com/tomcat/tomcat-6/v6.0.35/bin/apache-tomcat-6.0.35.tar.gz\ntar zxvf apache-tomcat-6.0.35.tar.gz\n<span class=\"hljs-built_in\">cd</span> apache-tomcat-6.0.35\nrm -rf webapps/ROOT\n\ngit <span class=\"hljs-built_in\">clone</span> https://gith [...]
+ },
+ {
+ "filename": "admin/install/consumer-demo.md",
+ "__html": "<h1>install demo consumer</h1>\n<p>install:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo.git\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo\nPlease start Provider first\nadd -Djava.net.preferIPv4Stack=<span class=\"hljs-literal\">true</span> <span class=\"hljs-keyword\">if</span> your IDE is Intellij Idea\n</code></pre>\n<p>configuration:</p>\n<pre><code class=\"language-sh\">reso [...]
+ },
+ {
+ "filename": "admin/install/introduction.md",
+ "__html": "<h1>Install manual</h1>\n<p>You can run Demo Provider and Demo Consumer only, the default discovery strategy is Multicast by configuration center broadcast, do not run the two parts on the same machine, if you have to do so, set <code>unicast=false</code>, like <code>multicast://224.5.6.7:1234?unicast=false</code>, or the unicast send to consumer will be taken by provider, and the same for consumers. Only multicast has this issue</p>\n<p>You can run multiple Demo Provide [...]
+ },
+ {
+ "filename": "admin/install/provider-demo.md",
+ "__html": "<h1>install demo provider</h1>\n<p>install:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo.git\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo\nrun com.alibaba.dubbo.demo.provider.Provider under dubbo-demo-provider module\nadd -Djava.net.preferIPv4Stack=<span class=\"hljs-literal\">true</span> <span class=\"hljs-keyword\">if</span> your IDE is Intellij Idea\n</code></pre>\n<p>configu [...]
+ },
+ {
+ "filename": "admin/install/redis.md",
+ "__html": "<h1>install Redis register center</h1>\n<p>Redis <sup class=\"footnote-ref\"><a href=\"#fn1\" id=\"fnref1\">[1]</a></sup> introductions, please refer to: <a href=\"http://dubbo.apache.org/books/dubbo-user-book-en/references/registry/redis.html\">Redis application center manual</a>。</p>\n<p>you need an origin Redis server only, and change the value from <code>dubbo.registry.addrss</code> to <code>redis://127.0.0.1:6379</code> in <code>conf/dubbo.properties</code> of <a hr [...]
+ },
+ {
+ "filename": "admin/install/simple-monitor-center.md",
+ "__html": "<h1>install Simple monitor center</h1>\n<h2>Step</h2>\n<p>install:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo-ops\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo-ops && mvn package\n<span class=\"hljs-built_in\">cd</span> dubbo-monitor-simple/target && tar xvf dubbo-monitor-simple-2.0.0-assembly.tar.gz\n<span class=\"hljs-built_in\">cd</span> dubbo-monitor-simple- [...]
+ },
+ {
+ "filename": "admin/install/simple-registry-center.md",
+ "__html": "<h1>install Simple configuration center</h1>\n<p>Simple Registry has not been well tested, may have bug, cluster is not supported, not recommended to use in production environment</p>\n<p>Install:</p>\n<pre><code class=\"language-sh\">git <span class=\"hljs-built_in\">clone</span> https://github.com/apache/incubator-dubbo-ops\n<span class=\"hljs-built_in\">cd</span> incubator-dubbo-ops && mvn package\n<span class=\"hljs-built_in\">cd</span> dubbo-registry-simple/ [...]
+ },
+ {
+ "filename": "admin/install/zookeeper.md",
+ "__html": "<h1>install Zookeeper configuration center</h1>\n<p>zookeeper register center client version: <code>dubbo-2.3.3</code> and above<sup class=\"footnote-ref\"><a href=\"#fn1\" id=\"fnref1\">[1]</a></sup></p>\n<p>Dubbo changes nothing of Zookeeper's server side, an original Zookeeper server is fine. All change happens while calling Zookeeper's client side</p>\n<p>install:</p>\n<pre><code class=\"language-sh\">wget http://archive.apache.org/dist/zookeeper/zookeeper-3.3.3/zook [...]
+ },
+ {
+ "filename": "admin/ops/dubbo-ops.md",
+ "__html": "<h1>Ops console management</h1>\n<h2>Page search</h2>\n<p>If you need to manage a Dubbo service, you need to search it first and open it's management page</p>\n<p><img src=\"../sources/images/dubbo-search.png\" alt=\"/admin-guide/images/dubbo-search.png\"></p>\n<h2>Service provider page</h2>\n<p><img src=\"../sources/images/dubbo-providers.png\" alt=\"/admin-guide/images/dubbo-providers.png\"></p>\n<h2>Service consumer page</h2>\n<p><img src=\"../sources/images/dubbo-con [...]
+ },
+ {
+ "filename": "admin/ops/introduction.md",
+ "__html": "<h1>Ops manual</h1>\n"
+ },
+ {
"filename": "dev/README.md",
"__html": "<h1>dubbo-dev-book</h1>\n<p>This book dives into the design principles of dubbo, mainly covers the following topics: extension, coding styles, versio, build, etc.</p>\n"
},
diff --git a/site_config/docs.js b/site_config/docs.js
index 5ceb748..1cae3fa 100644
--- a/site_config/docs.js
+++ b/site_config/docs.js
@@ -558,6 +558,54 @@ export default {
}
],
},
+ {
+ title: 'Admin guide',
+ children: [
+ {
+ title: 'Installation',
+ children: [
+ {
+ title: 'Install provider demo',
+ link: '/docs/admin/install/provider-demo.md'
+ },
+ {
+ title: 'Install consumer demo',
+ link: '/docs/admin/install/consumer-demo.md'
+ },
+ {
+ title: 'Install Zookeeper configuration center',
+ link: '/docs/admin/install/zookeeper.md'
+ },
+ {
+ title: 'Install Redis configuration center',
+ link: '/docs/admin/install/redis.md'
+ },
+ {
+ title: 'Install Simple configuration center',
+ link: '/docs/admin/install/simple-registry-center.md'
+ },
+ {
+ title: 'Install Simple monitor center',
+ link: '/docs/admin/install/simple-monitor-center.md'
+ },
+ {
+ title: 'Install admin console',
+ link: '/docs/admin/install/admin-console.md'
+ }
+ ],
+ },
+ {
+ title: 'Operation manual',
+ children: [
+ {
+ title: 'Admin console operation guide',
+ link: '/docs/admin/ops/dubbo-ops.md'
+ }
+ ]
+ }
+
+ ]
+ }
],
barText: 'Documentation',
},
@@ -1160,6 +1208,54 @@ export default {
link: '/docs/dev/TCK.md'
}
],
+ },
+ {
+ title: '运维管理',
+ children: [
+ {
+ title: '安装手册',
+ children: [
+ {
+ title: '示例提供者安装',
+ link: '/docs/admin/install/provider-demo.md'
+ },
+ {
+ title: '示例消费者安装',
+ link: '/docs/admin/install/consumer-demo.md'
+ },
+ {
+ title: 'Zookeeper 注册中心安装',
+ link: '/docs/admin/install/zookeeper.md'
+ },
+ {
+ title: 'Redis 注册中心安装',
+ link: '/docs/admin/install/redis.md'
+ },
+ {
+ title: 'Simple 注册中心安装',
+ link: '/docs/admin/install/simple-registry-center.md'
+ },
+ {
+ title: 'Simple 监控中心安装',
+ link: '/docs/admin/install/simple-monitor-center.md'
+ },
+ {
+ title: '管理控制台安装',
+ link: '/docs/admin/install/admin-console.md'
+ }
+ ],
+ },
+ {
+ title: '运维手册',
+ children: [
+ {
+ title: '管理控制台运维',
+ link: '/docs/admin/ops/dubbo-ops.md'
+ }
+ ]
+ }
+
+ ]
}
],
barText: '文档',
diff --git a/site_config/site.js b/site_config/site.js
index 1548781..2bc8ef5 100644
--- a/site_config/site.js
+++ b/site_config/site.js
@@ -27,16 +27,16 @@ export default {
title: 'Documentation',
list: [
{
- text: 'Overview',
- link: '/docs/user/preface/architecture.md',
- },
- {
text: 'Quick start',
link: '/docs/user/quick-start.md',
},
{
text: 'Developer guide',
- link: '/docs/demo.md',
+ link: '/docs/dev/build.md',
+ },
+ {
+ text: 'Admin manual',
+ link: '/docs/admin/ops/dubbo-ops.md',
},
],
},
@@ -88,7 +88,11 @@ export default {
{
text: '开发者指南',
link: '/docs/dev/build.md',
- }
+ },
+ {
+ text: '运维管理',
+ link: '/docs/admin/ops/dubbo-ops.md',
+ },
]
},
resources: {