From ecf876a67fc6295b523592f217b573be5f858895 Mon Sep 17 00:00:00 2001 From: liyang0608 <264327807@qq.com> Date: Wed, 18 Aug 2021 17:31:07 +0800 Subject: [PATCH 1/3] fix issues --- content/en/docs/Releasenotes/Terms of Use.md | 2 +- ...74\345\205\245\346\225\260\346\215\256.md" | 126 +++++++++--------- ...74\345\205\245\346\225\260\346\215\256.md" | 2 +- ...\347\224\250\345\207\206\345\244\207-8.md" | 2 +- ...77\347\224\250\345\207\206\345\244\207.md" | 2 +- ...347\224\250\346\214\207\345\257\274-13.md" | 12 +- ...345\242\203\351\203\250\347\275\262-12.md" | 2 +- ...33\345\273\272\347\272\277\347\250\213.md" | 4 +- content/zh/docs/Toolreference/gs_guc.md | 13 +- ...11\350\243\205\347\216\257\345\242\203.md" | 2 +- 10 files changed, 84 insertions(+), 83 deletions(-) diff --git a/content/en/docs/Releasenotes/Terms of Use.md b/content/en/docs/Releasenotes/Terms of Use.md index a5ae92e35..cd322783e 100644 --- a/content/en/docs/Releasenotes/Terms of Use.md +++ b/content/en/docs/Releasenotes/Terms of Use.md @@ -13,7 +13,7 @@ Permission to use, copy, modify, and distribute this software and its documentat IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN “AS-IS” BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. +THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS-IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. **Trademarks and Permissions** diff --git "a/content/zh/docs/Developerguide/\344\275\277\347\224\250gs_restore\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" "b/content/zh/docs/Developerguide/\344\275\277\347\224\250gs_restore\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" index 982c3ea9f..b81f5e72c 100644 --- "a/content/zh/docs/Developerguide/\344\275\277\347\224\250gs_restore\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" +++ "b/content/zh/docs/Developerguide/\344\275\277\347\224\250gs_restore\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" @@ -20,7 +20,7 @@ gs\_restore工具在导入时，允许用户选择需要导入的内容，并支 ## 操作步骤 >![](public_sys-resources/icon-note.gif) **说明：** ->gs\_restore默认是以追加的方式进行数据导入。为避免多次导入造成数据异常，在进行导入时，建议选择使用"-c" 和"-e"参数。"-c"表示在重新创建数据库对象前，清理（删除）已存在于将要还原的数据库中的数据库对象；"-e"表示当发送SQL语句到数据库时如果出现错误请退出，默认状态下会继续，且在导入后会显示一系列错误信息。 +>gs\_restore默认是以追加的方式进行数据导入。为避免多次导入造成数据异常，在进行导入时，建议选择使用“-c”和“-e”参数。“-c”表示在重新创建数据库对象前，清理（删除）已存在于将要还原的数据库中的数据库对象；“-e”表示当发送SQL语句到数据库时如果出现错误请退出，默认状态下会继续，且在导入后会显示一系列错误信息。 1. 以操作系统用户omm登录数据库主节点。 2. 使用gs\_restore命令，从postgres整个数据库内容的导出文件中，将数据库的所有对象的定义导入到backupdb。 @@ -31,68 +31,68 @@ gs\_restore工具在导入时，允许用户选择需要导入的内容，并支 ``` **表 1** 常用参数说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + +

参数

-

参数说明

-

举例

-

-U

-

连接数据库的用户名。

-

-U jack

-

-W

-

指定用户连接的密码。

-
  • 如果主机的认证策略是trust，则不会对数据库管理员进行密码验证，即无需输入-W选项；
  • 如果没有-W选项，并且不是数据库管理员，会提示用户输入密码。
-

-W abcd@123

-

-d

-

连接数据库dbname，并直接将数据导入到该数据库中。

-

-d backupdb

-

-p

-

指定服务器所侦听的TCP端口或本地Unix域套接字后缀，以确保连接。

-

-p 8000

-

-e

-

当发送SQL语句到数据库时如果出现错误，则退出。默认状态下会忽略错误任务并继续执行导入，且在导入后会显示一系列错误信息。

-

-

-

-c

-

在重新创建数据库对象前，清理（删除）已存在于将要导入的数据库中的数据库对象。

-

-

-

-s

-

只导入模式定义，不导入数据。当前的序列值也不会被导入。

-

-

-
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

参数

+

参数说明

+

举例

+

-U

+

连接数据库的用户名。

+

-U jack

+

-W

+

指定用户连接的密码。

+
  • 如果主机的认证策略是trust，则不会对数据库管理员进行密码验证，即无需输入-W选项；
  • 如果没有-W选项，并且不是数据库管理员，会提示用户输入密码。
+

-W abcd@123

+

-d

+

连接数据库dbname，并直接将数据导入到该数据库中。

+

-d backupdb

+

-p

+

指定服务器所侦听的TCP端口或本地Unix域套接字后缀，以确保连接。

+

-p 8000

+

-e

+

当发送SQL语句到数据库时如果出现错误，则退出。默认状态下会忽略错误任务并继续执行导入，且在导入后会显示一系列错误信息。

+

-

+

-c

+

在重新创建数据库对象前，清理（删除）已存在于将要导入的数据库中的数据库对象。

+

-

+

-s

+

只导入模式定义，不导入数据。当前的序列值也不会被导入。

+

-

+
其他参数说明请参见《工具参考》中“服务端工具 \> gs\_restore”章节。 diff --git "a/content/zh/docs/Developerguide/\344\275\277\347\224\250gsql\345\205\203\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" "b/content/zh/docs/Developerguide/\344\275\277\347\224\250gsql\345\205\203\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" index 4c8f46729..5a9bc5a04 100644 --- "a/content/zh/docs/Developerguide/\344\275\277\347\224\250gsql\345\205\203\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" +++ "b/content/zh/docs/Developerguide/\344\275\277\347\224\250gsql\345\205\203\345\221\275\344\273\244\345\257\274\345\205\245\346\225\260\346\215\256.md" @@ -189,7 +189,7 @@ gsql工具提供了元命令\\copy进行数据导入。 从本地文件拷贝数据到目标表a。假设存在本地文件/home/omm/2.csv。 - - 分隔符为‘，’。 + - 分隔符为”，“。 - 在导入过程中，若数据源文件比外表定义的列数多，则忽略行尾多出来的列。 ``` diff --git "a/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207-8.md" "b/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207-8.md" index 8f136d7d6..9e123db80 100644 --- "a/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207-8.md" +++ "b/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207-8.md" @@ -43,7 +43,7 @@ anomaly\_detection是一个独立于数据库内核之外的工具，其结构 ## anomaly\_detection的配置文件说明 -anomaly\_detection 在运行前需要加载**a-detection.conf**和**metric\_task.conf**两个配置文件，, 可以通过 **python main.py --help** 命令查看配置文件路径： +anomaly\_detection 在运行前需要加载**a-detection.conf**和**metric\_task.conf**两个配置文件，可以通过 **python main.py --help** 命令查看配置文件路径： **a-detection.conf**：该配置文件包含agent、server、database、security、forecast、log六个section，参数解释如下： diff --git "a/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207.md" "b/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207.md" index 4d4901a73..7741c7a6b 100644 --- "a/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207.md" +++ "b/content/zh/docs/Developerguide/\344\275\277\347\224\250\345\207\206\345\244\207.md" @@ -46,7 +46,7 @@ X-Tuner的整体架构如[图1 X-Tuner 结构图](#fig137427353816)所示，系 **方法一：直接通过源代码运行** -1. 切换到xtuner的源代码目录下。对于openGauss社区代码来说，该路径在openGauss-server/src/gausskernel/dbmind/tools/xtuner. 对于已经安装的数据库系统，则该源代码路径为 **$GAUSSHOME**/bin/dbmind/xtuner. +1. 切换到xtuner的源代码目录下。对于openGauss社区代码来说，该路径在openGauss-server/src/gausskernel/dbmind/tools/xtuner。对于已经安装的数据库系统，则该源代码路径为 **$GAUSSHOME**/bin/dbmind/xtuner。 2. 在当前目录下可以看到 requirements.txt 等文件，通过pip包管理工具根据该 requirements.txt 文件安装依赖： ``` diff --git "a/content/zh/docs/Developerguide/\344\275\277\347\224\250\346\214\207\345\257\274-13.md" "b/content/zh/docs/Developerguide/\344\275\277\347\224\250\346\214\207\345\257\274-13.md" index ed5cf434d..4945b43a2 100644 --- "a/content/zh/docs/Developerguide/\344\275\277\347\224\250\346\214\207\345\257\274-13.md" +++ "b/content/zh/docs/Developerguide/\344\275\277\347\224\250\346\214\207\345\257\274-13.md" @@ -26,12 +26,12 @@ return b $$ LANGUAGE plpythonu; ``` ->![](public_sys-resources/icon-caution.gif) **注意：** ->- PL/Python函数中，后缀为plpythonu。‘u’说明是untrusted类型的存储过程。 ->- Trusted：这个语言不能访问越权的数据。例如，数据库服务器的文件、数据库内部（包括直接访问共享内存）。 ->- Untrusted：这个语言没有任何限制，允许访问任何数据（包括文件，网络，共享LIB库等，危害性较大），但是功能更加强大。 ->- PL/Python属于untrusted类型的存储过程语言，当前仅允许管理员权限的用户创建和修改，普通用户仅支持使用。 ->- 定义PL/Python存储过程时，注意不要定义执行诸如import os；os.system\("rm -rf /"\) 等危险语句。管理员权限的用户需要小心创建此类PL/Python存储过程。 +>![](public_sys-resources/icon-caution.gif) **注意：** +>- PL/Python函数中，后缀为plpythonu。‘u’说明是untrusted类型的存储过程。 +>- Trusted：这个语言不能访问越权的数据。例如，数据库服务器的文件、数据库内部（包括直接访问共享内存）。 +>- Untrusted：这个语言没有任何限制，允许访问任何数据（包括文件，网络，共享LIB库等，危害性较大），但是功能更加强大。 +>- PL/Python属于untrusted类型的存储过程语言，当前仅允许管理员权限的用户创建和修改，普通用户仅支持使用。 +>- 定义PL/Python存储过程时，注意不要定义执行诸如import os；os.system\("rm -rf /"\) 等危险语句。管理员权限的用户需要小心创建此类PL/Python存储过程。 ## 数据库Null, None和空串处理 diff --git "a/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262-12.md" "b/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262-12.md" index c4a20d76d..616ff97a8 100644 --- "a/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262-12.md" +++ "b/content/zh/docs/Developerguide/\347\216\257\345\242\203\351\203\250\347\275\262-12.md" @@ -15,7 +15,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 安装前，请查看系统安装的python版本，当前DeepSQL需要python2.7.12以上版本的环境。 - 如果当前系统python2版本高于2.7.12，可以直接安装python-devel包。 - - 如果版本过低，或者无法安装python-devel包，可以下载最新python2源码，手动配置编译python2，并配置环境变量； + - 如果版本过低，或者无法安装python-devel包，可以下载最新python2源码，手动配置编译python2，并配置环境变量。 算法库中，部分算法调用了python包，如numpy，pandas等。用户可以安装以下python库： diff --git "a/content/zh/docs/Developerguide/\351\253\230\345\271\266\345\217\221\346\212\245\351\224\231-too-many-clients-already-\346\210\226\346\227\240\346\263\225\345\210\233\345\273\272\347\272\277\347\250\213.md" "b/content/zh/docs/Developerguide/\351\253\230\345\271\266\345\217\221\346\212\245\351\224\231-too-many-clients-already-\346\210\226\346\227\240\346\263\225\345\210\233\345\273\272\347\272\277\347\250\213.md" index 92e828f6b..6049de6e8 100644 --- "a/content/zh/docs/Developerguide/\351\253\230\345\271\266\345\217\221\346\212\245\351\224\231-too-many-clients-already-\346\210\226\346\227\240\346\263\225\345\210\233\345\273\272\347\272\277\347\250\213.md" +++ "b/content/zh/docs/Developerguide/\351\253\230\345\271\266\345\217\221\346\212\245\351\224\231-too-many-clients-already-\346\210\226\346\227\240\346\263\225\345\210\233\345\273\272\347\272\277\347\250\213.md" @@ -1,8 +1,8 @@ -# 高并发报错"too many clients already"或无法创建线程 +# 高并发报错“too many clients already”或无法创建线程 ## 问题现象 -高并发执行SQL，报错"sorry, too many clients already"；或报无法创建线程、无法fork进程等错误。 +高并发执行SQL，报错“sorry, too many clients already”；或报无法创建线程、无法fork进程等错误。 ## 原因分析 diff --git a/content/zh/docs/Toolreference/gs_guc.md b/content/zh/docs/Toolreference/gs_guc.md index f4593b0d2..f4c70fc8c 100644 --- a/content/zh/docs/Toolreference/gs_guc.md +++ b/content/zh/docs/Toolreference/gs_guc.md @@ -187,12 +187,13 @@ gs\_guc工具由操作系统用户omm执行。 当参数取值为ALL时，表示设置主机中所有的实例。 -- -D +- -D - 需要执行命令的openGauss实例路径。使用encrypt命令时，此参数表示指定的密码文件生成的路径。 + 需要执行命令的openGauss实例路径。使用encrypt命令时，此参数表示指定的密码文件生成的路径。 - ![](public_sys-resources/icon-note.gif) **说明：** - - 与"-I" 不能一块使用 + ![](public_sys-resources/icon-note.gif) **说明：** + + - 与"-I" 不能一块使用 - -c parameter=value @@ -200,9 +201,9 @@ gs\_guc工具由操作系统用户omm执行。 ![](public_sys-resources/icon-note.gif) **说明：** - - 如果参数是一个字符串变量，则使用-c parameter="'value'"或者使用-c "parameter = 'value'"。 + - 如果参数是一个字符串变量，则使用-c parameter='value'或者使用-c "parameter = 'value'"。 - - 当使用gs\_guc set/reload为"log\_directory" 恢复默认值时，其默认值会被置为具体的data目录。 + - 当使用gs\_guc set/reload为"log\_directory"恢复默认值时，其默认值会被置为具体的data目录。 - 当使用gs\_guc reload进行参数设定，并指定-N参数时，当指定的节点为主节点时，主备节点的参数值都会被修改；当指定节点为备节点时，只会修改备节点的参数值，不会修改主节点的参数值。 diff --git "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" index a791cbcb3..3a5811cfd 100644 --- "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -379,7 +379,7 @@ vim /etc/ssh/sshd_config #PermitRootLogin no ``` - - 将“PermitRootLogin“改为“yes“。 + - 将PermitRootLogin改为yes。 ``` PermitRootLogin yes -- Gitee From dad46d461872ccfca84febbdd88f25039a1bcf0e Mon Sep 17 00:00:00 2001 From: liyang <264327807@qq.com> Date: Wed, 18 Aug 2021 09:37:01 +0000 Subject: [PATCH 2/3] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20cont?= =?UTF-8?q?ent/zh/docs/installation/=E5=87=86=E5=A4=87=E8=BD=AF=E7=A1=AC?= =?UTF-8?q?=E4=BB=B6=E5=AE=89=E8=A3=85=E7=8E=AF=E5=A2=83.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...11\350\243\205\347\216\257\345\242\203.md" | 416 ------------------ 1 file changed, 416 deletions(-) delete mode 100644 "content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" diff --git "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" deleted file mode 100644 index 3a5811cfd..000000000 --- "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ /dev/null @@ -1,416 +0,0 @@ -# 准备软硬件安装环境 - -本章节描述安装前需要进行的环境准备。 - - - -- [软硬件环境要求](#软硬件环境要求) -- [修改操作系统配置](#修改操作系统配置) -- [设置root用户远程登录](#设置root用户远程登录) - - - -## 软硬件环境要求 - -介绍openGauss的软硬件环境要求。建议部署openGauss的各服务器具有等价的软硬件配置。 - -### 硬件环境要求 - -[表1](#zh-cn_topic_0241802565_zh-cn_topic_0085434629_zh-cn_topic_0059782022_t62cd0eed17004265b1b8ad98f302a4bc)列出了openGauss服务器应具备的最低硬件要求。在实际产品中，硬件配置的规划需考虑数据规模及所期望的数据库响应速度。请根据实际情况进行规划。 - -**表 1** 硬件环境要求 - - - - - - - - - - - - - - - - - - - -

项目

-

配置描述

-

内存

-

功能调试建议32GB以上。

-

性能测试和商业部署时，单实例部署建议128GB以上。

-

复杂的查询对内存的需求量比较高，在高并发场景下，可能出现内存不足。此时建议使用大内存的机器，或使用负载管理限制系统的并发。

-

CPU

-

功能调试最小1×8 核 2.0GHz。

-

性能测试和商业部署时，单实例部署建议1×16核 2.0GHz。

-

CPU超线程和非超线程两种模式都支持。

说明：

目前，openGauss仅支持鲲鹏服务器和基于X86_64通用PC服务器的CPU。

-

硬盘

-

用于安装openGauss的硬盘需最少满足如下要求：

-
  • 至少1GB用于安装openGauss的应用程序。
  • 每个主机需大约300MB用于元数据存储。
  • 预留70%以上的磁盘剩余空间用于数据存储。
-

建议系统盘配置为Raid1，数据盘配置为Raid5，且规划4组Raid5数据盘用于安装openGauss。有关Raid的配置方法在本手册中不做介绍。请参考硬件厂家的手册或互联网上的方法进行配置，其中Disk Cache Policy一项需要设置为Disabled，否则机器异常掉电后有数据丢失的风险。

-

openGauss支持使用SSD盘作为数据库的主存储设备，支持SAS接口和NVME协议的SSD盘，以RAID的方式部署使用。

-

网络要求

-

300兆以上以太网。

-

建议网卡设置为双网卡冗余bond。有关网卡冗余bond的配置方法在本手册中不做介绍。请参考硬件厂商的手册或互联网上的方法进行配置。

-
- - - -### 软件环境要求 - -**表 2** 软件环境要求 - - - - - - - - - - - - - - - - - - - -

软件类型

-

配置描述

-

Linux操作系统

-
  • ARM：
    • openEuler 20.3LTS（推荐采用此操作系统）
    • 麒麟V10
    -
  • X86：
    • openEuler 20.3LTS
    • CentOS 7.6
      说明：

      建议使用英文操作系统，当前安装包只能在英文操作系统上安装使用。

      -
      -
    -
-

Linux文件系统

-

剩余inode个数 > 15亿（推荐）

-

工具

-

bzip2

-

Python

-
  • openEuler：支持Python 3.7.X
  • CentOS：支持Python 3.6.X
  • 麒麟：支持Python 3.7.X
    说明：

    python需要通过--enable-shared方式编译。

    -
    -
-
- - -### 软件依赖要求 - -openGauss的软件依赖要求如[表3 软件依赖要求](#table1212531681911)所示。 - -建议使用上述操作系统安装光盘或者源中，下列依赖软件的默认安装包，若不存在下列软件，可参看软件对应的建议版本。 - -**表 3** 软件依赖要求 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

所需软件

-

建议版本

-

libaio-devel

-

建议版本：0.3.109-13

-

flex

-

要求版本：2.5.31 以上

-

bison

-

建议版本：2.7-4

-

ncurses-devel

-

建议版本：5.9-13.20130511

-

glibc-devel

-

建议版本：2.17-111

-

patch

-

建议版本：2.7.1-10

-

redhat-lsb-core

-

建议版本：4.1

-

readline-devel

-

建议版本 ：7.0-13

-

libnsl（openeuler+x86环境中）

-

建议版本 ：2.28-36

-
- - - - -## 修改操作系统配置 - -### 关闭操作系统防火墙 - -为了在防火墙开启的状态下，确保openGauss的正常使用。用户需要将同openGauss相关的服务、协议、IP以及端口添加到openGauss各主机的防火墙白名单中。 - -以openEuler操作系统为例，假设openGauss信息如[表1 openGauss信息](#zh-cn_topic_0241802566_zh-cn_topic_0085434636_zh-cn_topic_0059782018_table4312170510523)所示。 - -**表 1** openGauss信息 - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

主机名称

-

内部IP

-

外部IP

-

plat1

-

192.168.0.11

-

10.10.0.11

-

plat2

-

192.168.0.12

-

10.10.0.12

-

plat3

-

192.168.0.13

-

10.10.0.13

-

plat4

-

192.168.0.14

-

10.10.0.14

-

管理网络

-

-

-

10.10.64.236

-
- -**操作步骤** - -目前仅支持在防火墙关闭的状态下进行安装。 - -1.修改/etc/selinux/config文件中的“SELINUX“值为“disabled“。 - -+ 使用VIM打开config文件。 - - ``` - vim /etc/selinux/config - ``` - -+ 修改“SELINUX“的值“disabled“，执行:wq保存并退出修改。 - - ``` - SELINUX=disabled - ``` - -2.重新启动操作系统。 - - reboot - -3.检查防火墙是否关闭。 - - systemctl status firewalld - -若防火墙状态显示为active \(running\)，则表示防火墙未关闭，请执行步骤4； - -若防火墙状态显示为inactive \(dead\)，则无需再关闭防火墙。 - -4.关闭防火墙并禁止开机重启。 - - - systemctl disable firewalld.service - systemctl stop firewalld.service - -5.在其他主机上重复步骤1到步骤4。 - -### 设置字符集参数 - -将各数据库节点的字符集设置为相同的字符集，可以在/etc/profile文件中添加"export LANG=XXX"（XXX为Unicode编码）。 - -``` -vim /etc/profile -``` - -### 设置时区和时间 - -将各数据库节点的时区设置为相同时区，可以将/usr/share/zoneinfo/目录下的时区文件拷贝为/etc/localtime文件。 - -``` -cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime -``` - ->![](public_sys-resources/icon-note.gif) **说明：** ->\$地区/$时区为需要设置时区的信息，例如：Asia_Shanghai。 - -使用date -s命令将各主机的时间设置为统一时间，举例如下。 - -``` -date -s "Sat Sep 27 16:00:07 CST 2020" -``` - ->![](public_sys-resources/icon-note.gif) **说明：** ->可以通过date命令查询主机时区。 - -### （可选）关闭swap交换内存 - ->![](C:/Users/gongsiyi/Desktop/test/05-openGauss 安装指南/public_sys-resources/icon-note.gif) **说明：** ->关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 - -在各数据库节点上，使用swapoff -a命令将交换内存关闭。 - -``` -swapoff -a -``` - -### 设置网卡MTU值 - -将各数据库节点的网卡MTU值设置为相同大小。对于X86，MTU值推荐1500；对于ARM，MTU值推荐8192。 - -``` -ifconfig 网卡编号 mtu 值 -``` - -### 关闭RemoveIPC - -在各数据库节点上，关闭RemoveIPC。CentOS操作系统无该参数，可以跳过该步骤。 - -**操作步骤** - -1.修改/etc/systemd/logind.conf文件中的“RemoveIPC”值为“no”。 - -+ 使用VIM打开logind.conf文件。 - -``` -vim /etc/systemd/logind.conf -``` - -+ 修改“RemoveIPC”值为“no”。 - -``` -RemoveIPC=no -``` - -2.修改/usr/lib/systemd/system/systemd-logind.service文件中的“RemoveIPC”值为“no”。 - -+ 使用VIM打开systemd-logind.service文件。 - -``` -vim /usr/lib/systemd/system/systemd-logind.service -``` - -+ 修改“RemoveIPC”值为“no”。 - -``` -RemoveIPC=no -``` - -3.重新加载配置参数。 - -``` -systemctl daemon-reload -systemctl restart systemd-logind -``` - -4.检查修改是否生效。 - -``` -loginctl show-session | grep RemoveIPC -systemctl show systemd-logind | grep RemoveIPC -``` - -5.在其他主机上重复步骤1到步骤4。 - -## 设置root用户远程登录 - -在openGauss安装时需要root帐户远程登录访问权限，本章介绍如何设置使用root用户远程登录。 - -1.修改PermitRootLogin配置，允许用户远程登录。 - -+ 打开sshd\_config文件。 - -``` -vim /etc/ssh/sshd_config -``` - -+ 修改权限配置，可以使用以下两种方式实现： - - 注释掉“PermitRootLogin no”。 - - ``` - #PermitRootLogin no - ``` - - - 将PermitRootLogin改为yes。 - - ``` - PermitRootLogin yes - ``` - -+ 执行**:wq**保存并退出编辑页面。 - -2.修改Banner配置，去掉连接到系统时，系统提示的欢迎信息。欢迎信息会干扰安装时远程操作的返回结果，影响安装正常执行。 - -+ 编辑sshd\_config文件。 - -``` -vim /etc/ssh/sshd_config -``` - -+ 修改Banner配置，注释掉“Banner”所在的行。 - -``` -#Banner XXXX -``` - -+ 执行**:wq**保存并退出编辑页面。 - -3.使用如下命令使设置生效。 - - systemctl restart sshd.service - -4.以root用户身份重新登录。 - - ssh xxx.xxx.xxx.xxx - - >![](public_sys-resources/icon-note.gif) **说明：** - - >xxx.xxx.xxx.xxx为安装openGauss环境的IP地址。 -- Gitee From c07cec13398d7cceefddb2f01a0c49e8f3b5d004 Mon Sep 17 00:00:00 2001 From: liyang0608 <554903772@qq.com> Date: Wed, 18 Aug 2021 18:58:58 +0800 Subject: [PATCH 3/3] =?UTF-8?q?Revert=20"=E5=88=A0=E9=99=A4=E6=96=87?= =?UTF-8?q?=E4=BB=B6=20content/zh/docs/installation/=E5=87=86=E5=A4=87?= =?UTF-8?q?=E8=BD=AF=E7=A1=AC=E4=BB=B6=E5=AE=89=E8=A3=85=E7=8E=AF=E5=A2=83?= =?UTF-8?q?.md"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit dad46d461872ccfca84febbdd88f25039a1bcf0e. --- ...11\350\243\205\347\216\257\345\242\203.md" | 416 ++++++++++++++++++ 1 file changed, 416 insertions(+) create mode 100644 "content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" diff --git "a/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" new file mode 100644 index 000000000..3a5811cfd --- /dev/null +++ "b/content/zh/docs/installation/\345\207\206\345\244\207\350\275\257\347\241\254\344\273\266\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -0,0 +1,416 @@ +# 准备软硬件安装环境 + +本章节描述安装前需要进行的环境准备。 + + + +- [软硬件环境要求](#软硬件环境要求) +- [修改操作系统配置](#修改操作系统配置) +- [设置root用户远程登录](#设置root用户远程登录) + + + +## 软硬件环境要求 + +介绍openGauss的软硬件环境要求。建议部署openGauss的各服务器具有等价的软硬件配置。 + +### 硬件环境要求 + +[表1](#zh-cn_topic_0241802565_zh-cn_topic_0085434629_zh-cn_topic_0059782022_t62cd0eed17004265b1b8ad98f302a4bc)列出了openGauss服务器应具备的最低硬件要求。在实际产品中，硬件配置的规划需考虑数据规模及所期望的数据库响应速度。请根据实际情况进行规划。 + +**表 1** 硬件环境要求 + + + + + + + + + + + + + + + + + + + +

项目

+

配置描述

+

内存

+

功能调试建议32GB以上。

+

性能测试和商业部署时，单实例部署建议128GB以上。

+

复杂的查询对内存的需求量比较高，在高并发场景下，可能出现内存不足。此时建议使用大内存的机器，或使用负载管理限制系统的并发。

+

CPU

+

功能调试最小1×8 核 2.0GHz。

+

性能测试和商业部署时，单实例部署建议1×16核 2.0GHz。

+

CPU超线程和非超线程两种模式都支持。

说明：

目前，openGauss仅支持鲲鹏服务器和基于X86_64通用PC服务器的CPU。

+

硬盘

+

用于安装openGauss的硬盘需最少满足如下要求：

+
  • 至少1GB用于安装openGauss的应用程序。
  • 每个主机需大约300MB用于元数据存储。
  • 预留70%以上的磁盘剩余空间用于数据存储。
+

建议系统盘配置为Raid1，数据盘配置为Raid5，且规划4组Raid5数据盘用于安装openGauss。有关Raid的配置方法在本手册中不做介绍。请参考硬件厂家的手册或互联网上的方法进行配置，其中Disk Cache Policy一项需要设置为Disabled，否则机器异常掉电后有数据丢失的风险。

+

openGauss支持使用SSD盘作为数据库的主存储设备，支持SAS接口和NVME协议的SSD盘，以RAID的方式部署使用。

+

网络要求

+

300兆以上以太网。

+

建议网卡设置为双网卡冗余bond。有关网卡冗余bond的配置方法在本手册中不做介绍。请参考硬件厂商的手册或互联网上的方法进行配置。

+
+ + + +### 软件环境要求 + +**表 2** 软件环境要求 + + + + + + + + + + + + + + + + + + + +

软件类型

+

配置描述

+

Linux操作系统

+
  • ARM：
    • openEuler 20.3LTS（推荐采用此操作系统）
    • 麒麟V10
    +
  • X86：
    • openEuler 20.3LTS
    • CentOS 7.6
      说明：

      建议使用英文操作系统，当前安装包只能在英文操作系统上安装使用。

      +
      +
    +
+

Linux文件系统

+

剩余inode个数 > 15亿（推荐）

+

工具

+

bzip2

+

Python

+
  • openEuler：支持Python 3.7.X
  • CentOS：支持Python 3.6.X
  • 麒麟：支持Python 3.7.X
    说明：

    python需要通过--enable-shared方式编译。

    +
    +
+
+ + +### 软件依赖要求 + +openGauss的软件依赖要求如[表3 软件依赖要求](#table1212531681911)所示。 + +建议使用上述操作系统安装光盘或者源中，下列依赖软件的默认安装包，若不存在下列软件，可参看软件对应的建议版本。 + +**表 3** 软件依赖要求 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

所需软件

+

建议版本

+

libaio-devel

+

建议版本：0.3.109-13

+

flex

+

要求版本：2.5.31 以上

+

bison

+

建议版本：2.7-4

+

ncurses-devel

+

建议版本：5.9-13.20130511

+

glibc-devel

+

建议版本：2.17-111

+

patch

+

建议版本：2.7.1-10

+

redhat-lsb-core

+

建议版本：4.1

+

readline-devel

+

建议版本 ：7.0-13

+

libnsl（openeuler+x86环境中）

+

建议版本 ：2.28-36

+
+ + + + +## 修改操作系统配置 + +### 关闭操作系统防火墙 + +为了在防火墙开启的状态下，确保openGauss的正常使用。用户需要将同openGauss相关的服务、协议、IP以及端口添加到openGauss各主机的防火墙白名单中。 + +以openEuler操作系统为例，假设openGauss信息如[表1 openGauss信息](#zh-cn_topic_0241802566_zh-cn_topic_0085434636_zh-cn_topic_0059782018_table4312170510523)所示。 + +**表 1** openGauss信息 + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

主机名称

+

内部IP

+

外部IP

+

plat1

+

192.168.0.11

+

10.10.0.11

+

plat2

+

192.168.0.12

+

10.10.0.12

+

plat3

+

192.168.0.13

+

10.10.0.13

+

plat4

+

192.168.0.14

+

10.10.0.14

+

管理网络

+

-

+

10.10.64.236

+
+ +**操作步骤** + +目前仅支持在防火墙关闭的状态下进行安装。 + +1.修改/etc/selinux/config文件中的“SELINUX“值为“disabled“。 + ++ 使用VIM打开config文件。 + + ``` + vim /etc/selinux/config + ``` + ++ 修改“SELINUX“的值“disabled“，执行:wq保存并退出修改。 + + ``` + SELINUX=disabled + ``` + +2.重新启动操作系统。 + + reboot + +3.检查防火墙是否关闭。 + + systemctl status firewalld + +若防火墙状态显示为active \(running\)，则表示防火墙未关闭，请执行步骤4； + +若防火墙状态显示为inactive \(dead\)，则无需再关闭防火墙。 + +4.关闭防火墙并禁止开机重启。 + + + systemctl disable firewalld.service + systemctl stop firewalld.service + +5.在其他主机上重复步骤1到步骤4。 + +### 设置字符集参数 + +将各数据库节点的字符集设置为相同的字符集，可以在/etc/profile文件中添加"export LANG=XXX"（XXX为Unicode编码）。 + +``` +vim /etc/profile +``` + +### 设置时区和时间 + +将各数据库节点的时区设置为相同时区，可以将/usr/share/zoneinfo/目录下的时区文件拷贝为/etc/localtime文件。 + +``` +cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime +``` + +>![](public_sys-resources/icon-note.gif) **说明：** +>\$地区/$时区为需要设置时区的信息，例如：Asia_Shanghai。 + +使用date -s命令将各主机的时间设置为统一时间，举例如下。 + +``` +date -s "Sat Sep 27 16:00:07 CST 2020" +``` + +>![](public_sys-resources/icon-note.gif) **说明：** +>可以通过date命令查询主机时区。 + +### （可选）关闭swap交换内存 + +>![](C:/Users/gongsiyi/Desktop/test/05-openGauss 安装指南/public_sys-resources/icon-note.gif) **说明：** +>关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 + +在各数据库节点上，使用swapoff -a命令将交换内存关闭。 + +``` +swapoff -a +``` + +### 设置网卡MTU值 + +将各数据库节点的网卡MTU值设置为相同大小。对于X86，MTU值推荐1500；对于ARM，MTU值推荐8192。 + +``` +ifconfig 网卡编号 mtu 值 +``` + +### 关闭RemoveIPC + +在各数据库节点上，关闭RemoveIPC。CentOS操作系统无该参数，可以跳过该步骤。 + +**操作步骤** + +1.修改/etc/systemd/logind.conf文件中的“RemoveIPC”值为“no”。 + ++ 使用VIM打开logind.conf文件。 + +``` +vim /etc/systemd/logind.conf +``` + ++ 修改“RemoveIPC”值为“no”。 + +``` +RemoveIPC=no +``` + +2.修改/usr/lib/systemd/system/systemd-logind.service文件中的“RemoveIPC”值为“no”。 + ++ 使用VIM打开systemd-logind.service文件。 + +``` +vim /usr/lib/systemd/system/systemd-logind.service +``` + ++ 修改“RemoveIPC”值为“no”。 + +``` +RemoveIPC=no +``` + +3.重新加载配置参数。 + +``` +systemctl daemon-reload +systemctl restart systemd-logind +``` + +4.检查修改是否生效。 + +``` +loginctl show-session | grep RemoveIPC +systemctl show systemd-logind | grep RemoveIPC +``` + +5.在其他主机上重复步骤1到步骤4。 + +## 设置root用户远程登录 + +在openGauss安装时需要root帐户远程登录访问权限，本章介绍如何设置使用root用户远程登录。 + +1.修改PermitRootLogin配置，允许用户远程登录。 + ++ 打开sshd\_config文件。 + +``` +vim /etc/ssh/sshd_config +``` + ++ 修改权限配置，可以使用以下两种方式实现： + - 注释掉“PermitRootLogin no”。 + + ``` + #PermitRootLogin no + ``` + + - 将PermitRootLogin改为yes。 + + ``` + PermitRootLogin yes + ``` + ++ 执行**:wq**保存并退出编辑页面。 + +2.修改Banner配置，去掉连接到系统时，系统提示的欢迎信息。欢迎信息会干扰安装时远程操作的返回结果，影响安装正常执行。 + ++ 编辑sshd\_config文件。 + +``` +vim /etc/ssh/sshd_config +``` + ++ 修改Banner配置，注释掉“Banner”所在的行。 + +``` +#Banner XXXX +``` + ++ 执行**:wq**保存并退出编辑页面。 + +3.使用如下命令使设置生效。 + + systemctl restart sshd.service + +4.以root用户身份重新登录。 + + ssh xxx.xxx.xxx.xxx + + >![](public_sys-resources/icon-note.gif) **说明：** + + >xxx.xxx.xxx.xxx为安装openGauss环境的IP地址。 -- Gitee