OBProxy parameters descpription

2025-03-28 08:05:55  Updated

This topic describes startup parameters of OBProxy. When you create an OBProxy cluster, you can go to Parameter Settings to specify startup parameters.

Startup parameters

The following table describes the startup parameters that you need to specify when you create an OBProxy cluster. Otherwise, default values apply.

Parameter Default value Value range Description
app_name dropship - Specifies the application name of the OBProxy service.
automatic_match_work_thread True true false Specifies whether to automatically create worker threads based on the number of CPU cores. If you set the value of this parameter to true, the upper limit of work_thread_num applies.
block_thread_num 1 [1,4] Specifies the number of OBProxy threads for blocking tasks and is used for thread initialization.
bt_retry_times - - This parameter is deprecated and will be removed from later versions.
enable_cpu_topology false
  • true
  • false
  • Specifies whether to enable CPU affinity, which means that each worker thread is associated with a different CPU core.
    enable_metadb_used false
  • true
  • false
  • Specifies whether the MetaDB of OceanBase Cloud Platform (OCP) is accessible when OBProxy is running.
    enable_strict_kernel_release false
  • true
  • false
  • Specifies whether the OS kernel is to be verified. Valid values:
  • true: specifies to verify the OS kernel only on 5U, 6U, and 7U rackmount servers running on the RedHat operating system.
  • false: specifies not to verify the OS kernel, but the OBProxy may be unstable.
  • frequent_accept true
  • true
  • false
  • Specifies whether to initialize the net accept parameter.
    grpc_client_num 9 [9, 16] Specifies the number of gRPC clients.
    grpc_thread_num 8 [8, 16] Specifies the number of gRPC threads.
    listen_port 2883 (1024,65536) Specifies the listening port of OBProxy.
    local_bound_ip xxx.xxx.xxx.xxx - Specifies the local IP address of OBProxy.
    net_accept_threads 2 [0,8] Specifies the number of threads for net accept tasks.
    prometheus_cost_ms_unit false true false Specifies whether to set the cost unit of Prometheus to milliseconds. Default value: microseconds.
    prometheus_listen_port 2884 (1024,65536) Specifies the listening port of OBProxy Prometheus.
    proxy_id 0 [0,255] Specifies the ID of an OBProxy. When the value of the proxy_service_mode parameter is set to server, you cannot set the value of the proxy_id parameter to 0.
    proxy_service_mode client
  • client
  • server
  • Specifies the deployment and service mode of OBProxy.
    skip_proxy_sys_private_check true
  • true
  • false
  • Specifies whether to skip private CIDR blocks during the OBProxy check. If this parameter is set to true, the check is passed when private CIDR blocks are used.
    spool_thread_num - - This parameter is no longer in use and will be removed in the next update.
    stack_size 1 MB [1 MB,10 MB] Specifies the size of the thread stack and is used for thread creation.
    task_thread_num 2 [1,4] Specifies the number of OBProxy threads for tasks.
    work_thread_num 128 [1,128] Specifies the number of worker threads of OBProxy. When the value of the automatic_match_work_thread parameter is set to true, the work_thread_num parameter specifies the maximum number of worker threads.

    Contact Us