部署运维FAQs

初始化环境FAQs

Q1: clusterconfig.xml示例配置文件需要修改哪些参数？

需要修改机器名和IP地址。

<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
    <!-- MogDB整体信息 -->
    <CLUSTER>
        <PARAM name="clusterName" value="dbCluster" />
        <PARAM name="nodeNames" value="mogdb-kernel-0002" />
        <PARAM name="backIp1s" value="172.16.0.245"/>
        <PARAM name="gaussdbAppPath" value="/opt/mogdb/app" />
        <PARAM name="gaussdbLogPath" value="/opt/mogdb/mogdb_log/omm" />
        <PARAM name="gaussdbToolPath" value="/opt/mogdb/tool" />
        <PARAM name="corePath" value="/opt/mogdb/corefile"/>
        <PARAM name="clusterType" value="single-inst"/>
    </CLUSTER>

<!-- 每台服务器上的节点部署信息 -->
    <DEVICELIST>
        <!-- mogdb-kernel-0002上的节点部署信息 -->
        <DEVICE sn="1000001">
            <PARAM name="name" value="mogdb-kernel-0002"/>
            <PARAM name="azName" value="AZ1"/>
            <PARAM name="azPriority" value="1"/>
            <!-- 如果服务器只有一个网卡可用，将backIP1和sshIP1配置成同一个IP -->
            <PARAM name="backIp1" value="172.16.0.245"/>
            <PARAM name="sshIp1" value="172.16.0.245"/>

            <!--dbnode-->
            <PARAM name="dataNum" value="1"/>
            <PARAM name="dataPortBase" value="26000"/>
            <PARAM name="dataNode1" value="/mogdb/data/db1"/>
        </DEVICE>
    </DEVICELIST>
</ROOT>

初始化脚本FAQs

Q2: 当提示配置文件参数值与系统环境变量值不相符怎么办？

Failed to check the preinstall repeat condition.gaussdbToolPath [/opt/enmo/wisery] is not same with environment [/opt/mogdb/tool]

将clusterconfig.xml文件里gaussdbToolPath的值改为/opt/mogdb/tool。

说明：

出现此类问题，主要是因为系统之前安装过MogDB，环境可能未清理干净，所以会产生配置文件参数值与系统环境变量值不相符的情况，将导致执行失败。将clusterconfig.xml配置文件中报错参数的值改为和环境变量文件参数值相同即可。

在omm用户下执行vi ~/.bashrc可查看环境变量。

Q3: 当提示无权限执行该命令，怎么办？

Fixing server package owner.
[GAUSS-51400] : Failed to execute the command: su - omm -c 'cd '/opt/software/mogdb/''. Error:
-bash: line 0: cd: /opt/software/mogdb/: Permission denied

执行chmod 755 -R /opt/software为该目录赋予权限后，再重新执行脚本初始化命令。

Q4: 当符号链接创建失败怎么办？

In:failed to create symbolic link 'usr/bin/python3': File exists

将usr/bin/目录下的python3删掉，重新执行In命令。

Q5: 当提示主机名不在集群中时怎么办？

GAUSS-51619: "The host name [host-172-16-0-195] is not in the cluster."

这是因为机器实际的名称是host-172-16-0-195，而不是mogdb-kernel-0006，所以需要将clusterconfig.xml里的节点名称改为host-172-16-0-195。

Q6: 当出现如下报错时，怎么办？

[GAUSS-50202]:The /opt/mogdb must be empty. Or user [omm] has write permission to directory /opt/mogdb. Because it will create symbolic link [/opt/mogdb/app] to install path [/opt/mogdb/app_e0e9f58d] in gs_install process with this user.

在omm用户下，执行vi ~/.bashrc，将环境变量清空，重新执行初始化脚本即可成功。

Q7: 当出现如下有关依赖包的报错时，怎么办？

/opt/software/mogdb/bin/mogdb: error while loading shared libraries: libnsl.so.1: cannot open shared object file: No such file or directory
no data was returned by command ""/opt/software/mogdb/bin/mogdb" -V"
The program "mogdb" is needed by gs_initdb but was not found in the
same directory as "/opt/software/mogdb/bin/gs_initdb".
Check your installation.

重新安装依赖包libnsl*即可。

安装FAQs

Q8: 当提示集群已安装怎么办？

[GAUSS-51400] : Failed to execute the command: source /home/omm/.bashrc;python3 '/opt/mogdb/tool/script/local/CheckInstall.py' -U omm:dbgrp -R /opt/mogdb/app -l /opt/mogdb/mogdb_log/omm/omm/om/gs_local.log -X /opt/software/mogdb/clusterconfig.xml.Error:
Checking old installation.
[GAUSS-51806] : The cluster has been installed.

执行vi ~/.bashrc查看环境变量，将GAUSS_ENV=2改为GAUSS_ENV=1，重新执行安装命令即可。

Q9: 当执行安装命令报如下错误怎么办？

[GAUSS-51400] : Failed to execute the command: source /home/omm/.bashrc;python3 '/opt/mogdb/tool/script/local/CheckInstall.py' -U omm:dbgrp -R /opt/mogdb/app -l /opt/mogdb/mogdb_log/omm/omm/om/gs_local.log -X /opt/software/mogdb/clusterconfig.xml.Error:
Checking old installation.
Successfully checked old installation.
Checking SHA256.
Successfully checked SHA256.
Checking kernel parameters.
Successfully checked kernel parameters.
Checking directory.
[GAUSS-50202] : The /opt/mogdb/app_b75b585a must be empty.

在root用户下，进入/opt/mogdb/app_b75b585a目录，执行rm -rf *将目录下所有文件删除，重新执行安装命令即可。

Q10: 当错误提示socket被占用怎么办？

[GAUSS-50200] : The socket file already exists. Port:26000.

将clusterconfig.xml文件里的dataPortBase值改为一个可用的端口即可。

部署后FAQs

gs_om -t start启动数据库失败："在标准安装后，通过hostnamectl set修改主机名"

适用于：

MogDB 1.1.0
MogDB 2.0.0
MogDB 2.0.1
MogDB 单机数据库

本文档中的信息适用于x86平台。

症状：

在标准安装结束后（单机），通过hostnamectl set修改主机名，执行gs_om -t start命令数据库启动失败。

例如：

在root用户下通过hostnamectl set将主机名mogdb-kernel-0005修改为www.mogdb.com。

[root@mogdb-kernel-0005 ~]# hostnamectl
   Static hostname: mogdb-kernel-0005
         Icon name: computer-vm
           Chassis: vm
        Machine ID: de03a5f3bf5a4b7e9df939c9dc5b428d
           Boot ID: 828bfbe948ed4de7aff2a059103a0eaa
    Virtualization: kvm
  Operating System: CentOS Linux 7 (Core)
       CPE OS Name: cpe:/o:centos:centos:7
            Kernel: Linux 3.10.0-1160.15.2.el7.x86_64
      Architecture: x86-64
[root@mogdb-kernel-0005 ~]# id
uid=0(root) gid=0(root) groups=0(root)
[root@mogdb-kernel-0005 ~]# hostname
mogdb-kernel-0005
[root@mogdb-kernel-0005 ~]# hostnamectl set-hostname www.mogdb.com

在任意用户下执行如下命令查看是否主机名修改成功。
```
[root@mogdb-kernel-0005 ~]# hostname
www.mogdb.com
```

在omm用户下执行如下命令停止数据库。

[root@mogdb-kernel-0005 ~]# su - omm
Last login: Tue Jul 27 11:18:16 CST 2021 on pts/1
[omm@www ~]$ gs_ctl stop -D /mogdb/data/db1
[2021-07-27 11:19:20.283][32166][][gs_ctl]: gs_ctl stopped ,datadir is /mogdb/data/db1
waiting for server to shut down.... done
server stopped

在omm用户下执行如下命令启动数据库。

[omm@www ~]$ gs_om -t start

Starting cluster.
=========================================

=========================================
[GAUSS-53600]: Can not start the database, the cmd is source /home/omm/.bashrc; python3 '/opt/enmo/wisequery/script/local/StartInstance.py' -U omm -R /opt/mogdb/app -t 300 --security-mode=off,  Error:
[GAUSS-51400] : Failed to execute the command: source /home/omm/.bashrc; python3 '/opt/enmo/wisequery/script/local/StartInstance.py' -U omm -R /opt/mogdb/app -t 300 --security-mode=off. Error:
[FAILURE] mogdb-kernel-0005

目的：

在标准安装结束后（单机），通过modip.py脚本修改主机名，执行gs_om -t start命令，数据库启动成功。

故障解决步骤：

以omm用户创建modip.py脚本文件。

[omm@www ~]$ cd
[omm@www ~]$ pwd
/home/omm
[omm@www ~]$ vi modip.py

# -*- coding:utf-8 -*-

import sys
##sys.path.append(r'$GPHOME/script/')
sys.path.append(r'/opt/enmo/wisequery/script/')
from gspylib.common.DbClusterInfo import dbClusterInfo

oldIP = '172.16.0.176'
newIP = '172.16.0.176'
oldnodename = 'mogdb-kernel-0005'
newnodename = 'www.mogdb.com'
##Output file directory
tmpDir = r'/home/omm'
dbuser = 'omm'

c1=dbClusterInfo()
c1.initFromStaticConfig(dbuser)

for node in c1.dbNodes:
    if node.backIps[0] == oldIP:
        node.backIps[0] = newIP
    if len(node.virtualIp):
        if node.virtualIp[0] == oldIP:
            node.virtualIp[0] = newIP
    if node.name == oldnodename:
        node.name = newnodename
    if node.sshIps[0] == oldIP:
        node.sshIps[0] = newIP
    for dn in node.datanodes:
        if dn.listenIps[0] == oldIP:
            dn.listenIps[0] = newIP
        if dn.haIps[0] == oldIP:
            dn.haIps[0] = newIP
        for peerdn in dn.peerInstanceInfos:
            if len(peerdn.peerHAIPs):
                if peerdn.peerHAIPs[0] == oldIP:
                    peerdn.peerHAIPs[0] = newIP
for node in c1.dbNodes:
    staticConfigPath_dn = "%s/cluster_static_config_%s" % (tmpDir, node.name)
    c1.saveToStaticConfig(staticConfigPath_dn, node.id)
    print(staticConfigPath_dn)

说明: 需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为172.16.0.176，旧主机名为mogdb-kernel-0005，新主机名为www.mogdb.com。

执行如下命令生成集群静态配置文件。
```
[omm@www ~]$ python3 modip.py
```
回显如下即执行成功。
```
/home/omm/cluster_static_config_www.mogdb.com
```

执行如下命令替换源文件。

[omm@www ~]$ mv /opt/mogdb/app/bin/cluster_static_config /opt/mogdb/app/bin/cluster_static_config_mogdb.com

[omm@www ~]$ cp /home/omm/cluster_static_config_www.mogdb.com /opt/mogdb/app/bin/cluster_static_config

执行如下命令启动数据库。

[omm@www ~]$ gs_om -t start

Starting cluster.
=========================================

[SUCCESS] www.mogdb.com

2021-07-26 16:20:42.938 60fe7056.1 [unknown] 139667408496384 [unknown] 0 dn_6001 01000  0 [BACKEND] WARNING: could not create any HA TCP/IP sockets
=========================================

Successfully started.