一、 openGauss安裝（企業版）

1. 獲取安裝包

1.1. 從openGauss開源社區下載對應平臺的安裝包，

通過https://opengauss.org/zh/download.html 登錄openGauss開源社區，選擇 2.0.0版本對應平臺企業版安裝包（openGauss-2.0.0-CentOS-64bit-all.tar.gz）， 單擊“下載”，

1.2. 檢查安裝包，

解壓安裝包，檢查安裝目錄及檔案是否齊全，在安裝包所在目錄執行以下命令：

tar -zxvf openGauss-2.0.0-CentOS-64bit-all.tar.gz ls -1b

執行ls命令，顯示類似如下資訊：

----結束

2. 修改作業系統配置

2.1. 修改檔案

如果安裝的不是Centos7.6，則要修改/etc/rehat-release檔案，將 CentOS Linux release 7.9.2003 (Core)修改為CentOS Linux release 7.6 (Core)

2.2. 關閉作業系統防火墻

步驟1 修改/etc/selinux/config檔案中的“SELINUX”值為“disabled”， 使用VIM打開config檔案， vim /etc/selinux/config 修改“SELINUX”的值“disabled”，執行:wq保存并退出修改， SELINUX=disabled

步驟2 重新啟動作業系統，

reboot

步驟3 檢查防火墻是否關閉，

systemctl status firewalld

若防火墻狀態顯示為active (running)，則表示防火墻未關閉，請執行步驟4； 若防火墻狀態顯示為inactive (dead)，則無需再關閉防火墻，

步驟4 關閉防火墻，

systemctl disable firewalld.service systemctl stop firewalld.service

步驟5 在其他主機上重復步驟1到步驟4， ----結束

2.3. 設定字符集引數

將各資料庫節點的字符集設定為相同的字符集，可以在/etc/profile檔案中添加"export LANG=XXX"（XXX為Unicode編碼）， vim /etc/profile

2.4. 設定時區和時間

在各資料庫節點上，確保時區和時間一致，

步驟1 執行如下命令檢查各資料庫節點時間和時區是否一致，如果不一致，請執行步驟2~步驟3，

date

步驟2 使用如下命令將各資料庫節點/usr/share/zoneinfo/目錄下的時區檔案拷貝為/etc/localtime檔案，

cp /usr/share/zoneinfo/$地區/$時區/etc/localtime 說明: $地區/$時區為需要設定時區的資訊，例如：Asia/Shanghai，

步驟3使用date -s命令將各資料庫節點的時間設定為統一時間，舉例如下，

date -s "Sat Sep 27 16:00:07 CST 2020"

----結束

2.5. 設定網卡MTU 值

將各資料庫節點的網卡MTU值設定為相同大小，

步驟1 執行如下命令查詢服務器的網卡名稱

ifconfig 如下圖所示：

步驟2 使用如下命令將各資料庫節點的網卡MTU值設定為相同大小， 對于X86，MTU值推薦1500；對于ARM，MTU值推薦8192，

ifconfig 網卡名稱 mtu mtu值

----結束

3. 安裝openGauss

3.1. 創建XML組態檔

安裝openGauss前需要創建cluster_config.xml檔案，cluster_config.xml檔案包含部署 openGauss的服務器資訊、安裝路徑、IP地址以及埠號等，用于告知openGauss如何 部署，用戶需根據不同場景配置對應的XML檔案，

配置資料庫節點名稱時，請通過hostname命令獲取資料庫節點的主機名稱，

單節點組態檔如下：

3.2.初始化安裝環境

3.2.1. 準備安裝用戶及環境

步驟1 以root用戶登錄待安裝openGauss的任意主機，并按規劃創建存放安裝包的目錄，

步驟2 將安裝包“openGauss-2.0.0-CentOS-64bit-all.tar.gz”和組態檔“cluster_config.xml”都上傳至上一步所創建的目錄中，

步驟3 在安裝包所在的目錄下，解壓安裝包openGauss-2.0.0-CentOS-64bit-all.tar.gz，安裝包解壓后，會有OM安裝包和Server安裝包，繼續解壓OM安裝包，會在/opt/software/openGauss路徑下自動生成script子目錄，并且在script目錄下生成gs_preinstall等各種OM工具腳本，

步驟4 進入到工具腳本存放目錄下， cd /opt/software/openGauss/script

步驟5 為確保成功安裝，執行命令檢查 hostname 與 /etc/hostname 是否一致， hostname cat /etc/hostname

步驟6 使用gs_preinstall需要python3.6的環境，一般自帶的是python2.7，

• 安裝CentOS開發工具 【用于允許您從源代碼構建和編譯軟體】 sudo yum -y “groupinstall development”

• 下載epel

  sudo yum install epel-release

• 安裝python3

  sudo yum install python36

  

• 更改默認python

  

步驟7 使用gs_preinstall準備好安裝環境

采用互動模式執行前置，并在執行程序中自動創建root用戶互信和openGauss用 戶互信： ./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml

3.2.2. 建立互信（使用腳本建立互信）

步驟1 創建一個執行互信腳本所需要的輸入文本，并在此檔案中添加openGauss中所有主機 IP， vim hostfile

步驟2 以需要創建互信的用戶執行下面腳本建立互信， ./gs_sshexkey -f /opt/software/hostfile -W wangjingwei1

運行成功截圖如下

3.3.執行安裝

步驟1 登錄到openGauss的主機，并切換到omm用戶，

su - omm

步驟2 使用gs_install安裝openGauss，

gs_install -X /opt/software/openGauss/cluster_config.xml 在執行程序中，用戶需根據提示輸入資料庫用戶的密碼，密碼應具有一定的復雜度.

步驟3 安裝執行成功之后，需要手動洗掉主機root用戶的互信，即洗掉openGauss資料庫各 節點上的互信檔案， rm -rf ~/.ssh

安裝完成

4. 安裝驗證

步驟1 以omm用戶身份登錄服務器，

步驟2 執行如下命令檢查資料庫狀態是否正常，“cluster_state ”顯示“Normal”表示資料 庫可正常使用， gs_om -t status

步驟3 資料庫安裝完成后，默認生成名稱為postgres的資料庫，第一次連接資料庫時可以連接到此資料庫，其中postgres為需要連接的資料庫名稱，26000為資料庫主節點的埠號，即XML配置.檔案中的dataPortBase的值，請根據實際情況替換，

gsql -d postgres -p 26000 連接成功后，系統顯示類似如下資訊表示資料庫連接成功， gsql ((openGauss x.x.x build 290d125f) compiled at 2021-03-08 02:59:43 commit 2143 last mr 131 Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help.

步驟4 建立表，并插入內容進行查詢

二、使用jdbc連接資料庫

1. 確認連接資訊

步驟1 以作業系統用戶omm登錄資料庫主節點，

步驟2 使用“gs_om -t status --detail”命令查詢openGauss各實體情況，

2. 配置服務端遠程連接

步驟1 以作業系統用戶omm登錄資料庫主節點，

步驟2 配置客戶端認證方式

• 需先本地連接資料庫，并在資料庫中使用如下陳述句建立“jack”用戶：

  postgres=# CREATE USER jack PASSWORD 'Test@123';

• 允許客戶端以“jack”用戶連接到本機，此處遠程連接禁止使用

  “omm”用戶（即資料庫初始化用戶），下面示例中配置允許IP地址為10.27.1.209的客戶端訪問本機，

  

步驟3 配置listen_addresses，listen_addresses即遠程客戶端連接使用的資料庫主節點ip或者主機名，

• 使用如下命令查看資料庫主節點目前的listen_addresses配置，

  gs_guc check -I all -c "listen_addresses"

• 使用如下命令把要添加的IP追加到listen_addresses后面，多個配置項之間用英文逗號分隔，例如，追加IP地址10.11.12.13，

  gs_guc set -I all -c"listen_addresses='localhost,192.168.0.100,10.11.12.13'"

步驟4 執行如下命令重啟openGauss，

gs_om -t stop && gs_om -t start

3. JDBC 包、驅動類和環境類

• 在openGauss官網下載JDBC包，openGauss-2.0.0-JDBC.tar.gz，解壓獲得驅動jar包postgresql.jar，

• 在創建資料庫連接之前，需要加載資料庫驅動類“org.postgresql.Driver”，

• 終端輸入“java -version”，查看JDK版本，確認為JDK1.8版本，

4. 驅動加載

在代碼中創建連接之前任意位置隱含裝載：Class.forName("org.postgresql.Driver");

• 在windows下運行代碼進行連接時，使用eclipse裝載驅動即可，

  

• 在centos系統下連接資料庫時，要將postgresql.jar驅動包設定到java的classpath環境變數中，

  將postgresql.jar類別庫檔案拷貝到...\Java\jdk1.7.0\jre\lib\ext目錄下，（這個路徑根據JDK的版本和安裝路徑確定，下同）

  將postgresql.jar類別庫檔案拷貝到...\Java\jre7\lib\ext目錄下（ 最好是，只要是jre檔案夾，都復制一個postgresql.jar到jre7\lib\ext里去）

5. 連接資料庫

JDBC提供了三個方法，用于創建資料庫連接，

1. DriverManager.getConnection(String url)

2. DriverManager.getConnection(String url, Properties info);

3. DriverManager.getConnection(String url, String user, String password);

• 連接資料庫代碼如下：

  

• 

• 運行截圖

• 連接資料庫并在表中插入資料

  連接時會以某一用戶訪問某一表，要先在資料庫中對該用戶進行授權，

  代碼如下：

  運行截圖：

  查詢此表進行驗證：

三、 遇到的問題

1. 剛開始安裝的極簡版，發現有一個命令使用不了，后來改安裝企業版就沒遇到這個問題，

2. centos版本問題：在網上沒有找到centos7.6，只找到7.9，運行時會報錯，要修改/etc/rehat-release檔案，將 CentOS Linux release 7.9.2003 (Core)修改為CentOS Linux release 7.6 (Core)，

3. 安裝python3

   • 安裝CentOS開發工具 【用于允許您從源代碼構建和編譯軟體】 sudo yum -y “groupinstall development”

   • 下載epel sudo yum install epel-release

   • 安裝python3 sudo yum install python36

   • 更改默認python

   • 

4. 連接問題

   連接windows主機時，遠程連接也配置了，互信也建立了，總是報連接錯誤問題，后來選擇連接虛擬機，連接虛擬機要先配jdk，直接使用yum安裝比較方便：

   • 搜索jdk安裝包

     # yum search java|grep jdk

   • 下載jdk1.8，下載后默認目錄為：/uer/lib/jvm/

     # yum install java-1.8.0-openjdk

   • 驗證安裝

   后面要進行驅動加載，不加載的話使用不了下載的檔案，要將postgresql.jar驅動包設定到java的classpath環境變數中，

   將postgresql.jar類別庫檔案拷貝到...\Java\jdk1.7.0\jre\lib\ext目錄下，（這個路徑根據JDK的版本和安裝路徑確定，下同）

   將postgresql.jar類別庫檔案拷貝到...\Java\jre7\lib\ext目錄下（ 最好是，只要是jre檔案夾，都復制一個postgresql.jar到jre7\lib\