Skip to content

Commit 23608b9

Browse files
committed
update install guide for v4.4
1 parent cdcbf9f commit 23608b9

File tree

4 files changed

+87
-108
lines changed

4 files changed

+87
-108
lines changed

CN/modules/ROOT/pages/v4.4/3.adoc

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -52,16 +52,16 @@ gpgcheck=0
5252
```
5353
保存退出后,安装IvorySQL4
5454
```
55-
$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
55+
$ sudo dnf install -y IvorySQL-4.4
5656
```
5757
....
5858
59-
正确安装后,数据库将被安装在/usr/local/ivorysql路径下的ivorysql-version(如:ivorysql-4)文件夹内
59+
正确安装后,数据库将被安装在/opt/IvorySQL-4.4/路径下的IvorySQL-version(如:IvorySQL-4.4)文件夹内
6060
....
6161

6262
执行以下命令为ivorysql用户赋权:
6363
```
64-
$ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql
64+
$ sudo chown -R ivorysql:ivorysql /opt/IvorySQL-4.4
6565
```
6666
[[配置环境变量]]
6767
** 配置环境变量
@@ -70,11 +70,11 @@ $ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql
7070

7171
将以下配置写入~/.bash_profile文件并使用source命令该文件使环境变量生效:
7272
```
73-
PATH=/usr/local/ivorysql/ivorysql-4/bin:$PATH
73+
PATH=/opt/IvorySQL-4.4/bin:$PATH
7474
export PATH
75-
LD_LIBRARY_PATH=/usr/local/ivorysql/ivorysql-4/lib
75+
LD_LIBRARY_PATH=/opt/IvorySQL-4.4/lib
7676
export LD_LIBRARY_PATH
77-
PGDATA=/usr/local/ivorysql/ivorysql-4/data
77+
PGDATA=/opt/IvorySQL-4.4/data
7878
export PGDATA
7979
```
8080
```
@@ -84,7 +84,7 @@ $ source ~/.bash_profile
8484
** 数据库初始化
8585

8686
```
87-
$ initdb -D /usr/local/ivorysql/ivorysql-4/data
87+
$ initdb -D /opt/IvorySQL-4.4/data
8888
```
8989
....
9090
其中-D参数用来指定数据库的数据目录。更多参数使用方法,请使用initdb --help命令获取。
@@ -93,7 +93,7 @@ $ initdb -D /usr/local/ivorysql/ivorysql-4/data
9393
** 启动数据库服务
9494

9595
```
96-
$ pg_ctl -D /usr/local/ivorysql/ivorysql-4/data -l ivory.log start
96+
$ pg_ctl -D /opt/IvorySQL-4.4/data -l ivory.log start
9797
```
9898

9999
其中-D参数用来指定数据库的数据目录,如果<<配置环境变量>> 配置了PGDATA,则该参数可以省略。-l参数用来指定日志目录。更多参数使用方法,请使用pg_ctl --help命令获取。
@@ -102,7 +102,7 @@ $ pg_ctl -D /usr/local/ivorysql/ivorysql-4/data -l ivory.log start
102102
查看确认数据库启动成功:
103103
```
104104
$ ps -ef | grep postgres
105-
ivorysql 3214 1 0 20:35 ? 00:00:00 /usr/local/ivorysql/ivorysql-4/bin/postgres -D /usr/local/ivorysql/ivorysql-4/data
105+
ivorysql 3214 1 0 20:35 ? 00:00:00 /opt/IvorySQL-4.4/bin/postgres -D /opt/IvorySQL-4.4/data
106106
ivorysql 3215 3214 0 20:35 ? 00:00:00 postgres: checkpointer
107107
ivorysql 3216 3214 0 20:35 ? 00:00:00 postgres: background writer
108108
ivorysql 3218 3214 0 20:35 ? 00:00:00 postgres: walwriter
@@ -115,27 +115,27 @@ ivorysql 3238 1551 0 20:35 pts/0 00:00:00 grep --color=auto postgres
115115

116116
** 从Docker Hub上获取IvorySQL镜像
117117
```
118-
$ docker pull ivorysql/ivorysql:4.2-ubi8
118+
$ docker pull ivorysql/ivorysql:4.4-ubi8
119119
```
120120

121121
** 运行IvorySQL
122122
```
123-
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.2-ubi8
123+
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.4-ubi8
124124
```
125125

126126
** 查看IvorySQL容器运行是否成功
127127
```
128128
$ docker ps | grep ivorysql
129129
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
130-
6faa2d0ed705 ivorysql:4.2-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
130+
6faa2d0ed705 ivorysql:4.4-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
131131
```
132132

133133
== 数据库连接
134134

135135
psql连接数据库:
136136
```
137137
$ psql -d <database>
138-
psql (17.2)
138+
psql (17.4)
139139
Type "help" for help.
140140

141141
ivorysql=#

CN/modules/ROOT/pages/v4.4/6.adoc

Lines changed: 32 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -32,27 +32,27 @@ gpgcheck=0
3232
```
3333
保存退出后,安装IvorySQL4
3434
```
35-
$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
35+
$ sudo dnf install -y IvorySQL-4.4
3636
```
3737

3838
** 查看安装结果
3939
```
40-
dnf search ivorysql
40+
dnf search IvorySQL
4141
```
4242
查看结果说明如下:
4343
|====
4444
| 序号 | 包名 | 描述
4545
| 1 | ivorysql4.x86_64 | IvorySQL客户端程序和库文件
4646
| 2 | ivorysql4-contrib.x86_64 | 随IvorySQL发布的已贡献的源代码和二进制文件
47-
| 3 | Ivorysql4-devel.x86_64 | IvorySQL开发头文件和库
48-
| 4 | Ivorysql4-docs.x86_64 | IvorySQL的额外文档
47+
| 3 | ivorysql4-devel.x86_64 | IvorySQL开发头文件和库
48+
| 4 | ivorysql4-docs.x86_64 | IvorySQL的额外文档
4949
| 5 | ivorysql4-libs.x86_64 | 所有IvorySQL客户端所需的共享库
50-
| 6 | Ivorysql4-llvmjit.x86_64 | 对IvorySQL的即时编译支持
51-
| 7 | Ivorysql4-plperl.x86_64 | 用于IvorySQL的过程语言Perl
52-
| 8 | Ivorysql4-plpython3.x86_64 | 用于IvorySQL的过程语言Python3
53-
| 9 | Ivorysql4-pltcl.x86_64 | 用于IvorySQL的过程语言Tcl
50+
| 6 | ivorysql4-llvmjit.x86_64 | 对IvorySQL的即时编译支持
51+
| 7 | ivorysql4-plperl.x86_64 | 用于IvorySQL的过程语言Perl
52+
| 8 | ivorysql4-plpython3.x86_64 | 用于IvorySQL的过程语言Python3
53+
| 9 | ivorysql4-pltcl.x86_64 | 用于IvorySQL的过程语言Tcl
5454
| 10 | ivorysql4-server.x86_64 | 创建和运行IvorySQL服务器所需的程序
55-
| 11 | Ivorysql4-test.x86_64 | 随IvorySQL发布的测试套件
55+
| 11 | ivorysql4-test.x86_64 | 随IvorySQL发布的测试套件
5656
| 12 | ivorysql-release.noarch | 瀚高基础软件股份有限公司的Yum源配置RPM包
5757
|====
5858

@@ -61,12 +61,12 @@ dnf search ivorysql
6161

6262
** 从Docker Hub上获取IvorySQL镜像
6363
```
64-
$ docker pull ivorysql/ivorysql:4.2-ubi8
64+
$ docker pull ivorysql/ivorysql:4.4-ubi8
6565
```
6666

6767
** 运行IvorySQL
6868
```
69-
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.2-ubi8
69+
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.4-ubi8
7070
```
7171
-e参数说明
7272
|====
@@ -94,17 +94,7 @@ $ sudo dnf install -y lz4 libicu libxslt python3
9494
```
9595
** 获取rpm包
9696
```
97-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-4.2-1.rhel8.x86_64.rpm
98-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-contrib-4.2-1.rhel8.x86_64.rpm
99-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-devel-4.2-1.rhel8.x86_64.rpm
100-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-docs-4.2-1.rhel8.x86_64.rpm
101-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-libs-4.2-1.rhel8.x86_64.rpm
102-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-llvmjit-4.2-1.rhel8.x86_64.rpm
103-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-plperl-4.2-1.rhel8.x86_64.rpm
104-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-plpython3-4.2-1.rhel8.x86_64.rpm
105-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-pltcl-4.2-1.rhel8.x86_64.rpm
106-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-server-4.2-1.rhel8.x86_64.rpm
107-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql4-test-4.2-1.rhel8.x86_64.rpm
97+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.4/IvorySQL-4.4-a50789d-20250304.x86_64.rpm
10898
```
10999
** 安装rpm包
110100

@@ -114,7 +104,7 @@ $ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/
114104
```
115105
$ sudo yum --disablerepo=* localinstall *.rpm
116106
```
117-
数据库将被安装在/usr/local/ivorysql路径下
107+
数据库将被安装在/opt/IvorySQL-4.4/路径下
118108

119109
[[源码安装]]
120110
== 源码安装
@@ -169,14 +159,14 @@ $ sudo apt -y install pkg-config libreadline-dev libicu-dev libldap2-dev uuid-de
169159

170160
** 获取deb包
171161
```
172-
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.2/ivorysql-4.2.x86_64.deb
162+
$ sudo wget https://github.com/IvorySQL/IvorySQL/releases/download/IvorySQL_4.4/IvorySQL-4.4-a50789d-20250304.amd64.deb
173163
```
174164

175165
** 安装deb包
176166
```
177-
$ sudo dpkg -i ivorysql-4.2.x86_64.deb
167+
$ sudo dpkg -i IvorySQL-4.4-a50789d-20250304.amd64.deb
178168
```
179-
数据库将被安装在/usr/local/ivorysql路径下
169+
数据库将被安装在/opt/IvorySQL-4.4/路径下
180170

181171
== 启动数据库
182172
参考<<yum源安装>>、<<rpm安装>>、<<源码安装>>、<<deb安装>>的用户,需要手动启动数据库。
@@ -185,9 +175,9 @@ $ sudo dpkg -i ivorysql-4.2.x86_64.deb
185175

186176
+
187177

188-
执行以下命令为安装用户赋权,示例用户为ivorysql,安装目录为/usr/local/ivorysql
178+
执行以下命令为安装用户赋权,示例用户为ivorysql,安装目录为/opt/IvorySQL-4.4/
189179
```
190-
$ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql
180+
$ sudo chown -R ivorysql:ivorysql /opt/IvorySQL-4.4/
191181
```
192182
[[配置环境变量]]
193183
** 配置环境变量
@@ -196,11 +186,11 @@ $ sudo chown -R ivorysql:ivorysql /usr/local/ivorysql
196186

197187
将以下配置写入用户的~/.bash_profile文件并使用source命令该文件使环境变量生效:
198188
```
199-
PATH=/usr/local/ivorysql/ivorysql-4/bin:$PATH
189+
PATH=/opt/IvorySQL-4.4/bin:$PATH
200190
export PATH
201-
LD_LIBRARY_PATH=/usr/local/ivorysql/ivorysql-4/lib
191+
LD_LIBRARY_PATH=/opt/IvorySQL-4.4/lib
202192
export LD_LIBRARY_PATH
203-
PGDATA=/usr/local/ivorysql/ivorysql-4/data
193+
PGDATA=/opt/IvorySQL-4.4/data
204194
export PGDATA
205195
```
206196
```
@@ -209,8 +199,8 @@ $ source ~/.bash_profile
209199
** 数据库初始化
210200

211201
```
212-
$ mkdir /usr/local/ivorysql/ivorysql-4/data
213-
$ initdb -D /usr/local/ivorysql/ivorysql-4/data
202+
$ mkdir /opt/IvorySQL-4.4/data
203+
$ initdb -D /opt/IvorySQL-4.4/data
214204
```
215205
....
216206
其中-D参数用来指定数据库的数据目录。更多参数使用方法,请使用initdb --help命令获取。
@@ -219,7 +209,7 @@ $ initdb -D /usr/local/ivorysql/ivorysql-4/data
219209
** 启动数据库服务
220210

221211
```
222-
$ pg_ctl -D /usr/local/ivorysql/ivorysql-4/data -l ivory.log start
212+
$ pg_ctl -D /opt/IvorySQL-4.4/data -l ivory.log start
223213
```
224214

225215
其中-D参数用来指定数据库的数据目录,如果<<配置环境变量>> 配置了PGDATA,则该参数可以省略。-l参数用来指定日志目录。更多参数使用方法,请使用pg_ctl --help命令获取。
@@ -228,7 +218,7 @@ $ pg_ctl -D /usr/local/ivorysql/ivorysql-4/data -l ivory.log start
228218
查看确认数据库启动成功:
229219
```
230220
$ ps -ef | grep postgres
231-
ivorysql 130427 1 0 02:45 ? 00:00:00 /usr/local/ivorysql/ivorysql-4/bin/postgres -D /usr/local/ivorysql/ivorysql-4/data
221+
ivorysql 130427 1 0 02:45 ? 00:00:00 /opt/IvorySQL-4.4/bin/postgres -D /opt/IvorySQL-4.4/data
232222
ivorysql 130428 130427 0 02:45 ? 00:00:00 postgres: checkpointer
233223
ivorysql 130429 130427 0 02:45 ? 00:00:00 postgres: background writer
234224
ivorysql 130431 130427 0 02:45 ? 00:00:00 postgres: walwriter
@@ -242,7 +232,7 @@ ivorysql 130445 130274 0 02:45 pts/1 00:00:00 grep --color=auto postgres
242232
psql连接数据库:
243233
```
244234
$ psql -d <database>
245-
psql (17.2)
235+
psql (17.4)
246236
Type "help" for help.
247237

248238
ivorysql=#
@@ -266,7 +256,7 @@ TIP: Docker运行IvorySQL时,需要添加额外参数,参考:psql -d ivory
266256

267257
执行以下命令依次卸载:
268258
```
269-
$ sudo dnf remove -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
259+
$ sudo dnf remove -y IvorySQL-4.4
270260
$ sudo rpm -e ivorysql-release-4.2-1.noarch
271261
```
272262

@@ -276,15 +266,15 @@ $ sudo rpm -e ivorysql-release-4.2-1.noarch
276266
```
277267
$ docker stop ivorysql
278268
$ docker rm ivorysql
279-
$ docker rmi ivorysql/ivorysql:4.2-ubi8
269+
$ docker rmi ivorysql/ivorysql:4.4-ubi8
280270
```
281271

282272
=== rpm安装的卸载
283273

284274
执行以下命令卸载并清理文件夹:
285275
```
286276
$ sudo yum remove --disablerepo=* ivorysql4\*
287-
$ sudo rm -rf /usr/local/ivorysql
277+
$ sudo rm -rf /opt/IvorySQL-4.4
288278
```
289279

290280
=== 源码安装的卸载
@@ -293,13 +283,13 @@ $ sudo rm -rf /usr/local/ivorysql
293283
```
294284
$ sudo make uninstall
295285
$ make clean
296-
$ sudo rm -rf /usr/local/ivorysql
286+
$ sudo rm -rf /opt/IvorySQL-4.4
297287
```
298288

299289
=== deb安装的卸载
300290

301291
执行以下命令卸载数据库并清理文件夹:
302292
```
303-
$ sudo dpkg -P ivorysql4.2
304-
$ sudo rm -rf /usr/local/ivorysql
293+
$ sudo dpkg -P IvorySQL-4.4
294+
$ sudo rm -rf /opt/IvorySQL-4.4
305295
```

EN/modules/ROOT/pages/v4.4/3.adoc

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ gpgcheck=0
5151
```
5252
After saving and exiting, you can install IvorySQL 4 with the following steps
5353
```
54-
$ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-test
54+
$ sudo dnf install -y IvorySQL-4.4
5555
```
5656

5757
[[setting-environment-variables]]
@@ -61,11 +61,11 @@ $ sudo dnf install -y ivorysql4 ivorysql4-server ivorysql4-contrib ivorysql4-tes
6161

6262
Add below contents in ~/.bash_profile file and source to make it effective:
6363
```
64-
PATH=/usr/local/ivorysql/ivorysql-4/bin:$PATH
64+
PATH=/opt/IvorySQL-4.4/bin:$PATH
6565
export PATH
66-
LD_LIBRARY_PATH=/usr/local/ivorysql/ivorysql-4/lib
66+
LD_LIBRARY_PATH=/opt/IvorySQL-4.4/lib
6767
export LD_LIBRARY_PATH
68-
PGDATA=/usr/local/ivorysql/ivorysql-4/data
68+
PGDATA=/opt/IvorySQL-4.4/data
6969
export PGDATA
7070
```
7171
```
@@ -75,7 +75,7 @@ $ source ~/.bash_profile
7575
** Initializing database
7676

7777
```
78-
$ initdb -D /usr/local/ivorysql/ivorysql-4/data
78+
$ initdb -D /opt/IvorySQL-4.4/data
7979
```
8080
....
8181
The -D option specifies the directory where the database cluster should be stored. This is the only information required by initdb, but you can avoid writing it by setting the PGDATA environment variable, which can be convenient since the database server can find the database directory later by the same variable.
@@ -86,7 +86,7 @@ $ initdb -D /usr/local/ivorysql/ivorysql-4/data
8686
** Starting IvorySQL service
8787

8888
```
89-
$ pg_ctl -D /usr/local/ivorysql/ivorysql-4/data -l ivory.log start
89+
$ pg_ctl -D /opt/IvorySQL-4.4/data -l ivory.log start
9090
```
9191

9292
The -D option specifies the file system location of the database configuration files. If this option is omitted, the environment variable PGDATA in <<setting-environment-variables>> is used. -l option appends the server log output to filename. If the file does not exist, it is created.
@@ -97,7 +97,7 @@ $ pg_ctl -D /usr/local/ivorysql/ivorysql-4/data -l ivory.log start
9797
Confirm it’s successfully started:
9898
```
9999
$ ps -ef | grep postgres
100-
ivorysql 3214 1 0 20:35 ? 00:00:00 /usr/local/ivorysql/ivorysql-4/bin/postgres -D /usr/local/ivorysql/ivorysql-4/data
100+
ivorysql 3214 1 0 20:35 ? 00:00:00 /opt/IvorySQL-4.4/bin/postgres -D /opt/IvorySQL-4.4/data
101101
ivorysql 3215 3214 0 20:35 ? 00:00:00 postgres: checkpointer
102102
ivorysql 3216 3214 0 20:35 ? 00:00:00 postgres: background writer
103103
ivorysql 3218 3214 0 20:35 ? 00:00:00 postgres: walwriter
@@ -110,27 +110,27 @@ ivorysql 3238 1551 0 20:35 pts/0 00:00:00 grep --color=auto postgres
110110

111111
** Get IvorySQL image from Docker Hub
112112
```
113-
$ docker pull ivorysql/ivorysql:4.2-ubi8
113+
$ docker pull ivorysql/ivorysql:4.4-ubi8
114114
```
115115

116116
** Running IvorySQL
117117
```
118-
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.2-ubi8
118+
$ docker run --name ivorysql -p 5434:5432 -e IVORYSQL_PASSWORD=your_password -d ivorysql/ivorysql:4.4-ubi8
119119
```
120120

121121
** Check if the IvorySQL container is running successfully
122122
```
123123
$ docker ps | grep ivorysql
124124
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
125-
6faa2d0ed705 ivorysql:4.2-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
125+
6faa2d0ed705 ivorysql:4.4-ubi8 "docker-entrypoint.s…" 50 seconds ago Up 49 seconds 5866/tcp, 0.0.0.0:5434->5432/tcp ivorysql
126126
```
127127

128128
== Connecting to IvorySQL
129129

130130
Connect to IovrySQL via psql:
131131
```
132132
$ psql -d <database>
133-
psql (17.2)
133+
psql (17.4)
134134
Type "help" for help.
135135

136136
ivorysql=#

0 commit comments

Comments
 (0)