Yukon（禹贡）安装包安装教程 - 基于 openGauss 数据库和 CentOS 操作系统

1. 背景介绍

  Yukon（禹贡），基于 openGauss 数据库扩展地理空间数据的存储和管理能力，提供专业的 GIS （Geographic Information System） 功能，赋能传统关系型数据库。Yukon 支持二三维一体化的空间数据存储能力，同时 Yukon 还支持与 PostgreSQL 的适配。

  本篇主要介绍 Yukon 安装包 基于 openGauss 数据库的 安装过程详解 和 注意事项。

2. 环境准备

软件 / 系统	版本	下载地址	备注
CentOS	7.6 及以上（7.x）	CentOS-7-x86_64-Everything-1810.iso	推荐使用 CentOS 7.6 版本
openGauss	企业版 2.1.0	openGauss-2.1.0-CentOS-64bit-all.tar.gz	仅支持 openGauss 企业版 2.1.0，暂不支持其他版本
Yukon	1.0	Yukon-1.0-openGauss2.1.0-CentOS_x64.tar.gz	Yukon 针对 openGauss 数据库分别提供了基于 CentOS 和 openeuler 操作系统的安装包

3. 安装过程

1) openGauss 企业版 2.1.0 安装

• 下载 openGauss for CentOS 操作系统的安装包

  打开浏览器输入 https://opengauss.org/zh/download.html 进入 openGauss 数据库下载页面，选择 企业版 2.1.0 并下载对应操作系统的安装包
  

• 在 CentOS 7.6 操作系统中解压 openGauss 企业版 2.1.0 安装包

  解压 openGauss-2.1.0-CentOS-64bit-all.tar.gz 安装包

  tar -zxvf openGauss-2.1.0-CentOS-64bit-all.tar.gz
  mkdir openGauss-2.1.0-CentOS-64bit-all
  tar -zxvf openGauss-2.1.0-CentOS-64bit-om.tar.gz -C ./openGauss-2.1.0-CentOS-64bit
  cd openGauss-2.1.0-CentOS-64bit
  ls
  

  

• 进入 simpleInstall 目录，执行 openGauss 企业版安装脚本

  • openGauss 企业版 2.1.0 安装脚本软件依赖情况：

    所需软件	建议版本	备注
    firewalld	-	关闭防火墙
    python	3.x	需 python 3.x 版本
    wget	*	openGauss 企业版快速安装脚本依赖
    curl	*	openGauss 企业版快速安装脚本依赖
    boost	*	该软件是为 Yukon 数据库中添加扩展模块使用，若缺少此依赖，则无法在 Yukon 数据库中添加扩展模块

  • openGauss 企业版 2.1.0 安装脚本清单：

    文件名称	用途
    install.sh	简化安装主程序
    common.sh	公共命令
    README.md	参考文档
    template.xml	xml模板
    finance.sql	金融数据模型展示数据库
    school.sql	学校数据模型展示数据库

• 准备 openGauss 数据库安装的软件依赖环境

  • 关闭 CentOS 7.x 防火墙

    • 检查防火墙状态

      sudo systemctl status firewalld.service
      

      

    • 关闭防火墙

      sudo systemctl stop firewalld.service
      sudo systemctl status firewalld.service
      

      

    • 禁用防火墙

      sudo systemctl disable firewalld.service
      

      

  • 安装 python 3.x、wget、curl、boost 软件

    • 直接通过 yum 安装 python3

      sudo yum install python3 -y
      python3
      

      

    • 安装 wget、curl、boost

      sudo yum install wget curl boost -y
      

• 使用 install.sh 脚本安装 openGauss 企业版 2.1.0

  • install.sh 命令参数详解

    • 命令模板

      sh install.sh -U user_name -G user_group -h host_ip -p port [-D install_path]
      

    • 参数说明

      • user_name：openGauss 数据库的安装用户。
      • user_group：openGauss 数据库安装用户所属用户组。
      • host_ip：主机在后端存储网络中的 IP 地址（内网 IP）。
      • host_port：数据库节点的基础端口号。
      • install_path：openGauss 数据库安装路径，该参数为可选参数。

    • 执行安装

      sudo sh install.sh -U omm -G omm -h 192.168.85.136 -p 5432
      

      

    • 导出 openGauss 企业版 2.1.0 环境变量

      cd /home/omm
      ls
      sudo cat env_single
      

      openGauss 企业版 2.1.0 数据库安装成功后，会在 /home/omm 目录下自动生成 env_single 文件，该文件记录了 openGauss 企业版数据库需要导出的环境变量
      
      

2) Yukon 安装包 安装

• 下载 Yukon for openGauss CentOS 的安装包

  打开浏览器输入 https://gitee.com/opengauss/yukon/releases/tag/v1.0 进入 Yukon 数据库下载页面，下载 Yukon-1.0-openGauss2.1.0-CentOS_x64.tar.gz 安装包
  

• 切换当前用户为 omm，解压 Yukon-1.0-openGauss2.1.0-CentOS_x64.tar.gz 安装包

  su omm
  tar -zxvf Yukon-1.0-openGauss2.1.0-CentOS_x64.tar.gz
  cd Yukon-1.0-openGauss2.1.0-CentOS_x64-2022_06_24_12_28/
  ls
  

  

• 以 root 用户安装 Yukon 数据库

  su root
  sh install.sh -i
  

  

• 参考 Yukon 数据库入门教程 创建 Yukon 数据库插件扩展

  gsql -d postgres
  CREATE USER yukontest WITH SYSADMIN password "Bigdata@123";
  \q
  gsql -d postgres -U yukontest -W Bigdata@123
  CREATE TABLESPACE yukonspace LOCATION '/home/omm/data';
  CREATE DATABASE yukontutorial ENCODING='UTF8' TABLESPACE=yukonspace;
  \q
  gsql -d yukontutorial -U yukontest -W Bigdata@123
  CREATE EXTENSION postgis;
  CREATE EXTENSION postgis_raster;
  CREATE EXTENSION postgis_sfcgal;
  CREATE EXTENSION yukon_geomodel;
  CREATE EXTENSION yukon_geogridcoder;
  

  

4. 注意事项

• openGauss 企业版 2.1.0 安装异常 - 主机名异常

  • 异常现象
    

  • 解决方案

    修改 /etc/hostname 文件中记录的主机名，保存后并重启主机名服务

    sudo vim /etc/hostname
    sudo systemctl restart systemd-hostnamed
    

• openGauss 企业版 2.1.0 安装异常 - 找不到 openGauss 企业版安装包

  • 异常现象
    

  • 解决方案

    删除 /etc/omm 目录下的 openGaussTar 目录后，重新执行安装命令即可

• Yukon（禹贡）数据库安装成功后 ldconfig 输出 is not a symbolic link 信息

  • 这只是一个提示信息，说明只是有些文件命名不符合系统规定，并不影响功能正常使用