月度存档: 五月 2010

复制冲突文档的生成原理

前些天在讨论 Domino 环境中各种 ID 时,提到了一些关于如何处理复制冲突的内容,由于其原理比较复杂,当时就没有展开讨论。今天有读者询问其中的细节,所以在这篇文章中我们就仔细研究一下这个话题。

上一次说到在复制过程中如果发现两个副本关系的文档其 OID 不同,那么说明这两个文档处于不同步的状态。首先分析两个文档的 $Revisions 域(此域记录了文档历次修改的时间),判断是否存在冲突:

  • 如果两个域值除了某一个文档多出来一些值以外,其余部分完全相同,如:

    A:时间1,时间2,时间3
    B:时间1,时间2,时间3,时间4,时间5

    则表示 B 文档在 A 文档的基础上额外多修改了两次,不存在冲突

  • 如果两个域值最初相同,然后各自出现了不同的部分,如:

    A:时间1,时间2,时间3,时间4
    B:时间1,时间2,时间3,时间5

    则表示两个文档在不同的时间分别修改过,存在冲突

如果存在冲突,下一步检查目标文档(就是这次复制过程中会被修改的那个)的 $ConflictAction 域,如果其值为“1”表示允许合并复制冲突,开始分析两个文档各个域值,以判断能否进行合并:

  • 首先通过 $Revisions 域和 Sequence Number 找出两个文档最后一致的版本,以下面数据为例:

    A $Revisions:时间1,时间2,时间3,时间4
    A SN:5
    B $Revisions:时间1,时间2,时间3,时间5
    B SN:5

    两个文档在时间3这一版本是一致的,从 SN = 5 往回反推可以得到一致版本为 4

  • 每个文档域也有一个 SN 属性,它记录了此域最后一次修改时文档的 SN。用文档域的 SN 与之前得到的一致版本号 4 进行比对,就可以得到在一致版本之后修改的域。
  • 如果两个文档修改过的域有重合的部分,说明在不同的副本中对相同的域同时做了修改,无法合并冲突;反之则可以合并

如果 $ConflictAction 域值不是“1”或者属于上一段所述无法合并冲突的情况,则必须创建冲突文档。下一步就是通过 Sequence Number 和 Sequence Datetime 来分析哪个文档作为主文档(winner),哪个文档作为冲突文档(loser):

  • SN 比较大的(在一致版本之后编辑次数较多的)文档是 winner
  • 如果 SN 相同,SD 比较大的(最后编辑的)文档是 winner

至此,一个崭新的复制冲突文档诞生了。

问题跟踪系统 Mantis 配置要点

本文主要记录我在 Mantis 配置过程中遇到的几个问题,其安装比较简单这里就不详细描述,只是要注意 Mysql 安装时字符集选择 UTF-8。

(注:我的软件环境: Windows 2003,PHP 5.2.13,Mysql 5.1.46,Apache 2.2.15,Mantis 1.2.1)

  • 更改默认时区:在 config_inc.php 中加入
putenv("TZ=Asia/Shanghai");
  • 更改默认语言:在 config_inc.php 中加入
$g_default_language='chinese_simplified';
  • 更改窗口/页面标题:在 config_inc.php 中加入
$g_window_title = 'Bug跟踪系统';
$g_page_title = 'Bug跟踪系统';

之后发现标题变为空白,将 config_inc.php 改为 UTF-8无BOM格式 后问题解决。

  • 图表中文乱码问题

由于 Mantis 自带的图表引擎效果不好,所以建议使用 JpGraph 引擎。首先下载 JpGraph,将压缩包中 src 目录下所有文件解压到 {mantisroot}/library/jpgraph

以管理员帐号登录系统,通过 管理>插件管理 安装 Mantis图表 插件,然后对其进行配置:将第一项图表引擎改为 JpGraph,其余保持默认设置并保存(尤其是字体要保留 Arial,下面会用到)。至此图表已经可用,但中文乱码。

由于我的 Mysql 字符编码为 UTF-8,所以无需像网上大多数文章所述进行转码,直接找一个含有中文字符的字体即可。编辑 {mantisroot}libraryjpgraphjpgraph_ttf.inc.php 文件,通过查找 “FF_ARIAL =>”找到 Arial 字体配置部分,将原来的 arial.ttf 及各种粗斜变体替换为任意中文字体,样例如下:

FF_ARIAL =>   array(FS_NORMAL =>'msyh.ttf',
 FS_BOLD  =>'msyhbd.ttf',
 FS_ITALIC =>'msyh.ttf',
 FS_BOLDITALIC =>'msyhbd.ttf' ) ,

编辑好保存文件,乱码搞定。

针对分类视图查询数据

在 Domino 应用开发中,有很多方法可以对数据进行查询。@dblookup 和 NotesView.getAllDocumentsByKey 利用了预先建好的视图索引,所以在各种查询数据的方法中,它们的性能是最出色的,也是我们最常用的。

最近在工作中遇到了一个于此相关的问题,请大家也注意:如果查询的视图具有多层分类,那么 @dblookup 和 getAllDocumentsByKey 只能返回第一个子分类下的结果。以如下数据为例:

分类1
  分类1.1
    文档1.1.1
  分类2.2
    文档1.1.2
分类2

如果以“分类1”作为查询条件,则只有“文档1.1.1”会返回,同样符合条件的“文档1.1.2”则丢失。

请参考:Troubleshooting @DbLookup, @DbColumn, GetAllDocumentsByKey

Maximum number of file handles allowed for Domino is 1024 错误

今天同事报告一个问题:Linux 平台下的 Domino 服务器运行一段时间之后,Notes 客户机无法连接,但 HTTP 服务器却是好的。同时在服务器控制台上出现以下错误:

WARNING: the maximum number of file handles (ulimit -n) allowed for Domino is 1024. See Release Notes and set the allowable maximum to 20000.

经查明其原因是在 Linux 默认设置下,每个进程能够使用的 file handles 为 1024,达到这个限制之后就无法再打开任何文件了。修改此设定分为两种情况:

  • 用户登录系统手工启动 Domino(修改 /etc/security/limits.conf 文件)
  • 通过 /etc/init.d 脚本自动启动(在启动脚本中增加 ulimit -n 20000 命令)

具体方法请参考 IBM 技术支持文档

Notes/Domino 8.0.2 FP5 已发布

请参考:Notes/Domino 8.0.2 Fix Pack 5 Release NoticeDownload options for Notes/Domino 8.0.2 Fix Pack 5