Configuring the Port Range Bound to the Client

Scenarios

When the ZooKeeper client is started, it is bound to a random port. In most cases, you want to bind the ZooKeeper client to a specific port. For example, for the client connection whitelist based on the IP address and port number, users can configure the port range bound to the client so that the same port range can be configured in the connection whitelist.

Configuration Description

Set zookeeper.client.bind.port.range to <startPort:endPort> to ensure that the client is always bound to a port in the specified port range. For example, if zookeeper.client.bind.port.range is set to 65510:65512, the client can be bound only to port 65510, 65511, or 65512.

To set zookeeper.client.bind.port.range to <startPort:endPort>, set Dzookeeper.client.bind.port.range to <startPort:endPort> when starting the ZooKeeper client.

Procedure

1. Log in to the node where the client is installed as the client installation user.
2. Run the following command to switch to the client installation directory:

   cd /opt/client

3. Run the following command to edit the component_env file:

   vi ZooKeeper/component_env

   Add the zookeeper.client.bind.port.range parameter and its value.

   Normal mode:

   export ZOOKEEPER_HOME="/opt/client/ZooKeeper/zookeeper"
   PATH_NEW=`echo $PATH | sed "s|:$ZOOKEEPER_HOME/bin||g" | sed "s|$ZOOKEEPER_HOME/bin:||g"`
   export PATH="$ZOOKEEPER_HOME/bin:$PATH_NEW"
   # default heap for zookeeper client
   export ZK_CLIENT_HEAP="256"
   export CLIENT_JVMFLAGS="-Xmx${ZK_CLIENT_HEAP}m"
   export CLIENT_JVMFLAGS="$CLIENT_JVMFLAGS -Dzookeeper.root.logger=WARN,CONSOLE -Dzookeeper.request.timeout=120000 -Dzookeeper.client.bind.port.range=<startPort:endPort>" # Add a parameter.

   Security mode:

   if [ "$HADOOP_SECURITY_AUTHENTICATION" = "kerberos" ]; then
       default_realm=`cat $KRB5_CONFIG |grep default_realm|awk -F"=" '{gsub(" ","");print $2}'|tr 'A-Z' 'a-z'`
       export ZOO_SERVER_PRINCIPAL="zookeeper/hadoop.${default_realm}"
       export CLIENT_JVMFLAGS=" ${CLIENT_JVMFLAGS} -Djava.security.krb5.conf=$KRB5_CONFIG -Dzookeeper.client.bind.port.range=<startPort:endPort>"  # Add a parameter.

4. Run the :wq command to save execution.
5. Restart the client for the settings to take effect.