Skip to content

build-and-run.md

Latest commit

 

History

History
63 lines (39 loc) · 1.44 KB

build-and-run.md

File metadata and controls

63 lines (39 loc) · 1.44 KB

Get the code, build and run

Prerequisites

Check the Install toolchain guide for supported OS, GLIBC version requirement, and how to install the C++ toolchain.

Clone

Clone the source code to your development machine:

git clone https://github.com/oceanbase/seekdb.git

Build

Build OceanBase SeekDB from the source code in debug mode or release mode:

Debug mode

bash build.sh debug --init --make

Release mode

bash build.sh release --init --make

Run

Now that you built the observer binary, you can deploy a SeekDB instance with the obd.sh utility:

./tools/deploy/obd.sh prepare -p /tmp/obtest
./tools/deploy/obd.sh deploy -c ./tools/deploy/single.yaml

You can check the mysql_port in ./tools/deploy/single.yaml file to see the listening port. Normally, if you deploy with the root user, the seekdb server will listen on port 10000, and the examples below are also based on this port.

Connect

You can use the official MySQL client to connect to SeekDB:

mysql -uroot -h127.0.0.1 -P10000

Alternatively, you can use the obclient to connect to SeekDB:

./deps/3rd/u01/obclient/bin/obclient -h127.0.0.1 -P10000 -uroot -Doceanbase -A

Shutdown

You can run the following command to shut down the server and clean up the deployment, which prevents disk space consumption:

./tools/deploy/obd.sh destroy --rm -n single