DB2 Everyplace Sync Server 的命令行脚本

以下各表列示了可用于对 DB2 Everyplace Sync Server 进行操作和管理的脚本以及运行这些脚本的正确用法。这些脚本有两个主要位置。

DB2 Everyplace Sync Server 和移动设备管理中心命令位置

DB2 Everyplace Sync Server 实例管理命令位置

UNIX/Linux 和 Windows 平台的命令非常相似(UNIX 和 Linux 脚本具有 .sh 扩展名而 Windows 批处理文件具有 .bat 扩展名这一点除外)。以下各表采用 Windows 用法,但是命令和语法在功能上与 UNIX/Linux 平台等价。

表 219. UNIX、Linux 和 Windows 的命令

命令 用途 用法
dsyadmin.bat

此命令启动“DB2 Everyplace 移动设备管理中心(MDAC)”。MDAC 提供了 GUI 来管理用户、组、预订集和预订。

有关使用 MDAC 的更多信息,请参阅什么是“移动设备管理中心”?

对于 Linux 服务器,必须在启动 MDAC 之前启动 DB2 JDBC Applet 服务器。要启动 DB2 JDBC Applet 服务器,输入 db2jstrt。DB2 JDBC Applet 服务器的缺省端口是 6789。可以提供一个空闲端口作为此脚本的可选参数。必须在重新启动计算机后重新启动“DB2 JDBC Applet 服务器”。如果在除 6789 之外的端口上启动“DB2 JDBC Applet 服务器”,则必须向 dsyadmin.sh 提供该端口。

对于 Windows:

dsyadmin.bat

对于 Linux:

db2jstrt [a free port number]
./dsyadmin.sh [DB2 JDBC Applet Server port]
 

对于 Solaris 和 AIX:

./dsyadmin.sh
dsyadminxml.bat

此命令运行 MDAC XML 以使用 XML 文件从命令行管理 MDAC 配置。XML 工具可以对 MDAC 对象执行添加、除去和改变操作。MDAC 对象包括 DB2 Everyplace 用户、组、预订集和预订。

有关完整的用法信息,请参阅利用 XML 脚本编制工具

要获取帮助,请输入

dsyadminxml.bat

(不带自变量):

命令行参数:

-x|-d filename
-x filename [-add] [-remove]
  • -x 从控制数据库创建 XML 文件
  • -d 将 XML 文件应用于控制数据库
  • filename 要处理的 XML 文件名。-x 将覆盖文件(如果它已存在的话)。
  • [-add] [-remove] 是添加至同步服务器控制数据库或除去已经存在于该数据库中的内容的“XML 类型”
dsyblocksubscription.bat 此命令将阻塞在命令自变量中提供的预订名。可以在命令行上同时命名多个预订。阻塞预订将指示 Sync Server 拒绝将新的更改应用于预订数据。
dsyblocksubscription.bat  [subscription]

[subscription] 是要在服务器上阻塞的预订

例如:

dsyblocksubscription subscriptionName1

将以名称“subscriptionName1”阻塞预订。

dsyctldb.bat 此命令创建 DB2 Everyplace 控制数据库。此命令通常由 DB2 Everyplace 安装自动运行。
dsyctldb.bat <db2instance> <db2instance password>
dsyjdbcmigration.bat 此命令将 JDBC 预订从 Sync Server V8.1.2 和更早期版本迁移至 Sync Server V8.1.4 和更新版本。
dsyjdbcmigration.bat [sourceDatabaseUrl
sourceTableSpace] |
[sourceDatabaseUrl sourceTableSpace sourceTableName]

其中

  • sourceDatabaseUrl 是要迁移的源数据库的 URL
  • sourceTableSpace 是应在其中创建 Sync Server 控制表的表空间的名称
  • sourceTableName 是要迁移的源表的名称

例如,要迁移所有预订,输入:

dsyjdbcmigration.bat

要使用名为“mytablespace”的表空间在 VNURSE 数据库上迁移预订,输入:

dsyjdbcmigration.bat jdbc:db2:VNURSE mytablespace

要使用名为“mytablespace”的表空间在 VNURSE 数据库中的表 DSYSAMPLE.VNMEDICALRECORD 上迁移预订,输入:

dsyjdbcmigration.bat jdbc:db2:VNURSE mytablespace
    dsysample.vnmedicalrecord
dsymigratemessagestore.bat 仅当迁移时,此命令才由安装使用。将复位尚未完成其上一次同步的用户,从而强制对下一次同步进行刷新。由未完成同步上载的任何数据都可能会丢失。
dsymigratemessagestore.bat
dsymsgclean.bat 对于多个服务器环境,此命令将从消息存储数据库中除去所有消息。
dsymsgclean.bat
dsymsgdb.bat 此命令由安装用于多个服务器环境。它将创建必要的消息存储数据库。 dsymsgdb.bat
dsyreplicate.bat 此命令让 DB2 Everyplace 一有机会就将位于镜像数据库中的数据复制到源。
dsyreplicate.bat [mirror_database]
dsyreset.bat

复位用户、设备或用户组。

要获取帮助,输入不带自变量的 dsyreset.bat

dsyreset.bat {[user name]} {-device [device id]}
 {-group [group name]} {-all}

其中

  • [user name] 是要复位的用户名
  • [device id] 是要复位的设备标识
  • [group name] 是组名,指示复位属于某一组的所有用户

例如,要复位名为“bob”的用户,输入:

dsyreset.bat bob

要复位属于组“Sales”的所有用户,输入

dsyreset.bat -group Sales
dsyResetUserMigration.bat 生成 XML 脚本以复位其上一次同步被确定为未完成的用户。此命令的输入将采用用于访问控制数据库的 URL、用户标识和密码以及将为输出 XML 文件的绝对文件名。可以在任何时候运行此 XML 脚本。通常在安装期间执行此命令。
dsyResetUserMigration jdbc:db2:dsyctldb <userID>
<password> <filename.xml>

其中

  • userID 是“DB2 管理员”的用户标识
  • password 是指定的用户标识的密码
  • filename.xml 是输出 XML 文件
dsysetenv.bat 此脚本设置特定于 DB2 Everyplace Sync Server 的环境变量。
dsysetenv.bat
dsysetjavahome.bat 可以修改此脚本命令以将 JDBC 驱动程序添加至 MDAC 的类路径。要添加这些驱动程序可能需要的本机库,将那些条目添加至 dsysetenv.bat。注意,还必须将 JDBC 驱动程序添加至运行 DB2 Everyplace Servlet 的应用程序服务器类路径。
dsysetproperty.bat 在控制数据库 DSY.PROPERTIES 表中查询或设置属性。 输入不带自变量的
 dsysetproperty.bat
作为指令。
dsysync.bat

此命令将启动执行 DB2 Everyplace servlet 的 WebSphere Application Server V5 的嵌入式版本。该命令将启动后台中的服务器进程,然后退出。此命令不带自变量。

如果 DB2 Everyplace 安装在另一应用程序服务器上(如 WebSphere Application Server V5),则对该服务器使用适当的命令。

dsysync.bat
dsysyncmonitor.bat 此命令将启动一个 GUI 工具,该工具帮助查看关于当前正在同步的用户的日志信息。可以将 GUI 配置为以不同的时间间隔更新来显示最新的信息。
dsysyncmonitor.bat
dsysyncstatus.bat

此命令将打印出安装在 WebSphere Application Server V5 的嵌入式版本中的 DB2 Everyplace 服务器的执行状态。服务器的状态可以为“已启动”、“正在运行”或“已停止”。此命令不带自变量。

如果 DB2 Everyplace 安装在另一应用程序服务器上(如 WebSphere Application Server V5),则请对该服务器使用适当的命令。

dsysyncstatus.bat
dsysyncstop.bat

此命令将停止执行 DB2 Everyplace servlet 的 WebSphere Application Server V5 的嵌入式版本。它将向正在运行的服务器进程发出停止请求,打印状态,然后退出。此命令不带自变量。

如果 DB2 Everyplace 安装在另一应用程序服务器上(如 WebSphere Application Server V5),则对该服务器使用适当的命令。

dsytrace [0 | 1] [-console]
 

其中

  • 0 关闭跟踪(发生错误除外)
  • 1 打开所有跟踪
  • -console 禁用对控制台窗口的跟踪

例如,要打开所有跟踪但不显示在控制台窗口中,输入:

dsytrace 1 -console 
dsytraceprocess.bat 用来将跟踪文件中的时间戳记格式扩展为“yyyymmdd hh:mm:ss.ms”格式。
dsytraceprocess.bat -F <tracefileName> -O <true|false>
 

-O 选项用来指示覆盖标志。当指定为 true 时,将用带已扩展时间戳记的已转换跟踪文件覆盖原始跟踪文件。否则,结果跟踪文件将被命名为 originalTraceFile.new

dsyunblocksubscription.bat 此命令将取消对在命令自变量中提供的预订名的阻塞。可以在命令行上同时命名多个预订。取消对先前被阻塞的预订的阻塞将指示 Sync Server 继续从客户机接受新的更改来作为此预订或这些预订的一部分。
dsyunblocksubscription [subscription]+

其中

  • [subscription] 是要在服务器上取消阻塞的预订。

例如,要取消对名为“bob”的预订的阻塞,输入:

dsyunblocksubscription bob

要同时取消对名为“bob”和“sally”的预订的阻塞,输入:

dsyunblocksubscription bob sally
dsyversion.bat 此命令通过查询 dsy.properties 表来确定控制数据库的版本。
dsyversion.bat
useUdb8.bat 此脚本设置要与 DB2 UDB 版本 8.1 配合使用的“移动设备管理中心”的类路径。
useUdb8.bat
useUdbFp7_8.bat 此脚本设置要与 DB2 UDB 版本 7.2 修订包 7 或更新版本配合使用的“移动设备管理中心”的类路径。
useUdbFp7_8.bat

下表列示特定于 UNIX 和 Linux 服务器上的 DB2 Everyplace Sync Server 的脚本。

表 220. DB2 Everyplace Sync Server 实例管理脚本

命令 用途 用法
dsyidrop.sh 此脚本将删除 DB2 Everyplace Sync Server 实例。
dsyidrop.sh <dsyinstance>
其中 <dsyinstance> 是要删除的 DB2 Everyplace 

Sync Server 实例的名称。
dsyicreate.sh 此脚本用来创建 DB2 Everyplace Sync Server 实例。DB2 Everyplace Sync Server 实例必须为系统上的现有用户且必须为 DB2 UDB 实例。

要显示创建 DB2 Everyplace Sync Server 实例所必需的参数,输入:

dsyicreate.sh
dsyilist.sh 此脚本将列示当前定义的 DB2 Everyplace Sync Server 实例。
dsyilist.sh