| ![]() | ![]() | ![]() |
| |||||||||||
![]() | ![]() | 未显示需要 JavaScript. 的文档选项 |
姚明明 (yaomm@cn.ibm.com), 软件测试工程师, IBM
2008 年 7 月 10 日
IBM CommonStore for Lotus Domino 提供了对 Lotus Notes 文档进行存档并对已存档文档进行查询,显示,恢复,删除等功能,与 IBM Lotus Domino、IBM Content Manager 等环境软件之间存在接口,本教程将介绍其手动配置过程和自动配置工具的使用。
IBM CommonStore for Lotus Domino 简介
IBM CommonStore for Lotus Domino(以下简称 CSLD)提供了对 Lotus Notes 文档进行存档(archive),以及对已存档文档进行查询(search),显示(display),恢复(retrieve),删除(delete)等功能。CSLD 可以用于集中存档暂时不用的邮件,从而控制 Lotus Notes 数据库的大小,释放 Lotus Domino 服务器上的空间,以便提高 Domino 服务器的通信性能,还能保证客户满足与存档相关的法律法规要求。
本文是为不具备 IBM CommonStore for Lotus Domino 安装配置知识的人员编写的。但您应该对 IBM Lotus Domino、IBM Content Manager 等环境软件有基本知识和使用经验。
您将需要有下列服务器:
- CSLD 服务器(CSLD V8.4)
- Domino 服务器(Domino V8)
- CM 服务器(CM V8.4)
最好在三台不同的服务器上完成。
CSLD Task 通过 Lotus Notes C API 从 Domino 服务器上获取邮件,传递给 CSLD Server,后者通过 CM connector 将邮件保存到 CM 服务器上。
启动 Domino 服务器并尝试收发邮件,确认能正常运行。
启动 CM 相关服务并尝试向一个项目类型(item type)中导入文档,在 CM Windows Client 中查询该文档,确认能正常运行。
一般说来,只需要在 CSLD 服务器上安装 Lotus Notes 客户端。但是 Notes 没有适用于 AIX 平台的版本,因此必须安装 Domino,但不必进行任何配置。
Domino 在 AIX 上的安装请参考参考资源中相关内容。
注意:
记录您在安装 Domino 过程中进行的设置:
- 程序安装路径:默认值为 /opt/IBM/lotus
- 数据文件安装路径:默认值为 /opt/IBM/lotus/notesdata
- 用户名:默认值为 notes
- 组名:默认值为 notes
需要在 CSLD 所在机器上安装 IBM DB2(以下简称 DB2)和 IBM DB2 Information Integrator for Content(以下简称 II4C)。
DB2 在 AIX 上的安装请参考参考资源中相关内容。
II4C 在 AIX 上的安装请参考参考资源中相关内容。
注意:
记录您在安装 DB2 过程中进行的设置:
- 程序安装路径:默认值为 /usr/opt/db2_08_01(DB2 V8.1)或 /opt/IBM/db2/V9.1(DB2 V9.1)
- 用户名:默认值为 db2inst1
- 组名:默认值为 db2grp1
注意:
记录您在安装 II4C 过程中进行的设置:
- 程序安装路径:默认值为 /opt/IBM/db2cmv8
- 用户名:默认值为 ibmcmadm
- 组名:默认值为 ibmcmgrp
以 root 用户登录 AIX 系统,使用 smit 安装 CSLD 软件包。安装完成后,在 /usr/lpp 路径下将产生 csld 目录。
使用 smit 创建一个 AIX 用户,设置用户名为 csld(或其他名字),该用户必须是 bin 组成员。根据您前面记录的信息,还应设置该用户属于 Notes、DB2、CM 组,默认情况下就是 notes、db2grp1、ibmcmgrp。
以用户 csld 登录 AIX 系统,将 /usr/lpp/csld/bin 中的两个脚本拷贝到其 home 目录(/home/csld)中:
/usr/lpp/csld/bin/csenv.sh /usr/lpp/csld/bin/notesenv.sh |
编辑 csld 的登录 profile($home/.profile):
1. 加入对以下脚本的调用:
. $HOME/csenv.sh . $HOME/notesenv.sh . /home/db2inst1/sqllib/db2profile . /opt/IBM/db2cmv8/bin/cmbenv81.sh |
下文将描述如何修改上述脚本的内容以适于用户的实际环境。
2. 设置语言环境变量,CSLD 将使用这种语言输出屏幕信息:
export LANG=en_US |
1. CSLD Task 需要使用一个 Notes 用户连接 Domino 服务器。确保在 Domino 服务器上已经创建了此用户 cslduser(或其他名字)。
2. 根据您所记录的 Domino 程序安装路径等信息检查 $home/notesenv.sh,确认脚本中的设置与实际路径相符。
3. CSLD Task 使用根据 PATH 环境变量找到的第一个 notes.ini 文件。为了确保 CSLD 使用您所指定的 notes.ini,请将其所在的目录添加到 notesenv.sh 中 PATH 变量的最前端。默认是 $home/notesdata 目录,您可以指定其他目录。将 /usr/lpp/csld/bin 中的 AIX_sample_notes.ini 文件到 $home/notesdata 目录下,根据实际环境修改如下参数设置:
- Directory:指定地址簿 names.nsf 所在的目录。确保用户 csld 可以写这个目录,Notes 会话的调试信息会写入此目录。names.nsf 为 CSLD Task 提供指向 Domino 服务器的 connection 文档。您可以从一个安装了 Notes 客户端并连接到目标 Domino 服务器的 Windows 机器上拷贝地址簿文件 names.nsf。一般我们把 names.nsf 也放在 $home/notesdata 目录中,避免其他应用程序访问 names.nsf 从而与 CSLD 发生冲突。
- Location:如果不指定此参数,CSLD 使用 names.nsf 中按字母顺序排列的第一个 location 文档。要使用其他 location,应该在该参数中指定。
- MailServer:cslduser 的 home 服务器。
- MailFile:cslduser 的邮箱在 Domino 服务器上的相对路径(相对于 data 目录)。
- KeyFilename:cslduser 的 ID 文件。一般我们把这个 ID 文件也放在 $home/notesdata 目录中,避免冲突。
- ExtMgr_Addins=libextpwd.a:设置了这一参数以后,每次 CSLD Task 启动时将不再询问 cslduser 的密码,而是使用之前保存的密码。
CSLD Task 的配置数据保存在 Domino 服务器上的一个 Notes 数据库中(以下简称配置数据库)。
存档、查询、恢复和删除等操作的请求也保存在一个 Notes 数据库中(以下简称配置数据库)。
为了使普通 Notes 用户能够执行存档、查询、恢复和删除等操作,需要在其邮箱中添加对应的按钮和脚本。
CSLD 提供了创建上述 Notes 数据库的 NTF 模板文件。
模板文件位于 /usr/lpp/csld/data 目录中:
CSLDConfig.ntf:配置数据库模板。
确保 cslduser 对配置数据库至少拥有 Reader 权限。
注意:
配置数据库不会提供任何缺省配置,您必须自己创建所有配置。
为了启动 CSLD Task,至少要创建 Database Profile、Document Mapping、Content Type Mapping 等类型的文档,其中包含如下设置:
- CSLD Task 的类型:存档、恢复、查询和删除
- CSLD Task 的运行时间、频率
- CSLD Task 负责处理的请求数据库和邮件数据库
- CSLD Server 的主机名和端口号
- CSLD Task 的端口
- 日志目录
如果您希望 CSLD 自动遍历邮件数据库,根据事先设定的条件选择邮件并产生操作请求,还需要创建 Policy、Database Set、Scheduled Task 等类型的文档,其中包含如下设置:
- 自动遍历的时间、频率
- 需要遍历的邮件数据库
- 操作请求的类型
- 选择邮件的条件
CSLDJobs.ntf:请求数据库模板。
确保 cslduser 对请求数据库至少拥有 Editor 权限,并能删除文档。
CSLDStdMail.ntf 和 CSLDStdMail8.ntf:邮件数据库模板。
分别适用于 Domino V7 和 Domino V8。确保 cslduser 对邮件数据库至少拥有 Editor 权限,并能删除文档。
注意:
您可以直接使用这些模板文件,或参考它们创建自己的模板。
以 csld 身份登录 AIX 系统。
1.首先将 cslduser 的密码保存下来,这样每次启动 CSLD Task 时不必再输入密码:csld –f serverpasswd
2.启动 CSLD Task。
csld -n csldconf.nsf -s abc/def -p archive_task 其中参数 -n 指定配置数据库名称,-s 指定配置数据库所在 Domino 服务器名称,-p 指定 CSLD Task 名称。 |
1. CSLD Server 需要使用一个 CM 用户连接 CM 服务器。确保在 CM 服务器上已经创建了此用户 csldadmin(或其他名字)。
2. 根据您所记录的 DB2 程序安装路径等信息检查 /home/db2inst1/sqllib/db2profile,确认脚本中的设置与实际相符。
3. 根据您所记录的 II4C 程序安装路径等信息检查 /opt/IBM/db2cmv8/bin/cmbenv81.sh,确认脚本中的设置与实际相符。
注意:
确保正确设置了环境变量 IBMCMROOT 和 DB2HOME。
4. 对 CM 所使用的 DB2 数据库进行编目(catalog),如下:
db2 catalog tcpip node cm remote cmserver server 50000 db2 catalog db icmnlsdb as cmdb at node cmse |
其中 cmserver 是 CM 服务器的主机名,icmnlsdb 是 CM 所使用的 DB2 数据库名。
5. 编辑 /home/ibmcmadm/cmgmt/connectors 中的 cmbicmsrvs.ini 添加新的 CM 服务器连接信息。您也可以使用 II4C 提供的配置工具 config_II4C ,缺省情况下该工具位于 /opt/IBM/db2cmv8/bin 目录中。
邮件需要保存到 CM 服务器的一个项目类型中。
CSLD Server 可以使用两种项目类型:
- 一种是基础类型;
- 另一种具有这样的特性(称为 SIS)。
例如,Notes 用户 A 将邮件 M 发送给用户 B、C 和 D, B、C 和 D 都对这封邮件进行存档,在 CM 服务器中对邮件保存三次其实是对空间的一种浪费。在使用这种特殊项目类型时 CSLD 只会把这封邮件保存一次。
但是在计算是否应该保存一次时会花费一定的时间,所以是时间换空间的一种算法,请根据您的实际需要选择项目类型。
两种项目类型都可以包含 CSLDMailSubject、CSLDMailFrom、CSLDPostedDate、CSLDMailTo、CSLDMailCc、CSLDMailBcc 等属性,存档后您可以根据这些属性查询相关的邮件
将文件 /usr/lpp/csld/bin/archint_sample_cm8.ini 拷贝到 csld 用户的 home 目录中,并更名为 archint.ini。
根据 CM 服务器的连接信息在 archint.ini 进行如下设置:
- ITEM_TYPE:CM 服务器上项目类型的名称
- LIBSERVER:CM 服务器名称
- CMUSER :CM 用户
- INSTANCEPATH:请设置为 csld 用户的 home 目录。
注意:
$HOME/csenv.sh 中 CSNINSTANCEPATH 变量所指定的目录将用于保存 CSLD Server 的日志记录。
以 csld 身份登录 AIX 系统。
1. 首先将 csldadmin 的密码保存下来,这样每次启动 CSLD Server 时不必再输入密码:archpro –f serverpasswd
2. 启动 CSLD Server:archpro
可以看出手动配置过程较为繁琐,而自动配置工具可以根据您的输入自动完成一些设置。
使用 /usr/lpp/csld/bin/CSLDAutoConfig.sh 脚本运行自动配置工具。
运行工具之前,确保已经安装了 Domino 和 II4C,也创建了供 CSLD 使用的 AIX 用户。
检查 CSLDAutoConfig.sh 脚本,确保其中设置的所有变量与系统的实际情况一致。
注意:
CSNOTESDATAPATH 变量的值也被添加到 PATH 变量的最前端。配置工具会根据用户设置修改根据 PATH 环境变量找到的第一个 notes.ini 文件,设置为 CSLD Task 所使用的 notes.ini。notesenv.sh 中 PATH 变量应与其保持一致。
切换到 CSLD 用户,运行配置工具:
# su - cs $ CSLDAutoConfig.sh |
1. 配置工具界面。
2. 输入 CSLD 程序安装路径、CSLD 服务器的主机名。
3. 可以用 IP 地址连接 Domino 服务器,以避免 Domino 服务器名字解析过程中可能遇到的问题。也可使用 Domino 服务器的 Common Name 或 hierachical Name,这需要在 CSNOTESDATAPATH 变量指定的目录中提供 names.nsf 文件,或者依赖 hosts 文件或 DNS 等办法来解析名字。选择一个 Notes 用户的 ID 文件,这个用户将被用于创建配置数据库和请求数据库。输入密码后,点击 Connect 按钮。如果输入的信息正确,并且这台 Domino 服务器正在运行,连接成功的信息会显示在下方。
4. 选择一个 Notes 用户(例如 cslduser)的 ID 文件,CSLD Task 将使用这个用户访问 Domino 服务器,这个用户密码将被加密保存。
5. 指定保存配置数据库的 Domino 服务器及路径。可以指定要处理的邮件数据库所在的 Domino 服务器(可以指定多个)和该服务器上请求数据库的路径。
6. 选择 CM 服务器,输入用户名和密码,这个用户名将用于在此 CM 服务器上创建项目类型。
7. 下面的用户名将被 CSLD Server 用于连接 CM。如果这个用户不存在,就创建它,密码将被加密保存。
注意:
必须输入 CommonStore 全文检索模块在 CM 服务器上的安装路径,这是因为配置工具只能创建具有全文检索功能的项目类型。CommonStore 全文检索模块模块使 Notes 用户能够对已存档的邮件进行全文检索,其安装配置请参考参考资源中相关内容。
8. 设置完成后,工具就可以自动为您创建所有相关配置。
9. 如果一切设置正确,将会成功地创建所有配置。
注意:
如果某个属性在 CM 中已经存在,但与 CSLD 的要求不匹配,CSLD 会修改该属性的名字,并在此页面上加以说明。
配置步骤 | 自动配置 | 功能局限 |
安装 Domino | 手动 | - |
安装 II4C | 手动 | - |
创建 AIX 用户 csld | 手动 | - |
创建 Notes 用户 cslduser | 手动 | - |
cslduser 环境配置 | 手动 | - |
修改 notes.ini | 自动 | names.nsf 必须位于 $home/notesdata 目录下 |
拷贝 names.nsf | 手动 | - |
拷贝 cslduser.id | 手动 | - |
创建配置数据库 | 自动 | 无 |
创建请求数据库 | 自动 | 无 |
创建 CSLD Task 配置数据 | 自动 | 只提供一种固定的设置,可以处理普通邮件数据库和 Journal 数据库。 如果不适用,仍需要手工修改。 |
保存 cslduser 密码 | 自动 | 无 |
创建 CM 用户 csldadmin | 自动 | 无 |
添加 CM 服务器连接信息 | 手动 | - |
创建项目类型 | 自动 | 只提供一种固定的设置,支持全文检索和 SIS 特性。 如果不适用,仍需要手工修改。 |
保存 csldadmin 密码 | 自动 | 无 |
启动 CSLD Server 的脚本 | 自动 | 无 |
启动 CSLD Task 的脚本 | 自动 | 无 |
CSLD 的自动配置工具能够完成手动配置过程中一些繁琐的步骤,使用户可以更快地建立起一个可用的配置,也降低了因手工操作而出现错误的可能性。但工具只能建立特定的配置,手动配置则显得更加灵活。
查看原文:http://www.ibm.com/developerworks/cn/db2/library/techarticles/dm-0807yaomm/
来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/14751907/viewspace-403197/,如需转载,请注明出处,否则将追究法律责任。
转载于:http://blog.itpub.net/14751907/viewspace-403197/