---
title: 手把手带你快速安装openGauss-官方技术文章-鲲鹏社区
description: 本文主要向大家介绍如何快速安装openGauss。
keywords: Gauss,手把手带你快,速安装,官方技术文章,鲲鹏社区,准备安装环境,创建配置文件,初始化安装环境
url: https://www.hikunpeng.com/developer/techArticles/20230911-1?envFlag=1
section: (其他)
---

# 手把手带你快速安装openGauss-官方技术文章-鲲鹏社区

URL: https://www.hikunpeng.com/developer/techArticles/20230911-1?envFlag=1
描述: 本文主要向大家介绍如何快速安装openGauss。
关键词: Gauss,手把手带你快,速安装,官方技术文章,鲲鹏社区,准备安装环境,创建配置文件,初始化安装环境

官方技术文章 [了解详情](https://www.hikunpeng.com/zh/developer/techArticles)

手把手带你快速安装openGauss

手把手带你快速安装openGauss

实战经验

发表于 2020/07/09

0

openGauss在开源后受到业界的广泛关注，与此同时，可能还有不少朋友不太清楚如何安装部署openGauss，本文主要向大家介绍如何快速安装openGauss。

## 准备安装环境

| 环境 | 类别 | 要求 |
| --- | --- | ---|
| 硬件环境 | 内存 | 建议32GB以上 |
| CPU | 建议8核以上 |  |
| 软件环境 | 操作系统 | openEuler
  20.03 LTS |
| CentOS 7.6 |  |  |
| Python | openEuler
  搭配 Python 3.7.X |  |
| CentOS 搭配
  Python 3.6.X |  |  |
| libaio | 建议版本0.3.109-13 |  |

## 创建配置文件

安装openGauss前需要创建XML文件。用户需根据不同场景配置对应的XML文件。

```
mkdir -p /opt/setup 

cd /opt/setup

vi clusterconfig.xml
```

以下为配置文件示例，加粗字体内容请替换。

```
<?xml version="1.0" encoding="UTF-8"?>

<ROOT>

    <!-- openGauss整体信息 -->

    <CLUSTER>

        <PARAM name="clusterName" value="dbCluster" />

        <PARAM name="nodeNames" value="ecs-edison" />

        <PARAM name="backIp1s" value="192.168.0.113"/>

        <PARAM name="gaussdbAppPath" value="/opt/opengauss/install/app" />

        <PARAM name="gaussdbLogPath" value="/var/log/omm" />

        <PARAM name="tmpMppdbPath" value="/opt/opengauss/tmp" />

        <PARAM name="gaussdbToolPath" value="/opt/opengauss/install/om" />

        <PARAM name="corePath" value="/opt/opengauss/corefile" />

        <PARAM name="clusterType" value="single-inst"/>

    </CLUSTER>

    <!-- 节点部署信息 -->

    <DEVICELIST>

        <DEVICE sn="ecs-edison">

            <PARAM name="name" value="ecs-edison"/>

            <PARAM name="azName" value="AZ1"/>

            <PARAM name="azPriority" value="1"/>

            <PARAM name="backIp1" value="192.168.0.113"/>

            <PARAM name="sshIp1" value="192.168.0.113"/>

            <!--dbnode-->

            <PARAM name="dataNum" value="1"/>

            <PARAM name="dataPortBase" value="26000"/>

            <PARAM name="dataNode1" value="/opt/opengauss/install/data/db1"/>

        </DEVICE>

    </DEVICELIST>

</ROOT>
```

| 配置节点 | 参数 | 说明 |
| --- | --- | ---|
| CLUSTER | clusterName | 名称。 |
| nodeNames | 主机名称。请使用/etc/hostname中的名称。 |  |
| backIp1s | 主机在后端存储网络中的IP地址。所有openGauss主机使用后端存储网络通讯。 |  |
| gaussdbAppPath | openGauss程序安装目录。 |  |
| gaussdbLogPath | openGauss运行日志和操作日志存储目录。 |  |
| tmpdbPath | 数据库临时文件存放目录。 |  |
| gaussdbToolPath | openGauss系统工具目录，主要用于存放互信工具等。 |  |
| corePath | openGauss core文件的指定目录。 |  |
| clusterType | openGauss类型。single-inst表示单机一主多备部署形态。 |  |
| DEVICELIST | name | 主机名称。请使用/etc/hostname中的名称。 |
| azName | 指定azName，字符串（不能含有特殊字符），例如AZ1、AZ2、AZ3。 |  |
| azPriority | 指定azPriority的优先级。 |  |
| backIp1 | 主机在后端存储网络中的IP地址（内网IP）。所有openGauss主机使用后端存储网络通讯。 |  |
| sshIp1 | 设置SSH可信通道IP地址（外网IP）。若无外网，则可以不设置该选项或者同backIp1设置相同IP。 |  |

## 初始化安装环境

（1）以root用户登录待安装openGauss的机器。

（2）下载安装包，这里以CentOS安装包为例。

```
cd /opt/setup

wget https://opengauss.obs.cn-south-1.myhuaweicloud.com/1.0.0/x86/openGauss-1.0.0-CentOS-64bit.tar.gz
```

（3）对openGauss-1.0.0-CentOS-64bit.tar.gz进行解压。

```
tar -zxvf openGauss-1.0.0-CentOS-64bit.tar.gz
```

（4）修改安装目录权限。

```
chmod 755 -R /opt/setup
```

（5）进入到工具脚本存放目录。

```
cd /opt/setup/script
```

（6）如果是openEuler的操作系统，需要修改 /etc/profile.d/performance.sh文件

```
使用#注释sysctl -w vm.min_free_kbytes=112640 &> /dev/null
```

（7）为确保openssl版本正确，执行预安装前请加载安装包中lib库。

```
export LD_LIBRARY_PATH=/opt/setup/script/gspylib/clib:$LD_LIBRARY_PATH
```

（8）使用gs_preinstall准备好安装环境。这里采用交互模式执行前置，并在执行过程中自动创建root用户互信和openGauss用户互信。

```
./gs_preinstall -U omm -G dbgrp -X /opt/setup/clusterconfig.xml
```

omm为数据库管理员，也是运行openGauss的操作系统用户，dbgrp为运行openGauss的操作系统用户的群组名称。

## 执行安装

（1）登录到openGauss的主机并切换到omm用户。

```
su - omm
```

（2）使用gs_install安装openGauss。

```
gs_install -X /opt/setup/clusterconfig.xml
```

在执行过程中，用户需根据提示输入数据库的密码，密码具有一定的复杂度。设置的密码要符合复杂度要求：

1）最少包含8个字符；

2）不能和用户名和当前密码（ALTER）相同，或和当前密码反序；

3）至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+\|[{}];:,/?）四类字符中的三类字符。

（3）连接数据库

数据库安装完成后，默认生成名称为postgres的数据库。执行如下命令连接数据库。26000为之前在配置文件中设置的端口。

```
gsql -d postgres -p 26000
```

## 检查健康状态

通过openGauss提供的gs_checkos工具可以完成系统状态检查。

（1）以root用户身份登录。

（2）执行如下命令对openGauss节点服务器的OS参数进行检查。

```
gs_checkos -i A
```

检查节点服务器的OS参数的目的是为了保证在安装成功后可以安全高效的运行。

以上就是openGauss的快速安装过程。openGauss社区正在构建Docker镜像，以方便广大用户快速地体验openGauss，也期望您可以参与openGauss社区贡献，共同构建企业级的开源数据库社区。

openGauss开源社区官方网站：

https://opengauss.org/ [了解详情](https://opengauss.org)

openGauss组织仓库：

https://gitcode.com/opengauss [了解详情](https://gitcode.com/opengauss)

openGauss镜像仓库：

https://github.com/opengauss-mirror [了解详情](https://github.com/opengauss-mirror)

本页内容