Net::ZooKeeper - Perl extension for Apache ZooKeeper ==================================================== Net::ZooKeeper provides a Perl interface to the synchronous C API of Apache ZooKeeper. ZooKeeper is coordination service for distributed applications. For details see the ZooKeeper home page at: http://zookeeper.apache.org/ INSTALLATION To install this module type the following, first install the zookeeper C client, then: perl Makefile.PL make ZK_TEST_HOSTS=host:port,... make test make install If the C headers and library are installed in non-standard locations, specify them as arguments to Makefile.PL: perl Makefile.PL \ --zookeeper-include=/path/to/zookeeper/client/include \ --zookeeper-lib=/path/to/zookeeper/client/lib The path supplied to the --zookeeper-include option should identify the directory that contains the zookeeper.h and other ZooKeeper C include files. The path supplied to the --zookeeper-lib option should identify the directory that contains the libzookeeper_mt library. When running "make test", if no ZK_TEST_HOSTS environment variable is set, many tests will be skipped because no connection to a ZooKeeper server is available. To execute these tests, the ZK_TEST_HOSTS variable may be assigned a list of one or more ZooKeeper host:port pairs, e.g., "localhost:7100,otherhost:7200". The ZK_TEST_PATH environment variable, if defined, specifies the ZooKeeper path under which all test nodes should be created. The tests expect to have full read/write/create/delete/admin ZooKeeper permissions under this path. If no ZK_TEST_PATH variable is defined, the root ZooKeeper path ("/") is used. DEPENDENCIES Version 3.2.0 of ZooKeeper is required at a minimum. For version 3.2.0, you may also want to apply some of these additional patches to the ZooKeeper C API code: https://issues.apache.org/jira/browse/ZOOKEEPER-262 This module requires that the multi-threaded version of the ZooKeeper C API client library be available on your system. This in turn implies that the POSIX pthread library is available as well. COPYRIGHT AND LICENCE Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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.