OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Database Proxy

V4.1.0Community Edition

  • What is ODP?
  • Installation and deployment
    • Use OBD to deploy ODP
    • Parameter description
    • Deployment modes
  • Basic operations
  • Configuration parameter
    • Parameter description
    • Dynamically modifiable parameters
    • Parameters that are not dynamically modifiable
    • Internal and inherited parameters
    • In-memory parameters
  • Connection management
  • Data routing
    • Factors affecting data routing
    • Routing strategies
    • ODP routing
    • Intra-tenant routing
    • Read/Write separation
  • High availability mechanism
    • Overview
    • High availability of ODP services
    • High availability of OceanBase Database
    • High availability testing
  • Security and protocols
  • Operation and maintenance
    • Troubleshooting
      • Troubleshooting logic
      • Monitoring logs
    • Performance analysis

Download PDF

What is ODP? Use OBD to deploy ODP Parameter description Deployment modes Basic operations Parameter description Dynamically modifiable parameters Parameters that are not dynamically modifiable Internal and inherited parameters In-memory parameters Connection management Factors affecting data routing Routing strategies ODP routing Intra-tenant routing Read/Write separation Overview High availability of ODP services High availability of OceanBase Database High availability testing Security and protocols Troubleshooting logic Monitoring logs Performance analysis
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. OceanBase Database Proxy
  3. V4.1.0
iconOceanBase Database Proxy
V 4.1.0Community Edition
  • V 4.3.6
  • V 4.3.4
  • V 4.3.3
  • V 4.3.2
  • V 4.3.1
  • V 4.3.0
  • V 4.2.3
  • V 4.2.2
  • V 4.2.0 and earlier
Community Edition
  • V 4.2.0
  • V 4.1.0
  • V 4.0.0
  • V 3.1.0

High availability of ODP services

Last Updated:2023-06-25 03:41:30  Updated
share
What is on this page
ODP process exceptions
OCP exceptions

folded

share

High availability of ODP services means that ODP can continuously provide services to reduce the impact of faults on the proxy service. However, the service availability is subject to the following factors:

  • Factor 1: Whether the ODP process runs stably and provides services normally, and whether the process can be pulled up in time after being accidentally killed.

  • Factor 2: Whether the third-party modules on which ODP depends, such as OceanBase Cloud Platform (OCP) and OBServers, properly provide services, for example, whether OCP can properly provide HTTP services.

The following sections describe the high availability of ODP services in consideration of these two factors.

ODP process exceptions

In addition to server failures, ODP process exceptions also have a significant impact on service availability. ODP process exceptions occur for many reasons, for example, process core dump caused by program bugs, out-of-memory (OOM) exceptions caused by excessive memory usage, and accidental killing of processes by O&M operations. While the causes may vary, the final results are the same: The service port fails to provide services.

You can solve the issue by using the obproxyd.sh script. Run the nc command to access the listened-to port of ODP. If the TCP connection is established, the ODP process exists. If the process does not exist, the obproxyd.sh script restarts the ODP process. The ODP process can be started and provide services in about 1s.

obproxyd.sh can only restore services as far as possible. However, if a core dump is generated due to program bugs, this issue cannot be resolved by restarting the ODP process. In this case, you can follow the server exception troubleshooting process, so that the LB component will handle the exception. For some bugs that rarely occur, a restart can recover services in a timely manner, causing little impact on the business.

OCP exceptions

If another service that ODP depends on is abnormal, ODP configurations cannot be promptly updated even if ODP is normal. This section describes OceanBase Cloud Platform (OCP) exceptions.

OCP provides centralized configuration services for ODP and stores some key configuration information, such as the mapping between a cluster name and a cluster RS list, which contains a list of servers on which RootService resides. After ODP pulls the RS list information from OCP, ODP saves the information in the obproxy_rslist_info.json file in the local etc directory.

If OCP is unavailable, ODP can use the locally cached RS list file to provide services. To verify whether OCP is available, you can use the curl command to access the URL of OCP. The ignore_local_config parameter specifies whether the configuration of the cached file is used. The default value true specifies the configuration of the config server is used. The value false specifies the configuration of the cached file is used.

The use of local cached files can solve the issue that some clusters cannot be accessed upon OCP exceptions. However, this also has the following disadvantages:

  • Only the RS list information of accessed clusters is stored in the cache. Services remain unavailable for a cluster that has not been accessed.

  • The cached information is time-sensitive and becomes invalid if the RS list changes.

Therefore, OCP itself must have high availability design and can recover from faults in time to ensure service continuity.

In general, the LB component and the obproxyd.sh script can handle process exceptions and machine exceptions in a timely manner. ODP has been significantly optimized in terms of the program startup process, and can complete initialization and configuration loading and start to provide external services within 1s.

Dependency on external modules has been minimized for ODP. However, it is impossible for ODP to avoid using OCP. Therefore, ODP uses a local cache to reduce dependency on OCP and maximize service availability.

Previous topic

Overview
Last

Next topic

High availability of OceanBase Database
Next
What is on this page
ODP process exceptions
OCP exceptions