[GitHub] [incubator-kyuubi] cfmcgrady commented on a diff in pull request #2345: [DOC] Hot Upgrade Kyuubi Server

[GitBox <gi...@apache.org>]

cfmcgrady commented on code in PR #2345:
URL: https://github.com/apache/incubator-kyuubi/pull/2345#discussion_r849110828


##########
docs/deployment/high_availability_guide.md:
##########
@@ -82,3 +82,32 @@ For example,
 ```shell
 bin/beeline -u 'jdbc:hive2://10.242.189.214:2181/;serviceDiscoveryMode=zooKeeper;zooKeeperNamespace=kyuubi' -n kentyao
 ```
+
+## How to Hot Upgrade Kyuubi Server
+
+Kyuubi supports hot upgrade one of server in a HA cluster which is transparent to users.
+
+- If you have specified a custom port for Kyuubi server 
+
+  For example, the Kyuubi server started at host `kyuubi.host` with port `10009`, you can run the following cmd using `bin/kyuubi-ctl`:
+  
+  ```shell
+  ./bin/kyuubi-ctl delete server --host "kyuubi.host" --port "10009"
+  ```
+  
+  Kyuubi server will stop until all session closed, and then you can start a new Kyuubi server.
+
+- If you use a random port for Kyuubi server
+
+  You can just start the new Kyuubi Server, then runing cmd using `bin/kyuubi-ctl`:
+
+  ```shell
+  ./bin/kyuubi-ctl delete server --host "kyuubi.host" --port "${PORT_FPR_OLD_KYUUBI_SERVER}"
+  ```
+
+  The `${PORT_FPR_OLD_KYUUBI_SERVER}` can be found by:
+
+  ```shell
+  grep "server.KyuubiThriftBinaryFrontendService: Starting and exposing JDBC connection at" logs/kyuubi-*.out
+  ```
+  Note that, you do not need to care when the old Kyuubi server actually stooped since the new comming session are routed to the new Kyuubi server and others.

Review Comment:
   nit:
   1. stooped -> stopped
   2. comming -> coming



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@kyuubi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@kyuubi.apache.org
For additional commands, e-mail: notifications-help@kyuubi.apache.org