Sun Java System Communications Express 6 2005Q4 管理指南

设置托管域

与域相关的可配置参数存储在以下文件中:

部署 Communications Express 时,默认情况下将这些文件复制到 uwc-deployed-path/WEB-INF/domain 目录中。

对于特定用户的会话,按以下顺序搜索与域相关的属性文件:

Procedure托管域

步骤
  1. uwc-deployed-path/WEB-INF/domain/user\qs domain/property-files

  2. uwc-deployed-path/WEB-INF/domain/property-files

创建托管域

本部分介绍了创建托管域时需要执行的步骤。

Procedure为特定域指定与域相关的属性:

步骤
  1. uwc-deployed-path/WEB-INF/domain 下创建一个包含域名的目录。

    例如:uwc-deployed-path/WEB-INF/domain/domain-name

  2. uwc-deployed-path/WEB-INF/domain 目录下与域相关的配置文件复制到该目录。有关与域相关的参数列表,请参阅设置托管域部分。

  3. 按照以下各部分的说明,自定义 uwc-deployed-path/WEB-INF/domain/domain-name 目录中的属性文件。

  4. 要使 Access Manager 登录 URL 可以根据 Communications Express 特定于域的 URL 来构建,请将全限定虚拟主机名 uwc.isvirtualhostname 设置为 Access Manager 的虚拟主机名。

    例如,在

    ce.virtualdomain.com.isvirtualhostname=is.virtualdomain.com

    并从 http://ce.virtualdomain.com/uwc 访问 Communications Express 时,

    Access Manager URL 将显示为

    http://is.virtualdomain.com/amserver/UI/Login

    如果没有将全限定虚拟主机名映射至 Access Manager 的虚拟主机名,则 Communications Express 将根据在 uwcauth.identity.login.url 中配置的静态 Access Manager 登录 URL 来构建 Access Manager 登录 URL。

    例如,如果在 uwcauth.identity.login.url=http://siroe.com:85/amserver/UI/Login 中并且从某个特定于域的 URL(例如 http://ce.varrius.com:80/uwc)访问 Communications Express,则 Communications Express 会将 Access Manager 登录 URL 构建为:

    http://siroe.varrius.com:85/amserver/UI/Login

    其中,域为 varrius.com

    如果域为 ce.varrius.com,则 Communications Express 会将 Access Manager 登录 URL 构建为:http://siroe.ce.varrius.com:85/amserver/UI/Login

  5. 在 Access Manager 配置中进行以下更改:

    1. AMconfig.properties 中定义 FQDN 映射。AMconfig.properties 文件的默认位置为:/etc/opt/SUNWam/config/AMconfig.properties

      例如,如果通过 is.virtualdomain.com 虚拟主机访问 Access Manager,则 FQDN 映射将显示为:

      com.sun.identity.server.fqdnMap[is.virtualdomain.com]= is.virtualdomain.com

    2. Cookie 域(位于服务配置 -> 平台下)的其他 Cookie 域字段中添加 virtualdomain.com

为托管域配置参数

以下部分介绍了可以在 Communications Express 中为域配置的设置:

在 uwcdomainconfig.properties 文件中配置参数

uwcdomainconfig.properties 文件维护与日历和通讯录相关的用户首选项的默认值,可以基于每个域来配置这些首选项。这些默认用户首选项值是新用户第一次在 Communications Express 中访问日历和通讯录时为其动态分配的。

表 6-1 列出了应用程序中的默认用户首选项。

表 6–1 uwcdomainconfig.properties 文件中的默认用户首选项

参数 

默认值 

描述 

uwc-user-attr-sunUCDefaultApplication 

 

指定您登录后显示的页面。 

部署 Messenger Express 后,默认情况下将“邮件”页显示为登录页。否则显示“日历”页。如果未部署日历,用户将进入“通讯录”页。 

uwc-user-attr-sunUCDefaultEmail Handler 

uc、desktop 

指定用于从应用程序中发送电子邮件的默认电子邮件客户端。 

可以将默认电子邮件客户端设置为 Messenger Express 或浏览器邮件客户端。

uwc-user-attr-sunUCDateFormat 

M/D/Y 

指定日期中的日、月和年的显示顺序。 

可用选项为: 

M/D/Y、D/M/Y、Y/M/D 

uwc-user-attr-sunUCDateDelimiter 

指定日期中使用的分隔符。

分隔符是分隔日期中的日、月和年的字符。 

您可以将分隔符指定为逗号 (,)、正斜杠 (/) 或连字符 (-)。 

uwc-user-attr-sunUCTimeZone 

America/ Los_Angeles 

指定创建日历时所采用的时区。

您可以从以下区域中选择任何有效的时区: 

北美和南美地区、欧洲和非洲以及亚洲和太平洋周边。 

表 6–2 uwcdomainconfig.properties 文件中的默认日历首选项

参数 

默认值 

描述 

uwc-user-attr-icsExtendedUser Prefs-ceDefaultView 

dayview 

指定登录后应显示的默认日历视图。可用选项为:

日视图、周视图、月视图和年视图。 

uwc-user-attr-icsExtendedUser Prefs-ceShowCompletedTasks 

false 

指定完成的任务是否出现在日历的“任务”窗格中。 

如果您希望完成的任务出现在日历的“任务”窗格中,请将默认值更改为 "true"。 

uwc-user-attr-icsExtendedUser Prefs-ceDefaultCategory 

业务 

指定创建新事件或新任务应使用的默认类别。

可用类别为: 

“周年纪念日”、“约会”、“生日”、“业务”、“早餐”、“课程”、“电话会议”、“晚餐”、“假日”、“午餐”、“会议”、“其他”、“个人”、“研讨会”、“培训”、“旅行”、“休假”和“会谈”

uwc-user-attr-icsExtendedUser Prefs-ceDayHead 

指定一天的开始时间(以小时表示)。 

uwc-user-attr-icsExtendedUser Prefs-ceDayTail 

18 

指定一天的结束时间(以小时表示)。 

uwc-user-attr-icsExtendedUser Prefs-ceInterval 

PT1H0M 

(一小时) 

指定一天中划分的时间段。 

在“日”和“周”视图中,将一天划分为半小时或一小时的时间段。 

您可以将默认划分值更改为 PT0H30M(半小时)。 

uwc-user-attr-icsFirstDay 

您可以将一周中的某一天指定为日历中周的第一天。默认情况下,将星期日 (1) 作为一周中的第一天,而将星期六 (7) 作为一周中的最后一天。 

uwc-user-icsExtendedUser Prefs-ceWeekEndDays 

1 和 7 

在日历视图中指定周末是一周中的哪几天。 

默认情况下,星期日 (1) 是一周中的第一天,星期六 (7) 是一周中的最后一天。 

逗号分隔的数字列表表示一周中作为周末的那几天。 

uwc-user-attr-icsExtendedUser Prefs-ceIncludeWeekendIn Views 

false 

允许或禁止在日历的“周”和“月”视图中显示周末。 

如果应该在日历的“周”和“月”视图中显示周末,则将默认值设置为 "true"。 

uwc-user-attr-icsExtendedUser Prefs-ceSingleCalendarTZISD 

true 

指定是否应该用日历的时区来显示日历。 

如果不希望用日历的时区来查看日历,则将默认值更改为 "false"。在这种情况下,将按“全局选项”选项卡中指定的时区来显示所有日历。 

uwc-usr-attr-icsExtendedUser Prefs-ceDefaultAlarmStart 

PT0H30M 

指定在事件或任务前多长时间(默认小时和分钟数〕发送提醒。 

uwc-user-attr-icsExtendedUser Prefs-ceNotifyEnable 

false 

指定在创建新的事件时是否向内部被邀请人发送电子邮件(包含 ical 附件)。 

有效值为:false、true。 

表 6–3 uwcdomainconfig.properties 文件中的默认通讯录首选项

参数 

默认值 

描述 

uwc-user-sunAbExtended UserPrefs-abName 

Personal Address Book 

指定默认通讯录的名称。 

uwc-user-attr-sunAbExtended UserPrefs-abDescription 

This is the personal address book 

为默认通讯录指定简短描述。 

uwc-user-attr-sunAbExtended UserPrefs-abEntriesPerPage 

25 

指定在页面上显示的最大通讯录条目数。可用选项为:25、50、75。 

uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column1 

displayname 

指定要在第一列中显示的值。默认情况下,第一列显示联系人或组的名称。 

uwc-user-attr-sunAbExtended UserPrefs-abSerchDisplay Column2 

primaryemail 

指定要在通讯录的第二列中显示的值。 

您可以将显示列名称设置为: 

displayname、company、title、primaryphone、workphone、homephone、faxphone、pagerphone、primaryemail、email2、email3、homeaddress、workaddress、weburl1、weburl2、calendarurl、freebusyurl、birthday、anniversary、ou、edit、viewcalendar

uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column3 

 

指定要在通讯录的第三列中显示的值。 

您可以将显示列名称设置为: 

displayname、company、title、primaryphone、workphone、homephone、faxphone、pagerphone、primaryemail、email2、email3、homeaddress、workaddress、weburl1、weburl2、calendarurl、freebusyurl、birthday、anniversary、ou、edit、viewcalendar

uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column4 

edit 

指定要在通讯录的第四列中显示的值。 

您可以将显示列名称设置为: 

displayname、company、title、primaryphone、workphone、homephone、faxphone、pagerphone、primaryemail、email2、email3、homeaddress、workaddress、weburl1、weburl2、calendarurl、freebusyurl、birthday、anniversary、ou、edit、viewcalendar

配置 personalstore.properties 文件

修改 personalstore.properties 文件中的参数,以配置通讯录存储、公司目录以及任何远程目录。

表 6-4 列出了 personalstore.properties 文件中存储的设置。

表 6–4 personalstore.properties 文件中存储的配置设置

参数 

默认值 

描述 

db.defaultpsrootpattern 

ldap: //piPStoreOwner= %U,o=%D, o=PiServerDb 

指定用于为用户动态构建 psRoot 值的模式。psroot 标识用户条目存放的位置。

%U = 用户的 uid ("jsmith") 

%D = 用户的域 ("siroe.com") 

%O = 域的最重要部分 ("siroe") 

db.xxx.class 

com.iplanet.iabs. ldap.plug.iLDAP 

指定实现插件的 java 类名称。例如,LDAP 插件。 

db.xxx.urlmatch 

 

按以下格式指定 URL: 

ldap://host:port/DN 

基于此参数来标识 xxx 实例。 

该值应与 defaultps.xml 文件中存储的 "bookremoteurl" 属性对应。

db.xxx.configpath 

 

指定包含此实例 LDAP 信息的配置目录的路径。 

如果此路径是相对路径,则它相对于此文件的位置。 

db.xxx.wildcardsearch 

 

指定在通配符搜索中提供的最小字符数。 

db.xxx.randompaging 

false 

指定插件是否支持随机访问以及是否必须从第一页来访问每一页。 

如果为 false,则搜索过程继续进行搜索,直至找到正确的页为止。 

db.xxx.corporatedir 

false 

对于公司目录,此值应该为 true。 

db.useUserPsRoot 

false 

将值设置为 true 以使用用户的 psRoot 值。如果设置为 false,则使用 defaultserver 值。 

配置 defaultps.xml 文件

defaultps.xml 文件包含用户首次登录时在 LDAP 存储中创建的个人和公司通讯录的默认定义。

每个通讯录节点都包含一个为用户创建的通讯录定义,defaultps.xml 文件位于这些用户所在的域之下。

以下列举了 defaultps.xml 中的 XML 部分,其中包含个人通讯录和公司通讯录的定义。

个人通讯录 XML


示例 6–1 包含个人通讯录定义的 XML 部分


<book booktype="abook"\>
<bookoc\>piLocalBook</bookoc\>
<entry entryID="pab"\>
<displayname\>_Personal Address Book</displayname\>
<description\>_This is your Personal Address Book</description\>
</entry\>
</books\>

公司目录 XML


示例 6–2 包含公司通讯录定义的 XML 部分


<book booktype="abook"
bookremoteurl="ldap://corpdirectory"\>
<bookoc\>piRemoteBook</bookoc\>
<entry entryID="idirectory"\>
<displayname\>_Corporate Directory</displayname\>
<description\>_This is Corporate Directory</description\>
</entry\>
</book\>

Procedure公司通讯录

对于公司通讯录和远程通讯录,personalstore.properties 文件中应存在相应的 xxx 实例。应该将 defaultps.xml 文件中 bookremoteurl 属性的值指定给 personalstore.properties 文件中的 db.xxx.urlmatch

要添加新的远程通讯录,需要添加以下项:

步骤
  1. defaultps.xml 文件中添加新的通讯录节点

  2. personalstore.properties 文件中添加新的 xxx 实例。

  3. WEB-INF/config 下创建一个目录,以存储 db_config.propertiesxlate 文件。


    注 –

    xlate 文件包含联系人或组的 LDAP Schema 和通讯录 XML Schema 之间的字段映射。


自定义全局 GUI

主题文件包含在 Communications Express 中显示的图标的逻辑名称及其默认位置。可通过更改此文件中指定的路径来更改图像的位置。默认的 theme.properties 文件位于 uwc-deployed-path/WEB-INF/skin 下。

在 uwcdomainconfig.properties 文件中配置语言

uwcdomainconfig.properties 文件包含某个域所支持的语言列表。列表中的每种语言用分号隔开。您可以定义 Communications Express 为域支持的语言列表。

例如,如果计划在名为 siroe.com 的域中支持 en(英语)、de(德语)、fr(法语)和 ja(日语),则将该域的 uwcdomainconfig.properties 文件中的 supportedLanguages 设置为 supportedLanguages=en;fr;de;ja

siroe.comuwcdomainconfig.properties 文件应位于:

WEB-INF/domain/siroe.com/uwcdomainconfig.properties

您还必须在相应的 i18n.properties 文件中定义可本地化的字符串。例如,

uwc-common-options-preferredLanguage-en=English

uwc-common-options-preferredLanguage-de=German

uwc-common-options-preferredLanguage-fr=French

uwc-common-options-preferredLanguage-ja=Japanese

siroe.com 的 i18n.properties 文件将位于:

WEB-INF/domain/siroe.com/locale/i18n.properties

如果用户的 LDAP 条目中没有 preferredLanguage 属性,则域的 preferredLanguage 属性、浏览器提供的标题值和 i18.properties 文件的可用性将决定用户会话中使用的语言。