132 lines
5.2 KiB
Markdown
132 lines
5.2 KiB
Markdown
---
|
|
|
|
slug: /deploy-seekdb-testing-environment
|
|
---
|
|
|
|
# Quickly deploy seekdb in client/server mode
|
|
|
|
seekdb provides embedded mode and client/server mode. You can choose the appropriate deployment mode based on your business scenario. This topic introduces how to quickly deploy seekdb in client/server mode.
|
|
|
|
:::info
|
|
For information about using seekdb in embedded mode, see [Experience embedded seekdb](../50.embedded-mode/25.using-seekdb-in-python-sdk.md).
|
|
:::
|
|
|
|
## Deployment modes
|
|
|
|
seekdb provides flexible deployment modes that support everything from rapid prototyping to large-scale user workloads, meeting the full range of your application needs.
|
|
|
|
* Embedded mode
|
|
|
|
seekdb embeds as a lightweight library installable with a single pip command, ideal for personal learning or prototyping, and can easily run on various end devices.
|
|
|
|
* Client/Server mode
|
|
|
|
A lightweight and easy-to-use deployment mode recommended for both testing and production, delivering stable and efficient service.
|
|
|
|
:::info
|
|
For more detailed and comprehensive deployment methods for seekdb, see [Deployment overview](../../400.guides/400.deploy/50.deploy-overview.md).
|
|
:::
|
|
|
|
## Prerequisites
|
|
|
|
Before performing the operations in this topic, you need to confirm the following information:
|
|
|
|
* Your environment is an RPM platform system. The following systems are currently verified to be supported:
|
|
|
|
* Anolis OS 8.X (Linux kernel 3.10.0 or later)
|
|
* Alibaba Cloud Linux 2/3 (Linux kernel 3.10.0 or later)
|
|
* Red Hat Enterprise Linux Server 7.X, 8.X (Linux kernel 3.10.0 or later)
|
|
* CentOS Linux 7.X, 8.X (Linux kernel 3.10.0 or later)
|
|
* Debian 9.X or later (Linux kernel 3.10.0 or later)
|
|
* Ubuntu 20.X or later (Linux kernel 3.10.0 or later)
|
|
* SUSE / OpenSUSE 15.X or later (Linux kernel 3.10.0 or later)
|
|
* openEuler 22.03 and 24.03 (Linux kernel 5.10.0 or later)
|
|
* KylinOS V10
|
|
* UOS 1020a/1021a/1021e/1001c
|
|
* NFSChina 4.0 or later
|
|
* Inspur KOS 5.8
|
|
|
|
* The minimum CPU requirement for the current environment is 1 core.
|
|
|
|
* The minimum available memory requirement for the current environment is 2 GB.
|
|
|
|
* You have installed a database connection tool (MySQL client or OBClient) in your environment.
|
|
|
|
* The user you are using has permission to execute sudo commands.
|
|
|
|
* Requirements for deploying using yum install:
|
|
|
|
* You have installed the jq command-line tool in your environment and correctly configured systemd as the system and service manager.
|
|
|
|
* Requirements for deploying using Docker:
|
|
|
|
* You have installed Docker and started the Docker service.
|
|
|
|
## Quickly deploy seekdb using yum install
|
|
|
|
1. Add the seekdb repository.
|
|
|
|
```shell
|
|
[admin@test001 ~]$ sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
|
|
```
|
|
|
|
2. Install seekdb.
|
|
|
|
```shell
|
|
[admin@test001 ~]$ sudo yum install seekdb obclient
|
|
```
|
|
|
|
3. Start seekdb.
|
|
|
|
```shell
|
|
[admin@test001 ~]$ sudo systemctl start seekdb
|
|
```
|
|
|
|
4. Check the startup status of seekdb.
|
|
|
|
```shell
|
|
[admin@test001 ~]$ sudo systemctl status seekdb
|
|
```
|
|
|
|
When the status shows `Service is ready`, seekdb has started successfully.
|
|
|
|
5. Connect to seekdb.
|
|
|
|
```shell
|
|
mysql -h127.0.0.1 -uroot -P2881 -A oceanbase
|
|
```
|
|
|
|
## Quickly deploy seekdb in a container environment
|
|
|
|
If Docker is installed and the Docker service is started in your environment, you can also deploy seekdb using Docker containers. For more information about Docker deployment, see [Deploy seekdb in a container environment](../../400.guides/400.deploy/700.server-mode/200.deploy-by-docker.md).
|
|
|
|
1. Start a seekdb instance directly.
|
|
|
|
```shell
|
|
[admin@test001 ~]$ sudo docker run -d -p 2881:2881 oceanbase/seekdb
|
|
```
|
|
:::info
|
|
|
|
If pulling the Docker image fails, you can also pull the image from the quay.io or ghcr.io repository. Simply replace <code>oceanbase/seekdb</code> in the above command with <code>quay.io/oceanbase/seekdb</code> or <code>ghcr.io/oceanbase/seekdb</code>. For example, execute <code>sudo docker run -d -p 2881:2881 quay.io/oceanbase/seekdb</code> to pull the image from quay.io.
|
|
:::
|
|
|
|
2. Connect to seekdb.
|
|
|
|
```shell
|
|
mysql -h127.0.0.1 -uroot -P2881 -A oceanbase
|
|
```
|
|
|
|
## What's next
|
|
|
|
After deploying and connecting to seekdb, you can further experience seekdb's AI Native features and try building AI applications based on seekdb:
|
|
|
|
* [Experience vector search](30.experience-vector-search.md)
|
|
* [Experience full-text indexing](40.experience-full-text-indexing.md)
|
|
* [Experience hybrid search](50.experience-hybrid-search.md)
|
|
* [Experience AI function service](60.experience-ai-function.md)
|
|
* [Experience semantic indexing](70.experience-hybrid-vector-index.md)
|
|
* [Experience the Vibe Coding paradigm with Cursor Agent + OceanBase MCP](80.experience-vibe-coding-paradigm-with-cursor-agent-oceanbase-mcp.md)
|
|
* [Build a knowledge base desktop application based on seekdb](../../500.tutorials/100.create-ai-app-demo/100.build-kb-in-seekdb.md)
|
|
* [Build a cultural tourism assistant with multi-model integration based on seekdb](../../500.tutorials/100.create-ai-app-demo/300.build-multi-model-application-based-on-oceanbase.md)
|
|
* [Build an image search application based on seekdb](../../500.tutorials/100.create-ai-app-demo/400.build-image-search-app-in-seekdb.md)
|