// Manage seekdb instances using obd seekdb commands. Install, deploy, start, stop, destroy, and takeover seekdb. Set up primary-standby replication, perform switchover, failover, and decouple operations. Use when users mention seekdb, obd seekdb, or need a lightweight OceanBase-based database with primary-standby HA capabilities.
| name | seekdb |
| description | Manage seekdb instances using obd seekdb commands. Install, deploy, start, stop, destroy, and takeover seekdb. Set up primary-standby replication, perform switchover, failover, and decouple operations. Use when users mention seekdb, obd seekdb, or need a lightweight OceanBase-based database with primary-standby HA capabilities. |
| compatibility | Requires obd CLI with seekdb support. |
| metadata | {"author":"oceanbase","version":"1.0"} |
seekdb is a lightweight database component managed by OBD. All obd seekdb commands only apply to deployments containing the seekdb component.
For OceanBase cluster management: Use cluster-management. For tenant operations: Use tenant-management.
| Command | Description |
|---|---|
obd seekdb install | Interactive install (single node, requires TTY) |
obd seekdb install --primary | Install as primary (enables RPC for standby sync) |
obd seekdb install --standby | Install as standby (selects from running primaries) |
obd seekdb deploy <name> -c <config> | Deploy with config file |
obd seekdb list | List seekdb deployments only |
obd seekdb start <name> | Start |
obd seekdb stop <name> | Stop |
obd seekdb restart <name> | Restart |
obd seekdb display <name> | Show info |
obd seekdb display <name> -g | Show topology graph |
obd seekdb destroy <name> | Destroy (see safety rules below) |
obd seekdb takeover <name> --home-path <path> | Takeover non-OBD instance |
obd seekdb switchover <name> | Planned primary-standby swap |
obd seekdb failover <name> | Emergency promote standby to primary |
obd seekdb decouple <name> | Decouple standby into independent primary |
Destroying a primary that still has standby clusters requires --ignore-standby:
obd seekdb destroy <name> --ignore-standby
Without this flag, OBD will refuse and warn about the risk.
| Operation | When to Use | Primary Must Be |
|---|---|---|
switchover | Planned maintenance | Online (running) |
failover | Primary is down/unreachable | Stopped or unreachable |
failover will error if the primary is still running. Use switchover for planned swaps.
Primary and standby must be on different IPs. If deployed on the same IP, OBD suppresses --role=STANDBY, causing the standby to start as a primary — log sync will not work.
See references/install-modes.md for detailed install mode behavior, TTY requirements, and non-interactive deployment limitations.
See references/ha-operations.md for detailed switchover, failover, and decouple procedures.
obd seekdb deploy my-seekdb -c seekdb-config.yaml
obd seekdb start my-seekdb
obd seekdb display my-seekdb -g
obd seekdb takeover my-seekdb --home-path /home/admin/seekdb
Manage OceanBase cluster lifecycle using obd. Deploy, start, stop, restart, destroy, redeploy, upgrade, scale out, and configure clusters. Includes OCP CE takeover and monitoring setup. Use when creating, operating, or maintaining OceanBase CE clusters via obd, or when users mention obd, OceanBase deployment, cluster management, OCP, or monitoring.
Overview skill for OceanBase deployment and operations using obd. Routes to specialized skills for cluster management, tenant management, seekdb, and testing. Use as a starting point when the user's intent is not yet clear, or for general OceanBase obd questions. Also use when users mention OceanBase, obd, or want an overview of available OceanBase operations.
Manage OceanBase tenants using obd. Create, drop, show, and optimize tenants. Configure backup paths, run backups, and restore from backup. Use when users ask about OceanBase tenants, tenant creation, backup, restore, workload optimization, or multi-tenant management via obd.
Run OceanBase performance benchmarks and functional tests using obd test. Supports Sysbench, TPC-H, TPC-C benchmarks and mysqltest functional tests. Use when users want to benchmark, stress test, run functional tests, or evaluate OceanBase cluster performance. Also use when users mention sysbench, TPC-H, TPC-C, mysqltest, or obd test.