GBase XDM Cluster 简介

GBase XDM Cluster ，南大通用极速内存数据库管理系统，包括数据服务器 GBase XDM Cluster Server 、客户端 GBase XDM Cluster Client 、管理服务器 GBase XDM Cluster Admin Server 和管理服务器控制台 GBase XDM Cluster Admin Console 四部分。

GBase XDM Cluster 在记录数据容量、添加与查询性能、传输安全、集群分片部署支持等方面有显著优势。管理服务器综合了对数据服务器管理的各种功能，极大地降低了配置和维护数据服务器的难度。

1.    安装与初始化

本安装手册只介绍 Linux 系统上数据服务器、管理服务器安装过程。客户端、管理服务器控制台安装参考其它手册。本安装手册以 Redhat Linux AS5 系统上安装为例，说明安装与初始化过程。

因为安装时要检查、更新系统动态 库环境，所以安装时请用 root 身份。

安装界面上每个设置选项都由一个高亮度、反颜色显示的大写字母标示。光标闪烁处，输入标示字母（不区分大小写），“ Enter ”键提交，提示设置该选项值。看到提示语句后，用户在光标闪烁处输入选项值，“ Enter ”键提交，完成设置。用户对所有设置满意后，等待标示字母输入处输入“ n ”或“ N ”并用“ Enter ”键提交进入下一个界面或者开始安装；输入“ q ”或“ Q ”提交后将退出安装。如果输入有误，请用“ Ctrl ”键加退格键清除已输入字母。

1.1.         安装开始

GBase XDM ClusterLinux 版采用光盘形式发布。因为安装时会在当前路径下 生成临时文件，所以请勿在加载后的光盘路径中直接安装。把安装文件复制到一个有写权限的存储路径下，建议该存储路径下剩余存储空间不低于 1G 。检查安装文件是否有执行权限。如果文件不是可执行文件，请把文件加上执行权限。这样执行安装文件即可安装。主要命令参考如下：

加载光盘： mount  /dev/cdrom  /mnt/cdrom

复制文件： cp  /mnt/cdrom/< 安装文件名 >  < 目标路径 >

安装文件加执行权限： chmod  +x  < 安装文件 >

执行安装文件： ./< 安装文件 >

1.2.         软件许可证协议

图 4-1 中，用户安装 GBase XDM Cluster ，必须阅读、接受软件许可证协议。可以使用“空格键”逐屏阅读协议。如果不同意协议内容，可以在提示信息“ Do you agree to the above license terms? [yes or no] ”后输入“ no ”退出安装。输入“ yes ”开始解包安装。

图4-1

安装设置界面

图 4-2 中，用户可以设置安装基本信息。基本设置内容包括安装路径、数据库路径、是否批量远程安装、是否安装 GBase XDM Cluster Admin Server 、是否安装 GBase XDM Cluster Admin Console 、是否安装 GBase XDM Cluster Client 、是否安装 jre （ Java Runtime Environment ），下面逐一介绍。

图4-2

1.3.1. 安装路径

图 4-2 中，“ set installing Path ”提示设置安装路径。该选项由字母“ P ”标示。安装路径是 GBase XDM Cluster 在本地系统的安装位置。默认路径是 /usr/local/GBaseXDM6 。因为要向安装路径下复制文件，所以用户对此路径必须有写权限，并且该路径下剩余存储空间不低于 1G 。

下面以设置安装路径选项为例详细说明重新设置选项值过程，本安装手册将不再一一介绍其它选项设置方法。

如果不满意默认安装路径，用户可以使用标示字母“ P ”重新设置该选项值。

输入“ p ”，“ Enter ”键提交后，界面如图 4-3 所示。

图4-3

如图 4-4 所示，看到提示语句后，在下面光标闪烁处输入选项值。

图4-4

按“ Enter ”键提交选项值，如果输入选项值符合安装程序要求，安装程序接受输入值并在设置主界面中显示，如图 4-5 所示。至此完成了新的设置。如果输入选项值不符合安装程序要求，会继续提示输入选项值。

图4-5

1.3.2. 数据库路径

图 4-2 中，“ set Database path ”提示设置数据库路径。该选项由字母“ D ”标示。数据库路径是 GBase XDM Cluster 安装后，数据库存放的位置。它有两种情况：第一种，数据库路径设定为安装路径下的“ ldap/db ”路径，随安装路径改变而改变，用户不用设置；第二种，如果用户不满意这个设定，可以使用标示字母“ D ”重新设置该选项值，设置成功后第一种情况下的数据库路径不再起作用。无论哪种情况，用户对该路径必须有写权限。建议设置在较大存储空间处。

1.3.3. 是否批量远程安装Batch Remote Servers

图 4-2 中，“ install GBase XDM Cluster V6.3 64bit Batch Remote Servers ”提示是否启用批量远程安装。该选项由字母“ B ”标示。默认设成非批量远程安装，也即本地单个 Server 安装。如果不满意默认值，用户可以使用标示字母“ B ”重新设置该选项值。如果有多个 Server 需要安装时，如 XDM 集群，可以启用该选项，该选项的功能生效需要提前在安装包的同级路径中放置维护好若干 Server 信息的 remote.csv 文件，该配置文件模版及参数用法请在安装盘的 add-ons 文件中获取。

1.3.4. 是否安装GBase XDM Cluster Admin Server

图 4-2 中，“ install GBaseXDM 6.3 64bit Admin Server section ”提示是否安装 GBase XDM Cluster Admin Server 。该选项由字母“ A ”标示。默认设成安装。如果不满意默认值，用户可以使用标示字母“ A ”重新设置该选项值。

1.3.5. 是否安装GBase XDM Cluster Admin Console

图 4-2 中，“ install GBaseXDM 6.3 64bit Admin Console section ”提示是否安装 GBase XDM Cluster Admin Console 。该选项由字母“ C ”标示。默认设成安装。如果不满意默认值，用户可以使用标示字母“ C ”重新设置该选项值。

1.3.6. 是否安装GBase XDM Cluster Client

图 4-2 中，“ install GBaseXDM 6.3 64bit CLien sectiont ”提示是否安装 GBase XDM Cluster Client 。该选项由字母“ L ”标示。默认设成安装。如果不满意默认值，用户可以使用标示字母“ L ”重新设置该选项值。

1.3.7. 是否安装jre

图 4-2 中，“ install Jre Section ”提示是否安装 jre 。该选项由字母“ J ”标示。默认设成安装。如果不满意默认值，用户可以使用标示字母“ J ”重新设置该选项值。

1.4. 数据服务器设置界面

图 4-6 界面中，用户可以设置数据服务器基本信息。下面逐一介绍各个设置选项。

图4-6

1.4.1. 服务器ID

图 4-6 中，“ set the serverID of the syncrepl xdm server ”提示设置本服务器的 serverID 。该选项由字母“ I ”标示。该 serverID 用来区别使用推拉复制的其它数据服务器。默认设成“ 11 ”。如果在推拉复制范围内该值已被设置，用户应该使用标示字母“ I ”重新设置该选项值。

1.4.2. 数据库名字

图 4-6 中，“ set the name of initializing Database ”提示设置初始化数据库的名称。该选项由字母“ D ”标示。这个名字用来标示前面设定的“数据库路径”下存放的各个不同数据库。它自动加在“数据库路径”后面，和“数据库路径”一起作为存储该数据库文件的路径。默认设成“ database1 ”。如果不满意默认值，用户可以使用标示字母“ D ”重新设置该选项值。

类型

图 4-6 中，“ set the type of Suffix ”提示设置 suffix 类型。该选项由字母“ S ”标示。 suffix 是将要创建的 XDM 数据库的根 DN( 分辨名， Distinguished Name) ，它规定了什么样的条目可以添加到该数据库中。 suffix 形式是指 suffix 的 OID(Object Identifiers) 类型。通用形式有四种：“ o ”表示某个组织，“ c ”表示某个国家，“ dc ”表示某个域，“ st ”用来设置形如“ st=11,c=cn ”的 suffix 。用户还可以选择“ none ”，这样安装程序将不再接受数据库选项值输入，安装完成后的数据服务器配置文件中也没有具体数据库配置信息。默认设成“ dc ”类型。如果不满意默认值，用户可以使用标示字母“ S ”重新设置该选项值。

值

图 4-6 中，“ set the Value of suffix ”提示设置 suffix 值。该选项由字母“ V ”标示。安装程序将根据输入 suffix 建立数据库，并在库中新建一个以 suffix 作 DN 的根条目。“ o ”类型默认值是“ o=itec.com ”，“ c ”类型默认值是“ c=cn ”，“ dc ”类型默认值是“ dc=CT ”，“ st ” 类型默认值是“ st=11,c=cn ”。如果不满意默认值，用户可以使用标示字母“ V ”重新设置该选项值。

    suffix 值输入要完整，例如： o=content 。请参考默认格式输入。请勿仅仅输入 content 。

1.4.5. 数据服务器端口号

图 4-6 中，“ set the Port of server ”提示设置数据服务器端口号。该选项由字母“ P ”标示。默认端口号是 IANA （ Internet Assigned Numbers Authority ）分配给 LDAP 的 389 。 IANA 分配给 LDAPS( 基于 SSL 的 LDAP) 的端口号是 636 。如果不满意默认值，用户可以使用标示字母“ P ”重新设置该选项值。用户选择的端口号不应与操作系统或其他软件冲突，否则可能出现错误。

1.4.6. 拆分复制日志模式

图 4-6 中，“ set the split replica Log mode support ”提示设置是否启用复制日志拆分模式。该选项由字母“ L ”标示。默认值为“ n ”，即不采用拆分复制日志模式。如果用户希望使用拆分复制日志模式，请选择“ y ”。可以使用标示字母“ L ”重新设置该选项值。设置为启用拆分模式后，在安装后的 slapd.conf 中会加入全局参数“ split_public_replog on ”。

1.4.7. 数据服务器rootdn

图 4-6 中，“ set the Rootdn of database ”提示设置数据服务器 rootdn 。该选项由字母“ R ”标示。 rootdn 是数据服务器数据库的管理员。管理员是一个特殊的虚拟记录，并不实际存在于数据库中。但管理员 DN 必须以 suffix 结尾。默认值是“ cn=Directory Manager ”。如果不满意默认值，用户可以使用标示字母“ R ”重新设置该选项值。用户不必输入管理员 DN 中的 suffix 部分，安装程序会自动补齐。例如默认形式：

suffix ：                    dc=CT

用户输入的管理员条目 DN ： cn=Directory Manager

实际的管理员条目 DN ：     cn=Directory Manager,dc=CT

1.4.8.rootdn 的密码

图 4-6 中，“ set the passWord of rootdn ”提示设置 rootdn 的密码。该选项由字母“ W ”标示。默认值是“ secret ”。如果不满意默认值，用户可以使用标示字母“ W ”重新设置该选项值。                 

1.5. 管理服务器设置界面

如果选择安装 GBase XDM ClusterAdmin Server ，通过图 4-7 界面可以设置管理服务器基本信息。下面逐一介绍各个设置选项。

图4-7

1.5.1. 管理服务器端口号

图 4-7 中，“ set the Port of admin server ”提示设置管理服务器端口号。该选项由字母“ P ”标示。默认值是 2008 。如果不满意默认值，用户可以使用标示字母“ P ”重新设置该选项值。用户选择的端口号不应与操作系统或其他软件冲突，否则可能出现错误。

1.5.2. 备份路径

图 4-7 中，“ set the Backup path ”提示设置备份路径。该选项由字母“ B ”标示。备份路径是管理服务器备份数据服务器后备份文件存放路径。它有两种情况：第一种，备份路径设定为安装路径下的“ ldap/backup ”路径，随安装路径改变而改变，用户不用设置；第二种，如果用户不满意这个设定，可以使用标示字母“ B ”重新设置该选项值，设置成功后第一种情况下的备份路径不再起作用。

1.6. 安装执行

设置完成后，将向安装路径下安装 GBase XDM Cluster ，并检查、更新系统一些动态链接库。图 4-8 是安装完成后的一个界面。安装信息将被记录在安装路径下的 install.log 文件中。

图4-8

2.     启动

安装成功后，进入安装路径，如果完全安装可以看到若干个文件目录和二个文件。 admin 目录下存放管理服务器， adminconsole 目录下存放管理服务器控制台， client 目录下存放客户端， jre 目录下存放 java 运行环境， ldap 目录下存放数据服务器， lib 目录下存放安装程序提供的动态链接库， install.log 是安装记录文件， VERSION.txt 是 GBase XDM Cluster 版本文件。

2.1. 启动、停止 数据服务器

ldap 路径下有可执行文件： startslapd 、 stopslapd 。执行这两个文件启动、停止数据服务器。

2.2. 启动停止管理服务器

  admin/bin 路径下有可执行文件： startadmin ， stopadmin 。执行这两个文件启动、停止管理服务器。

官网：