"Fossies" - the Fresh Open Source Software Archive

Member "apache-zookeeper-3.8.1/zookeeper-contrib/zookeeper-contrib-zkperl/README" (25 Jan 2023, 3771 Bytes) of package /linux/misc/apache-zookeeper-3.8.1.tar.gz:

As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "README": 3.6.2_vs_3.7.0.

    1 Net::ZooKeeper - Perl extension for Apache ZooKeeper
    2 ====================================================
    3 
    4 Net::ZooKeeper provides a Perl interface to the synchronous C API
    5 of Apache ZooKeeper.  ZooKeeper is coordination service for
    6 distributed applications.
    7 For details see the ZooKeeper home page at:
    8 
    9 http://zookeeper.apache.org/
   10 
   11 INSTALLATION
   12 
   13 To install this module type the following, first install the
   14 zookeeper C client, then:
   15 
   16     perl Makefile.PL
   17     make
   18     ZK_TEST_HOSTS=host:port,... make test
   19     make install
   20 
   21 If the C headers and library are installed in non-standard
   22 locations, specify them as arguments to Makefile.PL:
   23     
   24     perl Makefile.PL \
   25         --zookeeper-include=/path/to/zookeeper/client/include \
   26         --zookeeper-lib=/path/to/zookeeper/client/lib
   27 
   28 The path supplied to the --zookeeper-include option should
   29 identify the directory that contains the zookeeper.h and other
   30 ZooKeeper C include files.
   31 
   32 The path supplied to the --zookeeper-lib option should identify
   33 the directory that contains the libzookeeper_mt library.
   34 
   35 If the C client supports Cyrus SASL (ZOOKEEPER-1112), it can also be
   36 enabled in the Perl binding by passing a --with-sasl2 flag (and,
   37 optionally, non-standard locations):
   38 
   39     perl Makefile.PL \
   40         --with-sasl2 \
   41         --sasl2-include=/path/to/sasl2/include \
   42         --sasl2-lib=/path/to/sasl2/lib
   43 
   44 When running "make test", if no ZK_TEST_HOSTS environment
   45 variable is set, many tests will be skipped because no connection
   46 to a ZooKeeper server is available.  To execute these tests,
   47 the ZK_TEST_HOSTS variable may be assigned a list of one or more
   48 ZooKeeper host:port pairs, e.g., "localhost:7100,otherhost:7200".
   49 
   50 The ZK_TEST_PATH environment variable, if defined, specifies
   51 the ZooKeeper path under which all test nodes should be created.
   52 The tests expect to have full read/write/create/delete/admin
   53 ZooKeeper permissions under this path.  If no ZK_TEST_PATH
   54 variable is defined, the root ZooKeeper path ("/") is used.
   55 
   56 The ZK_TEST_SASL_OPTIONS environment variable, if defined, provides a
   57 JSON-encoded map of SASL authentication options, enabling SASL tests.
   58 E.g.,
   59 
   60     {
   61        "host": "zk-sasl-md5",
   62        "mechlist": "DIGEST-MD5",
   63        "service": "zookeeper",
   64        "user": "bob",
   65        "password_file": "bob.secret"
   66     }
   67 
   68 DEPENDENCIES
   69 
   70 Version 3.1.1 of ZooKeeper is required at a minimum.
   71 
   72 For version 3.1.1, you may also want to apply some of these
   73 additional patches to the ZooKeeper C API code:
   74 
   75 https://issues.apache.org/jira/browse/ZOOKEEPER-262
   76 https://issues.apache.org/jira/browse/ZOOKEEPER-318
   77 
   78 For version 3.1.1, you may also want to apply some of these
   79 additional patches to the ZooKeeper C API code:
   80 
   81 https://issues.apache.org/jira/browse/ZOOKEEPER-262
   82 https://issues.apache.org/jira/browse/ZOOKEEPER-466
   83 
   84 This module requires that the multi-threaded version of the
   85 ZooKeeper C API client library be available on your system.
   86 
   87 This in turn implies that the POSIX pthread library is available
   88 as well.
   89 
   90 COPYRIGHT AND LICENCE
   91 
   92 Licensed to the Apache Software Foundation (ASF) under one
   93 or more contributor license agreements.  See the NOTICE file
   94 distributed with this work for additional information
   95 regarding copyright ownership.  The ASF licenses this file
   96 to you under the Apache License, Version 2.0 (the
   97 "License"); you may not use this file except in compliance
   98 with the License.  You may obtain a copy of the License at
   99 
  100   http://www.apache.org/licenses/LICENSE-2.0
  101 
  102 Unless required by applicable law or agreed to in writing, software
  103 distributed under the License is distributed on an "AS IS" BASIS,
  104 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  105 See the License for the specific language governing permissions and
  106 limitations under the License.
  107