ZooKeeper 文檔（入門）

ZooKeeper入門指南

• 開始：使用ZooKeeper協調分佈式應用程序
• 必備條件
• 下載
• 獨立的操做
• 管理ZooKeeper存儲
• 鏈接到ZooKeeper
• ZooKeeper的編程
• 運行主從複製ZooKeeper
• 其餘優化

開始：使用ZooKeeper協調分佈式應用程序

這個文檔包含了一些信息，能夠幫助你快速開始使用ZooKeeper，它主要針對但願嘗試它的開發人員，幷包含單個ZooKeeper服務器的簡單安裝說明，一些命令能夠驗證它是否正在運行，還有一個簡單的編程示例。最後，爲了方便起見，有一些關於更復雜的安裝部分，例如，運行主從複製部署，並優化事務日誌。然而，完整的商業部署說明，請參閱ZooKeeper管理員指南。

必備條件

請參閱管理指南中的系統需求。

下載

要得到一個ZooKeeper發行版，請從Apache下載鏡像下載一個最近的穩定版本。

獨立的操做

在獨立模式下設置ZooKeeper服務器很是簡單，服務器包含在一個JAR文件中，所以安裝包括了建立配置。

一旦你下載了一個穩定的ZooKeeper版本，解壓它並cd到根目錄。

要啓動ZooKeeper程序，你須要一個配置文件，這是一個示例，在conf/zoo.cfg中建立它：

tickTime=2000
dataDir=/var/lib/zookeeper
clientPort=2181

這個文件能夠被命名爲何名稱，可是爲了便於討論，咱們將其稱爲conf/zoo.cfg，更改dataDir的值，以指定一個現有(從空開始)目錄，下面是每一個字段的含義：

tickTime：被ZooKeeper使用的以毫秒爲單位的基礎時間單位，它用於進行心跳，而且最小會話超時時間將是tickTime的兩倍。
dataDir：存儲內存中數據庫快照的位置，以及（除非另有指定）數據庫更新的事務日誌。
clientPort：監聽客戶端鏈接的端口。

如今你已經建立了配置文件，能夠啓動ZooKeeper了：

bin/zkServer.sh start

ZooKeeper使用log4j記錄消息 -- 更多細節能夠在開發者指南的日誌記錄部分中找到，你將看到日誌消息到達控制檯(默認)和/或日誌文件，具體取決於log4j配置。

這裏列出的步驟在獨立模式下運行ZooKeeper，沒有主從複製，所以若是ZooKeeper進程故障，服務將會宕機，這對於大多數開發狀況來講都很好，可是要在主從複製模式下運行ZooKeeper，請參閱運行主從複製的ZooKeeper。

管理ZooKeeper存儲

對於長時間運行的生產系統，ZooKeeper的存儲必須由外部管理(dataDir和日誌)，有關更多細節，請參閱維護部分。

鏈接到ZooKeeper

$ bin/zkCli.sh -server 127.0.0.1:2181

這容許你執行簡單的、相似文件的操做，一旦你鏈接起來，你應該會看到這樣的東西：

Connecting to localhost:2181
log4j:WARN No appenders could be found for logger (org.apache.zookeeper.ZooKeeper).
log4j:WARN Please initialize the log4j system properly.
Welcome to ZooKeeper!
JLine support is enabled
[zkshell: 0]

在shell中，鍵入help得到能夠從客戶端執行的命令列表，如：

[zkshell: 0] help
ZooKeeper host:port cmd args
        get path [watch]
        ls path [watch]
        set path data [version]
        delquota [-n|-b] path
        quit
        printwatches on|off
        create path data acl
        stat path [watch]
        listquota path
        history
        setAcl path acl
        getAcl path
        sync path
        redo cmdno
        addauth scheme auth
        delete path [version]
        deleteall path
        setquota -n|-b val path