快速开始

1. 环境要求

硬件要求

配置参数

最低配置

推荐配置

CPU

4核

16核

内存

4GB

64GB

存储

800MB，机械硬盘

5GB以上，SSD或NvMe

网络

千兆网络

万兆网络

软件要求

IvorySQL数据库目前支持的操作系统包括但不限于CentOS 7.X和CentOS 8.X。

2. 快速安装

  快速开始所使用的操作系统为CentOS 7.9。

2.1. 从yum源安装IvorySQL数据库

安装前准备

安装前请先创建一个用户，并赋予其root权限，安装和使用均以该用户执行。这里以ivorysql用户为例。如何创建sudo用户
下载安装

执行以下命令安装：

$ sudo yum install -y https://yum.highgo.ca/dists/ivorysql-rpms/repo/ivorysql-release-3.0-1.noarch.rpm

$ sudo yum install -y ivorysql3 ivorysql3-server ivorysql3-contrib ivorysql3-test --skip-broken

  正确安装后，数据库将被安装在/usr/local/ivorysql路径下的ivorysql-version(如:ivorysql-3)文件夹内

执行以下命令为ivorysql用户赋权：

$ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql

配置环境变量

将以下配置写入~/.bash_profile文件并使用source命令该文件使环境变量生效：

PATH=/usr/local/ivorysql/ivorysql-3/bin:$PATH
export PATH
LD_LIBRARY_PATH=/usr/local/ivorysql/ivorysql-3/lib
export LD_LIBRARY_PATH
PGDATA=/usr/local/ivorysql/ivorysql-3/data
export PGDATA

$ source ~/.bash_profile

数据库初始化

$ initdb -D /usr/local/ivorysql/ivorysql-3/data

  其中-D参数用来指定数据库的数据目录。更多参数使用方法，请使用initdb --help命令获取。

启动数据库服务

$ pg_ctl -D /usr/local/ivorysql/ivorysql-3/data -l ivory.log start

其中-D参数用来指定数据库的数据目录，如果[配置环境变量] 配置了PGDATA，则该参数可以省略。-l参数用来指定日志目录。更多参数使用方法，请使用pg_ctl --help命令获取。

查看确认数据库启动成功：

$ ps -ef | grep postgres
ivorysql  3214     1  0 20:35 ?        00:00:00 /usr/local/ivorysql/ivorysql-3/bin/postgres -D /usr/local/ivorysql/ivorysql-3/data
ivorysql  3215  3214  0 20:35 ?        00:00:00 postgres: checkpointer
ivorysql  3216  3214  0 20:35 ?        00:00:00 postgres: background writer
ivorysql  3218  3214  0 20:35 ?        00:00:00 postgres: walwriter
ivorysql  3219  3214  0 20:35 ?        00:00:00 postgres: autovacuum launcher
ivorysql  3220  3214  0 20:35 ?        00:00:00 postgres: logical replication launcher
ivorysql  3238  1551  0 20:35 pts/0    00:00:00 grep --color=auto postgres

2.2. docker方式运行

从Docker Hub上获取IvorySQL镜像

$ docker pull ivorysql/ivorysql:3.1-ubi8

运行IvorySQL

$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:3.1-ubi8

查看IvorySQL容器运行是否成功

$ docker ps | grep ivorysql
CONTAINER ID   IMAGE               COMMAND                   CREATED          STATUS          PORTS                              NAMES
6faa2d0ed705   ivorysql:3.1-ubi8   "docker-entrypoint.s…"   50 seconds ago   Up 49 seconds   5866/tcp, 0.0.0.0:5434->5432/tcp   ivorysql

3. 数据库连接

psql连接数据库：

$ psql -d <database>
psql (16.1)
Type "help" for help.

ivorysql=#

  其中-d参数用来指定想要连接到的数据库名称。IvorySQL默认使用ivorysql数据库，但较低版本的IvorySQL首次使用时需用户先连接postgres数据库，然后自己创建ivorysql数据库。较高版本的IvorySQL则已为用户创建好ivorysql数据库，可以直接连接。

  更多参数使用方法，请使用psql --help命令获取。

Docker运行IvorySQL时，需要添加额外参数，如 psql -d ivorysql -U ivorysql -h 127.0.0.1 -p 5434

现在可以开始使用IvorySQL啦！就是这么简单！

想要获得更多安装方式，请参考安装指南