IBM CommonStore for Lotus Domino在AIX平台上的手动配置过程及自动配置工具的使用

	打印本页			将此页作为电子邮件发送
		未显示需要 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 应用的架构

图 1. CSLD 应用架构

CSLD Task 通过 Lotus Notes C API 从 Domino 服务器上获取邮件，传递给 CSLD Server，后者通过 CM connector 将邮件保存到 CM 服务器上。

确认 Domino 服务器正常运行

启动 Domino 服务器并尝试收发邮件，确认能正常运行。

确认 CM 服务器正常运行

启动 CM 相关服务并尝试向一个项目类型（item type）中导入文档，在 CM Windows Client 中查询该文档，确认能正常运行。

安装 Notes C API

一般说来，只需要在 CSLD 服务器上安装 Lotus Notes 客户端。但是 Notes 没有适用于 AIX 平台的版本，因此必须安装 Domino，但不必进行任何配置。

Domino 在 AIX 上的安装请参考参考资源中相关内容。

注意：

记录您在安装 Domino 过程中进行的设置：

• 程序安装路径：默认值为 /opt/IBM/lotus
• 数据文件安装路径：默认值为 /opt/IBM/lotus/notesdata
• 用户名：默认值为 notes
• 组名：默认值为 notes

安装 CM connector

需要在 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

安装 CSLD 软件包

以 root 用户登录 AIX 系统，使用 smit 安装 CSLD 软件包。安装完成后，在 /usr/lpp 路径下将产生 csld 目录。

创建 AIX 上的 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

连接 Domino 服务器

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 所需的 Notes 数据库

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 Task

以 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 名称。

连接 CM 服务器

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 目录中。

CSLD 所需的 CM 项目类型（Item Type）

邮件需要保存到 CM 服务器的一个项目类型中。

CSLD Server 可以使用两种项目类型：

• 一种是基础类型；
• 另一种具有这样的特性（称为 SIS）。

例如，Notes 用户 A 将邮件 M 发送给用户 B、C 和 D， B、C 和 D 都对这封邮件进行存档，在 CM 服务器中对邮件保存三次其实是对空间的一种浪费。在使用这种特殊项目类型时 CSLD 只会把这封邮件保存一次。

但是在计算是否应该保存一次时会花费一定的时间，所以是时间换空间的一种算法，请根据您的实际需要选择项目类型。

两种项目类型都可以包含 CSLDMailSubject、CSLDMailFrom、CSLDPostedDate、CSLDMailTo、CSLDMailCc、CSLDMailBcc 等属性，存档后您可以根据这些属性查询相关的邮件

启动 CSLD Server

将文件 /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. 配置工具界面 1

2． 输入 CSLD 程序安装路径、CSLD 服务器的主机名。

图 3. 配置工具界面 2

3． 可以用 IP 地址连接 Domino 服务器，以避免 Domino 服务器名字解析过程中可能遇到的问题。也可使用 Domino 服务器的 Common Name 或 hierachical Name，这需要在 CSNOTESDATAPATH 变量指定的目录中提供 names.nsf 文件，或者依赖 hosts 文件或 DNS 等办法来解析名字。选择一个 Notes 用户的 ID 文件，这个用户将被用于创建配置数据库和请求数据库。输入密码后，点击 Connect 按钮。如果输入的信息正确，并且这台 Domino 服务器正在运行，连接成功的信息会显示在下方。

图 4. 配置工具界面 3

4． 选择一个 Notes 用户（例如 cslduser）的 ID 文件，CSLD Task 将使用这个用户访问 Domino 服务器，这个用户密码将被加密保存。

图 5. 配置工具界面 4

5． 指定保存配置数据库的 Domino 服务器及路径。可以指定要处理的邮件数据库所在的 Domino 服务器（可以指定多个）和该服务器上请求数据库的路径。

图 6. 配置工具界面 5

6． 选择 CM 服务器，输入用户名和密码，这个用户名将用于在此 CM 服务器上创建项目类型。

图 7. 配置工具界面 6

7． 下面的用户名将被 CSLD Server 用于连接 CM。如果这个用户不存在，就创建它，密码将被加密保存。

注意：

必须输入 CommonStore 全文检索模块在 CM 服务器上的安装路径，这是因为配置工具只能创建具有全文检索功能的项目类型。CommonStore 全文检索模块模块使 Notes 用户能够对已存档的邮件进行全文检索，其安装配置请参考参考资源中相关内容。

图 8. 配置工具界面 7

8． 设置完成后，工具就可以自动为您创建所有相关配置。

图 9. 配置工具界面 8

9． 如果一切设置正确，将会成功地创建所有配置。

注意：

如果某个属性在 CM 中已经存在，但与 CSLD 的要求不匹配，CSLD 会修改该属性的名字，并在此页面上加以说明。

图 10. 配置工具界面 9
 

自动配置的局限

表 1. 自动配置工具总结

结束语

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/

本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！