Skip to content

Commit 5c4798d

Browse files
committed
docs(v1.17): update installation guide for CentOS and Ubuntu
- Update IvorySQL installation instructions for CentOS and Ubuntu - Improve clarity and consistency in the documentation - Remove unnecessary commands and options - Add notes on default installation paths and firewall configuration - Update examples for initializing and starting the database
1 parent a8a2a8c commit 5c4798d

File tree

2 files changed

+33
-39
lines changed
  • CN/modules/ROOT/pages/v1.17
  • EN/modules/ROOT/pages/v1.17

2 files changed

+33
-39
lines changed

CN/modules/ROOT/pages/v1.17/6.adoc

Lines changed: 22 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
== CentOS安装概述
99

10-
本文介绍 Ivorysql 在Linux平台(以CentOS 7为例)的安装过程及注意事项。本文主要演示数据库在Centos 7环境下rpm包安装步骤、源码安装步骤。
10+
本文介绍 IvorySQL 在Linux平台(以CentOS 7为例)的安装过程及注意事项。本文主要演示数据库在Centos 7环境下rpm包安装步骤、源码安装步骤。
1111

1212
=== 软硬件要求
1313

@@ -85,7 +85,7 @@ sudo yum groupinstall -y 'Development Tools'
8585
git checkout tags/Ivory_REL_1_17
8686
./configure --prefix=/usr/local/ivorysql/ivorysql-1.17
8787
----
88-
> 说明: 由于没有提供 `--prefix`,默认安装在 `/usr/local/ivorysql`,故需要指定路径
88+
> 说明: 如果没有提供 `--prefix`,默认将安装在 `/usr/local/ivorysql`。
8989
>
9090
> 注意:我们要记住指定的目录,因为系统查不出已经编译安装的程序在哪。更多 configure 参数通过 `./configure --help` 查看。还可以查看 PostgreSQL 手册。
9191

@@ -177,7 +177,7 @@ firewall-cmd --reload
177177
host all all 0.0.0.0/0 trust
178178

179179

180-
> 注意:这里是trust,就是说可以免密登录
180+
> 注意:trust,设置免密登录
181181

182182
执行以下命令加载配置:
183183

@@ -274,7 +274,7 @@ rm -fr /opt/IvorySQL-1.17 --删除残留安装目
274274

275275
== Ubuntu安装概述
276276

277-
本文介绍 Ivorysql 在Linux平台Ubuntu(以Ubuntu2404为例)的安装过程及注意事项。本文主要演示数据库在Ubuntu 2404环境下deb包安装步骤、源码安装步骤。
277+
本文介绍 IvorySQL 在Linux平台Ubuntu(以Ubuntu2404为例)的安装过程及注意事项。演示数据库在Ubuntu 2404环境下deb包安装步骤、源码安装步骤。
278278

279279
=== 软硬件要求
280280

@@ -318,7 +318,7 @@ IvorySQL 数据库支持Ubuntu24.x操作系统。详细信息,参考<<#_软硬
318318

319319
=== 获取安装包
320320

321-
您可以通过 源码安装 IvorySQL 数据库或 DEB 包安装
321+
您可以通过源码安装IvorySQL数据库或DEB包安装
322322

323323
==== 使用源码构建IvorySQL数据库
324324

@@ -341,22 +341,18 @@ sudo apt install -y gcc make flex bison
341341
3.1 配置:Root用户执行以下命令进行配置:
342342
----
343343
git checkout tags/Ivory_REL_1_17
344-
./configure \
345-
--prefix=/usr/local/ivorysql/ivorysql-1.17 \
346-
--enable-debug \
347-
--enable-cassert \
348-
--enable-depend
344+
./configure --prefix=/usr/local/ivorysql/ivorysql-1.17
349345
350346
----
351-
> 说明: 由于没有提供 `--prefix`,默认安装在 `/usr/local/ivorysql`,故需要指定路径
347+
> 说明: 如果没有提供 `--prefix`,默认将安装在 `/usr/local/ivorysql`。
352348
>
353349
> 注意:我们要记住指定的目录,因为系统查不出已经编译安装的程序在哪。更多 configure 参数通过 `./configure --help` 查看。还可以查看 PostgreSQL 手册。
354350

355351
3.2 编译安装:配置完成后,执行 make 进行编译:
356352

357353
make
358354

359-
要在安装新编译的服务之前使用回归测试测试一下,以下命令均可
355+
在安装新编译的服务之前,建议先进行回归测试以确保稳定性,可以使用以下任意命令执行测试
360356

361357
----
362358
make check
@@ -368,7 +364,7 @@ make all-check-world
368364
sudo make install
369365

370366

371-
==== 使用 DEB 包安装 IvorySql 数据库
367+
==== 使用 DEB 包安装 IvorySQL 数据库
372368

373369
1. 运行以下命令,下载 IvorySQL 安装包。
374370
----
@@ -419,7 +415,7 @@ firewall-cmd --zone=public --add-port=1521/tcp --permanent
419415
firewall-cmd --reload
420416
----
421417

422-
> 说明:默认端口是1521,如果不开放该端口,外部客户端通过ip连接会失败
418+
> 说明:默认端口是1521,外部客户端若想通过此端口连接需开放该端口
423419

424420
4.初始化:在用户ivorysql下,简单执行initdb就可以完成初始化:
425421

@@ -430,23 +426,24 @@ firewall-cmd --reload
430426

431427
5.启动数据库:使用pg_ctl启动数据库服务:
432428

433-
pg_ctl -D /home/ivorysql/data -l logfile start
429+
pg_ctl -D $PGDATA -l logfile start
434430

435-
查看状态,启动成功
431+
查看状态:
436432

437-
pg_ctl status
433+
pg_ctl -D $PGDATA status
438434

439-
=== 配置服务
435+
启动成功会有如下输出:
440436

441-
修改配置文件权限为可读写:
442-
chmod 755 $PGDATA/*
437+
pg_ctl: server is running (PID: 2273)
443438

444-
1. 客户端验证:修改 /home/ivorysql/data/pg_hba.conf,追加以下内容:
439+
=== 配置服务
440+
441+
1. 客户端验证:修改 $PGDATA/pg_hba.conf,追加以下内容:
445442

446443
host all all 0.0.0.0/0 trust
447444

448445

449-
> 注意:这里是trust,就是说可以免密登录
446+
> 注意:trust,设置免密登录
450447

451448
监听地址:修改$PGDATA/postgresql.conf ,追加以下内容:
452449

@@ -534,9 +531,9 @@ make clean
534531
3.删除残余目录和文件:
535532

536533
```
537-
systemctl disable ivorysql.servicemake --禁用服务
538-
mv /usr/lib/systemd/system/ivorysql.service /tmp/ --服务文件移到/tmp,删除也可以
539-
rm -fr /usr/local/ivorysql/ivorysql-1.17 --删除残留安装目录
534+
systemctl disable ivorysql.service --禁用服务
535+
mv /usr/lib/systemd/system/ivorysql.service /tmp/ --服务文件移到/tmp
536+
rm -fr /usr/local/ivorysql/ivorysql-1.17 --删除残留安装目录
540537
```
541538

542539
> 说明:还有用户ivorysql以及对应的环境变量,可以根据情况是否清理。剩下的就是数据目录了,请务必做好备份再做处理。还有安装的依赖包,可根据情况决定是否卸载。

EN/modules/ROOT/pages/v1.17/6.adoc

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
## CentOS Installation overview
99

10-
This article introduces the installation process and precautions of Ivorysql on Linux platform. This article mainly demonstrates rpm package installation steps, and source code installation steps of the database under the Centos 7 environment.
10+
This article introduces the installation process and precautions of IvorySQL on Linux platform. This article mainly demonstrates rpm package installation steps, and source code installation steps of the database under the Centos 7 environment.
1111

1212

1313
=== Software and hardware requirements
@@ -90,7 +90,7 @@ Configuration: Root users execute the following commands to configure:
9090
./configure --prefix=/usr/local/ivorysql/ivorysql-1.17
9191
```
9292

93-
> Note: Because -- prefix is not provided, it is installed in/usr/local/pgsql by default, so you need to specify the path
93+
> Note: If the `--prefix` option is not provided, the default installation path will be `/usr/local/ivorysql`.
9494

9595
> Note: We should remember the specified directory, because the system cannot find out where the compiled and installed programs are. More configure parameters can be viewed through "./configure -- help". You can also view the PostgreSQL manual
9696

@@ -306,7 +306,7 @@ rm -fr /opt/IvorySQL-1.17 --remove residual installa
306306

307307
## Ubuntu Installation overview
308308

309-
This article introduces the installation process and precautions of Ivorysql on Linux platform. This article mainly demonstrates rpm package installation steps, and source code installation steps of the database under the Ubuntu 2404 environment.
309+
This article introduces the installation process and precautions of IvorySQL on Linux platform. This article mainly demonstrates rpm package installation steps, and source code installation steps of the database under the Ubuntu 2404 environment.
310310

311311

312312
=== Software and hardware requirements
@@ -376,14 +376,10 @@ Configuration: Root users execute the following commands to configure:
376376

377377
```
378378
git checkout tags/Ivory_REL_1_17
379-
./configure \
380-
--prefix=/usr/local/ivorysql/ivorysql-1.17 \
381-
--enable-debug \
382-
--enable-cassert \
383-
--enable-depend
379+
./configure --prefix=/usr/local/ivorysql/ivorysql-1.17
384380
```
385381

386-
> Note: Because -- prefix is not provided, it is installed in/usr/local/pgsql by default, so you need to specify the path
382+
> Note: If the `--prefix` option is not provided, the default installation path will be `/usr/local/ivorysql`.
387383

388384
> Note: We should remember the specified directory, because the system cannot find out where the compiled and installed programs are. More configure parameters can be viewed through "./configure -- help". You can also view the PostgreSQL manual
389385

@@ -406,7 +402,7 @@ Installation:
406402
make install
407403
```
408404

409-
==== Install the IvorySql database using the DEB package
405+
==== Install the IvorySQL database using the DEB package
410406

411407
1. Run the following command to download the IvorySQL installation package.
412408

@@ -465,7 +461,7 @@ firewall-cmd --zone=public --add-port=1521/tcp --permanent
465461
firewall-cmd --reload
466462
```
467463

468-
> Note: The default port is 1521. If the port is not opened, the external client will fail to connect via IP.
464+
> Note: The default port is 1521. If the port is not opened, the external client will fail to connect via port.
469465

470466
4.Initialization: Under user ivorysql, simply execute initdb to complete initialization:
471467

@@ -478,13 +474,14 @@ initdb -D $PGDATA
478474
5.Start database: use pg_ Ctl starts the database service:
479475

480476
```
481-
pg_ctl -D /home/ivorysql/data -l logfile start
477+
pg_ctl -D $PGDATA -l logfile start
482478
```
483479

484480
View the status and start successfully:
485481

486482
```
487-
pg_ctl status
483+
pg_ctl -D $PGDATA status
484+
pg_ctl: server is running (PID: 2273)
488485
```
489486

490487
=== Configure service
@@ -596,7 +593,7 @@ make clean
596593
3.Delete residual directories and files:
597594

598595
```
599-
systemctl disable ivorysql.servicemake --disable Service
596+
systemctl disable ivorysql.service --disable Service
600597
mv /usr/lib/systemd/system/ivorysql.service /tmp/ --the service file can be moved to/tmp or deleted
601598
rm -fr /usr/local/ivorysql/ivorysql-1.17 --remove residual installation directory
602599
```

0 commit comments

Comments
 (0)