From 4f37cad26c26fa7ae943bef645fcf25456773a25 Mon Sep 17 00:00:00 2001 From: liuheng Date: Wed, 20 Dec 2023 11:09:15 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E4=B8=80=E7=AB=99=E5=BC=8F=E5=AE=89?= =?UTF-8?q?=E8=A3=85=E6=8C=87=E5=8D=97=E8=B5=84=E6=96=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...11\350\243\205\346\214\207\345\215\227.md" | 150 ++++++++++++++++++ .../ToolandCommandReference/gs_preinstall.md | 4 + content/zh/menu/index.md | 1 + 3 files changed, 155 insertions(+) create mode 100644 "content/zh/docs/InstallationGuide/\344\270\200\347\253\231\345\274\217\345\256\211\350\243\205\346\214\207\345\215\227.md" diff --git "a/content/zh/docs/InstallationGuide/\344\270\200\347\253\231\345\274\217\345\256\211\350\243\205\346\214\207\345\215\227.md" "b/content/zh/docs/InstallationGuide/\344\270\200\347\253\231\345\274\217\345\256\211\350\243\205\346\214\207\345\215\227.md" new file mode 100644 index 000000000..17176d390 --- /dev/null +++ "b/content/zh/docs/InstallationGuide/\344\270\200\347\253\231\345\274\217\345\256\211\350\243\205\346\214\207\345\215\227.md" @@ -0,0 +1,150 @@ +# 一站式安装指南 + +本章详细介绍openGauss的一站式安装，通过交互式方便用户快速配置xml文件，大大减少用户安装数据库的时间。 +如果使用一站式安装，那么就可以直接跳过创建xml配置文件和初始化安装安装。 + +## 前提条件： + +- 所有服务器操作系统和网络均正常运行 +- 用户必须有数据库包解压路径、安装路径的读、写和执行操作权限，并且安装路径必须为空。 +- 用户对下载的openGauss压缩包有执行权限。 +- 如果使用中文界面来安装，需要检查当前本地字符集是否支持中文(如:zh_CN.UTF-8) + +## 操作步骤 +1. 使用root或普通用户，下载软件包并解压，到script目录下，执行 + +``` +./gs_preinstall -U omm -G dbgroup --one-stop-install --sep-env-file=ENVFILE +``` + +其中--sep-env-file是环境分离时使用，如果不使用环境分离，可以去掉该参数。 + +2. 执行后，首先程序会根据本地的默认字符集，程序根据配置的语言设置会显示对应语言的导航栏，用户在导航栏选择使用哪种语言来进行下面的安装(支持:中文，英文) + +可以通过如下命令来查看本地操作系统的语言设置: + +``` +echo $LANG +``` + +如果系统显示值包含"en_US"，则导航栏为英文 + +``` +Please choose whether to generate an XML file with one click navigation in English or Chinese? +>> 1) chinese + 2) english +``` + +如果系统显示值包含"zh_CN"，则为中文语言，导航栏会显示中文内容。否则，您可以执行如下命令修改语言设置为中文： + +``` +export LANG=zh_CN.UTF-8 +``` + +``` +请选择是英文还是中文导航一键式生成xml文件? +>> 1) 中文 + 2) 英文 +``` + +3. 请输入xml的路径和文件名(默认:./cluster.xml) + +用户输入的xml文件路径如果存在，会对判断该输入是否有非法字符，是否是文件，当前用户是否有权限；如果输入xml文件路径不存在，那么不会判断；默认会在script/base_utils/template/cluster.xml目录下生成一个cluster.xml文件。 + +4. 请输入数据库安装目录(默认:/opt/openGauss/install) + +用户输入的数据库安装目录如果存在，会判断该目录是否有非法字符，是否是一个空目录，当前用户是否有权限操作；如果目录不存在，那么不会判断。 + +5. 请输入数据库端口(默认:15000) + +数据库端口在0-65535之间，并且输入必须是数字。 + +6. 请选择是否主备部署 + +用户可以选在主备部署或单机部署，如果单机部署默认会将本地ip和hostname写入xml中，后面的流程跳过；如果主备部署继续后面的流程。 + +7. 请选择是否部署资源池化 + +用户选择部署或不部署资源池化，如果部署，默认会部署CM；如果不部署，继续后面的流程 + +8. 请选择是否部署CM + +用户选择部署CM或不部署CM + +9. 请输入cmserver端口(默认:15400) + +用户输入的端口在0-65535之间，必须是数字，不能和上面配置的数据库的端口重复 + +10. 请输入节点数量,最多支持一主八备,即9个节点(默认是一主两备,3个节点) + +用户输入节点数量在1-9之间，必须是数字 + +11. 请输入主机节点IP和节点名称(如:192.168.0.1 hostname1;192.168.0.2 hostname2) + +用户输入的节点ip和名称，首先数量必须一致，ip和hostname之间用空格分隔，每一组ip hostname之间用分号分隔；其次输入的ip不能重复。 + +12. 生成的xml路径是: /xxx/script/base_utils/template/cluster.xml + +默认生成的xml路径在script/base_utils/template/cluster.xml + +13. xml的内容 +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +14. 请确认xml的内容是否正确,正确输入yes;如需修改xml内容请自行修改,然后输入yes确认 + +生成的xml先让用户确认下是否正确，如果正确输入y或yes继续后面的流程；如果不正确，请用户重新开个窗口直接修改生成的xml，修改完毕，回到当前窗口，输入y或yes继续下面的流程。 \ No newline at end of file diff --git a/content/zh/docs/ToolandCommandReference/gs_preinstall.md b/content/zh/docs/ToolandCommandReference/gs_preinstall.md index c94924bc4..0839b80d6 100644 --- a/content/zh/docs/ToolandCommandReference/gs_preinstall.md +++ b/content/zh/docs/ToolandCommandReference/gs_preinstall.md @@ -100,6 +100,10 @@ openGauss提供了gs\_preinstall工具来帮助完成openGauss的环境配置， 是否使用om提供的三方库。默认使用，如果指定该参数则不使用。 +- --one-stop-install + + 一站式安装数据库。默认不使用，如果指定该参数，表示通过命令行交互式进行预安装。 + - -l 指定日志文件名及路径。在内部会自动给日志名添加一个时间戳。 diff --git a/content/zh/menu/index.md b/content/zh/menu/index.md index b8528b7de..eff694e1d 100644 --- a/content/zh/menu/index.md +++ b/content/zh/menu/index.md @@ -190,6 +190,7 @@ headless: true - [准备软硬件安装环境]({{< relref "./docs/InstallationGuide/准备软硬件安装环境_企业版.md" >}}) - [了解安装用户及用户组]({{< relref "./docs/InstallationGuide/了解安装用户及用户组.md" >}}) - [安装openGauss]({{< relref "./docs/InstallationGuide/安装openGauss.md" >}}) + - [一站式安装指南]({{< relref "./docs/InstallationGuide/一站式安装指南.md" >}}) - [创建XML配置文件]({{< relref "./docs/InstallationGuide/创建XML配置文件.md" >}}) - [初始化安装环境]({{< relref "./docs/InstallationGuide/初始化安装环境.md" >}}) - [执行安装]({{< relref "./docs/InstallationGuide/执行安装.md" >}}) -- Gitee From 9837ee66da6324a102701355f4c1c3f67c8e6cc7 Mon Sep 17 00:00:00 2001 From: liuheng Date: Wed, 3 Jan 2024 17:07:35 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E5=8E=BB=E9=99=A4root=E6=9D=83=E9=99=90?= =?UTF-8?q?=E8=B5=84=E6=96=99?= 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" | 35 +++++++------- ...15\346\217\220\346\223\215\344\275\234.md" | 47 +++++++++++++++++++ .../docs/ToolandCommandReference/gs_check.md | 4 +- .../ToolandCommandReference/gs_checkos.md | 12 +++-- .../ToolandCommandReference/gs_expansion.md | 4 +- .../ToolandCommandReference/gs_install.md | 10 ++-- .../ToolandCommandReference/gs_preinstall.md | 12 ++--- 7 files changed, 88 insertions(+), 36 deletions(-) create mode 100644 "content/zh/docs/InstallationGuide/\345\211\215\346\217\220\346\223\215\344\275\234.md" diff --git "a/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" "b/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" index 1357b2c53..37883e864 100644 --- "a/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" +++ "b/content/zh/docs/InstallationGuide/\345\210\235\345\247\213\345\214\226\345\256\211\350\243\205\347\216\257\345\242\203.md" @@ -10,9 +10,9 @@ ## 准备安装用户及环境 -创建完openGauss配置文件后，在执行安装前，为了后续能以最小权限进行安装及openGauss管理操作，保证系统安全性，需要运行安装前置脚本gs\_preinstall准备好安装用户及环境。 +创建完openGauss配置文件后，在执行安装前，为了后续能以最小权限进行安装及openGauss管理操作，保证系统安全性，需要运行安装前置脚本gs_preinstall准备好安装用户及环境。 -安装前置脚本gs\_preinstall可以协助用户自动完成如下的安装环境准备工作： +安装前置脚本gs_preinstall可以协助用户自动完成如下的安装环境准备工作： - 自动设置Linux内核参数以达到提高服务器负载能力的目的。这些参数直接影响数据库系统的运行状态，请仅在确认必要时调整。openGauss所设置的Linux内核参数取值请参见[配置操作系统参数](#配置操作系统参数)。 - 自动将openGauss配置文件、安装包拷贝到openGauss主机的相同目录下。 @@ -21,17 +21,18 @@ ### 前提条件 -- 已完成[安装准备](安装准备.md)的所有任务。 +- 已完成[安装准备](安装准备_企业版.md)的所有任务。 +- 如果是普通用户执行前置脚本gs_preinstall，需要完成[前提操作](前提操作.md)。 ### 注意事项 - 用户需要检查上层目录权限，保证安装用户对安装包和配置文件目录读写执行的权限。 - xml文件中各主机的名称与IP映射配置正确。 -- 只能使用root用户执行gs\_preinstall命令。 +- 使用root或普通用户执行gs_preinstall命令。 ### 操作步骤 -1. 以root用户登录待安装openGauss的任意主机，并按规划创建存放安装包的目录。 +1. 以root或普通用户登录待安装openGauss的任意主机，并按规划创建存放安装包的目录。 ``` mkdir -p /opt/software/openGauss @@ -44,9 +45,9 @@ chmod 755 -R /opt/software > >- openGauss用户须具有/opt/software/openGauss目录的读写权限。 -2.将安装包“openGauss-x.x.x-openEuler-64bit-all.tar.gz”和配置文件“cluster\_config.xml”都上传至上一步所创建的目录中。 +2.将安装包“openGauss-x.x.x-openEuler-64bit-all.tar.gz”和配置文件“cluster_config.xml”都上传至上一步所创建的目录中。 -3.在安装包所在的目录下，解压安装包openGauss-x.x.x-openEuler-64bit-all.tar.gz。安装包解压后，会有OM安装包和Server安装包。继续解压OM安装包，会在/opt/software/openGauss路径下自动生成script子目录，并且在script目录下生成gs\_preinstall等各种OM工具脚本。 +3.在安装包所在的目录下，解压安装包openGauss-x.x.x-openEuler-64bit-all.tar.gz。安装包解压后，会有OM安装包和Server安装包。继续解压OM安装包，会在/opt/software/openGauss路径下自动生成script子目录，并且在script目录下生成gs_preinstall等各种OM工具脚本。 ``` cd /opt/software/openGauss @@ -56,9 +57,9 @@ tar -zxvf openGauss-x.x.x-openEuler-64bit-om.tar.gz >![](public_sys-resources/icon-note.png) **说明：** > ->- 在执行前置脚本gs\_preinstall时，需要规划好openGauss配置文件路径、安装包存放路径、程序安装目录、实例数据目录，后续普通用户使用过程中不能再更改这些路径。 +>- 在执行前置脚本gs_preinstall时，需要规划好openGauss配置文件路径、安装包存放路径、程序安装目录、实例数据目录，后续普通用户使用过程中不能再更改这些路径。 > ->- 运行前置脚本gs\_preinstall准备安装环境时，脚本内部会自动将openGauss配置文件、解压后的安装包同步拷贝到其余服务器的相同目录下。 +>- 运行前置脚本gs_preinstall准备安装环境时，脚本内部会自动将openGauss配置文件、解压后的安装包同步拷贝到其余服务器的相同目录下。 > >- 在执行前置脚本或者互信前，请检查/etc/profile文件中是否包含错误输出信息，如果存在错误输出，需手动处理。 @@ -68,7 +69,7 @@ tar -zxvf openGauss-x.x.x-openEuler-64bit-om.tar.gz cd /opt/software/openGauss/script ``` -5.如果是openEuler的操作系统（openEuler 20.03），执行如下命令打开performance.sh文件，用\#注释sysctl -w vm.min\_free\_kbytes=112640 &\> /dev/null，键入“ESC”键进入指令模式，执行 **:wq** 保存并退出修改。 +5.如果是openEuler的操作系统（openEuler 20.03），执行如下命令打开performance.sh文件，用#注释sysctl -w vm.min_free\kbytes=112640 &> /dev/null，键入“ESC”键进入指令模式，执行 **:wq** 保存并退出修改。 ``` vi /etc/profile.d/performance.sh @@ -76,15 +77,15 @@ vi /etc/profile.d/performance.sh 6.为确保成功安装，检查hostname与/etc/hostname是否一致。预安装过程中，会对hostname进行检查。 -7.使用gs\_preinstall准备好安装环境。若为共用环境需加入\-\-sep-env-file=ENVFILE参数分离环境变量，避免与其他用户相互影响，ENVFILE为用户自行指定的环境变量分离文件的路径，可以为一个空文件。 +7.使用gs_preinstall准备好安装环境。若为共用环境需加入--sep-env-file=ENVFILE参数分离环境变量，避免与其他用户相互影响，ENVFILE为用户自行指定的环境变量分离文件的路径，可以为一个空文件。 - 采用交互模式执行前置，并在执行过程中自动创建操作系统root用户互信和omm用户互信： ``` ./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml ``` -omm为数据库管理员（也是运行openGauss的操作系统用户），dbgrp为运行openGauss的操作系统用户的群组名称，/opt/software/openGauss/cluster\_config.xml为openGauss配置文件路径。在执行过程中，用户根据提示选择是否创建互信，并输入操作系统root用户或omm用户的密码。 +omm为数据库管理员（也是运行openGauss的操作系统用户），dbgrp为运行openGauss的操作系统用户的群组名称，/opt/software/openGauss/cluster_config.xml为openGauss配置文件路径。在执行过程中，用户根据提示选择是否创建互信，并输入操作系统root用户或omm用户的密码。 -- 允许创建root用户互信时，预安装脚本在执行的时候会将各个主机的ip,hostname写入到/etc/hosts中，并在每个映射关系后边加入注释内容：\#Gauss OM IP Hosts Mapping。 +- 允许创建root用户互信时，预安装脚本在执行的时候会将各个主机的ip,hostname写入到/etc/hosts中，并在每个映射关系后边加入注释内容：#Gauss OM IP Hosts Mapping。 - 不允许创建root用户互信时，此时需要用户手动先建立互信（也就是将各个主机的ip，hostname写入到/etc/hosts中），然后执行预安装脚本 a.执行下面命令准备安装环境。 @@ -324,7 +325,7 @@ PreInstallationGuide succeeded. ### 错误排查 -如果准备安装环境失败请根据openGauss日志目录“$GAUSSLOG/om”下的“gs\_preinstall-YYYY-MM-DD\_HHMMSS.log”和“gs\_local-YYYY-MM-DD\_HHMMSS.log”中的日志信息排查错误。例如配置文件中“gaussdbLogPath”参数指定的路径为“/var/log/gaussdb”，则“$GAUSSLOG/om”路径为“/var/log/gaussdb/omm/om”，omm用户为运行openGauss的用户。 +如果准备安装环境失败请根据openGauss日志目录“$GAUSSLOG/om”下的“gs_preinstall-YYYY-MM-DD_HHMMSS.log”和“gs_local-YYYY-MM-DD_HHMMSS.log”中的日志信息排查错误。例如配置文件中“gaussdbLogPath”参数指定的路径为“/var/log/gaussdb”，则“$GAUSSLOG/om”路径为“/var/log/gaussdb/omm/om”，omm用户为运行openGauss的用户。 ![](public_sys-resources/icon-notice.png) **须知：** @@ -345,7 +346,7 @@ root用户互信可能会存在安全隐患，因此建议用户在使用完成 - 确保xml文件中各主机名称和IP配置正确。 - 确保所有机器节点间网络畅通。 - 如果为普通用户建立互信，需要提前在各主机创建相同用户并设置密码。 -- 如果各主机安装并启动了SELinux服务，需要确保/root和/home目录安全上下文为默认值（home目录：system\_u:object\_r:home\_root\_t:s0，root目录：system\_u:object\_r:admin\_home\_t:s0）或者关闭掉SELinux服务。 +- 如果各主机安装并启动了SELinux服务，需要确保/root和/home目录安全上下文为默认值（home目录：system_u:object_r:home_root_t:s0，root目录：system_u:object_r:admin_home_t:s0）或者关闭掉SELinux服务。 检查系统SELinux状态的方法：执行命令getenforce，如果返回结果是Enforcing，说明SELinux安装并启用。 @@ -393,11 +394,11 @@ plat1:/opt/software/openGauss/script# ./gs_sshexkey -f /opt/software/hostfile ### 手工建立互信 -如果openGauss各主机的root密码不一致，gs\_preinstall脚本无法建立互信，可以手工建立互信。 +如果openGauss各主机的root密码不一致，gs_preinstall脚本无法建立互信，可以手工建立互信。 >![](public_sys-resources/icon-note.png) **说明：** > ->建立互信的过程中需要生成如下4个文件：authorized\_keys、id\_rsa、id\_rsa.pub、known\_hosts。请勿删除或破坏这些互信相关的文件。 +>建立互信的过程中需要生成如下4个文件：authorized_keys、id_rsa、id_rsa.pub、known_hosts。请勿删除或破坏这些互信相关的文件。 > 手工建立信任关系，步骤如下，plat1、plat2、plat3是主机名： diff --git "a/content/zh/docs/InstallationGuide/\345\211\215\346\217\220\346\223\215\344\275\234.md" "b/content/zh/docs/InstallationGuide/\345\211\215\346\217\220\346\223\215\344\275\234.md" new file mode 100644 index 000000000..98fd46a16 --- /dev/null +++ "b/content/zh/docs/InstallationGuide/\345\211\215\346\217\220\346\223\215\344\275\234.md" @@ -0,0 +1,47 @@ +# 前提操作 + +本章详细介绍openGauss企业版安装过程中使用普通用户执行预安装，需要用户提前做的一些操作，下面的操作均需要root权限来操作。如果已完成本章节的配置，请忽略。 + +- 将映射关系写入到/etc/hosts，可以使用gs_sshexkey工具来执行(可以参考gs_sshexkey用法) + + ``` + gs_sshexkey -f host + ``` + +- 设置os参数 + + ``` + 内核信号量参数设置大小，需要设置 + kernel.sem="250 6400000 1000 25600" + + 将这个参数写入到/etc/sysctl.conf + echo 'kernel.sem="250 6400000 1000 25600"' >> /etc/sysctl.conf + sysctl -p 生效 + ``` + +- 普通用户需要具有定时任务的权限 + + ```shell + echo "xxx" >> /etc/cron.allow + + 重启定时服务 + systemctl restart crond + ``` + +- 修改/etc/security/limits.d/*.conf中，最大文件描述符的数量 + + 查询/etc/security/limits.d/路径下后缀是nofile.conf的文件，将所有的文件里面的内容加上下面的内容 + + ```shell + # 建议值是1百万 + xx soft nofile 1000000 + xx hard nofile 1000000 + + find /etc/security/limits.d/ -type f -name "*.conf" -exec sh -c 'echo "xx soft nofile 1000000" >> {}' \; + find /etc/security/limits.d/ -type f -name "*.conf" -exec sh -c 'echo "xx hard nofile 1000000" >> {}' \; + + xx代表:当前普通用户 + + # 查询 + ulimit -n + ``` \ No newline at end of file diff --git a/content/zh/docs/ToolandCommandReference/gs_check.md b/content/zh/docs/ToolandCommandReference/gs_check.md index 2e6004257..a33acd494 100644 --- a/content/zh/docs/ToolandCommandReference/gs_check.md +++ b/content/zh/docs/ToolandCommandReference/gs_check.md @@ -1,8 +1,8 @@ -# gs\_check +# gs_check ## 背景信息 -gs\_check改进增强，统一化当前系统中存在的各种检查工具，例如[gs\_check](gs_check.md)、[gs\_checkos](gs_checkos.md)等，帮助用户在openGauss运行过程中，全量的检查openGauss运行环境、操作系统环境、网络环境及数据库执行环境，也有助于在openGauss重大操作之前对各类环境进行全面检查，有效保证操作执行成功。 +gs_check改进增强，统一化当前系统中存在的各种检查工具，例如[gs_check](gs_check.md)、[gs_checkos](gs_checkos.md)等，帮助用户在openGauss运行过程中，全量的检查openGauss运行环境、操作系统环境、网络环境及数据库执行环境，也有助于在openGauss重大操作之前对各类环境进行全面检查，有效保证操作执行成功。 ## 注意事项 diff --git a/content/zh/docs/ToolandCommandReference/gs_checkos.md b/content/zh/docs/ToolandCommandReference/gs_checkos.md index ad4e0c03b..3b8cb578f 100644 --- a/content/zh/docs/ToolandCommandReference/gs_checkos.md +++ b/content/zh/docs/ToolandCommandReference/gs_checkos.md @@ -1,8 +1,8 @@ -# gs\_checkos +# gs_checkos ## 背景信息 -gs\_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等内容，并对系统控制参数、I/O配置、网络配置和THP服务等信息进行配置。 +gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等内容，并对系统控制参数、I/O配置、网络配置和THP服务等信息进行配置。 ## 前提条件 @@ -10,7 +10,9 @@ gs\_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 - 各主机间root互信状态正常。 -- 只能使用root用户执行gs\_checkos命令。 +- 使用root或普通用户执行gs_checkos命令。 + +- 使用普通用户执行gs_checkos命令时，只会校验参数，不会设置参数。 ![](public_sys-resources/icon-note.png) **说明：** @@ -86,7 +88,7 @@ gs\_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 指定日志文件及存放路径。 - 默认值：/tmp/gs\_checkos/gs\_checkos-YYYY-MM-DD\_hhmmss.log。 + 默认值：/tmp/gs_checkos/gs_checkos-YYYY-MM-DD_hhmmss.log。 - -?, --help @@ -286,6 +288,8 @@ gs\_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 > - A11选项检查万兆网卡参数“MTU”、“RX”、“TX”标准来自配置文件check\_list.conf下\[/sbin/ifconfig\]域，可以使用B5参数对RX、TX进行设置，MTU需用户手动设置。 > > - 使用gs\_checkos设置的内核参数值和文件句柄参数值，需重启新会话生效。 +> +> - 如果使用普通用户执行，那么A9，A10，A11这几项不会校验，当然了普通用户也不会设置这几项；如果想设置的话，一是用root用户执行之前的流程来设置，二是可以用root用户单独执行这几个的设置 ## 操作系统参数 diff --git a/content/zh/docs/ToolandCommandReference/gs_expansion.md b/content/zh/docs/ToolandCommandReference/gs_expansion.md index d6372b55c..632d78bb8 100644 --- a/content/zh/docs/ToolandCommandReference/gs_expansion.md +++ b/content/zh/docs/ToolandCommandReference/gs_expansion.md @@ -1,4 +1,4 @@ -# gs\_expansion +# gs_expansion ## 背景信息 @@ -26,7 +26,7 @@ openGauss提供了gs_expansion工具对数据库的备机进行扩容。支持 - 正确配置xml文件，在已安装数据库配置文件的基础上，添加需要扩容的备机信息。 -- 只能使用root用户执行gs_expansion命令。 +- 使用root或普通用户执行gs_expansion命令。 - 不允许同时在主节点上执行gs_dropnode命令删除其他备机。 diff --git a/content/zh/docs/ToolandCommandReference/gs_install.md b/content/zh/docs/ToolandCommandReference/gs_install.md index afd89cb75..17f4e856e 100644 --- a/content/zh/docs/ToolandCommandReference/gs_install.md +++ b/content/zh/docs/ToolandCommandReference/gs_install.md @@ -1,14 +1,14 @@ -# gs\_install +# gs_install ## 背景信息 -数据库的部署是一个复杂的过程。openGauss提供了gs\_install工具来帮助完成openGauss的安装和部署。 +数据库的部署是一个复杂的过程。openGauss提供了gs_install工具来帮助完成openGauss的安装和部署。 openGauss安装部署，要求用户指定配置文件，配置文件中会指定程序安装路径、实例数据目录、主备关系、实例数、各实例的业务IP端口等信息。 ## 前提条件 -- 已成功执行前置脚本gs\_preinstall。 +- 已成功执行前置脚本gs_preinstall。 - 用户需确保各个节点上的locale保持一致。 - 需要使用前置时设置的openGauss用户进行安装操作。 @@ -54,13 +54,13 @@ openGauss安装部署，要求用户指定配置文件，配置文件中会指 数据实例参数指定。 - 取值范围请参见[gs\_initdb](gs_initdb.md)的参数说明，其中对-A、-D、-U、-C、-X参数的设置不生效。 + 取值范围请参见[gs_initdb](gs_initdb.md)的参数说明，其中对-A、-D、-U、-C、-X参数的设置不生效。 - --dn-guc=PARAM 配置参数。 - 取值范围请参见[gs\_guc](gs_guc.md)的参数说明。 + 取值范围请参见[gs_guc](gs_guc.md)的参数说明。 - --time-out=SECS diff --git a/content/zh/docs/ToolandCommandReference/gs_preinstall.md b/content/zh/docs/ToolandCommandReference/gs_preinstall.md index 0839b80d6..239c24ba8 100644 --- a/content/zh/docs/ToolandCommandReference/gs_preinstall.md +++ b/content/zh/docs/ToolandCommandReference/gs_preinstall.md @@ -1,15 +1,15 @@ -# gs\_preinstall +# gs_preinstall ## 背景信息 -openGauss提供了gs\_preinstall工具来帮助完成openGauss的环境配置，以保证openGauss安装的正常进行。 +openGauss提供了gs_preinstall工具来帮助完成openGauss的环境配置，以保证openGauss安装的正常进行。 ## 注意事项 - 用户需要检查上层目录权限，保证安装用户对安装包和配置文件目录读写执行的权限。 - xml文件中各主机的名称与IP映射配置正确。 -- 只能使用root用户执行gs\_preinstall命令。 -- 执行gs\_preinstall会清理/etc/hosts中的openGauss映射信息，可能存在已部署数据库连接丢失风险，可以在安装结束后手动添加其它数据库映射至/etc/hosts文件中。 +- 使用root或普通用户执行gs_preinstall命令。 +- 使用root用户执行gs_preinstall会清理/etc/hosts中的openGauss映射信息，可能存在已部署数据库连接丢失风险，可以在安装结束后手动添加其它数据库映射至/etc/hosts文件中。 - gs_preinstall指定的用户不支持使用-d手动选定家目录，仅支持系统默认创建的/home下和用户同名的/home目录。 - 本产品支持同一操作系统大版本下的小版本混合部署，其支持列表如下： @@ -95,7 +95,7 @@ openGauss提供了gs\_preinstall工具来帮助完成openGauss的环境配置， - --skip-hostname-set - 是否将xml配置文件中主机名与IP的映射关系写入“/etc/hosts”文件中。默认写入，如果指定该参数则不写入。 + 是否将xml配置文件中主机名与IP的映射关系写入“/etc/hosts”文件中。默认写入，如果指定该参数则不写入；如果执行的是普通用户，默认不写入。 - --unused-third-party 是否使用om提供的三方库。默认使用，如果指定该参数则不使用。 @@ -108,7 +108,7 @@ openGauss提供了gs\_preinstall工具来帮助完成openGauss的环境配置， 指定日志文件名及路径。在内部会自动给日志名添加一个时间戳。 - 默认值：/var/log/gaussdb/用户名/om/gs\_preinstall.log + 默认值：/var/log/gaussdb/用户名/om/gs_preinstall.log 当不明确指定-l，但在XML文件中配置了gaussdbLogPath时，默认值为gaussdbLogPath的值、用户名和om/gs\_preinstall-YYYY-MM-DD\_hhmmss.log的组合。 -- Gitee