安装到Linux系统

1.安装模式

优炫数据库根据用户操作习惯的不同，提供命令行安装、静默安装、图形化安装方式安装部署优炫数据库管理系统UXDB。

2.安装前准备

在安装开始之前，首先应该检查所得到的UXDB产品是否完整，并准备好UXDB所需的硬件环境、软件环境。本章主要介绍在安装UXDB产品前需要进行的准备工作。

2.1.硬件环境需求

用户应根据UXDB及应用系统的需求来选择合适的硬件配置，如CPU的指标、内存及磁盘容量等。作为数据库服务端的机器，硬件环境档次一般应尽可能高一些，基于Java的程序运行时最好有较大的内存。其他设备如不间断电源（UPS）等在重要应用中也应考虑。安装UXDB所需的硬件最低配置：

由于UXDB是基于客户/服务器方式的大型数据库管理系统，一般应在网络环境下使用，客户端和服务端分别在不同的机器上，所以硬件环境通常包括网络环境（如一个局域网）。

2.2.软件环境需求

2.2.1.操作系统要求

2.2.2.服务器字符集要求

安装之前应检测系统设置的字符集。部分字符集不支持做UXDB服务端编码（初始化数据目录等操作会产生错误），支持的字符集请参见：

客户/服务器字符集转换表

修改字符可参考如下方法（以centos7为例）。

1. root用户登录，查看当前字符集。

   echo $LANG
   

2. 修改/etc/locale.conf配置文件并保存。

   vim /etc/locale.conf
   LANG="XXX"   //XXX表示需要使用的字符集
   

3. 使配置文件生效并查看。

   source /etc/locale.conf
   echo $LANG
   

2.3.计算机管理员准备工作

在安装UXDB之前，计算机管理员正确地安装操作系统、合理地分配磁盘空间、检查机器配置是否满足要求。还要做好以下主要准备工作。

• 创建uxdb用户

  为减少对操作系统的影响，不建议用户以root用户来安装UXDB。用户可以在安装之前用root用户为UXDB创建一个专门的系统用户，

• 开启指定端口

  安装UXDB前，首先要开启以下端口。

  1. 默认创建数据目录使用的端口（52025）。
  2. 使用到的其他端口。

2.3.1.创建uxdb用户

1. 创建uxdb用户。

   su - root
   useradd uxdb
   passwd uxdb
   

   在UOS下需使用adduser创建用户。

2. 编辑sudoers文件添加uxdb用户，为uxdb用户添加sudo权限。

   visudo
   

   找到## Allow root to run any commands anywhere一行并添加如下内容，保存并退出。

   ## Allow root to run any commands anywhere
   root    ALL=(ALL)     ALL
   uxdb    ALL=(ALL)     ALL
   

2.3.2.开启指定端口

以centos7 52025端口号为例，操作方法如下。

1. 添加

   firewall-cmd --zone=public --add-port=52025/tcp --permanent
   firewall-cmd --reload
   

2. 查看

   firewall-cmd --zone=public --query-port=52025/tcp
   

3. 删除

   firewall-cmd --zone=public --remove-port=52025/tcp --permanent
   

4. 查看所有开启的端口

   firewall-cmd --zone=public --list-ports
   

2.4.用户准备

UXDB是一款基于客户端/服务器端架构的数据库管理系统。服务端可兼做客户端。在计算机管理员的准备工作都已完成之后，uxdb用户在安装过程中必须注意以下几点。

1. 若系统中已安装UXDB，在重新安装前，应完全卸载原来的UXDB（注：重新安装前，需要备份好数据），若需要切换不同用户安装或卸载UXDB数据库，请在切换用户时，将当前已经使用过数据库的用户注销，再登录管理员用户进行安装或卸载，避免出现资源占用导致安装或卸载失败的情况。
2. 作为服务端的每台计算机必须安装服务端组件，只作为客户端的计算机不必安装服务端组件。
3. 作为客户端的每台计算机可在所有客户端组件中选择安装所需要的客户端组件。

3.安装和卸载

注意

1. UXDB不支持重复安装。

2. 如果安装包没有可执行权限，需要赋予可执行权限。

   chmod a+x uxdb-std-x86_64-v2.1.2.2.run
   

注意
凝思60系统安装数据库前需要执行以下操作。

1. 升级automake版本。

   tar -zxvf automake-1.12.1.tar.gz
   cd automake-1.12.1
   ./confiugre
   make -j8
   sudo make install
   

2. 安装liblzma包。

   tar -zxvf liblzma-5.2.2.tar.gz
   cd liblzma-5.2.2
   ./autogen.sh
   ./configure --prefix=/usr
   make -j8
   sudo make install
   

3. 安装coreutils。 .bashrc文件中添加内容alias mkdir_p='mkdir -p'；并执行source ~/.bashrc使环境变量生效。
   下载coreutils-8.22.tar.gz安装包并解压，然后编译安装。

   configure --prefix=/usr;
   make;
   make install
   

3.1.命令交互安装及卸载

本次安装、卸载过程以UXDB for Linux v2.1.2.2标准版、Linux-x86_64 CentOS 7操作系统、环境语言是中文为例。

3.1.1.安装

1. 执行安装包文件uxdb-std-x86_64-v2.1.2.2.run

   选择命令行，回车进入下一步。

2. 选择语言

   默认语言是中文，回车进入下一步。

3. 欢迎页面根据提示输入1，回车进入下一步。

4. 产品简介

   查看产品信息，根据提示输入1，回车进入下一步。

5. 许可协议页面

   查看许可协议，根据提示输入1，回车进入下一步。

6. 用户数据页面

   默认用户是uxdb，回车选择使用默认用户，根据提示输入1，如下所示：

7. 安装路径页面

   用户可以输入安装路径，不输入则使用默认路径，默认路径为/opt/uxdbinstall，如下所示：

8. 选择安装包

   根据提示输入1，回车进入下一步。

9. 环境检测

   进行环境监测，如下所示：若存在问题，请解决之后重新检测，也可联系优炫数据库技术人员进行解决。根据提示输入，回车进入下一步。

   

10. 加载Lincese

    若存在license文件，需要手动输入license文件的文件夹路径；若不存在license文件，输入1进入下一步。

    

11. 安装

    安装完成自动进入下一步，此步骤无需操作。

12. 数据库初始化

    选择“是”则进行数据库初始化的操作，如选择“否”则直接跳转到安装完成界面，后续需手动初始化，本次选择“是”。

13. 初始化实例

    用户可以输入数据库目录，也可以使用数据库目录默认路径，默认路径为/opt/uxdbinstall/dbsql/data/dbhome_1。

    a. 选择数据库模式，根据需求选择Standard模式、Oracle模式或者MySQL模式，默认使用Standard模式。

    b. 选择是否开启安全功能，默认选择不开启。开启安全功能，则添加增加是否开启全库加密选项，默认选择开启且默认开启审计加密功能，且审计加密功能不能关闭；如果不开启全库加密功能，则新增是否开启审计加密选项，默认选择开启。

    c. 选择是否注册服务，选择是则添加注册服务名称，默认为“UxdbServer"，选择否则不用填写注册服务名称。

    d. 选择实例初始化后是否启动，默认选择否，这里选择是。

    e. 填写密码，未开启安全功能填写超级用户的密码，已开启安全功能填写uxsmo、uxsao、uxsso的密码，三者为同一个密码。

    f. 选择数据库编码，使用默认值。

    根据提示输入1，回车进入下一步。

    

14. 执行额外程序

    此步骤无需操作，执行结果如下所示：

    

15. 安装完成

    • 不生成自动安装脚本
      输入N，然后回车，安装成功。

      

    • 生成自动安装脚本
      输入Y，回车；输入路径，不输入则使用默认路径，默认路径为/opt/uxdbinstall/auto-install.xml。

16. 导入license

    导入licence参见获取许可证（License），即可使用数据库。

3.1.2.卸载

1. 运行卸载程序

   切换root用户进入卸载目录，默认路径为/opt/uxdbinstall/uninstaller，执行uninstall文件，输入1选择命令行，回车后确认卸载，选择Yes，卸载完成。

2. 如果有进程正在运行，则显示提示信息并退出卸载程序

3.2.图形化安装及卸载

本次安装、卸载过程以UXDB for Linux v2.1.2.2标准版、Linux-x86_64 CentOS 7操作系统、环境语言是中文为例。

3.2.1.安装

1. 执行安装包

   以root用户执行uxdb-std-x86_64-v2.1.2.2.run安装包，如下所示：

   ./uxdb-std-x86_64-v2.1.2.2.run
   

2. 选择图形化安装

   根据提示输入0，选择图形化安装，回车进行下一步。

   

3. 选择安装过程的语言

   选择安装过程的语言，单击“OK”。支持中英文两种语言，若系统为中文环境，则默认选择中文；若系统为非中文环境，则默认选择英文。后续步骤以选择中文为例。

   

4. 安装欢迎界面

   无需操作，单击“下一步”。

5. 阅读产品简介

   无需操作，单击“下一步”。

6. 阅读许可协议条款

   选择“我接受该许可协议的条款.”，单击“下一步”。

7. 创建系统用户

   输入用户名，默认创建用户为uxdb，若输入的用户名不存在，则在安装时创建此用户，单击“下一步”。

8. 选择安装路径

   安装路径根据创建的系统用户名称自动生成。以默认创建“uxdb”用户为例，安装路径为：/opt/uxdbinstall，安装路径可以通过“浏览...”自定义。然后单击“下一步”。

   如果安装路径已存在，则弹窗询问是否覆盖此目录，单击“是”，进行下一步骤；单击“否”，重新输入安装路径。

   

   如果安装路径不存在，则弹窗提示创建该路径，单击“确定”。

9. 选择安装组件

   安装分为完整安装，服务器安装，客户端安装，自定义安装4种方式，根据需要选择安装模式。

10. 环境检测

    页面自动执行环境检测程序，检测完成后，页面如下，单击”下一步”。

    若存在问题，请解决之后重新检测，可联系优炫数据库技术人员进行解决，也可选择“是”继续安装。

11. 加载License

    若存在license文件，则单击“浏览”，选择本地license文件导入，会自动将解析的license的信息显示在表格中；若不存在license文件，则安装完成后导入。单击“下一步”。

    若需要重新导入文件，单击“重置”，选择的文件和表格信息都会为空，重新单击“浏览”选择文件。

12. 安装信息预览

    显示安装目录以及选择的安装组件，单击“下一步”进行安装。

13. 执行安装程序

    页面会显示包安装过程以及总体安装进度，等包安装过程为“完成”时，单击“下一步”。

14. 数据库初始化

    是否选择初始化数据库实例，如果选择“否”，则直接跳转到安装完成页面，需后续手动实例化数据库，选择“是”，单击“下一步”。

15. 配置数据库

    根据需要进行选择，单击“下一步”。

16. 数据库初始化

    进行数据库初始化，初始化完成后单击“下一步”。

17. 安装完成

    安装完成后同时生成卸载脚本，单击“完成”。

    如果需要生成自动安装脚本，单击本页面的“生成自动安装脚本”，选择生成路径并保存。

18. 导入license

    导入licence参见获取许可证（License），即可使用数据库。

3.2.2.卸载

1. 运行卸载程序

   切换root用户，进入卸载目录，默认路径为/opt/uxdbinstall/uninstaller，执行uninstall文件，输入0选择图形化界面。

2. 卸载

   单击“卸载”按钮，进行卸载。

   卸载完成后，弹出提示框。单击“确定”。

   单击“完成”，完成卸载。

   

3. 如果有数据库正在运行，则显示提示信息并退出卸载程序。

   

3.3.静默安装

3.3.1.环境准备

1. 请联系优炫公司获取UXDB数据库安装包，如：uxdb-std-x86_64-v2.1.2.2.run。

2. 查看安装帮助信息。

   [uxdb@localhost opt]$ ./uxdb-std-x86_64-v2.1.2.2.run -h
   usage:
   uxdb-std-x86_64-v2.1.2.2.run [OPTIONS]
   
   Configuration:
   -h, --help                   display this help and exit
   --with-silent=DIR            Silent installation
   -a, --auto-install           Generate an automatic installation file
   

3. 生成静默安装文件auto-install.xml。

   [uxdb@localhost opt]$ sudo ./uxdb-std-x86_64-v2.1.2.2.run --auto-install
   Unpacking, please wait...
   Generated successfully auto-install.xml in the current path
   
   [uxdb@localhost opt]$ ll
   总用量 686228
   -rwxr-xr-x. 1 root root       5529 1月  25 11:32 auto-install.xml
   

   auto-install.xml内容如下所示：

   <?xml version="1.0" encoding="UTF-8" standalone="no"?>
   <!-- ### 以<com.izforge.izpack.panels>开头的面板统一为记录默认操作面板 -->
   <!--  #选择语言为chn 或者 eng -->
   <AutomatedInstallation langpack="chn">
   <!--  #开始面板 -->
   <com.izforge.izpack.panels.hello.HelloPanel id="HelloPanel_0"/>
   <!--  #信息面板    -->
   <com.izforge.izpack.panels.info.InfoPanel id="InfoPanel_1"/>
   <!--  #licence选择 默认同意 -->
   <com.izforge.izpack.panels.licence.LicencePanel id="LicencePanel_2"/>
   <!--  #用户选择面板	-->
   <com.izforge.izpack.panels.userinput.UserInputPanel id="createuser">
       <!--    #* 默认设置为uxdb，可修改为其他用户名称，不可设置为root用户 -->
       <entry key="usname" value="uxdb"/>
   </com.izforge.izpack.panels.userinput.UserInputPanel>
   <!--  #安装路径面板 -->
   <com.izforge.izpack.panels.target.TargetPanel id="TargetPanel_4">
       <!--    #* 默认安装路径为/opt/uxdbinstall 如有文件存在将覆盖，可修改为其他路径 -->
       <installpath>/opt/uxdbinstall</installpath>
   </com.izforge.izpack.panels.target.TargetPanel>
   <!--  #安装包选择面板 如果需要取消某个组件，请将selected的值改为false-->
   <com.izforge.izpack.panels.treepacks.TreePacksPanel id="TreePacksPanel_5">
       <pack index="0" name="Server" selected="true"/>
       <pack index="1" name="Database Server" selected="true"/>
       <pack index="2" name="Agent Server" selected="true"/>
       <pack index="3" name="Client Tools" selected="true"/>
       <pack index="4" name="UXDBAdmin" selected="true"/>
       <pack index="5" name="UXHA" selected="true"/>
       <pack index="6" name="UXDB Migrator" selected="true"/>
       <pack index="7" name="UXCC" selected="true"/>
       <pack index="8" name="Driver" selected="true"/>
       <pack index="9" name="UXDBDoc" selected="true"/>
   </com.izforge.izpack.panels.treepacks.TreePacksPanel>
   <com.izforge.izpack.panels.checkenvironment.CheckEnvPanel
           id="com.izforge.izpack.panels.checkenvironment.CheckEnvPanel_6">
       <!--   #*环境检测面板 遇WARN自动继续执行,此处即使为false也不会阻止程序继续运行 -->
       <warnContinue>true</warnContinue>
   </com.izforge.izpack.panels.checkenvironment.CheckEnvPanel>
   <com.izforge.izpack.panels.uxdblic.UxdbLicPanel id="com.izforge.izpack.panels.uxdblic.UxdbLicPanel_7">
       <LICENSE_PATH>/prjs/uxdb.lic</LICENSE_PATH>
   </com.izforge.izpack.panels.uxdblic.UxdbLicPanel>
   <com.izforge.izpack.panels.summary.SummaryPanel id="SummaryPanel_8"/>
   <com.izforge.izpack.panels.install.InstallPanel id="InstallPanel_9"/>
   <com.izforge.izpack.panels.userinput.UserInputPanel id="initializedatabase">
       <entry key="initializedatabase" value="true"/>
   </com.izforge.izpack.panels.userinput.UserInputPanel>
   <!--  #用户初始化面板 -->
   <com.izforge.izpack.panels.userinput.UserInputPanel id="createdb">
       <!--   #* 实例初始化后是否启动，默认为 false -->
       <entry key="autoStart" value="false"/>
       <!--   #* 是否开启安全功能 默认为 false，若当前选择为true，则会有显示差异 -->
       <entry key="security" value="false"/>
   
       <!--   #* 当安全功能"security=true"时，显示"fullEncryption"选项 -->
       <!--   #* 当"fullEncryption=true"时，选项"auditEncryption"默认也为true -->
       <!-- <entry key="fullEncryption" value="false"/> -->
       <!--   #* 当安全功能"security=true"并且"fullEncryption=false"时，显示"auditEncryption"选项 -->
       <!-- <entry key="auditEncryption" value="false"/> -->
   
       <!--   #* 初始密码  当安全功能"security=false"时，显示 "passwd"，屏蔽 "pwdsmo pwdsso pwdsao" -->
       <entry key="passwd" value=""/>
       <!--   #* 初始密码  当安全功能"security=true"时，屏蔽 "passwd"，显示 "pwdsmo pwdsso pwdsao"-->
       <!-- <entry key="pwdsmo" value=""/> -->
       <!-- <entry key="pwdsso" value=""/> -->
       <!-- <entry key="pwdsao" value=""/> -->
   
       <!--   #* 实例路径 -->
       <entry key="dbhomepath" value="/opt/uxdbinstall/dbsql/data/dbhome1"/>
       <!--   #* 初始化模式 默认为standard，可设置为oracle或mysql -->
       <entry key="runningMode" value="standard"/>
       <!-- <entry key="runningMode" value="oracle"/> -->
       <!-- <entry key="runningMode" value="mysql"/> -->
       <!--   #* 若初始化模式为mysql时 可增加大小写敏感设置项 默认为 false -->
       <!-- <entry key="ignoreCase" value="false"/> -->
   
       <!--   #* 自动为初始化的默认实例注册服务 默认为true  -->
       <entry key="registservice" value="true"/>
       <!--   #* 若默认实例注册服务 为true 增加服务名称输入框 默认为UxdbServer -->
       <entry key="registServiceName" value="UxdbServer"/>
   
       <!--   #* 编码方式，默认为 UTF8中文安装可设置 GBK，GB18030.ASCII。英文可设置：ASCII，UTF8 -->
       <entry key="encoding" value="UTF8"/>
   </com.izforge.izpack.panels.userinput.UserInputPanel>
   <!--  #后续初始化等脚本执行 -->
   <com.izforge.izpack.panels.process.ProcessPanel id="ProcessPanel_12"/>
   <!--  #完成面板 -->
   <com.izforge.izpack.panels.finish.FinishPanel id="FinishPanel_13"/>
   </AutomatedInstallation>
       <!-- ### 以上 '#*' 标识参数均可自定义值进行静默安装 -->
   

3.3.2.安装

1. 运行UXDB数据库安装包。

   [uxdb@localhost ~]$  sudo ./uxdb-std-x86_64-v2.1.2.2.run --with-silent=/opt/uxdbinstall/auto-install.xml
   

   --with-silent为指定auto-install.xml所在位置的绝对路径。

2. 导入license。

   导入licence参见获取许可证（License），即可使用数据库。

提示

1. 2.1.1.5C以上版本支持从run包中，通过-a参数获取静默安装模板文件，命令举例：sudo ./uxdb-std-x86_64-v2.1.2.2.run -a。
2. 2.1.1.5C及以下版本不支持第1条，仅支持在图形化安装完成页面，单击界面上的“生成自动安装脚本”，或在命令行安装时，选择生成自动安装脚本的方式，获取本次安装选项生成的auto-install.xml文件。

4.获取许可证（License）

1. 进入UXDB安装路径下的license目录。

   cd /opt/uxdbinstall/license
   

2. 执行以下程序，生成UXDB所在服务器的硬件信息文件：UxdbLicense.json。

   ./GetUserInfo.sh
   

3. 将生成的UxdbLicense.json文件发送给优炫公司License管理员，License管理员确认后，再将许可证uxdb.lic发到您的邮箱。

4. 您将uxdb.lic从邮箱中下载下来，再上传到UXDB安装路径下的license目录（/opt/uxdbinstall/license）中即可。

如您找不到优炫公司License管理员，请与400-650-7837联系。

5.数据目录的使用

5.1.本地数据目录的使用

5.1.1.创建本地数据目录

使用操作系统用户uxdb进入到UXDB安装路径的bin目录下（例如：/opt/uxdbinstall/dbsql/bin/），创建过程中需要设置数据库超级管理员uxdb的登录密码。

• 相对路径

  ./initdb -W -D ../data/uxdblocal01
  

• 绝对路径（uxdb用户对uxdblocal02有读写权限）

  ./initdb -W -D /opt/uxdbinstall/dbsql/data/uxdblocal02/
  

5.1.2.启动和停止本地数据目录

1. 启动DB server

   • 相对路径

     方法1
     ./uxdb -D ../data/uxdblocal01
     
     方法2
     ./ux_ctl -D ../data/uxdblocal01 start
     

   • 绝对路径

     方法1
     ./uxdb -D /opt/uxdbinstall/dbsql/data/uxdblocal02/
     
     方法2
     ./ux_ctl -D /opt/uxdbinstall/dbsql/data/uxdblocal02/ start
     

2. 查看DB server状态

   • 相对路径

     ./ux_ctl -D ../data/uxdblocal01 status
     

   • 绝对路径

     ./ux_ctl -D /opt/uxdbinstall/dbsql/data/uxdblocal02/ status
     

3. 停止DB server

   • 相对路径

     ./ux_ctl -D ../data/uxdblocal01 stop
     

   • 绝对路径

     ./ux_ctl -D /opt/uxdbinstall/dbsql/data/uxdblocal02/ stop
     

注意
如果安装过程中初始化数据目录并注册了服务(比如：UxdbServer)，可通过启停服务来启停数据目录，如果没有注册服务，此步骤略。

syetemctl start UxdbServer //UxdbServer为安装过程中初始化的数据目录注册的服务名
syetemctl stop UxdbServer

5.1.3.访问本地数据目录

用uxdb用户链接uxdb数据库，如下所示：

./uxsql -d uxdb -U uxdb

6.常见问题

1. 在运行数据库命令时，提示UXDB缺少.so文件。
   在运行数据库命令时，如果提示UXDB缺少.so文件问题。如下图所示：

   首先确认uxdbinstall/dbsql/lib下是否有对应版本的库文件，如果没有，则通过yum安装对应的命令；如果有，可以通过以下命令添加路径信息。

   patchelf --set-rpath {数据库库文件绝对路径} uxdb
   

   如下所示：

   patchelf --set-rpath  /home/uxdb/uxdbinstall/dbsql/lib  uxdb
   

2. 安装时/tmp目录下控件不足，解压失败。
   设置临时环境变量UXDB_INSTALL_PATH_TMP，举例如下：

   export UXDB_INSTALL_PATH_TMP=/root/uxdb_install_tmp
   

   设置环境变量后，执行run包，run包的文件会解压到上述设置的路径下。

3. gtk版本过低，导致admin无法启动。
   确认是否是gtk版本过低，执行命令rpm -q gtk3，若是3.20及以下即为版本过低。
   升级gtk，命令如下。

   yum install gtk3
   

4. 凝思6.0.80系统，因su - uxdb -c "ls"需要输入密码，导致的安装时出现初始化默认实例卡死的问题（uxdb可替换为任意非root用户）。

   • 解决方案1：强行关闭当前程序，删除当前安装的路径文件，重新执行安装程序，在是否初始化默认实例页面选择否，继续，可安装成功。

   • 解决方案2：强行关闭当前程序，删除当前安装的路径文件，在系统上按照如下方式配置后，再次执行安装程序，可以正常初始化默认实例并安装成功。

     1. 在cmd切换到root用户或以root用户打开cmd。

     2. 编辑文件：vim /etc/pam.d/su。

     3. 在上述文件中查找类似于下面的内容：

        #auth       sufficient pam_rootok.so
        

     4. 去掉上述行的#注释，保存。

     5. 使用su - uxdb -c "ls"命令检查，可不要密码直接执行，即为配置成功(uxdb可替换为当前系统存在的任意非root帐户)。

5. 若直接删除了安装路径，系统上有一些残留文件需要删除。

   1. 卸载服务（若不卸载，下次安装无法使用此服务名称注册）
      删除文件或软链接如下。
      使用附件的unregister.sh脚本，执行时需要传入需要卸载的服务名称参数，执行举例如下。

      ./unregister.sh UXDBServer
      

   2. 删除环境变量
      删除用户~/.bashrc文件中的UXDB_HOME环境变量设置，和此文件中，PATH中引用的$UXDB_HOME。

   3. 若安装了admin，需要删除admin的残留文件（不删除下次安装会覆盖为新的信息） 在路径/home/uxdb/.local/share/UXDBAdminData下，删除drivers文件夹。

7.依赖库说明