安装与卸载

在安装 Yukon 之前必须先安装数据库(openGauss或PostgreSQL )。数据库安装指导参见： openGauss 或 PostgreSQL 。

Note

openGauss 支持的操作系统有： centos_x86_64、openeuler_aarch64、openeuler_x86_64，请优先在这些操作系统进行安装。

数据库安装成功后，开始 Yukon 产品的安装。

安装包安装

安装包中包含了 Yukon 相关的帮助文档以及安装包。

安装包
版本	openGauss 2.1	PostgreSQL13
Yukon-1.0	Yukon-1.0-openGauss2.1.0-CentOS_x64.tar.gz/Yukon-1.0-openGauss2.1.0-openeuler_aarch64.tar.gz	Yukon-1.0-postgres13-CentOS_x64.tar.gz

下载并解压后进入到 Yukon-1.0-* 目录，执行 sh install.sh -i 进行安装，看到如下输出则说明安装成功。

Note

安装时请使用 root 用户安装，同时导出 pg_config 路径及 PGDATA 环境变量

__     __      _
\ \   / /     | |
 \ \_/ /_   _ | | __ ___   _ __
  \   /| | | || |/ // _ \ |  _ \
   | | | |_| ||   <| (_) || | | |
   |_|  \____||_|\_\\___/ |_| |_|

Note

openGauss 加载环境变量，使用脚本一键安装的单机版环境变量一般为 source /home/user/env_single ，手动安装集群式安装环境变量一般为 source /home/user/.bashrc，完成后重新安装。

编译安装

获取 Yukon 源码

安装 git 工具，在 Yukon 的 Gitee 仓库获取源码，以 Yukon for openGauss 为例：

git clone https://gitee.com/opengauss/Yukon.git

准备编译环境

安装下列软件依赖包
- gcc/g++ >= 7.3
- gdal-devel >= 3.0.0
- geos-devel >=3.6.0
- json-c-devel
- proj-devel
- libxml2-devel
- sfcgal
以上安装包可以通过源码安装，也可以直接使用 yum 工具直接安装。如果还缺少其他依赖，可自行安装。
开始编译

准备好编译环境以后，就可以开始进行编译安装：
```
# 如果您想使用 SFCGAL 作为 PostGIS 的处理后端，那么在准备安装环境时，需要预先安装 SFCGAL

进入Yukon目录后运行配置文件：
cd Yukon
./configure --with-pgconfig=/pg_config --without-topology  --without-address-standardizer \
            --without-interrupt-tests CFLAGS='-O2 -fpermissive -DPGXC  -pthread ' CC=g++
make
make install
```
Note

安装时可能会提示 openGauss 目录下缺少部分头文件，此时需要从 openGauss源码库中的 src/include 目录下拷贝对应文件到提示的目录下，出于方便也可以直接全部覆盖。

如果在安装 gdal、 geos、 json-c、 libxml2、porj、 sfcgal时自定义了安装路径，那么运行配置文件时需要添加以下的配置选项：
```
--with-gdalconfig=/path/gdal-config --with-geosconfig=/path/geos-config \
--with-xml2config=/path/xml2-config --with-jsondir=/path/json-c \
--with-projdir=/path/proj4 --with-sfcgal=/path/sfcgal-config
```
同时，需要将这些依赖的动态库的路径添加到 /etc/ld.so.conf 文件中，然后使用 ldconfig 命令加载路径,或者将路径添加到 LD_LIARARY_PATH 环境变量中。

开始使用

以上安装完成后，可以进入数据库操作。这里我们以 openGauss 为例：

--- 切换到 omm (数据库安装用户)
su omm
--- 连接到 postgres 数据库
gsql -d postgres

--- 创建 postgis 扩展
CREATE EXTENSION postgis;
--- 创建 postgis_raster 扩展
CREATE EXTENSION postgis_raster;
--- 创建 yukon_geomodel 扩展
CREATE EXTENSION yukon_geomodel;
--- 创建 yukon_geogridcoder 扩展
CREATE EXTENSION yukon_geogridcoder;
-- 如果在编译时支持了 SFCGAL 则可以创建 SFCGAL 扩展
CREATE EXTENSION postgis_sfcgal;

容器安装

目前 1.0 版本提供的 Docker 镜像如下：

supermap/yukon:1.0-opengauss2.1.0-amd64
supermap/yukon:1.0-opengauss2.1.0-arm64
supermap/yukon:1.0-postgresql13-amd64

启动Yukon

--Yukon for openGauss
docker run --name Yukon --privileged=true -d -e GS_PASSWORD=Bigdata@123 supermap/yukon:1.0-opengauss2.1.0-amd64
--Yukon for PostgreSQL
docker run --name Yukon --privileged=true -d -e POSTGRES_PASSWORD=Bigdata@123 supermap/yukon:1.0-postgresql13-amd64

环境变量

openGauss镜像支持以下变量的设定：

GS_PASSWORD ：【必须设置】，该参数设置了 openGauss 数据库的超级用户 omm 以及外部连接用户 gaussdb 的密码。openGauss 安装时默认会创建 omm 超级用户，测试用户 gaussdb 是在 entrypoint.sh 中自定义创建的用户，openGauss 设置的密码要符合复杂度要求：
- 最少包含8个字符。
- 不能和用户名、当前密码（ALTER）、或当前密码反序相同。
- 至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,<.>/?）四类字符中的三类字符。
GS_NODENAME：【可选设置】，该参数设置了 openGauss 数据库的节点名称，默认为 gaussdb，可以在 entrypoint.sh 中进行查看
GS_USERNAME：【可选设置】，该参数设置了 openGauss 数据库的外部连接用户名，默认为 gaussdb，可以在 entrypoint.sh 中进行查看
GS_PORT:【可选设置】，该参数设置了 openGauss 数据库的连接端口，默认为 5432，可以在 entrypoint.sh 中进行查看。

PostgreSQL 镜像支持以下变量的设定：

POSTGRES_PASSWORD ：【必须设置】，设置 PostgreSQL 密码

体验 Yukon

稍等片刻，等 Yukon 启动后，可以使用如下命令体验 Yukon。以 Yukon for openGauss 为例：

sudo docker exec -it Yukon  /bin/bash
su omm
gsql -d postgres

连接成功后，可以看到类似如下的字符：

[omm@367dd3bb5d10 /]$ gsql -d postgres
    gsql ((openGauss 2.1.0 build 590b0f8e) compiled at 2021-09-30 14:29:04 commit 0 last mr  )
    Non-SSL connection (SSL connection is recommended when requiring high-security)
    Type "help" for help.

openGauss=#

postgres 数据库默认已经创建了 postgis , postgis_raster , postgis_sfcgal , yukon_geomodel, yukon_geogridcoder 扩展，可以直接使用。

-- 查询 yukon_geomodel 的版本及其编译时间
select yukon_version();
-- 输出 1.0.0 Compiled at:2022-05-06 08:49:42 Commit ID:e1cdae4

外部连接数据库

openGauss 的默认监听端口为 5432 ，如果想要从容器外部访问数据库，则需要在 docker run 的时候指定 -p 进行端口映射：

docker run --name Yukon --privileged=true -d -e GS_PASSWORD=Bigdata@123 -p 5432:5432 supermap/yukon:1.0-opengauss2.1.0-amd64

现在就可以使用 openGauss 的数据库管理工具 DataStudio，或者使用开源的 DBeaver 连接数据库（第一次连接时间可能较长，需要等待数据库安装初始化完成）。

持久化存储数据

容器一旦被删除，容器内的所有数据和配置也均会丢失，而从镜像重新运行一个容器的话，则所有数据又都是呈现在初始化状态，因此对于数据库容器来说，为了防止因为容器的消亡或者损坏导致的数据丢失，需要进行持久化存储数据的操作。通过在 docker run 的时候指定 -v 参数来实现，或者可以指定已经建立好的 Volume 。使用以下命令将 openGauss 的所有数据文件存储在宿主机的 /Yukon/opengauss 下。

mkdir -p /Yukon/opengauss
docker run --name Yukon --privileged=true -d -e GS_PASSWORD=Bigdata@123 \
    -v /Yukon/opengauss:/var/lib/opengauss  -p 5432:5432 \
    supermap/yukon:1.0-opengauss2.1.0-amd64

主备节点安装

如果是在 openGauss 集群下安装 Yukon，需要在主机间执行命令，传送文件等操作。在主机之间建立互信的基础上，只需执行安装包里的脚本文件 sh install_cluster.sh -f hostfile -U username 即可（openGauss安装集群时，会在主机间建立互信，如果此时没有互信，可以再重新手动建立互信）。

hostfile ：存放有openGauss中所有主机IP的配置文件。

例： /opt/software/openGauss> vim hostfile

username ：openGauss集群所使用的安装用户，默认为 omm 用户。

卸载

如果使用安装包进行安装，执行 sh install.sh -r 命令即可卸载。

如果使用源码进行编译安装，在源码根目录下，执行命令 make uninstall 进行卸载。

如果使用 Docker 进行安装，直接删除 Docker 容器和镜像即可。

您也可以手动检查以下三个地方查看是否有卸载残留：

$GAUSSHOME/lib/postgresql/ 目录下与 postgis 和 yukon 相关的文件
$GAUSSHOME/share/postgresql/extension/ 目录下与 postgis 和 yukon 相关的文件
/opt 目录下是否有 yukon_dep 文件夹