更新日期：2024年09月11日
API）
随同 admin() 或 task() 函数，使用 checkpoint 参数来强制一检查点。
语法
用法
这个函数强制一检查点，经缓冲区清空到磁盘。如果逻辑日志中最近的检查点记录阻止释
放逻辑日志文件（状态 U-B-L），则可使用这个函数来强制一检查点。
使用 block 参数来防止数据库服务器处理任何事物。在 GBase
8s 上使用这个选项执行外
部备份。在数据库服务器阻塞时，用户不可访问它，除非在只读模式中。直到解除数据库
服务器阻塞，事务才可完成。
使用 hard 参数来强制一阻塞检查点。这是缺省情况。
使用 norm 参数来强制一非阻塞检查点。
使用 unblock 参数来解除数据库服务器阻塞。当解除数据库服务器阻塞时，可恢复数据事
务和正常的数据库服务器操作。请在 GBase 8s 上完成外部备份之后使用这个选项。
这个函数等同于 onmode -c 命令。
示例
下列示例启用一阻塞检查点：
EXECUTE FUNCTION task("checkpoint","block");
下表对比了 Client SDK 和 GBase 8s Connect 的四种备选安装方法。
该表使用了命令格式的 Client SDK 安装示例；对于 GBase 8s Connect 安装，请替
换相应的 GBase 8s Connect 命令。
表 1. 备用安装方法
安装方
法
命令格式
安装的产
品
使用的理由
限制
静默安
装
./installclientsdk
-silent -options
mysilent.ini
./installclientsdk
-i silent -f
path_name
用于以定
制配置安
装 Client
SDK 或
GBase 8s
Connect
使用预设置的
安装文件
（.ini
文件）
，
此文件
可保存并作为
模板复用
通过使用响应
文件（在 -f
path_name 选
项中调用）
，
只
需使用极少或
不使用任何用
户交互，
即可复
制多台计算机
上的特定安装
配置。
对于某些
以 root 用户身份安装。
除非在命令行指定
-acceptlicense=yes，或
将 -W lafiles.license
Accepted 属性设为值
true，否则安装将无法继
续。
如果使用
csdk.properties 或
conn.properties 文件作
为响应文件的模板，必须
更改响应文件设置以接受
许可条款协议。要接受许
可条款协议，请将
LICENSE_ACCEPTED=FALSE
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 25 -
安装方
法
命令格式
安装的产
品
使用的理由
限制
用户场景，
静默
安装可以节约
很多时间。
更新为
LICENSE_ACCEPTED=TRUE
使用命
令行脚
本解压
./installclientsdk
-legacy
./installclientsdk
-DLEGACY=TRUE
用于单独
安装
Client
SDK
或 GBase
8s
Connect。
使用命令行解
压来进行安装
的备用方法在
以下某个场景
中会很有帮助：
•
您希望
安装产品以
将其快速重
新分发到多
台计算机，
并且占用的
磁盘空间极
少
•
您希望
在产品重新
分发期间避
免使用
Java™ 运行
时环境
(JRE)
无
直接调
用 JAR
文件
java -cp csdk.jar
run
用于以特
定于产品
的命令安
装 Client
是较快的安装
方法
要使用此安装选项，
必须有
JRE V1.3.2 或更高版本。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 26 -
安装方
法
命令格式
安装的产
品
使用的理由
限制
SDK 或
GBase 8s
Connect
表 2. 备用安装方法
安装方
法
命令格式
安装的产品
使用的理由
限制
静默安
装
./installclientsdk
-silent -options
mysilent.ini
./installclientsdk
-i silent -f
path_name
用于以特定
于产品的命
令安装
Client SDK
或 GBase
8s Connect
使用预设置的
安装文件
（.ini
文件），此文件
可保存并作为
模板复用
通过使用响应
文件（在 -f
path_name 选
项中调用），只
需使用极少或
不使用任何用
户交互，
即可复
制多台计算机
上的特定安装
配置。
对于某些
用户场景，
静默
安装可以节约
很多时间。
以 root 用户身份安
装。除非在命令行指定
-acceptlicense=yes，
或将 -W
lafiles.license
Accepted 属性设为值
true，否则安装将无法
继续。
如果使用
bundle.properties 文
件作为响应文件的模
板，必须将产品许可条
款协议的响应文件设置
更改为“Accept”，该
文件才能在静默安装期
间起作用。
使用命
令行脚
./installclientsdk
用于单独安
装 Client
使用命令行解
无
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 27 -
安装方
法
命令格式
安装的产品
使用的理由
限制
本解压
-legacy
./installclientsdk
-DLEGACY=TRUE
SDK 或
GBase 8s
Connect。
压来进行安装
的备用方法在
以下某个场景
中会很有帮助：
•
您希望
安装产品以
将其快速重
新分发到多
台计算机，
并且占用的
磁盘空间极
少
•
您希望
在产品重新
分发期间避
免使用
Java 运行
时环境
(JRE)
以静默方式安装
在编辑 .ini 文件中的属性后，
可以在无用户交互的情况下安装 Client
SDK 和
GBase 8s Connect。 下列语法图说明了静默安装的安装选项。
静默安装语法
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 28 -
表 1. 静默安装选项的元素
元素
用途
限制
optionfile
指定要预设置安装属性的 .ini 文件的文件名
无
Java™ dir
指定安装期间要使用的主机上的 JRE，
以代替安装程序提供
的 JRE
该 JRE 必须是
V1.4.2 或更高
版本。
logfilename
指定非缺省日志文件名
无
temp path
指定临时目录的路径。如果文件解压期间收到错误消息，表
示 /tmp 目录中没有足够空间，
那么请将 -tempdir 选项设
为其他临时目录。
无
下表描述了静默安装选项。
表 2. 静默安装选项
选项
含义
-silent
将安装程序设为静默方式
-acceptlicense=yes
接受许可协议
-options
提供用于预设置安装属性的 .ini 文件的位置
installconn
仅安装 GBase 8s Connect
installclientsdk
仅安装 Client SDK
-log
记录安装程序的进度
-javahome
使用指定的 JRE。要强制安装程序使用捆绑的 JRE 并忽略任何本地
JRE，请使用 -javahome none 参数。
-tempdir
指向除 /tmp 以外的临时目录
-is:freediskblocks
开始安装之前用来确定是否有足够的空间可用于产品安装文件。
-is:nospacecheck
用来阻止安装程序检查是否有足够的空间可用于产品安装文件。请谨
慎使用：如果没有足够空间来解压临时文件，那么安装程序将会失败。
-help-?
显示所支持选项以及它们的功能的列表
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 29 -
要执行 Client SDK 的静默安装，可以修改 csdk.ini 文件中的值，以设置属
性或接受缺省值。
要执行 GBase 8s Connect 的静默安装，可以修改 conn.ini 文件中的值，或
接受缺省值。
下表描述了这些属性。
表 3. silent.ini 文件的属性
属性
可能的值
描述
-P installLocation=
有效的目录；例如：
/usr/gbasedbt（缺省
值）
指定要安装产品的目录
-W setupTypes.selectedSetupTypeId=
typical（缺省值）
custom
指定安装类型
-P csdk.active=
true
false（缺省值）
指示是否选定产品或功能部
件以进行安装。
GBase 8s Connect 和完整
Client SDK 不能同时安装，
也不能安装在同一位置。
-P iconnect.active=
true（缺省值）
false
指示是否选定产品或功能部
件以进行安装。
GBase 8s Connect 和
Client SDK 不能同时安装。
-SP CSDK/UNIX/csdk.jar
clientfeature.active=
true（缺省值）
false
指示是否选定产品或功能部
件以进行安装。
仅适用于“定制”选项的
Client SDK 安装。
-P messagesfeature.active=
true（缺省值）
false
指示是否选定错误消息功能
部件以进行安装
-P glsfeature.active=
true（缺省值）
false
指示是否选定错误 GLS 功
能部件以进行安装
-G licenseAccepted
true
false
接受许可协议。false 值会
停止安装过程。如果在命令
行接受许可协议，那么无需
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 30 -
属性
可能的值
描述
任何值。
可以在
$MEDIADIR/doc/license 中
找到许可协议。
执行静默安装
按照以下步骤执行静默安装。
要执行静默安装：
1.
将 csdk.ini 或 conn.ini 复制到任何可读取的位置，并重命名：
myclient.ini。
2.
编辑目录中的 *.ini 文件。
使用此文件，以指定选项配置安装。在指定静默安装时，如果不编辑这些值或指定
*.ini 文件，安装程序将使用缺省值。
3.
以 root 用户身份，使用以下方式运行 Client SDK 或 GBase 8s Connect 的
静默安装：
installclientsdk -silent -options myclient.ini
或者使用以下方式运行 GBase 8s Connect 的静默安装：
installconn -silent -options myclient.ini
在 UNIX™ 和 Linux™ 上执行静默客户机产品安装
要执行静默安装（有时称为无人照管安装），必须创建响应文件，其中包含有
关希望如何安装产品的信息。可在命令行选项中调用此响应文件以执行静默安
装。
必须以 root 用户身份登录才能运行安装应用程序。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 31 -
注意： 如果使用 csdk.properties 文件或 conn.properties 文件作为响应文件的模板，必须
将产品许可条款协议的响应文件设置更改为“Accept”，该文件才能在静默安装期间起作用。
要在多个目录中部署 Client SDK 或 GBase 8s Connect：
1.
通过执行以下某项操作来创建响应文件：
l
在命令行上，以 GUI 或控制台方式启动产品安装应用程序，并指定 -r
选项以生成响应文件。
l
保存安装介质上 csdk.properties 文件或 conn.properties 文件的
本地副本，重命名该文件，并配置环境设置以及同意许可条款。跳至步骤
3。
2.
将响应文件复制到要安装客户机产品的计算机。
3.
针对要安装的一个或多个产品运行静默安装命令，同时在 -f 选项后指明响应
文件的绝对路径：
l
./installclientsdk -i silent -f path_name，用来安装 Client SDK。
l
./installconnect -i silent -f path_name，用来安装 GBase 8s
Connect。
4.
为要部署相同安装设置的每个位置重复步骤 2 和 3。
通过命令行脚本使用解压来安装
作为使用安装程序的备选，您可以生成基于脚本的可安装介质，并且可以在以
后使用命令行选项来安装 Client SDK 和 GBase 8s Connect。解压方式使用安
装程序来解压介质并提供“软件许可协议”。解压以后，当您准备安装产品时，
必须运行命令行安装脚本。
解压语法
下表说明了语法元素。
表 1. 语法元素
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 32 -
元素
用途
限制
Java™ dir
指定安装期间要使用的主机上的 JRE，以代替安装程序
提供的 JRE
该 JRE 必须是
V1.4.2 或更高
版本。
logfilename
指定非缺省日志文件名
无
temp path
指定临时目录的路径。如果文件解压期间收到错误消息，
表示 /tmp 目录中没有足够空间，那么请将 -tempdir
选项设为其他临时目录。
无
下表描述了解压选项。
表 2. 安装选项
选项
含义
installconn
仅抽取 GBase 8s Connect
installclientsdk
仅抽取 Client SDK
-gui
以 GUI 方式启动解压过程
-log
记录安装程序的进度
-javahome
使用指定的 JRE。
要强制安装程序使用捆绑的 JRE 并忽略任何本地
JRE，请使用 -javahome none 参数。
-tempdir
指向除 /tmp 以外的临时目录
-is:freediskblocks 开始解压之前用来确定是否有足够的空间可用于产品安装文件。
-is:nospacecheck
用来阻止安装程序检查是否有足够的空间可用于产品安装文件。请
谨慎使用：如果没有足够空间来解压临时文件，那么解压程序将会
失败。
-help
显示所支持选项以及它们的功能的列表
在此安装以后，不会出现提供安装的 JRE，也不会出现卸载程序。
如果想将产品安装在不同位置或重新分发产品，请使用该选项。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 33 -
使用脚本解压并重新分发客户机产品
可以使用带 -DLEGACY=TRUE 选项的安装命令从 GBase 8s 客户机产品介质解压
文件，然后使用脚本将软件重新分发到其他计算机。此方法仅在 UNIX™ 和
Linux™ 操作系统上可用。
如果要解压客户机产品文件以在不将 JRE 或卸载应用程序添加到多个主机系统的情况下重新
分发这些文件，请使用这种命令格式。通过在一台计算机上使用 -DLEGACY=TRUE 命令启动安装
应用程序来解压产品文件。完成安装应用程序的运行后，可以复制第一台计算机的安装目录中
的文件，以将产品重新分发到其他计算机上。
1.
根据您要使用的产品，运行以下某个命令：
l
./installclientsdk -DLEGACY=TRUE
l
./installconnect -DLEGACY=TRUE
缺省情况下安装应用程序以控制台方式打开。如果要以 GUI 方式运行安装应用程
序，请在命令末尾输入 -i gui 选项。
2.
遵循安装应用程序中的指示信息。
3.
复制安装目录的内容，并将它们放入要重新分发产品的其他计算机的目录中。
这些内容包括用于重新分发的 RUNasroot 脚本。
4.
为要在其他计算机上部署的产品运行脚本。
可以在一个位置中部署 Client SDK 或 GBase 8s Connect，但不能两者都部署。
选项
描述
RUNasroot.installclientsdk
完成 Client SDK 文件的重新分发。
RUNasroot.installconnect
完成 GBase 8s Connect 文件的重新分发。
以命令行抽取方式安装 Client SDK 和 GBase 8s Connect
使用这些指示信息以命令行抽取方式安装 Client SDK 和 GBase 8s Connect。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 34 -
要以命令行抽取方式安装 Client SDK 和 GBase 8s Connect：
1.
以 root 用户身份，运行下列一个选项以解压产品文件：
./installclientsdk -legacy
或
./installconn -legacy
安装程序用于抽取。
可以按缺省控制台方式或 GUI 方式使用 -legacy 参数，但不能以静默安装方式使
用。以下指示信息适用于缺省控制台方式。
2.
输入 1 在安装屏幕之间前进。
此时会显示“软件许可协议”。
3.
阅读许可协议后，输入 1 接受条款。
4.
指定安装目录或接受缺省目录。
将解压客户机产品和安装文件。
5.
选择“完成”退出向导。
可安装介质现在已可用。此时，可以复制、归档或分发文件。然后，您可以在不使
用安装程序或 Java™ 的情况下来安装 Client SDK 或 GBase 8s Connect。
6.
要安装 Client SDK 或 GBase 8s Connect，请将 $GBASEDBTDIR 设为可单独安
装产品的目标目录，并且以 root 用户身份运行安装脚本：
./installclientsdk
或
./installconn
通过直接调用 JAR 文件进行安装
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 35 -
以下语法图说明了直接调用 Client SDK 或 GBase 8s Connect .jar 文件时可
以使用的安装选项。要使用此安装选项，必须有 JRE V1.3.2 或更高版本。
直接 JAR 调用安装语法
表 1. 调用 JAR 的安装选项的元素
元素
用途
限制
relative_directory
指定所指定 .jar 文件的路径。如果从 .jar 文
件所在的目录运行命令，那么不要指定路径。
无
logfile
指定非缺省日志文件名
无
optionfile
指定要预设置安装属性的 .ini 文件的文件名
无
下表描述了 Java 调用的应用程序选项。
表 2. 调用 JAR 的安装选项
选项
含义
csdk.jar
Client SDK 的安装应用程序
conn.jar
GBase 8s Connect 的安装应用程序
-P legacy.active=true 解压文件但不安装产品
-p logfile
记录安装程序的进度
-is:freediskblocks
开始安装之前用来确定是否有足够的空间可用于产品安装文件。
-is:nospacecheck
用来阻止安装程序检查是否有足够的空间可用于产品安装文件。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 36 -
选项
含义
请谨慎使用：
如果没有足够空间来解压临时文件，
那么安装程序
将会失败。
-swing
将调用 Java™ 的应用程序设置为 GUI 方式
-silent
将调用 Java 的应用程序设置为静默方式
-options
与 optionfile 一起使用。
指定要预设置安装属性的 .ini 文件
的文件名
通过调用 JAR 文件来安装 Client SDK 或 GBase 8s Connect
可通过直接调用 JAR 文件进行安装 Client SDK 或 GBase 8s Connect。
要通过直接调用 JAR 文件进行安装 Client SDK 或 GBase 8s Connect：
使用与要安装产品相对应的命令在安装应用程序上调用 Java™，例如：
java -cp csdk.jar run
必须从 csdk.jar 文件的目录中运行此命令。