Sun Java System Content Delivery Server 集成和配置指南

在部署 Sun Java System Content Delivery Server 后，需要进行一些配置，以便将部署设置为在现有基础架构中运行。所需的配置取决于要使用的功能。

本章包含以下主题：

• 配置监视服务
• 配置事件服务
• 配置同步
• 配置市场活动
• 设置定制报告
• 配置外部托管内容
• 设置自动发布
• 设置定制字段
• 定义受欢迎程度
• 启用过期项清除
• 配置设备客户机 Web 服务
• 配置实现服务

---

1.1 配置监视服务

要将应用程序监视代理与网络监视系统集成，需要配置监视服务。可以将监视服务配置为只发出您所需要的警报，而禁用所有其他警报。《Sun Java System Content Delivery Server 5.1 系统管理指南》的第 1.1 节“应用程序监视代理”中介绍了监视代理发出的状态和警报。

要配置监视服务，请编辑 $CDS_HOME/deployment/deployment-name/conf 目录中的 CDSSnmp.properties 文件。下表介绍了这些属性。

---

1.2 配置事件服务

事件服务基于 $CDS_HOME/deployment/deployment-name/conf/EventService.properties 文件中设置的属性生成事件。如果事件的使用方未运行，则 Java 消息服务 (Java Message Service, JMS) 将在事件的使用方启动之前保留这些事件。随着时间的推移，消息可能会越积越多并导致内存不足错误。

活动事件处理程序产生由通知服务使用的事件。可记帐事件处理程序将消息发布到后付费服务的某个主题，该服务在初次运行时将创建一个长期主题监听器客户端。开发者更新事件处理程序、开发者提交事件处理程序以及 OMA DRM 1.0 权限传送事件处理程序将消息发布到由消息传送服务使用的队列。

如果不希望将通知服务、后付费服务或消息传送服务作为 Content Delivery Server 系统的一部分运行，则可以通过配置事件服务不再生成消息来避免消息累积。要阻止处理程序生成消息，请编辑 EventService.properties 文件，并在定义处理程序的属性所在的行开头添加井号 (#) 以注释掉处理程序：

• 当未运行通知服务时，可通过注释掉以下语句来阻止生成活动通知，如下所示：

      #eventservice.handler=Campaign 

• 当未运行后付费服务时，可通过注释掉以下语句来阻止生成可记帐事件，如下所示：

      #eventservice.handler=Billing 

• 当未运行消息传送服务时，可通过注释掉以下语句来阻止生成消息，如下所示：

      #eventservice.handler=DeveloperUpdate 
      #eventservice.handler=DeveloperSubmit 
      #eventservice.handler=OMARightsDelivery 

---

1.3 配置同步

Catalog Manager 和每个 Vending Manager 具有其自己的数据库。诸如内容状态或支持的设备类型之类的信息必须跨数据库进行维护。数据库同步是由 Content Delivery Server 进行管理的。当 Vending Manager 收到来自 Catalog Manager 的更改通知时，Vending Manager 将尝试与 Catalog Manager 进行同步。如果同步失败，Vending Manager 将重试此操作。

要管理此操作的尝试次数和频率，请在 Vending Manager 部署的 $CDS_HOME/deployment/deployment-name/conf/RemoteVending.properties 文件中设置以下属性：

• vending.messaging.retries.no - 同步失败时 Vending Manager 尝试与 Catalog Manager 进行同步的次数。在重试指定的次数后，Vending Manager 将等待为 vending.messaging.processor.restart.interval 属性指定的时间间隔，然后再次尝试进行同步。
• vending.messaging.processor.restart.interval - Vending Manager 再次尝试与 Catalog Manager 进行同步之前等待的毫秒数。

《Sun Java System Content Delivery Server 5.1 参考手册》中的“Catalog Manager 和 Vending Manager”一章提供了有关 Catalog Manager 和 Vending Manager 之间同步的其他信息。

---

1.4 配置市场活动

Content Delivery Server 提供了可以将广告发送到选定订户的功能。可以使用短消息服务 (Short Message Service, SMS)、无线应用协议 (Wireless Application Protocol, WAP)、多媒体消息服务 (Multimedia Messaging Service, MMS) 或简单邮件传输协议 (Simple Mail Transfer Protocol, SMTP) 来发送消息。

以电子邮件形式发送的活动使用为消息传送服务定义的 SMTP 邮件服务。要更改邮件服务，请参见 10.1 配置邮件服务。

可以在消息中包含指向促销项目的链接。链接指向的地址基于为部署配置文件中的 sp.external.uri 属性指定的值。

如果配置文件中的值不正确，请编辑 $CDS_HOME/deployment/deployment-name/conf 目录中的 CDS.properties 文件，并将 default.external.subscriberportal.uri 属性的值设置为正确的地址。如果 Content Delivery Server 在防火墙后运行，请指定订户可以从防火墙外部进行访问的地址。

---

1.5 设置定制报告

Vending Manager 提供了每日统计报告，通过该报告可以查看和跟踪应用程序下载信息和使用情况统计。要生成定制报告，您可以对 Content Delivery Server 进行配置，以便将事务数据存储在 Vending Manager 数据库的 REPORT_DOWNLOAD 表中。

1.5.1 启用定制报告

要配置定制报告支持，请执行以下操作：

1. 编辑 $CDS_HOME/deployment/deployment-name/conf 目录中的 PostpaidService.properties 文件。

要启用报告处理程序，请从 postpaid.handler=ReportingHandler 语句中删除井号 (#)。

此外，还要设置以下属性：

• postpaid.handler.ReportingHandler.events。指定报告处理程序要处理的一个或多个记帐事件。有效事件为：
• content_purchased
• content_refunded
• download_error
• download_initiated
• subscription_cancelled
• subscription_purchased
• usage_purchased

要指定多个事件，请用垂直条 (|) 分隔这些事件。

• postpaid.handler.ReportingHandler.billingevent.process_free_downloads。设置为 true 可处理免费内容的事件。设置为 false 则不处理免费内容的事件。
• postpaid.handler.ReportingHandler.billingevent.process_prepay_events。设置为 true 可处理预付费内容的事件。设置为 false 则不处理预付费内容的事件。
• postpaid.handler.ReportingHandler.billingevent.identify_recurring_download_purchases。设置为 true 可将每次下载记帐模型的记帐事件标识为“定期”。设置为 false 则将事件标识为“已购买”。
• postpaid.handler.ReportingHandler.recovery.starting.transaction。设置为一个时间戳，用于标识要恢复的第一个事务。时间戳的格式为 MM-dd-yyyy HH:mm:ss，它是在 SimpleDateFormat 类中定义的。当 REPORT_DOWNLOAD 表为空时，将恢复过去的记录。该表中填充了指定给最新事务的事务中的数据。

2. 编辑 $CDS_HOME/deployment/deployment-name/conf 目录中的 ReportService.properties 文件。

设置以下属性：

• reportdb.username。用于访问报告数据库的用户名。这里为 prefix_vs_app，其中 prefix 是为 Prefix 元素指定的值，该元素在用于创建数据库的数据库配置文件中位于 Vending 元素的下方。有关此文件的信息，请参见《Sun Java System Content Delivery Server 5.1 安装指南》。
• reportdb.password。用于访问报告数据库的密码。这是为 Password 元素指定的值，该元素在数据库配置文件中位于 Vending 元素的下方。
• reportdb.server.url。数据库的连接 URL。此值被指定为 jdbc:oracle:thin:@dbhost.domain.com:1521:sid。按照需要为数据库服务器设置 dbhost.domain.com 和 sid。

1.5.2 为报告存储的数据

如果启用了定制报告，后付费服务将在 Vending Manager 数据库的 REPORT_DOWNLOAD 表中存储每个购买和退款事务的记录。为每个事务存储的信息都是事务发生时的实时信息。只有在执行事务恢复操作并且历史信息不可用时，才会更改已存储事务的信息。例如，如果订户更改了所使用的设备，该订户的新事务将显示新设备。除非执行了恢复操作，否则，使用旧设备发生的事务将继续在 MODEL 字段中显示旧设备。恢复的事务将显示新设备。

下表说明了当前为每个事务存储的数据。可以在以后的版本中更改该表。

---

1.6 配置外部托管内容

如果支持外部托管内容，事件服务必须具有对 Developer Portal 的访问权限。将使用为部署配置文件中的 dp.internal.uri 属性指定的值进行这种访问。如果未正确设置此属性，则无法获取对外部托管内容的更新。

如果配置文件中的值不正确，请按照以下步骤设置 Developer Portal URL：

1. 编辑 $CDS_HOME/deployment/deployment-name/conf 目录中的 CDS.properties 文件。

2. 将 default.internal.developerportal.uri 属性的值设置为 Developer Portal 的内部地址。

---

1.7 设置自动发布

通常，Catalog Manager 管理员审查所有提交的内容，然后确定要发布的项。如果需要，您可以将 Content Delivery Server 配置为自动发布内容并跳过管理员审查。可以使用以下选项：

• 自动发布所有内容。

对于此选项，请将 $CDS_HOME/deployment/deployment-name/conf/DeveloperPortal.properties 文件中的 submission.content.auto_publish 属性设置为 true。

• 在 Content Delivery Server 检测到更新时自动发布外部托管内容。

对于此选项，请将 $CDS_HOME/deployment/deployment-name/conf/DeveloperPortal.properties 文件中的 external.content.auto_publish 属性设置为 true。

• 按照 $CDS_HOME/deployment/deployment-name/conf/AutoPublishRules.properties 文件中设置的规则自动发布内容。

对于此选项，请定义用于自动发布的规则，并创建一个使用自动发布内容验证适配器的提交验证器工作流。有关设置规则的信息，请参见 AutoPublishRules.properties 文件中的说明。有关内容验证适配器的信息，请参见 14。

以下算法用于确定是否自动发布提交的内容：

1. 如果提交验证器工作流指示自动发布内容，则忽略 submission.content.auto_publish 和 external.content.auto_publish 属性并自动发布内容。

2. 如果 submission.content.auto_publish 为 true，则忽略 external.content.auto_publish 并自动发布内容。

3. 如果 external.content.auto_publish 为 true、内容为外部内容并且 Content Delivery Server 自动检测到外部内容更新，则会自动发布内容。

4. 如果 external.content.auto_publish 为 true 并且内容不是外部内容，则不会自动发布内容。

5. 对于其他情况，不会自动发布内容。

---

1.8 设置定制字段

Content Delivery Server 提供了一组标准字段，用于提供有关每个内容项的信息，如“名称”、“版本”和“简短描述”。除了标准字段以外，您还可以对 Content Delivery Server 进行配置以管理定制字段。

定制字段提供了有关企业所需内容的其他信息。还可以使用定制字段支持其他功能。例如，Content Delivery Server 使用定制字段支持特色内容概念。有关此功能的信息，请参见 17。

可以定义适用于所有内容类型的定制字段，也可以为不同的内容类型指定不同的字段。例如，您可能要为内容类型 midlet 创建一个名为“评级”的字段以指定游戏等级。

1.8.1 定义字段

要定义定制字段，请编辑 $CDS_HOME/deployment/deployment-name/conf/CustomField.properties 文件，然后创建表 1-3 中介绍的一组属性。对于每个属性，content-type 是与字段关联的内容类型，custom-key 是一个字符串，用于标识属性所适用的定制字段。

指定的内容类型必须是为 Content Delivery Server 定义的内容类型。要将字段与所有内容类型相关联，请使用 all。

定制键是一个字母数字字符串，它也可以包含破折号 (-) 或下划线 (_) 字符。只有在内容类型不同时，才可以将定制键用于多个字段。如果将某个键用于内容类型 all，则不能将其用于其他内容类型。

要在内容查找中包含定制字段，必须将这些字段包含在查找索引中。有关说明，请参见 11.2.2 在查找索引中添加定制字段。

如果具有远程 Vending Manager，应为 Catalog Manager 定义定制字段，然后将 CustomField.properties 文件复制到 Vending Manager。如果需要，您可以修改 Vending Manager 定制字段的属性，或者定义其他字段。不要删除字段。如果不希望向 Vending Manager 管理员或订户显示某个字段，请从字段定义的 viewable 和 editable 属性中删除门户。要在所有门户中隐藏某个字段，请将此属性设置为空字符串 ("")。

在对 CustomField.properties 进行更改后，不需要重新启动服务器。如果在提交内容后更改了属性，现有内容将使用新定义，但更改可能会产生以下结果：

• 如果更改了特定定制键的 datatype 属性，定制字段中的现有数据可能无法使用。
• 添加的定制字段为空。如果将新字段声明为 required，并且处理的现有内容不包含该字段的数据，则可能会发生错误。
• 已删除的定制字段中的数据无法使用。

Content Delivery Server 未提供定制字段迁移功能。如果在更改定制字段定义后需要进行数据迁移，则必须提供此进程。

1.8.2 指定标签和提示

出于本地化方面的原因，将在单独的文件中定义定制字段的标签和提示。标签用于标识字段并显示在用户界面中。提示用于提供字段的相关信息，并在用户将鼠标指针悬停在字段上时显示。必须在以下属性文件中为每个门户设置这些字符串，这些文件位于 $CDS_HOME/deployment/deployment-name/localization 目录中：

• AdminConsoleMessages.properties
• DevPortalMessages.properties
• VendingManagerMessages.properties
• SubscriberPortalLocaleResources.properties

这些文件的本地化版本的文件名包含语言代码，并且还可能包含国家/地区代码。在这些文件中，对于显示字段的每个门户以及支持的每种语言，请为 CustomField.properties 文件中定义的每个字段设置以下属性：

• emf.content-type.custom-key.label。请将此属性设置为作为字段标签显示的字符串。
• emf.content-type.custom-key.hint。请将此属性设置为一个字符串，用于提供在字段中输入的数据的相关信息。如果此属性在某个字段中不存在，则使用基于数据类型的默认提示。

content-type 是与字段关联的内容类型，custom-key 是一个字符串，用于标识属性所适用的字段。内容类型和定制键组合必须与 CustomField.properties 文件中的字段定义相匹配。

---

1.9 定义受欢迎程度

了解内容项的受欢迎程度可能是非常有用的信息。Content Delivery Server 提供了一项功能，它基于在一段时间内访问内容的次数来计算受欢迎程度。如果受欢迎程度的默认定义不符合需要，您可以对其进行定制。这种更改可能非常简单，您只需要限制在访问次数中包含的事件即可；也可能非常复杂，您需要编写自己的算法以计算受欢迎程度。

包含受欢迎程度等级的字段仅适用于储存的内容，Content Delivery Server 将根据您设置的计划自动对其进行更新。通过将该字段包含在默认查找结果或查找查询中，可以在 Vending Manager 管理控制台或 Subscriber Portal 中显示该字段。有关设置默认查找结果的信息，请参见 11.1 配置默认结果字段。

受欢迎程度等级因 Vending Manager 而异。如果多个未共享数据库的 Vending Manager 储存相同的内容项，每个 Vending Manager 将单独计算该项的受欢迎程度等级。

1.9.1 默认定义

默认情况下，Content Delivery Server 使用以下方法评定内容的受欢迎程度等级：将系统生成的与受欢迎程度有关的事件数除以自第一次发生事件后经过的时间。此计算的结果为浮点值。将计算以下事件数以确定受欢迎程度：

• content_purchased
• subscription_purchased
• usage_purchased
• gift_download_initiated
• gift_purchased
• gift_subscription_purchased
• gift_usage_purchased

每次处理列表中的某个事件时，事件计数将增加 1。默认情况下，还会计算免费内容的事件数。

Content Delivery Server 使用 $CDS_HOME/deployment/deployment-name/conf/CustomField.properties 文件中定义的定制字段来存储与受欢迎程度相关的信息。不要更改具有以下前缀的字段的字段定义：

• emf.all.first_access_time - 存储第一次访问内容时的时间戳。
• emf.all.popularity_hits - 存储与内容受欢迎程度有关的事件数。
• emf.all.popularity - 存储内容的受欢迎程度等级。此字段用于显示等级，以及用于按欢迎程度查找内容或对其进行排序。

1.9.2 定制受欢迎程度定义

如果受欢迎程度的默认定义不符合需要，您可以创建自己的定义。您可以继续使用默认算法并只更改计算的事件，也可以编写您自己的算法。

$CDS_HOME/deployment/deployment-name/conf/EventService.properties 文件中的以下属性控制默认算法计算的事件以及是否计算免费内容：

• eventservice.handler.Popularity.events。删除系统生成的以下事件：不想包含在受欢迎程度计数中以及无法使用某个其他属性排除的事件。不要将事件添加到此属性中。
• eventservice.handler.Popularity.count_download。如果设置为 true，则会在受欢迎程度计数中包含 download_initiated 事件。如果不希望将该事件包含在计数中，则设置为 false。
• eventservice.handler.Popularity.count_purchase。如果设置为 true，则会在受欢迎程度计数中包含 content_purchased、subscription_purchased 和 usage_purchased 事件。如果不希望将这些事件包含在计数中，则设置为 false。
• eventservice.handler.Popularity.count_gift。如果设置为 true，则会在受欢迎程度计数中包含 gift_download_initiated、gift_purchased、gift_subscription_purchased 和 gift_usage_purchased 事件。如果不希望将这些事件包含在计数中，则设置为 false。如果设置为 true，只有在将 eventservice.handler.Popularity.count_download 也设置为 true 时，才会计算 gift_download_initiated 事件。
• eventservice.handler.Popularity.count_free_content。如果设置为 true，则会在受欢迎程度计数中包含免费内容的事件。如果不希望将免费内容包含在计数中，则设置为 false。如果设置为 true，则必须至少将一个其他属性也设置为 true 才会计算免费内容。

Content Delivery Server 用于设置受欢迎程度等级的默认算法是在 com.sun.content.server.vending.PopularityImpl 类中定义的。要定义您自己的算法，请实现 cdsapi.jar 文件中包含的 com.sun.content.server.content.Popularity 接口。有关此接口的信息，请参见 $CDS_HOME/javadoc/cdsapi 目录中的 Javadoc 工具的输出。

在此实现就绪时，请将 $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties 文件中的 vsadmin.popularity.impl 属性设置为全限定类名。将包含算法的文件放在 $CDS_HOME/deployment/deployment-name/lib/external 目录中，以使 Content Delivery Server 能够进行访问。

如果要更改计算事件的方式（例如，在事件中添加不同的权重），您可以编写自己的受欢迎程度处理程序以处理这些事件，并设置在定制字段 popularity_hits 中存储的计数。如果您要编写自己的处理程序，请将 $CDS_HOME/deployment/deployment-name/conf/EventService.properties 文件中的 eventservice.handler.Popularity.classname 属性设置为全限定类名。

1.9.3 计划重新计算受欢迎程度

如果要重新计算 Vending Manager 中的所有内容的受欢迎程度，则可能会在运行此进程时降低系统性能。应将 Content Delivery Server 配置为按设置的计划重新计算，而不是在每次处理相关事件时重新计算。

要设置计划，请在 $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties 文件中设置以下属性：

• vsadmin.popularity.reindex.interval。请将此属性设置为两次重新计算间隔的分钟数。
• vsadmin.popularity.reindex.start。请将此属性设置为午夜过后的分钟数，以作为计算间隔的起始基准时间。例如，如果将此属性设置为 30，并且将 vsadmin.popularity.reindex.interval 设置为 90，则从凌晨 0:30 开始每隔 90 分钟重新计算一次受欢迎程度等级。
• vsadmin.popularity.reindex.enable。如果将此属性设置为 true，则会按照 vsadmin.popularity.reindex.interval 和 vsadmin.popularity.reindex.start 属性指定的计划重新计算受欢迎程度等级。如果不希望运行重新计算进程，则设置为 false。

---

1.10 启用过期项清除

流式传输的内容可能具有为其指定的结束时间。通过使用定制字段，其他内容也可以具有结束时间。可以将 Content Delivery Server 配置为自动取消激活到达截止时间的项，以使订户无法再使用这些项。要自动将过期内容的状态设置为 Inactive，请在 $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties 文件中设置以下属性：

• vsadmin.expired_content.cleanup.enabled。表示是否自动取消激活内容。设置为 true 可自动取消激活内容。设置为 false 则禁止自动取消激活内容。默认值为 true。
• vsadmin.expired_content.cleanup.interval。两次过期内容检查的间隔时间（以秒为单位）。默认值为 3600。

---

1.11 配置设备客户机 Web 服务

设备客户机 Web 服务是一些 API，可以在 Web 上使用这些服务来访问 Content Delivery Server 数据库中的数据。可以使用设备客户机 Web 服务验证订户，搜索、预览、购买和下载内容，访问订户的购买历史以及取消内容项订阅。

如果计划使用设备客户机 Web 服务来创建自己的订户界面，请在 $CDS_HOME/deployment/deployment-name/conf/SubscriberPortal.properties 文件中设置以下属性：

• subscriberApi.authkey.timeout.minutes。在验证密钥失效之前处于不活动状态的分钟数。初始值为 10。
• webservices.v1.authenticate.headers.enable。表示能否使用请求标题验证用户的标志。使用的请求标题取决于 Content Delivery Server 配置使用的 WAPGatewayAdapter 实现。设置为 true 可允许使用请求标题。设置为 false 则要求匿名使用或用户名和密码验证。初始值为 false。
• webservice.v1.auto_provision.unknown.userpeer。表示是否在 Content Delivery Server 中置备对外部订户数据库已知但 Content Delivery Server 无法识别的订户的标志。设置为 true 可置备未知用户。设置为 false 则禁止置备未知用户。初始值为 true。如果设置为 false，也可以对订户进行验证，但只能使用不要求订户对 Content Delivery Server 已知的设备客户机 Web 服务。

有关设备客户机 Web 服务的信息，请参见《Sun Java System Content Delivery Server 5.1 定制指南》中的第 13 章。

---

1.12 配置实现服务

来自设备的使用 URL 的内容请求是通过实现服务进行处理的。将使用发出请求的订户的 MSISDN 来验证该订户的订户计划是否包含所请求的内容，即订户是否具有该内容的访问权限。可以从请求标题中检索 MSISDN。如果请求标题中不包含 MSISDN，验证将会失败，并且不会传送内容。

如果支持的设备发出的请求所生成的请求标题不包含 MSISDN，则必须允许取消置备的用户下载内容，以确保能够传送该内容。允许取消置备的用户下载内容可绕过订户计划验证，因此不需要 MSISDN。

要允许取消置备的用户下载内容，请在每个 Vending Manager 部署的 $CDS_HOME/deployment/deployment-name/conf/FulfillmentService.properties 文件中将 fs.allow_unprovisioned_downloads 属性设置为 true。

^{1 (表格注解) dp = Developer Portal；vm = Vending Manager 管理控制台；cm = Catalog Manager 管理控制台；sp = Subscriber Portal；空字符串 ("") = 无门户。}

Sun Java System Content Delivery Server 集成和配置指南

820-5379-10

版权所有 © 2008, Sun Microsystems, Inc. 保留所有权利