gs_checkos
背景信息
gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等内容,并对系统控制参数、I/O配置、网络配置和THP服务等信息进行配置。
前提条件
当前的硬件和网络环境正常。
各主机间root互信状态正常。
只能使用root用户执行gs_checkos命令。
说明:
该工具不支持独立调用,出于安全考虑,企业版安装方式下,前置完成后会自动删除。
语法
检查操作系统信息
gs_checkos -i ITEM [-f HOSTFILE] [-h HOSTNAME] [-X XMLFILE] [--detail] [-o OUTPUT] [-l LOGFILE]
显示帮助信息
gs_checkos -? | --help
显示版本号信息
gs_checkos -V | --version
参数说明
-i
列表编号。格式:-i A、-i B1、-i A1 -i A2或-i A1,A2。
取值范围:A1…A14、B1…B8。
说明:
A1…A14 表示只检查操作系统参数,并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。
详细的检查项请参见表1。
-f
主机名称列表文件。
说明: -f和-h参数不能同时使用。
取值范围:主机名称的列表。
-h
指定需要检查的主机名称,可以同时指定多个主机,主机之间使用“,”分割。
取值范围:openGauss的主机名称。如果不指定主机,则检查当前主机。
-X
openGaussXML配置文件。
--detail
显示检查结果详情。
-o
指定OS检查报告输出到指定的文件。
不指定则将检查结果输出到屏幕上。
-l
指定日志文件及存放路径。
默认值:/tmp/gs_checkos/gs_checkos-YYYY-MM-DD_hhmmss.log。
-?, --help
显示帮助信息。
-V, --version
显示版本号信息。
表 1 操作系统检查项
操作系统版本检查:保证主机平台是支持的openEuler和CentOS平台中的一种。同时保证openGauss各个主机的平台是属于同一混编范围的。 | ||
内核参数检查:保证当前内核中的参数值和默认的期望值保持一致。 详细的内核参数请参见操作系统参数。 | ||
硬盘挂载参数检查:格式为xfs的硬盘,其挂载格式必须为:“rw,noatime,inode64,allocsize=16m”。 | ||
| ||
内核参数设置:当实际值不满足检查条件期望时,对结果为Abnormal项参数进行修改设置;对Warning项不进行设置,由用户根据实际环境设置。 | ||
系统文件句柄设置:当系统文件句柄的参数值小于100万时,对其进行修改设置。 | ||
欧拉系统属性检查:检查设置欧拉系统文件/usr/lib/systemd/system/systemd-logind.service,/etc/systemd/logind.conf中配置项RemoveIPC属性值是否为no,当不为no时,对其进行修改设置。 | ||
远程设备继承系统默认资源:修改/etc/pam.d/sshd服务文件,添加配置项session required pam_limits.so,来控制用户使用的资源。 |
说明:
A6选项检查标准来自配置文件check_list.conf下[/etc/sysctl.conf]、[SUGGEST:/etc/sysctl.conf]域: 若[/etc/sysctl.conf]下参数值与系统实际参数值不同,A6检查提示Abnormal,可以使用B1参数进行设置。 若[SUGGEST:/etc/sysctl.conf]下参数值与系统实际参数值不同,A6检查提示Warning,B1参数不会进行设置,需根据实际情况进行手动设置。
A7选项检查系统文件句柄标准来自配置文件check_list.conf下[/etc/security/limits.conf]域open file参数,可以使用B2参数进行设置。
A11选项检查万兆网卡参数“MTU”、“RX”、“TX”标准来自配置文件check_list.conf下[/sbin/ifconfig]域,可以使用B5参数对RX、TX进行设置,MTU需用户手动设置。
使用gs_checkos设置的内核参数值和文件句柄参数值,需重启新会话生效。
操作系统参数
表 2 操作系统参数
文件系统参数
soft nofile
说明:soft nofile表示软限制,用户使用的文件句柄数量可以超过该限制,但是如果超过会有告警信息。
推荐取值:1000000
hard nofile
说明:hard nofile表示硬限制,是一个严格的限制,用户使用的文件句柄数量一定不能超过该设置。
推荐取值:1000000
stack size
说明:线程堆栈大小。
推荐值:3072
示例
使用如下命令检查操作系统参数。
gs_checkos -i A -h plat1 -X /opt/software/openGauss/clusterconfig.xml --detail -o /var/log/checkos
Performing operation system check/set. Output the result to the file /var/log/checkos.
Operation system check/set is completed.
Total numbers:14. Abnormal numbers:0. Warning number:1.
查看操作系统参数检查结果。
vim /var/log/checkos
Checking items:
A1. [ OS version status ] : Normal
A2. [ openGauss version status ] : Normal
A3. [ Unicode status ] : Normal
A4. [ Time zone status ] : Normal
A5. [ Swap memory status ] : Normal
A6. [ System control parameters status ] : Normal
A7. [ File system configuration status ] : Normal
A8. [ Disk configuration status ] : Normal
A9. [ Pre-read block size status ] : Normal
A10.[ IO scheduler status ] : Normal
A11.[ Network card configuration status ] : Normal
A12.[ Time consistency status ] : Warning
A13.[ Firewall service status ] : Normal
A14.[ THP service status ] : Normal