Skip to content

Commit 2a2fccb

Browse files
authored
Merge pull request #5 from haiwen/Setup_SeaDB_in_single_node
Setup SeaDB in single node
2 parents b568e02 + 3880984 commit 2a2fccb

File tree

2 files changed

+46
-13
lines changed

2 files changed

+46
-13
lines changed

manual/setup/setup_seadb_cluster.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ FoundationDB is a distributed database designed to handle large volumes of struc
66

77
## Deploy FoundationDB Cluster
88

9-
This guide uses a three-node FoundationDB setup as an example `cluster-fdb1(192.168.0.10), cluster-fdb2(192.168.0.11), cluster-fdb3(192.168.0.12)`. Each node runs two fdbserver processes, and each fdbserver process uses its own dedicated SSD data disk (`/fdb1` and `/fdb2`). Unless otherwise specified, the following steps should be performed on all three nodes. For more information, please refer to the [official documentation](https://apple.github.io/foundationdb/building-cluster.html?wework_cfm_code=N62oKwB0BwL1eIEfRQ9gi2JYDKFJ2GVPsa4FeatkT5iEMS5q30ZBfJXubqhrhrPzBj07eBXsZFkcrCwzIDbgR4x13xzFY7o2zieAtTi5VZHWQn8SBMg2YjrV2X1If2DQiA%3D%3D).
9+
This guide uses a three-node FoundationDB`(v7.3.63)` setup as an example `cluster-fdb1(192.168.0.10), cluster-fdb2(192.168.0.11), cluster-fdb3(192.168.0.12)`. Each node runs two fdbserver processes, and each fdbserver process uses its own dedicated SSD data disk (`/fdb1` and `/fdb2`). Unless otherwise specified, the following steps should be performed on all three nodes. For more information, please refer to the [official documentation](https://apple.github.io/foundationdb/building-cluster.html?wework_cfm_code=N62oKwB0BwL1eIEfRQ9gi2JYDKFJ2GVPsa4FeatkT5iEMS5q30ZBfJXubqhrhrPzBj07eBXsZFkcrCwzIDbgR4x13xzFY7o2zieAtTi5VZHWQn8SBMg2YjrV2X1If2DQiA%3D%3D).
1010

1111
### FoundationDB Installation
1212

manual/setup/setup_seadb_single.md

Lines changed: 45 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,25 +6,64 @@ FoundationDB is a distributed database designed to handle large volumes of struc
66

77
## Deploy FoundationDB
88

9-
Please refer to the [official documentation](https://apple.github.io/foundationdb/getting-started-mac.html) to deploy FoundationDB.
9+
For non-production environments, FoundationDB`(v7.3.63)` can be deployed as a single-node instance using Docker. For installation-package deployments, please refer to the [official documentation](https://apple.github.io/foundationdb/getting-started-linux.html).
10+
11+
### Download and modify `.env`
12+
13+
```shell
14+
mkdir -p /opt/seadb
15+
cd /opt/seadb
16+
17+
wget -O .env https://manual.seaticket.ai/main/repo/docker/seadb/env
18+
wget https://manual.seaticket.ai/main/repo/docker/seadb/fdb.yml
19+
wget https://manual.seaticket.ai/main/repo/docker/seadb/fdb.cluster
20+
21+
vim .env
22+
```
23+
24+
Modify `COMPOSE_FILE='seadb.yml'` to `COMPOSE_FILE='fdb.yml'` in the `.env` file.
25+
26+
```shell
27+
COMPOSE_FILE='fdb.yml'
28+
```
29+
30+
### Initialize FoundationDB
31+
32+
```shell
33+
# Start the FoundationDB service
34+
docker compose up -d
35+
36+
# Enter the fdb container
37+
docker exec -it fdb bash
38+
39+
fdbcli
40+
# Configure the ssd-2 storage engine
41+
fdb> configure new single ssd
42+
fdb> configure storage_migration_type=aggressive
43+
fdb> configure ssd
44+
45+
# Check the fdb status
46+
fdb> status
47+
```
1048

1149
## Deploy SeaDB
1250

1351
### Download and modify `.env`
1452

15-
To deploy SeaDB with Docker, you have to `.env`, `seadb.yml` and `fdb.cluster` in a directory (e.g., `/opt/seadb`):
16-
1753
```bash
18-
mkdir /opt/seadb
1954
cd /opt/seadb
2055

21-
wget -O .env https://manual.seaticket.ai/main/repo/docker/seadb/env
2256
wget https://manual.seaticket.ai/main/repo/docker/seadb/seadb.yml
23-
wget https://manual.seaticket.ai/main/repo/docker/seadb/fdb.cluster
2457

2558
vim .env
2659
```
2760

61+
Modify `COMPOSE_FILE='fdb.yml'` to `COMPOSE_FILE='fdb.yml,seadb.yml'` in the `.env` file.
62+
63+
```shell
64+
COMPOSE_FILE='fdb.yml,seadb.yml'
65+
```
66+
2867
The following fields merit particular attention:
2968

3069
| Variable | Description | Default Value |
@@ -34,12 +73,6 @@ The following fields merit particular attention:
3473
| `FDB_VOLUME` | The volume directory of FoundationDB data | `/opt/fdb-data` |
3574
| `TIME_ZONE` | Time zone | `UTC` |
3675

37-
Modify `fdb.cluster`, the content should copy from the `/etc/foundationdb/fdb.cluster` file in the FoundationDB node:
38-
39-
```bash
40-
vim fdb.cluster
41-
```
42-
4376
### Start SeaDB
4477

4578
Run the following command:

0 commit comments

Comments
 (0)