Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/advanced-analytics/postgis.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ You can access the Cloudberry Database PostGIS project repo at [`cloudberrydb/po

Before installing PostGIS for Cloudberry Database, install the required dependencies and compile several components. This process is currently supported only on CentOS, with plans to support Rocky Linux in the future.

Before you get started, ensure that the Cloudberry Database is correctly installed on your machine. If it is not installed, see the [documentation](https://cloudberrydb.org/docs/) for installation instructions.
Before you get started, ensure that the Cloudberry Database is correctly installed on your machine. If it is not installed, see the [documentation](https://cloudberry.apache.org/docs/) for installation instructions.

1. Install the pre-requested dependencies.

Expand Down
46 changes: 23 additions & 23 deletions docs/cbdb-linux-compile.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ import TabItem from '@theme/TabItem';
# Compile and Install Cloudberry Database on Linux

:::info
The source of this document is from the GitHub repository [`cloudberrydb/cloudberrydb`](https://github.com/cloudberrydb/cloudberrydb/blob/main/deploy/build/README.Linux.md).
The source of this document is from the GitHub repository [`apache/cloudberry`](https://github.com/apache/cloudberry/blob/main/deploy/build/README.Linux.md).
:::

This document shares how to compile and install Cloudberry Database on Linux systems (CentOS 7, RHEL, and Ubuntu). Note that this document is for developers to try out Cloudberry Database in a single-node environments. DO NOT use this document for production environments.
Expand All @@ -23,10 +23,10 @@ Take the following steps to compile and install Cloudberry Database:

## Step 1. Clone GitHub repo

Clone the GitHub repository `cloudberrydb/cloudberrydb` to the target machine:
Clone the GitHub repository `apache/cloudberry` to the target machine:

```shell
git clone https://github.com/cloudberrydb/cloudberrydb.git
git clone https://github.com/apache/cloudberry.git
```

## Step 2. Install dependencies
Expand All @@ -38,10 +38,10 @@ Enter the repository and install dependencies according to your operating system

The following steps work on CentOS 7. For other CentOS versions, these steps might work but are not guaranteed to work.

1. Run the Bash script `README.CentOS.bash` in the `deploy/build` directory of the `cloudberrydb/cloudberrydb` repository. To run this script, password is required. Then, some required dependencies will be automatically downloaded.
1. Run the Bash script `README.CentOS.bash` in the `deploy/build` directory of the `apache/cloudberry` repository. To run this script, password is required. Then, some required dependencies will be automatically downloaded.

```bash
cd cloudberrydb/deploy/build
cd cloudberry/deploy/build
./README.CentOS.bash
```

Expand Down Expand Up @@ -90,7 +90,7 @@ The following steps work on CentOS 7. For other CentOS versions, these steps mig
3. Install more dependencies by running the `README.Rhel-Rocky.bash` script.

```bash
cd ~/cloudberrydb/deploy/build/
cd cloudberry/deploy/build/
./README.Rhel-Rocky.bash
```

Expand All @@ -101,7 +101,7 @@ The following steps work on CentOS 7. For other CentOS versions, these steps mig

```shell
## You need to enter your password to run.
sudo ~/cloudberrydb/deploy/build/README.Ubuntu.bash
sudo cloudberry/deploy/build/README.Ubuntu.bash
```

:::info
Expand Down Expand Up @@ -166,18 +166,18 @@ After you have installed all the dependencies for your operating system, it is t

After you have installed all the dependencies and performed the prerequisite platform tasks, you can start to build Cloudberry Database. Run the following commands in sequence.

1. Configure the build environment. Enter the `cloudberrydb` directory and run the `configure` script.
1. Configure the build environment. Enter the `cloudberry` directory and run the `configure` script.

```bash
cd cloudberrydb
./configure --with-perl --with-python --with-libxml --with-gssapi --prefix=/usr/local/cloudberrydb
cd cloudberry
./configure --with-perl --with-python --with-libxml --with-gssapi --prefix=/usr/local/cloudberry
```

:::info
Cloudberry Database is built with GPORCA by default. If you want to build CBDB without GPORCA, add the `--disable-orca` flag in the `./configure` command.

```bash
./configure --disable-orca --with-perl --with-python --with-libxml --prefix=/usr/local/cloudberrydb
./configure --disable-orca --with-perl --with-python --with-libxml --prefix=/usr/local/cloudberry
```

:::
Expand All @@ -193,12 +193,12 @@ After you have installed all the dependencies and performed the prerequisite pla

```bash
cd ..
cp -r cloudberrydb/ /home/gpadmin/
cp -r cloudberry/ /home/gpadmin/
cd /home/gpadmin/
chown -R gpadmin:gpadmin cloudberrydb/
chown -R gpadmin:gpadmin cloudberry/
su - gpadmin
cd cloudberrydb/
source /usr/local/cloudberrydb/greenplum_path.sh
cd cloudberry/
source /usr/local/cloudberry/greenplum_path.sh
```

4. Start the demo cluster.
Expand Down Expand Up @@ -254,13 +254,13 @@ After you have installed all the dependencies and performed the prerequisite pla
postgres=# select * from gp_segment_configuration;
dbid | content | role | preferred_role | mode | status | port | hostname | address | datadir | warehouseid
------+---------+------+----------------+------+--------+------+------------+------------+------------------------------------------------------------------------------+-------------
1 | -1 | p | p | n | u | 7000 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/qddir/demoDataDir-1 | 0
8 | -1 | m | m | s | u | 7001 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/standby | 0
3 | 1 | p | p | s | u | 7003 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/dbfast2/demoDataDir1 | 0
6 | 1 | m | m | s | u | 7006 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/dbfast_mirror2/demoDataDir1 | 0
2 | 0 | p | p | s | u | 7002 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/dbfast1/demoDataDir0 | 0
5 | 0 | m | m | s | u | 7005 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/dbfast_mirror1/demoDataDir0 | 0
4 | 2 | p | p | s | u | 7004 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/dbfast3/demoDataDir2 | 0
7 | 2 | m | m | s | u | 7007 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberrydb/gpAux/gpdemo/datadirs/dbfast_mirror3/demoDataDir2 | 0
1 | -1 | p | p | n | u | 7000 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/qddir/demoDataDir-1 | 0
8 | -1 | m | m | s | u | 7001 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/standby | 0
3 | 1 | p | p | s | u | 7003 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/dbfast2/demoDataDir1 | 0
6 | 1 | m | m | s | u | 7006 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/dbfast_mirror2/demoDataDir1 | 0
2 | 0 | p | p | s | u | 7002 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/dbfast1/demoDataDir0 | 0
5 | 0 | m | m | s | u | 7005 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/dbfast_mirror1/demoDataDir0 | 0
4 | 2 | p | p | s | u | 7004 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/dbfast3/demoDataDir2 | 0
7 | 2 | m | m | s | u | 7007 | i-6wvpa9wt | i-6wvpa9wt | /home/gpadmin/cloudberry/gpAux/gpdemo/datadirs/dbfast_mirror3/demoDataDir2 | 0
(8 rows)
```
27 changes: 13 additions & 14 deletions docs/cbdb-macos-compile.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ title: On macOS
# Compile and Install Cloudberry Database on macOS

:::info
The source of this document is from the GitHub repository [`cloudberrydb/cloudberrydb`](https://github.com/cloudberrydb/cloudberrydb/blob/main/deploy/build/README.macOS.md).
The source of this document is from the GitHub repository [`apache/cloudberry`](https://github.com/apache/cloudberry/blob/main/deploy/build/README.macOS.md).
:::

This document shares how to build, compile, and install Cloudberry Database on macOS (single node) for development and trial purposes. Follow the steps below.
Expand All @@ -21,13 +21,13 @@ DO NOT use this guide for production deployment.
1. Clone the source code of Cloudberry Database from GitHub to your local Mac.

```bash
git clone [email protected]:cloudberrydb/cloudberrydb.git
git clone [email protected]:apache/cloudberry.git
```

2. Enter the `cloudberrydb/` directory.
2. Enter the `cloudberry/` directory.

```bash
cd cloudberrydb/
cd cloudberry/
```

3. Run the following command to install the needed dependencies. You will be asked to enter the `sudo` password of your macOS system.
Expand Down Expand Up @@ -77,7 +77,7 @@ DO NOT use this guide for production deployment.
## Step 3. Configure, compile, and install

```bash
# Run the following commands under the `cloudberrydb/` dir.
# Run the following commands under the `cloudberry/` dir.
# 1. Configure the build environment.

BREWPREFIX=$(brew --prefix); export PATH="$BREWPREFIX/opt/gnu-sed/libexec/gnubin:$BREWPREFIX/opt/apr/bin:$PATH"; CXXFLAGS="-I $BREWPREFIX/include" CFLAGS="-ggdb -Og -g3 -fno-omit-frame-pointer -I $BREWPREFIX/include" LDFLAGS="-L $BREWPREFIX/lib" CC=$(which gcc-13) CXX=$(which g++-13) ./configure --enable-debug --prefix=$(cd ~; pwd)/install/cbdb;
Expand Down Expand Up @@ -138,14 +138,13 @@ source gpAux/gpdemo/gpdemo-env.sh
postgres=# select * from gp_segment_configuration;
dbid | content | role | preferred_role | mode | status | port | hostname | address | datadir | warehouseid
------+---------+------+----------------+------+--------+------+-----------------------------+-----------------------------+----------------------------------------------------------------------------------------------------------+-------------
1 | -1 | p | p | n | u | 8000 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/qddir/demoDataDir-1 | 0
8 | -1 | m | m | s | u | 8001 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/standby | 0
3 | 1 | p | p | s | u | 8003 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/dbfast2/demoDataDir1 | 0
6 | 1 | m | m | s | u | 8006 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/dbfast_mirror2/demoDataDir1 | 0
2 | 0 | p | p | s | u | 8002 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/dbfast1/demoDataDir0 | 0
5 | 0 | m | m | s | u | 8005 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/dbfast_mirror1/demoDataDir0 | 0
4 | 2 | p | p | s | u | 8004 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/dbfast3/demoDataDir2 | 0
7 | 2 | m | m | s | u | 8007 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberrydb/gpAux/gpdemo/datadirs/dbfast_mirror3/demoDataDir2 | 0
1 | -1 | p | p | n | u | 8000 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/qddir/demoDataDir-1 | 0
8 | -1 | m | m | s | u | 8001 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/standby | 0
3 | 1 | p | p | s | u | 8003 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/dbfast2/demoDataDir1 | 0
6 | 1 | m | m | s | u | 8006 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/dbfast_mirror2/demoDataDir1 | 0
5 | 0 | m | m | s | u | 8005 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/dbfast_mirror1/demoDataDir0 | 0
4 | 2 | p | p | s | u | 8004 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/dbfast3/demoDataDir2 | 0
7 | 2 | m | m | s | u | 8007 | cbdb.local | cbdb.local | /Users/cbdb/Documents/GitHub/upstream/cloudberry/gpAux/gpdemo/datadirs/dbfast_mirror3/demoDataDir2 | 0
(8 rows)

postgres=#
Expand All @@ -158,4 +157,4 @@ source gpAux/gpdemo/gpdemo-env.sh
make installcheck-world
```

Congratulations 🎉! You've successfully installed and created a CloudberryDB cluster. Happy Hacking! 😉
Congratulations 🎉! You've successfully installed and created a Cloudberry cluster. Happy Hacking! 😉
2 changes: 1 addition & 1 deletion docs/create-and-manage-tables.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,6 @@ Similar to unique constraints, an exclusion constraint is permitted only for rep

Exclusion constraints are not supported for partitioned tables.

See also [`CREATE TABLE ... CONSTRAINT ... EXCLUDE`](https://github.com/cloudberrydb/cloudberrydb-site/blob/cbdb-doc-validation/docs/sql-stmts/create-table.md) for details.
See also [`CREATE TABLE ... CONSTRAINT ... EXCLUDE`](https://github.com/apache/cloudberry-site/blob/cbdb-doc-validation/docs/sql-stmts/create-table.md) for details.

Adding an exclusion constraint automatically creates an index of the type specified in the constraint declaration.
2 changes: 1 addition & 1 deletion docs/performance/update-stats-using-analyze.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ WHERE relname = 'test_analyze';

## Generate statistics selectively

Running [`ANALYZE`](https://github.com/cloudberrydb/cloudberrydb-site/blob/cbdb-doc-validation/docs/sql-stmts/analyze.md) with no arguments updates statistics for all tables in the database. This can be a very long-running process and it is not recommended. You should `ANALYZE` tables selectively when data has changed or use the [analyzedb](https://github.com/cloudberrydb/cloudberrydb-site/blob/cbdb-doc-validation/docs/sys-utilities/analyzedb.md) utility.
Running [`ANALYZE`](https://github.com/apache/cloudberry-site/blob/cbdb-doc-validation/docs/sql-stmts/analyze.md) with no arguments updates statistics for all tables in the database. This can be a very long-running process and it is not recommended. You should `ANALYZE` tables selectively when data has changed or use the [analyzedb](https://github.com/apache/cloudberry-site/blob/cbdb-doc-validation/docs/sys-utilities/analyzedb.md) utility.

Running `ANALYZE` on a large table can take a long time. If it is not feasible to run `ANALYZE` on all columns of a very large table, you can generate statistics for selected columns only using `ANALYZE table(column, ...)`. Be sure to include columns used in joins, `WHERE` clauses, `SORT` clauses, `GROUP BY` clauses, or `HAVING` clauses.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,15 @@ variable](https://go.dev/doc/install).
1. Pull the `cloudberrydb/gpbackup` GitHub repository to the target machine.

```bash
go install github.com/cloudberrydb/gpbackup@latest
go install github.com/apache/cloudberry-gpbackup@latest
```

The repository is placed in `$GOPATH/pkg/mod/github.com/cloudberrydb/gpbackup`.
The repository is placed in `$GOPATH/pkg/mod/github.com/apache/cloudberry-gpbackup`.

2. Enter the `cloudberrydb/gpbackup` directory. Then, build and install the source code:

```bash
cd <$GOPATH/pkg/mod/github.com/cloudberrydb/gpbackup>
cd <$GOPATH/pkg/mod/github.com/apache/cloudberry-gpbackup>
make depend
make build
```
Expand Down
2 changes: 1 addition & 1 deletion docs/sys-admin/enable-coordinator-mirroring.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Make sure that you have already configured a standby coordinator on a different

:::note

If you follow the steps described in the [Prepare to Deploy](https://cloudberrydb.org/docs/cbdb-op-prepare-to-deploy) and [Deploy Cloudberry Database Manually Using RPM Package](https://cloudberrydb.org/docs/cbdb-op-deploy-guide) topics to deploy the cluster, a host for the standby coordinator ( `cbdb-standbycoordinator`) is already configured in the cluster.
If you follow the steps described in the [Prepare to Deploy](https://cloudberry.apache.org/docs/cbdb-op-prepare-to-deploy) and [Deploy Cloudberry Database Manually Using RPM Package](https://cloudberry.apache.org/docs/cbdb-op-deploy-guide) topics to deploy the cluster, a host for the standby coordinator ( `cbdb-standbycoordinator`) is already configured in the cluster.

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ import TabItem from '@theme/TabItem';
# 在 Linux 系统上编译和安装 Cloudberry Database

:::info
本文档来自 GitHub 仓库 [`cloudberrydb/cloudberrydb`](https://github.com/cloudberrydb/cloudberrydb/blob/main/deploy/build/README.Linux.md).
本文档来自 GitHub 仓库 [`apache/cloudberry`](https://github.com/apache/cloudberry/blob/main/deploy/build/README.Linux.md).
:::

本文档分享如何在 Linux 系统(CentOS 7、RHEL 和 Ubuntu)上编译和安装 Cloudberry Database。请注意,本文档仅供开发人员在单节点环境中尝试 Cloudberry Database。**请勿将本文档用于生产环境**。
Expand All @@ -23,10 +23,10 @@ import TabItem from '@theme/TabItem';

## 第 1 步:克隆 GitHub 仓库

将 GitHub 仓库 `cloudberrydb/cloudberrydb` 克隆到目标机器:
将 GitHub 仓库 `apache/cloudberry` 克隆到目标机器:

```shell
git clone https://github.com/cloudberrydb/cloudberrydb.git
git clone https://github.com/apache/cloudberry.git
```

## 第 2 步:安装依赖项
Expand All @@ -38,7 +38,7 @@ git clone https://github.com/cloudberrydb/cloudberrydb.git

以下步骤在 CentOS 7 上测试通过。对于其他版本的 CentOS,这些步骤可能有效,但不能保证有效。

1. 执行 `cloudberrydb/cloudberrydb` 仓库下 `deploy/build` 目录中的 `README.CentOS.bash` 脚本。执行此脚本需要输入密码。然后,系统会自动下载一些必要的依赖项。
1. 执行 `apache/cloudberry` 仓库下 `deploy/build` 目录中的 `README.CentOS.bash` 脚本。执行此脚本需要输入密码。然后,系统会自动下载一些必要的依赖项。

```bash
cd cloudberrydb/deploy/build
Expand Down
Loading