发行说明

Sun Java™ System Content Delivery Server 2004Q1
产品更新 1

2005 年 3 月

文件号码 819-2478-10

简介

本产品更新提供了 Sun Java™ System Content Delivery Server 版本 2004Q1 的更新。其中还包含用于系统监视和维护的新实用程序（请参见新增工具。）

借助 Sun Java System Content Delivery Server，移动运营商、服务提供商和企业能够提供可以下载到移动用户的数据服务。内容聚集、表示和传送由 Catalog Manager、Fulfillment Manager 和 Vending Manager 单独进行管理。通过这些管理器，服务提供商可以对几乎所有类型的无线内容进行添加、管理、销售、下载和记帐。

从通过内容提供商获取内容，直至将内容传送给移动设备，Sun Java System Content Delivery Server 对整个内容生命周期进行全程管理。同时提供标准适配器，以便与组织的现有基础结构集成，包括记帐系统、WAP 网关和订户数据库。API 还可用于编写定制的适配器。

[页首]

此次更新中修复的错误

本节包含此次更新中修复的错误信息。错误列为以下几类：

整体 Sun Java System Content Delivery Server
API
包
活动
Catalog Manager
Developer Portal
设备
礼品
轻量目录访问协议 (LDAP)
移动始发 (MO) 推送
短消息服务 (SMS) 推送
面向订户的错误
Vending Manager
文档

下表说明与整体 Sun Java System Content Delivery Server 系统有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5034089	浏览类别可能很慢
5049429	连接池设计/实现问题
5062302	新设备的新版储存内容创建了新类别
5062609	当 Catalog Manager 和 Vending Manager 的类别不同时，更新某版会更改 Vending Manager
5067847	对于在 Catalog Manager 中编辑的储存内容，内容状态更改为 `Unavailable`
5078959	如果初次购买某项内容失败，则随后的所有购买都将失败
5095024	如果 Content Delivery Server 与外部记帐系统集成，则查看详细资料不调用 `BillingInfo`
5103142	Catalog Manager、Vending Manager、Subscriber Portal - 在搜索字段中使用下划线 (_) 符号时，搜索结果出现异常
6184728	Vending Manager 内容名称中的特殊字符 "\|" 和 "." 会使活动和包树断开
6199050	Vending Manager 的类别价格编辑不能使用迁移的数据
6211942	如果未生成事件，则不会强制生成连续（例如，每天）记帐记录文件
6212047	报告服务从不记录 `subscription_purchase` 或 `usage_purchase` 事件
6216077	无法预览标题中带有引号的铃声
6219762	在第二个 Vending Manager 上的 `cdsi db update` 出现 SQLException
6221312	无法自动储存版的升级
6221659	无论是哪个文件名传递到 `cdse startserver`，始终都是在 `DBConf.xml` 上完成数据库字符集验证
6222591	有可能在试用期内免费无限次使用内容

下表说明与 API 有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
6208582	`BillingManager.getBillingInfo(s)` 在 `ApiUtil` 内被多次调用

下表说明与内容包有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
6183214	对于包，批量编辑外部内容和组 ID 不能按预期方式运行
6183807	无法下载带有未储存内容的包
6184428	如果已购买包，则必须显示任何状态下的所有内容
6187153	如果两项包中的内容状态更改，则将显示包带有一项或不带有项
6191644	已由订户购买的包即使处于不活动状态，也仍然可用
6198735	在设备门户中，包的导航和下载功能将更强大
6199655	有可能创建带有“试用”记帐模型的包
6199732	如果包中没有与所有内容相匹配的设备，则允许使用此包
6199738	在包中显示不正确的“支持的设备”列表

下表说明与活动有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5078271	如果活动包含扩展的土耳其语字符，则 XHTML 手机会出现问题。
5102355	事件驱动的活动 - 内容下载不可用
6177862	通过活动管理接口发送到订户的 MMS 库拥有不正确的促销 URL
6177977	通过活动管理接口发送到订户的 MMS 库拥有不正确的主题信息
6178222	如果活动已执行，则无法删除订户帐户
6185531	如果外发活动未进行，则获取活动无效
6189789	从 Vending Manager 进行活动预览不应触发对 `getBillingInfo(s)` 的调用
6190327	在到期日之内跟踪事件驱动的活动失败
6190500	事件驱动的活动在到期后仍旧发送活动
6191585	活动接收者数量的显示不一致
6211163	在“已提交内容”主页上可以按照“新”状态搜索内容
6224499	如果将外发活动中的任何内容移到不活动状态，则该活动将被阻止
6225447	不支持 `en_US` 语言环境的设备不可访问活动

下表说明与 Catalog Manager 有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
4931725	编辑计划时，类别名称中的特殊字符造成错误
5021731	无法删除特定设备的 MIME 类型映射
5026634	在 Catalog Manager 中编辑应用程序时，服务器繁忙
5031849	在编辑后未更新详细资料页
5088720	Catalog Manager - 将“已发布内容”下第二级类别显示的内容移到末尾
5097018	不能正确保存通过 Catalog Manager 手动创建的设备
6184694	功能匹配可能因某条内容而阻塞，并在此停止
6185766	Catalog Manager - 删除关联的设备时，“查看内容版”为空
6197541	支持的设备功能存在限制
6199426	开发者许可证持有人功能停用 - 没有为开发者计划显示的开发者帐户
6208618	一些 MIDlet 的功能匹配后台作业失败
6211194	有可能创建带有多个文件扩展名（不用逗号分隔）的 MIME 类型
6211686	Catalog Manager 允许您编辑管理员的 LoginID
6211822	执行版本更新或内容更新后，Catalog Manager 中的价格会重置为初始值
6212681	Catalog Manager - “已发布内容”的“类别价格编辑”不可用

下表说明与 Developer Portal 有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5040143	无法加载 MIDP2.0 游戏
5097062	PAR 提交 - 可以提交显示名称超过 20 个字符的内容
6206548	在 Catalog Manager 的开发者创建页中，电子邮件字段具有 25 个字符的限制
6226368	`Cp_Notification` - 提交接收到不正确的 URL
6229096	无法远程提交托管的受版权保护的内容

下表说明与设备有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5077827	Nokia 6600 - 下载 MIDP2 内容过程中出现 `Qtn_swins_note_no_ams_auth` 错误
5092939	Nokia 6600 - 无法运行 MIDP2 内容
5095551	"--------------"（出现在文本“主菜单”上面）
6186205	Samsung A600 - 类别在主菜单上向上移动之后，未显示出移动过
6186210	Samsung N400 - 类别在主菜单上向上移动之后，未显示出移动过
6208630	未建立有效的会话就不能检索内容描述符

下表说明与礼品有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5052526	在“订户帐户”信息中不显示赠予的内容
6210148	订阅礼品不调用 `BillingManager.subscriber()` 方法
6185953	下载礼品后，不显示“我的下载”列表
6227710	订阅的礼品只可能下载一次

下表说明与 LDAP 支持有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5069747	需要对 LDAP 进行配置，才能一次搜索多个分支
5092680	CDS 与外部客户 LDAP USER 系统信息库相集成
6191574	在注册外部用户时，事件驱动的活动不可用
6195534	通过 LDAP 置备订户时，Opt-in 功能不可用
6214062	密码提醒功能对新订户不可用（该订户虽然在 LDAP 中，但是不在 Content Delivery Server 中）

下表说明与 MO 推送有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
6199798	通过带有 contentID 的移动始发 SMS 进行购买时，不针对订户计划检查订户

下表说明与 SMS 推送有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
6201518	订户 API 中的消息服务将 SMS 消息限制在 120 个字符

下表说明面向订户的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5051149	消息“Please purchase the application before attempting to download（请在尝试下载之前购买应用程序）”始终以英文形式显示
5063613	尝试从 Subscriber Portal 更新系统生成的临时密码出现错误
5072853	下载次数超过 5 次的订户只能看到最初 5 次下载的内容
5078844	“Subscription（订阅）”和“per period（每期）”未本地化
5088354	Nokia 3650 - 浏览内容时，如果删除订户，则发出错误消息“API 上下文无效”
5088356	Nokia 6600 - 浏览内容时，如果删除订户，则发出错误消息“API 上下文无效”
6186688	XML-RPC - `serHandler.setModelId()` 可能使 Vending Manager 中断
6191485	XML-RPC - 无法获取与购买相关的证明书
6198893	对于其参数在外部记帐系统中无效的内容，Content Delivery Server 应考虑购买方案
6199723	在 Subscriber Portal 中应显示不同的价格
6203287	选项卡导航上的订户更改密码表单重置
6210081	编辑配置文件时，按钮标签所使用的字符串与说明中使用的字符串不同
6213153	使用 LDAP 时无法查看内容属性
6181956	要能够禁用“订户 Web”控制台上的“购买确认”屏幕
6226608	订户不能删除“愿望列表”中不活动的内容
6228902	无法从基于设备的 Subscriber Portal 推送礼品

下表说明与 Vending Manager 有关的错误，这些错误均已在此次更新中修复。

错误 ID	描述
5030747	不能正确编辑外部内容 ID
5096052	刚刚删除设备就进行帐户更新之后，“Vending Manager->帐户”崩溃
5096993	在 Vending Manager 中编辑外部内容和内容的组 ID 将中止浏览功能
6199593	订户计划添加成员 - 单击分页中的“执行”时，页面发生错误
6199739	`resource.try_before_you_buy.label` 显示在 Vending Manager 的“查看内容属性”中
6200198	对于免费内容，购买历史显示空单元
6205115	随着订户的增加，订户计划管理的性能显著下降
6211834	进行版本/内容更新之后，Vending Manager 中的零售价格返回到初始值
6213627	在购买历史页面上，分页中断
6214841	编辑外部内容 ID 之后抛出异常
6214856	编辑外部内容 ID 很慢
6218611	如果使用消息传送服务，则无法取消储存内容或删除订户
6221171	只能在提交内容之后，设置免费试用和定期下载的价格组合
6224928	Vending Manager - 在带有多个子类别的类别中，“已发布内容”未显示在目录内容列表中

下表说明了文档错误，此发行说明中已包含这些错误的修复。有关文档更新的信息，请参见文档问题。

错误 ID	描述
5043938	Java™ Message Service (JMS) 无法处理未使用的事件
5089115	署名指南的第 13 页为 Developer Portal 数据指定了错误的文件进行编辑
6180877	管理员指南的“捆绑的内容”中存在错误信息和屏幕快照
6181492	管理员指南的包中有关内容状态更改的信息不正确
6188320	集成指南 - “后付费记录”生成操作的设置信息不正确
6185221	文档和 Vending Manager 包内容中的实际情况存在偏差
6189099	有关下载和使用情况的报告跟踪信息不正确
6189734	某些模式的登录名致使“用户注册”失败
6190442	未介绍 `cdse statusservice` 的功能
6191107	文档错误地一起指定了订阅和使用价格
6207253	没有为 `common.external_content_id.enable` 属性指定文件
6221952	`postpaid.record.class` 的类名必须是全限定的
6229322	`postpaid.output.refresh.frequency` 可以是 "yearly"、"monthly"、"weekly" 和 "daily"
6239457	容量计划指南：对此部署的硬件要求错误地介绍为 2MB RAM
6242278	容量计划指南和安装指南的基本硬件要求不匹配

[页首]

系统要求

系统要求在安装指南的第 2.1 节“验证先决条件”中进行了描述。本指南位于 Sun Java System Content Delivery Server 安装目录的 Documentation/language/install 子目录中。

以下要求覆盖了安装指南中的相应部分：

最低内存要求为 1 GB RAM。
Oracle 9i 版本 9.2.0.6.0 是 Sun Java System Content Delivery Server 要求使用的数据库。
如果使用的是 Sun Java System Application Server 7，则要求使用下列软件：
- Sun Java System Application Server 7 Update 6
- Java 2 SDK, Standard Edition 1.4.2_07
如果使用的是 WebLogic Server，则要求使用 WebLogic Server 7.0 Service Pack 5。

[页首]

产品更新的内容

可以使用两种不同的分发文件。一种文件用于进行 Sun Java System Content Delivery Server 2004Q1 的完整产品安装，其中包含此次产品更新中提供的更改。另一种文件用于更新现有的 Sun Java System Content Delivery Server 2004Q1 安装。将选中的分发文件解压缩到所选的目录中。

解压缩用于完整产品安装的分发文件将创建一个名为 Sun_Java_System_Content_Delivery_Server_2004Q1-PU1 的子目录，该目录包含以下文件和目录：

LicenseReadme：包含与此产品相关的许可证文本文件的目录。
Proprietary_Rights_Notice.txt：包含有关专有权限信息的文件。
ReleaseNotes：包含该产品发行版发行说明和此次更新发行说明的目录。
jscds-2004Q1-PU1-bin-solaris-sparc.zip：包含产品文件、文档和第三方源代码的文件。

解压缩用于产品更新的分发文件将创建一个名为 Sun_Java_System_Content_Delivery_Server_2004Q1-PU1-Patch 的子目录，该目录包含以下文件和目录：

LicenseReadme：包含与此产品相关的许可证文本文件的目录。
Proprietary_Rights_Notice.txt：包含有关专有权限信息的文件。
ReleaseNotes：包含此次更新发行说明的目录。
jscds-2004Q1-PU1-patch-bin-solaris-sparc.zip：包含已更新产品文件的文件。

[页首]

安装

本节包含以下主题：

安装完整产品
将此更新应用于现有安装
查看更新历史

安装完整产品

如果尚未安装 Sun Java System Content Delivery Server 2004Q1，则可以通过相应的产品更新分发文件进行完全安装。按照安装指南中的安装说明执行操作。解压缩产品压缩文件的内容之后，该指南位于 $CDS_HOME/Documentation/language/install 目录中。

安装说明的更新如下：

Sun Java System Content Delivery Server 需要 Java DataBase Connectivity (JDBC™) 软件的驱动程序，该软件是您所使用的数据库服务器附带的。按照第 3.1.2 节“步骤 2：设置基本部署的数据库”、第 3.2.2 节“步骤 2：设置 Vending Manager 部署的数据库”或第 3.3.2 节“步骤 2：设置高级部署的数据库”中所述方法设置数据库时，在部署之前，应该先将 classes12.zip 文件从数据库服务器复制到 $CDS_HOME/dist/cds/lib 中。如果在部署之前未复制该文件，则必须在部署之后，将 classes12.zip 文件复制到 $CDS_HOME/deployment/deployment-name/lib。
如果使用的是 Sun Java System Application Server，则在按照第 3.1.5.1 节“设置 Sun Java System Application Server”中所述的方法设置服务器后，必须编辑位于 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/server-name/config 目录中的 server.xml 文件。将 java-config 元素的 java-home 属性设置为某个目录，该目录是为 init_env.sh 文件中的 SUN_AS_JAVA_HOME 变量指定的。
提供了英语、加拿大法语和简体中文版本的 Subscriber Portal。为了支持法语和中文版本，您必须在部署之后向 Catalog Manager 添加相应的语言环境。有关说明，请参见管理员指南的“添加新语言环境”一节。请使用下表中显示的值。

语言语言代码国家/地区代码

法语 fr CA

中文 zh CN

语言	语言代码	国家/地区代码
法语	fr	CA
中文	zh	CN

将此更新应用于现有安装

如果已安装 Sun Java System Content Delivery Server 2004Q1，则使用更新脚本来更新安装。

进行更改时，更新脚本将备份要更改的文件。

源目录	备份目录
`$CDS_HOME/dist`	`/tmp/backupdist_cds_day_month_year.hour.minute.second`¹
`$CDS_HOME/deployment/deployment-name`²	`/tmp/backupdepl_deployment-name_day_month_year.hour.minute.second`¹
¹ `day_month_year.hour.minute.second` 是执行更新脚本的日期和时间。 ² `deployment-name` 是所备份的部署的名称。

应用更新：

停止所有正在运行的 Sun Java System Content Delivery Server 进程。
切换到解压缩分发文件时创建的 Sun_Java_System_Content_Delivery_Server_2004Q1-PU1-Patch 目录。
使用以下命令解压缩 jscds-2004Q1-PU1-patch-bin-solaris-sparc.zip 文件：
unzip jscds-2004Q1-PU1-patch-bin-solaris-sparc.zip -d cds-home

cds-home 是初次安装 Sun Java System Content Delivery Server 时创建的主目录。
接收到文件将被替换的警告，并询问您将采取何种操作时，回复 A。
使用以下命令将更新应用于分发目录中的文件：
cdsi patchdist 2004Q1-PU1-Patch.xml

将更新应用于分发目录之后，以后的部署都将使用更新的文件。
使用以下命令将数据库更新为当前内部版本：
cdsi db update db-config

db-config 是部署中所使用的数据库配置文件的名称。如果未指定 db-config，则使用 $CDS_HOME/bin/init.env.sh 文件中 DEFAULT_DB 变量的值。

如果拥有多个数据库配置文件，则更新所有实例。
使用以下命令将更新应用于每个现有部署：
cdsi patchdepl 2004Q1-PU1-Patch.xml deployment-name cfg-file-name

deployment-name 是要修补的部署的名称，cfg-file-name 是用于部署的部署配置文件的名称。如果未指定 deployment-name，则使用 $CDS_HOME/bin/init.env.sh 文件中 DEFAULT_DEPL 变量的值。如果未指定 cfg-file-name，则使用 $CDS_HOME/bin/init.env.sh 文件中 DEFAULT_CONFIG 变量的值。
如果使用的是 Sun Java System Application Server，则必须为每个部署编辑 server.xml 文件。此文件位于 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/server-name/config 目录中。将 java-config 元素的 java-home 属性设置为某个目录，该目录是为 init_env.sh 文件中的 SUN_AS_JAVA_HOME 变量指定的。
以前进行的署名或定制可能都需要重新应用。检查备份目录中的文件，查看更新了哪些文件，并根据需要重新应用所做的更改。
重新启动 Sun Java System Content Delivery Server 管理器和服务。

查看更新历史

要查看分发文件的更新历史，请使用以下命令：

cdsi distpatches

要查看部署的更新历史，请使用以下命令：

cdsi deplpatches [deployment-name]

deployment-name 是要查看的部署的名称。如果未指定 deployment-name，则使用 $CDS_HOME/bin/init_env.sh 文件中设置的 DEFAULT_DEPL 变量的值。

[页首]

新增工具

本节介绍此产品更新提供的以下新增工具。

诊断工具
许可证审计工具

诊断工具

Content Delivery Server 提供的诊断工具用于在出现问题时报告有关系统和环境的信息。使用此工具可以获得以下系统组件的诊断信息：

Application server
Content Delivery Server 配置
Java™ Virtual Machine
(注：术语 "Java Virtual Machine" 和 "JVM™" 即 Java™ 平台的虚拟机。）
数据库
操作系统

如果使用的是 HP-UX，则有关设置系统以支持该工具的说明，请参见在 HP-UX 上运行诊断工具。

命令语法

诊断工具 cdsdiag 位于 $CDS_HOME/bin 目录中。请使用以下命令运行该工具：

cdsdiag [options] -component

下表介绍了有效选项。

选项	描述
`-f [file]`	写入所生成输出的文件的名称。如果文件未在当前目录中，则包含其路径。如果 `-all` 指定为组件，则文件名是包含不同类型诊断报告的 tar 归档的名称。如果未指定文件名，则将数据写入标准输出 (stdout)。
`-d deployment`	请求其诊断信息的部署的名称。如果未指定部署，则使用 `init_env.sh` 文件中为 `DEFAULT_DEPL` 属性指定的缺省部署。
`-w`	表明输出文件将被覆盖的标志。如果未指定，则新数据将附加到文件的现有数据中。只有在同时使用 `-f` 选项时，该选项才有意义。注：如果为组件指定 `-all`，则将忽略此选项。除非使用 `-i` 选项，否则 tar 文件将始终重写上一个文件。
`-i`	表明将在输出文件的名称中添加附标的标志。每当使用相同的文件名运行诊断工具时，附标将以 1 为增量递增，同时创建一个新文件。例如，如果在三次执行诊断工具时，都将 `diaginfo` 指定为文件名，则在第三次执行之后，将拥有的文件如下：`diaginfo.1.tar`、`diaginfo.2.tar` 和 `diaginfo.3.tar`。只有在同时使用 `-f` 选项，并且组件为 all 时，该选项才有意义。
`-u username`	访问数据库的用户名。只有当组件是 `oracle` 时，该选项才有意义。
`-p password`	访问数据库的密码。只有当组件是 `oracle` 时，该选项才有意义。

下表介绍了有效组件。

值	描述
`all`	提供所有组件的所有信息。
`appserv`	提供有关 Application Server 的信息。请参见 Application Server 诊断。
`conf`	提供有关 Sun Java System Content Delivery Server 当前配置的信息。请参见 Content Delivery Server 配置。
`jdkstat`	提供有关 Java Virtual Machine 的信息。请参见 Java Virtual Machine 诊断。
`oracle task`	基于为 `task` 指定的值，提供有关数据库的信息。以下是 `task` 的有效值： `all`：提供数据库的所有信息。 `config`：提供有关数据库配置的信息。 `instance`：提供有关实例状态的信息。 `memory`：提供有关内存使用量和高速缓存命中率的信息。 `session`：提供有关数据库会话的信息。 `storage`：提供有关存储的信息。 `rowcount`：提供有关临界表中行数的信息。 `help`：列出 `task` 的有效值。请参见数据库诊断。
osstat	提供有关操作系统的信息。请参见操作系统诊断。

组件诊断

诊断工具提供的信息取决于在诊断工具命令中指定的组件。以下各节根据组件介绍信息。

使用以下命令可生成所有组件的所有信息：

cdsdiag [options] -all

有效选项在选项表中进行介绍。

注：如果使用的是 WebLogic Server，则只有在未频繁使用 Sun Java System Content Delivery Server 时才对所有诊断运行此命令。否则，存在使系统关闭的风险。

Application Server 诊断

使用以下命令生成 Application Server 的诊断信息：

cdsdiag [options] -appserv

有效选项在选项表中进行介绍。

将提供以下信息：

JMS 服务器统计
JMS 消息的当前量和高峰量
已发送字节的当前量和高峰量
JMS 消息使用者的当前量和高峰量
Java Transaction API 创建的活动事务数量
只有在使用 WebLogic Server 时才提供 Java Virtual Machine 的诊断信息

Content Delivery Server 配置

使用以下命令生成有关 Sun Java System Content Delivery Server 配置的诊断信息：

cdsdiag [options] -conf

有效选项在选项表中进行介绍。

将提供以下信息：

Sun Java System Content Delivery Server 当前部署的版本和内部版本号
以下文件中属性的当前值：
- $CDS_HOME/deployment/deployment-name/CDS.properties
- $CDS_HOME/cfg/$DEFAULT_CONFIG（缺省部署配置文件）
- $CDS_HOME/cfg/$DEFAULT_DB（缺省数据库配置文件）
以下环境变量的当前值：
- $BEA_HOME
- $WL_HOME
- $WL_JAVA_HOME
- $SUN_AS_JAVA_HOME
- $DEFAULT_CONFIG
- $DEFAULT_DB
- $DEFAULT_DEPL

Java Virtual Machine 诊断

使用以下命令生成 Java Virtual Machine 的诊断信息：

cdsdiag [options] -jdkstat

有效选项在选项表中进行介绍。

将提供以下信息：

Java Virtual Machine 参数
Content Delivery Server 的活动线程数
可用堆内存和最大堆内存
线程的堆栈跟踪数

Java Virtual Machine 诊断将写入执行诊断工具的命令窗口标准输出中。要将诊断信息写入文件中，请在启动 Sun Java System Content Delivery Server 时使用日志过滤实用程序 cdslogfilter.pl。例如：

cdse starterserver | cdslogfilter.pl [options]

请参见安装指南，以了解有关启动 Sun Java System Content Delivery Server 的信息。有关实用程序的信息，请参见日志过滤实用程序。

注：如果使用的是 WebLogic Server，则只有在未频繁使用 Sun Java System Content Delivery Server 时才对 Java Virtual Machine 诊断运行此命令。否则，存在使系统关闭的风险。

数据库诊断

使用以下命令生成数据库的诊断信息：

cdsdiag [options] -oracle task

有效选项在选项表中进行介绍。如果未指定 -u 选项或 -p 选项，则会提示您指定该值。

所提供的有关数据库的信息基于为 task 指定的值。有效值为：

all：提供数据库的所有信息。
config：提供有关数据库配置的信息。
instance：提供有关实例状态的信息。
memory：提供有关内存使用量和高速缓存命中率的信息。
session：提供有关数据库会话的信息。
storage：提供有关存储的信息。
rowcount：提供有关临界表中行数的信息。
help：列出 task 的有效值。

操作系统诊断

使用以下命令生成操作系统的诊断信息：

cdsdiag [options] -osstat

有效选项在选项表中进行介绍。

将提供以下信息：

网络状态
文件系统状态
与 Sun Java System Content Delivery Server 相关的所有进程的堆栈跟踪数
磁盘空间
当前打开的文件和连接的列表

诊断工具使用以下系统实用程序来收集诊断信息。如果其中一个实用程序不可用或未正确配置，则可能生成警告，但是不会提供相应的信息。

ifconfig
df
ps
lsof

注：如果收到来自 lsof 实用程序的错误，请确保运行的是最新版本（可通过 http://people.freebsd.org/~abe/ 获得）。此外，如果由无权限的用户运行诊断工具，则必须为 lsof 实用程序设置 s 位。要设置 s 位，请使用命令 chmod u+s lsof。

日志过滤实用程序

日志过滤实用程序捕获 Java Virtual Machine 线程转储的输出，并且在请求 Java Virtual Machine 诊断时由诊断工具调用。有关该实用程序用法的示例，请参见 Java Virtual Machine 诊断。该实用程序作为另一个进程输出的代理，不可作为独立的进程。如果要从 Java Virtual Machine 进程中过滤 Java Virtual Machine 线程转储，则使用此实用程序。

注：该实用程序是使用 Perl 编写的脚本，需要 Perl 解释程序才能执行。如果 Perl 解释程序不在 /bin/perl 目录中，则必须编辑脚本第一行，以指定解释程序所在的位置。

日志过滤实用程序 cdslogfilter.pl 位于 $CDS_HOME/bin 目录中。使用以下命令运行该实用程序：

cdslogfilter.pl [options]

下表介绍了有效选项。

选项描述

-v 表明来自传入管道的所有数据均打印为标准输出 (stdout) 以及打印到文件的标志。

选项	描述
-v	表明来自传入管道的所有数据均打印为标准输出 (stdout) 以及打印到文件的标志。
-f `file`	写入输出的文件的名称。缺省值为 `$CDS_HOME/.jvmdump`。注：诊断工具要求使用缺省文件名。如果将日志过滤实用程序与诊断工具一起使用，则不要使用此选项。

-f file

写入输出的文件的名称。缺省值为 $CDS_HOME/.jvmdump。

注：诊断工具要求使用缺省文件名。如果将日志过滤实用程序与诊断工具一起使用，则不要使用此选项。

在 HP-UX 上运行诊断工具

HP-UX 平台当前不支持 -osstat，该选项用于获取有关操作系统的信息。

要使用诊断工具的其他选项，请使用以下代码为 ps 命令创建包装 (wrapper) 脚本。

$ cat > /ups.sh << _EOF_
#!/bin/sh
# translates BSD ps in HP-UX ps
[ -z "$1" ] && { ps ; exit $?; }
[ "$1" = "auxww" -o "$1" = "-auxww" ] && { ps -efx; exit $?; }
ps -xp $1
exit $?
_EOF_
$ chmod +x /ups.sh

通过以下步骤，自行更改诊断工具中某些系统命令的缺省位置：

打开 $CDS_HOME/bin/cdsdiag 文件进行编辑。
找到以 TAIL= 开头的行，并用 TAIL=/usr/bin/tail 进行替换。
找到以 AWK= 开头的行，并用 AWK=/usr/bin/awk 进行替换。
找到以 UPS= 开头的行，并用 UPS=/ups.sh 进行替换。
如果将包装脚本保存到其他位置，请使用相应位置来替换 /ups.sh。
保存所做的更改。

现在即可在 HP-UX 平台上使用诊断工具。

[页首]

许可证审计工具

Sun Java System Content Delivery Server 提供了许可证审计工具，用于生成有关系统使用率的报告。该工具旨在监视系统使用率，以确保使用率在许可协议的范围内。在每月和每个许可证周期结束时会自动运行该工具。您还可以手动运行该工具，以生成特定时段的报告。

审计数据是由与 Vending Manager 关联的事件服务生成的。每月数据本地存储在一个文件中。在许可证周期结束生成的数据或由手动执行生成的数据将通过电子邮件发送到指定的地址。

配置

为了确保许可证审计工具能够准确报告，请设置下表中所述的属性。这些属性位于 $CDS_HOME/deployment/deployment-name/conf 目录下的 License.properties 文件中。

属性	描述
`license.disable`	表明是否自动运行工具的标志。设置为 `true` 可禁用自动报告。注：针对特定的 Vending Manager 运行事件服务的多个实例时，可能要禁用许可证工具。
`license.model`	运行 Sun Java System Content Delivery Server 所遵循的许可协议中指定的许可证模型。使用下列值中的一个： `Active Subscribers` - 许可证基于活动订户的数量。活动订户就是在为 `license.period` 指定的周期内，按照为 `license.download_count` 指定的下载次数下载内容的订户。 `Transactional` - 许可证基于为 `license.period` 指定的周期内的下载次数。注：这两种模型都计算启动的下载次数。对于退款、购买或价格模型允许无限次下载的内容不作调整。
`license.download_count`	在为 `license.period` 指定的周期内，视为活动订户的订户需要的下载次数。只有当 `license.model` 设置为 `Active Subscribers` 时，该属性才有意义。
`license.period`	许可证周期的天数。注：无论指定的月包含多少天，都将一个月解释为 30 天。
`license.start_date`	许可证开始处于活动状态的日期。以 mm/dd/yyyy 格式输入日期。月或天不需要前导零。例如，6/7/2005 就是一个有效日期。
`license.organization`	与为其生成报告的 Vending Manager 关联的组织名称。该值包含在通过电子邮件发送的报告中。
`license.smtp.address`	在每个许可证周期结束时或手动运行该工具后发送报告的目标地址。有关设置要使用的邮件服务的信息，请参见安装指南中第 4.9.1 节“配置邮件服务”。

执行

如果启用自动报告（license.disabled 属性设置为 false），则事件服务将在每月和许可证周期结束时触发许可证审计工具运行一次。也可以手动执行许可证审计工具。在上一节的属性表中定义了本节引用的属性。

每月执行

初次启动事件服务时，将生成每月的审计条目，日期范围从为 license.start_date 属性指定的日期到当前日期。此后的每个月，都会在每月与 license.start_date 属性对应的那一天运行许可证审计工具。例如，如果起始日期设置为 6/7/2005，则将在每月 7 号运行许可证审计工具。

月报告包含自许可证起始日期开始每月的条目。每个条目包含该月的活动订户数或事务数，具体情况取决于许可证模型。条目将写入 $CDS_HOME/deployment/deployment-name/logs 目录下的 License.txt 文件中。如果找不到该文件，则此工具将重新创建文件，并重新生成过去所有月份的数据。

周期结束执行

在 license.period 属性中指定报告周期的长度。从许可证起始日期开始，事件服务将在每个周期结束时触发许可证审计工具。生成的报告包含该周期的活动订户数或事务数，具体情况取决于许可证模型。该信息将发送到为 license.smtp.address 属性指定的电子邮件地址。

手动执行

您可以使用以下命令随时生成手动报告：

cdsi license [deployment-name] [database-configuration] [date]

下表介绍了可选参数。

参数	描述
`deployment-name`	为其运行工具的部署的名称。如果未指定名称，则使用 `init_env.sh` 文件中 `DEFAULT_DEPL` 变量的值。
`database-configuration`	要使用的数据库配置文件的名称。如果未指定名称，则使用 `init_env.sh` 文件中 DEFAULT_DB 变量的值。
`date`	运行报告的日期，格式为 mm/yyyy。返回的信息针对包含指定日期的周期。例如，如果从 1/1/2005 开始，周期为 90 天，输入的日期为 8/2005，则返回周期介于 7/1/2005 和 9/30/2005 之间的信息。如果未指定日期，则使用当前日期。

生成的报告包含该周期（含有指定日期）的活动订户数或事务数。报告的数据类型取决于许可证模型。该信息将发送到为 license.smtp.address 属性指定的电子邮件地址。

[页首]

API 更改

本节介绍 Sun Java System Content Delivery Server API 的更改。有关 API 的信息，请参见 Javadoc™ 工具的 HTML 输出。安装了完整产品或将更新应用于现有安装后，该信息位于 $CDS_HOME/javadoc 目录中。

软件包：com.sun.content.server.service.security

类更改

UserManager

新方法：

protected abstract java.lang.String doFormatLoginId(java.lang.String loginId)
protected abstract java.lang.String doFormatMobileId(java.lang.String mobileId)
public final java.lang.String formatLoginId(java.lang.String loginId)
public final java.lang.String formatMobileId(java.lang.String mobileId)

软件包：com.sun.content.server.billing

类更改

BillingConstants

新常量：

public static final java.lang.String KEY_CONTENT_SHORT_DESCRIPTION
public static final java.lang.String KEY_NEW_PRICING
public static final int STATUS_GIFT_REFUNDED

BillingInfo

过时的方法：

public int getPreviousBillingStatus()
public void setPreviousBillingStatus(int inPreviousBillingStatusConstant)

软件包：com.sun.content.server.subscriberapi

类	更改
`IPurchaseDetails`	新方法： `public java.lang.String getTicket()`
`IContentService`	新方法： `public boolean hasPurchases()` 新常量： `public static final int DETAILS_INCLUDE_PRICING_AND_GIFTING_INFO` `public static final int DETAILS_INCLUDE_RETAIL_PRICE` 过时的方法： `public java.util.Collection getContentDetails(java.util.Collection contentSummaries, java.util.BitSet filter, long campaignId, long bundleId, boolean retailPrice, booleanisSkip Trial)`
`IGifting`	新方法： `public boolean isRefunded()`
`IApiContext`	新常量： `public static final java.lang.String API_REQUEST_PROPERTY_PREPAY`
`CDSException`	新常量： `public static final java.lang.String CDS_EX_ACCOUNT_DISABLED` `public static final java.lang.String CDS_EX_ACCOUNT_MODIFIED` `public static final java.lang.String CDS_EX_ACCOUNT_REMOVED` `public static final java.lang.String CDS_EX_BILLING_EXCEPTION` `public static final java.lang.String CDS_EX_DEVICE_UNSUPPORTED_LOGIN` `public static final java.lang.String CDS_EX_DEVICE_UNSUPPORTED_NOT_LOGIN`

注：对于 com.sun.content.server.subscriberapi.ApiUtil 类，以下方法错误地标识为公共方法。请不要使用这些方法。

public static com.sun.content.server.vendcatalog.Content[] getActiveBundleItems(IApiContext apiContext, long bundleId)
public static long getBestContentForClass(IApiContext apiContext, long classId)
public static boolean isPrepay(long subscriberId)

[页首]

已知错误和问题

本节包含以下主题：

文档问题
本地化问题
设备问题
软件错误

[页首]

文档问题

解压缩分发文件的内容后，文档位于 $CDS_HOME/Documentation 目录下。本节介绍了针对文档所进行的更正与添加。包含以下主题：

安装指南
管理员指南
署名指南
容量计划指南
内容开发者指南
定制指南
集成指南

安装指南

本节介绍安装指南的更新。

第 4.1.1.2 节“配置 SMS 的消息传送服务”

在配置 SMS HTTP 推送支持的消息传送服务的步骤中，$CDS_HOME/deployment/deployment-name/conf/MsgService.properties 文件中设置的属性名称已更改。

以前的名称	新名称
`sms.http.serverurl`	`cds.sms.http.serverurl`
`sms.http.user`	`cds.sms.http.user`
`sms.http.password`	`cds.sms.http.password`
`sms.http.from`	`cds.sms.http.from`

在 MsgService.properties 文件中必须设置五个额外的属性。下列属性指定要在 SMS 消息中传送的 HTTP 参数的名称。

cds.sms.attribname.userid
cds.sms.attribname.password
cds.sms.attribname.from
cds.sms.attribname.msg
cds.sms.attribname.to

例如，如果短消息服务中心 (SMSC) 使用 HTTP 参数 smsfrom 来标识发送消息的起始位置，则将 cds.sms.attribname.from 设置为 smsfrom。这些值不得为空值或空白。

第 4.1.3 节“配置后付费服务”

在步骤 2 中，还必须设置用于处理礼品退款的属性。例如，

postpaid.billingevent.type.gift_refunded=true

在步骤 3a 中，common.external_content_id.enable 属性位于 $CDS_HOME/deployment/deployment-name/conf/CDS.properties 文件中。

在步骤 4 中，postpaid.output.refresh.frequency 属性的有效值如下：

daily。每天在启动“后付费服务”的同时生成一个新文件。例如，如果该服务在 02:07:00 启动，则在每天 02:07:00 都将生成一个新文件。
weekly。每周在启动“后付费服务”的同时生成一个新文件。例如，如果该服务在星期四的 22:30:57 启动，则在每星期四的 22:30:57 都将生成一个新文件。
monthly。每月在启动“后付费服务”的同时生成一个新文件。例如，如果该服务在 3 月 14 日的 21:23:34 启动，则在每月 14 日的 21:23:34 都将生成一个新文件。
yearly。每年在启动“后付费服务”的同时生成一个新文件。例如，如果该服务在 1 月 6 日的 04:10:05 启动，则在每年 1 月 6 日的 04:10:05 都将生成一个新文件。

注：停止并重新启动后付费服务，将重新启动写入文件的周期。例如，如果频率设置为每周，后付费服务最初在星期一启动，然后在星期四重新启动，则将在下一个星期四写入下一个文件，而不是在下一个星期一写入。

在步骤 5 中，要恢复过去的记帐记录，应将 postpaid.recovery.enabled 属性设置为 true。该属性位于 $CDS_HOME/deployment/deployment-name/conf/PostpaidService.properties 文件中。

步骤 6 是一个新增步骤。如果希望在未生成记帐记录的情况下也创建记帐记录的文件，则将 postpaid.output.refresh.empty_file 设置为 true。如果不想创建空文件，则将该属性设置为 false。如果该属性设置为 true，则无论是否存在记帐记录，都将在以下时间生成文件。如果该属性设置为 false，则只有存在记帐记录时，才能在以下时间生成文件。

每个周期结束时
重新启动后付费服务时
恢复事件时

如果缺少该属性，则缺省值为 true。如果该属性设置为 true 或 false 以外的值，则缺省值为 false。

第 4.1.6 节“配置事件服务”

事件服务基于 $CDS_HOME/deployment/deployment-name/conf/EventService.properties 文件中设置的属性生成事件。如果事件的使用者未运行，则 JMS 将保留事件，直至启动事件的使用者。随着时间的推移，这可能导致内存不足。

活动事件处理程序产生由通知服务使用的事件。可记帐事件处理程序将消息发布到后付费服务的某个主题，该服务在初次运行时创建一个长期主题监听器客户端。如果您不想将通知服务或后付费服务作为 Sun Java System Content Delivery Server 系统的一部分运行，则通过配置事件服务，以不再生成消息，从而避免消息累积。

未运行通知服务时，通过注释掉 $CDS_HOME/deployment/deployment-name/conf/EventService.properties 文件中的以下属性，可以停止生成活动通知。

eventservice.handler.campaign_event.id=campaign_event
eventservice.handler.campaign_event.classname=com.sun.content.server.eventservice.server.handler.CampaignEventHandler
eventservice.handler.campaign_event.events=subscriber_registered|content_purchased|content_refunded|download_install_notified

要注释掉某个属性，请在行首添加一个井号 (#)。

未运行后付费服务时，通过注释掉 $CDS_HOME/deployment/deployment-name/conf/EventService.properties 文件中的以下属性，可以停止生成可记帐事件。

eventservice.handler.billable_event.id=billable_event
eventservice.handler.billable_event.classname=com.sun.content.server.eventservice.server.handler.CDSBillableEventHandler
eventservice.handler.billable_event.events=*

要注释掉某个属性，请在行首添加一个井号 (#)。

第 4.4.3 节“设置 Subscriber Portal 属性”

以下属性添加到表 11 中：

特性	描述	属性
消息长度	指定推送到设备的消息允许的最大长度。	`max.device.message.length` 将此属性设置为推送到设备的消息中包含的最大字节数。缺省值为 10000。
显示价格	指定当订户从“选择内容”页面或“我的下载”列表查看内容详细资料时，是显示当前价格还是购买价格。	`display.price.navigation` 将此属性设置为 `retail`，订户从“选择内容”页面查看内容详细资料时，向所有订户显示当前价格。设置为 `purchase`，向购买内容的订户显示购买价格。 `display.price.my_downloads` 将此属性设置为 `retail`，显示当前价格。设置为 `purchase`，显示购买价格。

第 4.7.1 节“Java 应用程序的工作流”

MIDP 2.0 应用程序的工作流包含一个额外的步骤，即“向 MIDlet 添加权限”。此步骤将向 MIDlet-Permissions 和 MIDlet-Permissions-Opt 特性添加所需的权限，通过连接的数字权限管理 (DRM) 代理运行由 Sun Java System Content Delivery Server 进行程序校验的 MIDlet 时需要这些权限。如果未完成 MIDP 2.0 应用程序的程序校验或者使用了断开连接的 DRM 代理，则在工作流中注释此步骤。

第 4.7.1.1 节“数字权限管理设置程序校验”

在表 15 中，DRM 代理的大小发生了变化。

DRM 代理	新大小	以前大小
Disconnected Time Sensitive	3.2	3.0
Disconnected Use Sensitive	4.6	4.4
Small Connected Use and Time Sensitive	无变化	5.1
Midsize Connected Use and Time Sensitive	无变化	5.8
Standard Connected Use and Time Sensitive	7.1	6.9

第 4.8.1 节“设置缺省语言”

如果将缺省语言设置为非英语语言，并且要支持将英语作为一个语言选项，则必须将 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件复制到 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource_en.properties。

第 4.12 节“配置对定制报告的支持”

在步骤 2 中，报告数据库是 prefix_es，而不是 prefix_report。

第 5.3 节“确定服务的状态”

使用以下 Content Delivery Server 执行命令 (cdse) 确定 Sun Java System Content Delivery Server 的某个服务组件是否正在运行。

cdse statusservice prefix

下表显示了 prefix 的有效值。

前缀	服务组件
es	事件服务
ms	消息传送服务
pl	推送监听器服务
ns	通知服务
pp	后付费服务
cl	确认监听器服务
mo	监视服务

如果服务正在运行，则将写出字符串 "Service service-name is RUNNING"，并且进程结束，状态代码为 0。如果服务未运行，则将写出字符串 "Service service-name is NOT running"，并且进程结束，状态代码为 1。

您既可以从命令行输入此命令，检查服务的当前状态；也可以将该命令包含在自动进程中，以根据服务是否正在运行来采取相应的措施。

第 B.1.1 节“设置数据库连接池大小”

此信息将替换本书中的同类信息。

几个 Sun Java System Content Delivery Server 组件同时访问数据库。为了获得最佳性能，请按照以下指导所述设置数据库连接的数量。

在以下文件中，将 db.pool.size.max 属性设置为运行 Content Delivery Server 的服务器上 CPU 数量的 8 倍。例如，如果服务器拥有两个 CPU，则将此属性设置为 16。
- $CDS_HOME/deployment/deployment-name/conf/SubscriberPortal.properties
- $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties
在 $CDS_HOME/deployment/deployment-name/conf/FulfillmentService.properties 文件中，将 db.pool.size.max 属性设置为运行 Content Delivery Server 的服务器上 CPU 数量的 4 倍。例如，如果服务器拥有两个 CPU，则将此属性设置为 8。
在以下文件中，将 db.pool.size.max 属性设置为运行 Content Delivery Server 的服务器上 CPU 数量的 2 倍。例如，如果服务器拥有两个 CPU，则将此属性设置为 4。
- $CDS_HOME/deployment/deployment-name/conf/AdminConsole.properties
- $CDS_HOME/deployment/deployment-name/conf/DeveloperPortal.properties
- $CDS_HOME/deployment/deployment-name/conf/PostpaidService.properties
- $CDS_HOME/deployment/deployment-name/conf/ReportService.properties

必须对数据库进行配置，以支持为 Sun Java System Content Delivery Server 的所有实例指定的连接数量。将数据库的 sessions 参数设置为一个数值，该数值大于为 db.pool.size.max 属性指定的连接数总和。例如，使用指导中指定的样例数量，并假设 Content Delivery Server 具有两个实例，则将 sessions 参数设置为 114。

注：如果运行数据库的服务器不支持指定的连接数量，并且性能下降，请根据需要减小连接池的大小，以避免数据库过载。

第 B.1.3 节“设置数据库内存分配”

这是全新的章节。

最佳的数据库配置取决于很多因素。本节中提供的信息可作为数据库管理和调节的起点。

对于拥有多达 5000 个内容项和 50 个设备的系统，请按照以下指导进行内存分配：

将共享池大小设置为 2GB。
将高速缓存存储区设置为 1.5GB 或更大值。
对于共享数据库配置，请使用以下指导：
- 使用以下等式设置进程全局区 (Process Global Area, PGA) 目标：
  10MB * 最大数据库连接数量
  
  有关数据库连接的信息，请参见第 B.1.1 节“设置数据库连接池大小”。
- 使用以下等式设置大池：
  200MB + 用户全局区 (User Global Area, UGA)
  
  UGA = 0.5MB * 最大数据库连接数量。有关数据库连接的信息，请参见第 B.1.1 节“设置数据库连接池大小”。
对于专用数据库配置，请使用以下指导：
- 使用以下等式设置进程全局区 (PGA) 目标：
  （10MB * 最大数据库连接数量）+ UGA
  
  UGA = 0.5MB * 最大数据库连接数量。有关数据库连接的信息，请参见第 B.1.1 节“设置数据库连接池大小”。
- 将大池设置为 200MB。
将 Java_pool_size 参数设置为 0。

随着将更多的内容或设备添加到系统中，可能需要更多的内存，特别是高速缓存存储区。内存分配不足可能导致出现数据库错误消息或性能下降。

第 D 节“报告”

报告数据库是 prefix_es，而不是 prefix_report。

[页首]

管理员指南

本节介绍管理员指南的更新。

"Catalog Manager" 一章的子段“搜索内容”

步骤 2 中介绍可以输入内容描述中的某个词有误。搜索内容时，在“查找”文本字段中既可以输入内容标题的一部分，也可以输入完整标题。然后将显示与搜索条目完全匹配的所有内容的列表。

"Catalog Manager" 一章的子段“编辑内容”

您可以选择内容的价格模型组合。请注意，您可以设置一个价格模型或以下组合之一：

下载和每次使用
下载和订阅/每期（仅适用于 Java MIDlet 应用程序）

如果设置多个价格模型，则将按照设置的组合条件进行收费。

以前在设置内容的价格选项时，下载选项非常混乱。尽管可能以两种不同的方式提交相同的价格模型，选项的表示方式与显示也是完全相同的。

现在价格选项的表示已经非常清晰，允许您选择以下选项之一：

第一次下载：仅第一次下载的价格金额 $X
定期下载：每 X 次下载或 X 天内的价格金额 $X

"Catalog Manager" 一章的子段“删除版”

这是全新的章节。通过指定没有设备与内容关联，可以使内容版对于订户不可用。

编辑版（请参阅管理员指南中的“查看已发布版”）。
在“支持的设备”字段中单击“选择”。
选中“强制不为此版选择设备”选项。

"Catalog Manager" 一章的子段“管理设备”

当针对设备的所有内容运行功能匹配，并且一项或多项内容验证失败时，进程可以完成，但是“后台作业”列表却显示作业失败。Catalog Manager 管理员无法重试此作业。失败的内容项必须更正。并针对这些项启动另一个功能匹配进程。管理员可以检查失败作业的“后台作业详细资料”页，以查看验证失败的内容。

"Catalog Manager" 一章的子段“同步 Vending Manager”

这是管理员指南中全新的章节。重新激活不活动的 Vending Manager 时，必须与 Catalog Manager 数据库的当前状态同步。Catalog Manager 管理员现在可以转到“帐户”页，选择所需的 Vending Manager 帐户，然后单击“同步”按钮，以将 Vending Manager 与 Catalog Manager 同步。

单击 Catalog Manager 主菜单栏上的“帐户”。
显示 "Vending Manager" 页。
单击要更新的 Vending Manager 帐户。
显示“Vending Manager 帐户详细资料”页。
单击“同步”。
帐户详细资料上面将出现一条消息：Vending Manager 正在与 Catalog Manager 数据库同步。只同步内容版和设备功能匹配结果。请注意，执行此进程可能需要一段时间。
如果对 Catalog Manager 中的价格或内容元数据进行了更改，则必须手动更新 Vending Manager 中的信息。

只要 Vending Manager 表现出与 Catalog Manager 不同步，您就可以同步 Vending Manager 数据库。

"Catalog Manager" 一章的子段“添加开发者帐户”

在步骤 3 中，输入密码之后，必须在“确认密码”字段中再次输入密码。

"Catalog Manager" 一章的子段“添加 Catalog Manager 管理员帐户”

在步骤 3 中，输入密码之后，必须在“确认密码”字段中再次输入密码。

"Vending Manager" 一章中的字段“储存内容”和“编辑储存的内容”

您可以选择内容的价格模型组合。请注意，您可以设置一个价格模型或以下组合之一：

下载和每次使用
下载和订阅/每期（仅适用于 Java MIDlet 应用程序）
试用和下载
试用和每次使用
试用和订阅/每期
试用及下载和每次使用
试用和下载以及订阅/每期

试用是购买前试用模型。如果设置多个价格模型，则将按照设置的组合条件进行收费。

以前在设置内容的价格选项时，下载选项非常混乱。尽管可能以两种不同的方式提交相同的价格模型，选项的表示方式与显示也是完全相同的。

现在价格选项的表示已经非常清晰，允许您选择以下选项之一：

第一次下载：仅第一次下载的价格金额 $X
定期下载：每 X 次下载或 X 天内的价格金额 $X

"Vending Manager" 一章的子段“查找储存的内容”

搜索储存的内容时，可以在“查找”文本字段中输入标题的一部分、内容的整个标题，或内容描述中的某个词。然后将显示包含一个或多个搜索条目的所有内容的列表。

"Vending Manager" 一章的子段“创建包”

如果在系统中没有任何设备可以运行包中的所有内容，则在创建包时将发出一条警告消息。该包将存储起来，但是不可用于任何订户。

"Vending Manager" 一章的子段“管理包”

如果包中的内容状态由活动更改为不活动（如测试或已删除），则不会向订户显示该内容。Vending Manager 管理员可以在包的属性页上看到内容状态的变化。并不会向 Vending Manager 发送电子邮件通知。

本节对状态进行了更正，即当包中以前不活动的内容项再次处于活动状态时，如果 Vending Manager 中的自动储存选项设置为 ON，则订户立即可以使用该内容项。只有当该选项设置为 OFF 时，才需要由 Vending Manager 管理员手动重新储存内容。然而，如果内容项由于处在“测试”状态而不活动，则当该内容项的状态返回到活动时将自动重新激活，与自动储存设置无关。

有关包的其他信息，请参见附录“包和礼品”。

"Vending Manager" 一章的子段“查看包信息”

“捆绑的内容”页的屏幕捕获显示错误的捆绑内容列表和“储存选项”按钮。该页应显示类别内容树和“创建包”按钮。单击“按标题查看”可按名称查看捆绑内容的完整列表。该“按标题查看”页与“储存的内容”的“按标题查看”页类似。

"Vending Manager" 一章的子段“添加 Vending Manager 管理员帐户”

在步骤 3 中，输入密码之后，必须在“确认密码”字段中再次输入密码。

"Vending Manager" 一章的子段“添加订户帐户”

在步骤 4 中，输入密码之后，必须在“确认密码”字段中再次输入密码。

"Vending Manager" 一章的子段“查看订户的下载历史”

除了显示订户下载的内容列表之外，“订户帐户”页还显示订户给出和收到的礼品。

"Vending Manager" 一章的子段“管理订户许可证”

第一段后面的注意事项已更正，如下所述：
您只能为使用订阅价格选项的内容（作为礼品赠予或接收的内容除外）更改许可证状态。

"Vending Manager" 一章的子段“创建 MMS 消息”

在步骤 4 中需注意，如果您使用的多媒体消息服务中心 (Multimedia Message Service Center, MMSC) 或订户的设备不支持 $CDS_HOME/deployment/deployment-name/conf/MsgService.properties 文件的 mms_smil.template.filename 属性中定义的同步多媒体集成语言 (Synchronized Multimedia Integration Language, SMIL) 模板，则文本的位置可能与选定的位置有所不同。

在步骤 7 中，如果您提供带有图像或视频文件的音频文件，则音频文件将与图像或视频同时播放。这些文件将同时显示，而不是按顺序显示。

附录“包和礼品”

此附录介绍购买 Content Delivery Server 版本 2004Q1 产品更新 1 中捆绑内容的订户体验。提供此信息的目的是使 Vending Manager 管理员和客户服务代理能够在包可用时或包中的内容发生更改时，更好地了解订户可以看到、购买和下载的内容。

包价格

在 Vending Manager 中，捆绑内容的“按标题查看”页显示每个包的当前零售价格。“查看内容包属性”页显示以下价格信息：

包中每个内容项的当前零售价格
Vending Manager 管理员对于每个内容项所花费的成本
包的当前零售价格

在订户的设备上，“我的下载”显示屏指出为内容支付的购买价格，包括捆绑的内容。

“获取内容”显示屏以两种方式指出内容价格，具体情况取决于价格属性设置的方式。订户可以看到独立和捆绑内容的以下价格类型之一：

当前零售价格
未购买内容的当前零售价格和已购买内容的支付价格（由指示器表示已购买的内容，如灰色突出显示）

由于销售事件、促销活动等因素的差异，当前零售价格和内容的购买价格可能会有所不同。

不可用的内容

本节介绍在包不可用或包中的内容项不可用时，订户可以使用的内容。当内容处于由 Catalog Manager 管理员设置的以下一种状态时，该内容不可用：

待定
测试
已拒绝
已删除

当包处于由 Vending Manager 管理员设置的以下一种状态时，该包或其内容不可用：

不活动
未储存

Vending Manager 管理员也可以删除包。

Vending Manager 管理员可以从“捆绑的内容”选项卡页的“按标题查看”显示屏查看包的状态。订户从“获取内容”显示屏查看可进行购买的包和内容。可以从“我的下载”页查看已购买的包和内容。

包和内容方案

订户可在其设备上检查“获取内容”显示屏，查看可购买的内容。不向订户显示不可用的包或包中不可用的内容项。

Vending Manager 管理员可以在捆绑内容的“按标题查看”显示屏中检查包的可用性。在“查看内容包属性”页中显示包中各个内容项的可用性。当 Vending Manager 管理员删除某个包时，将从包列表中将其删除。

下表介绍了在购买包之后，订户可在其已购买内容列表（“我的下载”）中看到的内容；以及下载内容之前，包的状态或包中内容的更改。

方案我的下载

包由 Vending Manager 管理员删除。由于该包是在将其从“储存的内容”中删除之前购买的，因此将显示它。
由于已购买包，因此订户可以下载包中的任何内容或所有内容。包的内容将被视为任何其他以前购买的内容。

包的状态发生更改，并且在购买后变为不可用。由于包是在其状态更改之前购买的，因此将显示它。订户单击该包即可查看其内容。
由于已购买包，因此订户可以下载包中的任何内容或所有内容。包的内容将被视为任何其他以前购买的内容。

在购买时，包中的某些内容项不可用。随后，整个包都将变为不可用。由于包是在变为不可用之前购买的，因此将显示它。该包仍然可供下载。
包中任何不可用的内容将由指示器表示 1。如果订户单击不可用的内容，则将显示消息“* 该内容当前不可用”。

在购买时，包中的某些内容项不可用。包中不可用的内容将由指示器表示。如果订户单击不可用的内容，则将显示消息“* 该内容当前不可用”。
如果不可用的内容重新变为可用，则内容将显示为可用。

在购买时，包中的所有内容项都可用。购买包之后，一些内容项变为不可用。 包中最初购买包含的所有内容都显示在该包的内容列表中。
包中不可用的内容将由指示器表示。如果订户单击不可用的内容，则将显示消息“* 该内容当前不可用”。

如果不可用的内容重新变为可用，则内容将显示为可用。

在购买时，包中的一条或多条内容不可用。购买之后，包中的某些不可用内容项变为可用。购买包后，包中的内容可供下载。
任何不可用的内容将由指示器表示。如果订户单击不可用的内容，则将显示消息
“该内容当前不可用”。

如果不可用的内容重新变为可用，则内容将显示为可用。

购买的包中包含还可独立提供的内容项。该包中的所有内容均可供下载。如果订户尝试购买独立提供的内容，则将显示消息“此内容已在下列包中购买”。
订户无法再次购买该内容。

购买多个包含相同内容项的包。所有包中的内容均可供下载。您可以只下载一次内容。如果订户下载包含内容 A 的包 1，然后购买也包含内容 A 的包 2，则将通知该订户已下载内容 A。

1. 状态指示器是可配置的，例如，订户可以看到指示器为颜色指示器或星号。

方案	我的下载
包由 Vending Manager 管理员删除。	由于该包是在将其从“储存的内容”中删除之前购买的，因此将显示它。由于已购买包，因此订户可以下载包中的任何内容或所有内容。包的内容将被视为任何其他以前购买的内容。
包的状态发生更改，并且在购买后变为不可用。	由于包是在其状态更改之前购买的，因此将显示它。订户单击该包即可查看其内容。由于已购买包，因此订户可以下载包中的任何内容或所有内容。包的内容将被视为任何其他以前购买的内容。
在购买时，包中的某些内容项不可用。随后，整个包都将变为不可用。	由于包是在变为不可用之前购买的，因此将显示它。该包仍然可供下载。包中任何不可用的内容将由指示器表示 1。如果订户单击不可用的内容，则将显示消息“* 该内容当前不可用”。
在购买时，包中的某些内容项不可用。	包中不可用的内容将由指示器表示。如果订户单击不可用的内容，则将显示消息“* 该内容当前不可用”。如果不可用的内容重新变为可用，则内容将显示为可用。
在购买时，包中的所有内容项都可用。购买包之后，一些内容项变为不可用`。`	包中最初购买包含的所有内容都显示在该包的内容列表中。包中不可用的内容将由指示器表示。如果订户单击不可用的内容，则将显示消息“* 该内容当前不可用”。如果不可用的内容重新变为可用，则内容将显示为可用。
在购买时，包中的一条或多条内容不可用。购买之后，包中的某些不可用内容项变为可用。	购买包后，包中的内容可供下载。任何不可用的内容将由指示器表示。如果订户单击不可用的内容，则将显示消息 “该内容当前不可用”。如果不可用的内容重新变为可用，则内容将显示为可用。
购买的包中包含还可独立提供的内容项。该包中的所有内容均可供下载。	如果订户尝试购买独立提供的内容，则将显示消息“此内容已在下列包中购买”。订户无法再次购买该内容。
购买多个包含相同内容项的包。所有包中的内容均可供下载。	您可以只下载一次内容。如果订户下载包含`内容 A` 的`包 1`，然后购买也包含`内容 A` 的`包 2`，则将通知该订户已下载`内容 A`。
1. 状态指示器是可配置的，例如，订户可以看到指示器为颜色指示器或星号。

注 – 当更新的版本替换已删除的内容时，更新的内容将显示在包的内容列表中。与其他内容一样，更新的可用性会在“我的下载”中指出。在“获取内容”列表中，可用更新将替换已删除的版。

将以相同的方式显示礼品包和赠予内容的可用性。

赠予信息

Vending Manager 的“订户帐户”页现在包含一些字段，显示已作为礼品被订户接收的内容及订户之间相互赠予的内容。

[页首]

署名指南

在“对 Developer Portal 署名”一章的简介中，第二项应该引用 $CDS_HOME/deployment/deployment-name/localization/DevPortalMessages.properties，将其作为包含标题和其他文本元素字符串的文件。

[页首]

容量计划指南

本节介绍容量计划指南的更新。

补充资料

本发行版中包含的是《Sun Java System Content Delivery Server 容量计划指南》的补充资料。该补充资料提供了一些指导，可以帮助您规划 Content Delivery Server 的安装。其中包括中等部署配置所需的最低硬件和软件要求，以及可用于确定硬件和软件需求的样例计划。

部署计划补充资料作为 HTML 文件 setup.html，位于 $CDS_HOME/Documentation/language/capacity 目录中。

第 2.1 节“试用配置”

本节末尾介绍的硬件要求应为 2GB RAM，而不是 2MB。

[页首]

内容开发者指南

本节介绍内容开发者指南的更新。

“通过向导提交新内容”一节

在步骤 7 中，设备图标和小图标的大小指定为 40 x 40 像素，大图标的大小指定为 80 x 80 像素。如果使用不同大小的图像，则使用这些图像的页面可能无法在订户的设备上正确显示。

在步骤 10 中，有用于选择内容价格模型组合的选项。请注意，您可以设置一个价格模型或以下组合之一：

下载和每次使用
下载和订阅/每期（仅适用于 MIDlet）

如果设置多个价格模型，则将按照设置的组合条件请求付费。

以前在设置内容的价格选项时，下载选项非常混乱。尽管可能以两种不同的方式提交相同的价格模型，选项的表示方式与显示也是完全相同的。

现在价格选项的表示已经非常清晰，允许您选择以下选项之一：

第一次下载：仅第一次下载的价格金额 $X
定期下载：每 X 次下载或 X 天内的价格金额 $X

“创建内容提交文件”一节

<EditionName> 标记的描述需要以下附加信息：

此值最大不超过 64 个字符。

在内容提交文件的“价格描述符节”中，<Subscription> 标记和 <Usage> 标记是互斥的。代码示例 4 包含两个错误的标记。正确的示例没有 <Usage> 标记。

“创建置备文件”一节

<display-name> 标记的描述需要以下附加信息：

此值最大不超过 20 个字符。

<content-file> 标记的描述需要以下附加信息：

如果捆绑的内容不包含描述符文件，则必须包含 <content-file> 标记，指示内容所在的位置。此链接既可以是相对的，也可以是绝对的。包的内容文件必须可用于服务器。

[页首]

定制指南

本节介绍定制指南的更新。

第 2.3 节“事件和事件数据”

以下事件添加到表 6“事件”中。

事件	描述
`gift_refunded`	已对订户购买的礼品发放了退款。

以下更改应用于表 7“事件数据”：

以前的名称	新名称	更改
`content_description`	内容的详细描述	已修改描述
`content_short_description`	内容的简短描述	添加的参数

第 6.1 节“用户管理器类”

该类中有两种新方法。

doFormatMobileId
格式化移动 ID，以匹配外部数据库的要求。例如，对于无法处理 ID 内连字符的数据库，使用此方法可以删除特殊字符。

protected abstract String doFormatMobileId(String mobileId);
doFormatLoginId
格式化登录 ID，以匹配外部数据库的要求。例如，对于需要小写 ID 的数据库，使用此方法可以将 ID 转换为小写。

protected abstract String doFormatLoginId(String loginId);

第 10.3.2.4 节 "ContentHandler"

在表 14“ContentHandler 的方法”中，getContentDetails 方法的参数包含 isSkipTrial。参数的正确列表如下：apiContext、contentId、campaignId（可选）、bundleId（仅当内容是包的一部分才指定）、retailPrice、isSkipTrial、filter。

同样在表 14 中，getContentDetailsList 方法的参数包含 isSkipTrial。参数的正确列表如下：apiContext、contentIdList、campaignId（可选）、bundleId（仅当内容是包的一部分才指定）、retailPrice、isSkipTrial、filter。

第 10.3.2.5 节 "DownloadHandler"

在表 15“DownloadHandler 的方法”中，pushMMSContent 方法的正确参数是 apiContext 和 contentId。该方法不返回任何参数。

第 10.3.2.8 节 "SystemHandler"

SystemHandler 存在新方法。

方法名称	描述	参数	返回
`getDefaultModel`	获取缺省设备模型。	`apiContext`	`modelId`

第 10.3.2.10 节“方法的参数”

以下更改应用于表 20“方法参数”：

参数 campaignExpiration 的描述应该指出，如果活动到期则返回 NULL。
参数 purchaseList 包含另一个名为 codedTicket 的元素，这是与购买关联的唯一证明书。

[页首]

集成指南

本节介绍集成指南的更新。

第 2.3 节“使用后付费服务”

以下更正应用于 $CDS_HOME/deployment/deployment-name/conf/PostpaidService.properties 文件中的属性：

将 postpaid.record.class 属性设置为 com.sun.content.server.postpaid.PostpaidBillingRecord。
设置 postpaid.template.filename 属性的正确示例是
postpaid.template.filename=deployment/deployment-name/conf/resources/default_record.xsl

以下更改应用于表 1“记帐事件参数”：

以前的名称	新名称	更改
`content_description`	内容的详细描述	已修改描述
`content_short_description`	内容的简短描述	添加的参数

第 3.3.1 节“为 LDAP 创建映射文件”

在步骤 2 中，现已不再在 security.config 文件中设置属性 security.ldapusermanager.max_search_wait_time。将在映射文件中指定最长等待时间，如下一节中所述。

第 3.3.1.1 节“Content Delivery Server 的订户数据”

除了表 2 中所述的 LDAP 属性和表 3 中所述的订户数据之外，映射文件还包含以下配置属性：

属性描述

属性	描述
`search_scope`	搜索的范围。指定下列值中的一个： `0`：OBJECT_SCOPE，搜索命名的对象。 `1`：ONELEVEL_SCOPE，只搜索命名对象的一个级别。这是缺省值。 `2`：SUBTREE_SCOPE，搜索命名对象的整个子树。
`max_search_wait_time`	LDAP 执行搜索请求的最长时间（毫秒）

search_scope

搜索的范围。指定下列值中的一个：

0：OBJECT_SCOPE，搜索命名的对象。
1：ONELEVEL_SCOPE，只搜索命名对象的一个级别。这是缺省值。
2：SUBTREE_SCOPE，搜索命名对象的整个子树。

max_search_wait_time LDAP 执行搜索请求的最长时间（毫秒）

第 3.3.1.2 节“样例映射文件”

样例映射文件在 <ldap> 元素之前需要以下代码：

<ldapusermanager>
  <config>
    <search_scope>1</search_scope>
    <max_search_wait_time>1000</max_search_wait_time>
  </config>
  <ldap>
    .
    .
  </ldap>
    .
    .
</ldapusermanager>

第 7.1.1 节“页面定义”

表 5“Subscriber Portal 页面的 XML 文件”包含以下新文件：

_my_gifts_menu.xml。该页面显示订户已赠予礼品和订户已接收礼品的链接。只有当订户已赠予或订户已接收到至少一个礼品时，才显示相关的链接。

第 7.1.3.8 节“查看我的礼品列表进程”

此信息将替换本书中的同类内容。

只有在订户已接收到礼品或已为其他订户购买礼品时，才可以使用主菜单页面上的“我的礼品”列表。当订户单击“我的礼品”时，将显示由 _my_gifts_menu.xml 生成的“我的礼品”页面。

如果订户已接收到礼品，则“我的礼品”页面中有“已接收礼品”的链接。当订户单击“已接收礼品”链接时，将显示由 _catalog_menu.xml 生成的“已接收礼品”页面。该页面显示订户已作为礼品接收的内容列表。当订户选择某项内容时，将显示由 _gift_details.xml 生成的礼品详细资料。如果订户要接受礼品，请单击“下载礼品”链接，将显示由 _download.xml 生成的“下载”页面。

如果订户已为其他订户购买礼品，则“我的礼品”页面中有“已发送礼品”的链接。当订户单击“已发送礼品”链接时，将显示由 _catalog_menu.xml 生成的“已发送礼品”页面。该页面显示订户已作为礼品购买的内容列表。当订户选择某项内容时，将显示由 _gift_details.xml 生成的礼品详细资料。按订阅收费的内容礼品具有一个取消礼品的选项。如果订户选择取消礼品订阅，则将显示由 _gift_cancel_confirm.xml 生成的确认请求页面。如果成功完成请求，则将显示由 _gift_cancel_success.xml 生成的通知页面。

第 7.2 节“为特定设备生成页面”

在步骤 2 中，用于生成特定式样表页面的命令是 /bin/cdsi genmarkup stylesheet，其中 stylesheet 是所创建的式样表的名称。该名称不得包含 .xsl 扩展名。

第 8.1 节“创建内容验证适配器”

表 7 需要以下内容验证适配器：

适配器	描述
`MIDletPermissionsAdapter`	该适配器添加了 `MIDlet-Permissions` 和 `MIDlet-Permissions-Opt` 特性的权限，运行通过连接的 DRM 代理进行程序校验的 MIDlet 需要这些权限。

[页首]

本地化问题

Subscriber Portal 提供了英语、法语和中文版本。Developer Portal 和管理控制台只提供了英语版本。您可以使用所需的其他语言对任何界面进行本地化。

对 Subscriber Portal 进行本地化

有关以 Sun Java System Content Delivery Server 所提供语言之外的语言显示 Subscriber Portal 的说明，请参见安装指南中的第 4.8 节“对 Subscriber Portal 进行本地化”。

对 Developer Portal 进行本地化

以下步骤介绍以不同的语言显示 Developer Portal 的过程。

在 $CDS_HOME/deployment/deployment-name/localization 目录中，制作 DevPortalMessages.properties 文件的副本，在该文件的文件名末尾附加语言和国家/地区代码。
例如 DevPortalMessages_es_ES.properties。
在创建的文件中，使用以下指导翻译等号 (=) 右侧的文本字符串。
- 不要更改等号左侧的属性名称。
- 将以下属性设置为一个模式字符串，这些模式字符串是在 java.text.SimpleDateFormat 类 Javadoc 工具的 HTML 输出中定义的。
  - date.format
  - date.format.long
  - time.format
  - time.format.long
  - datetime.format
  - datetime.format.long
  - date.format.input
  - time.format.input
  - datetime.format.input
- 以 .image 结尾的属性名称指定图像文件的名称。要对图像进行本地化，请使用所创建的本地化图像的名称替换文件名。图像文件位于下列目录之一，具体情况取决于所使用的应用程序服务器：
  - 如果使用的是 Sun Java System Application Server，则该目录为 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/servername/applications/j2ee-modules/CDSDeveloperPortal_1/developer/media
  - 如果使用的是 WebLogic Server，则该目录为 $CDS_HOME/deployment/deployment-name/weblogic/domains/server-domain/applications/developerportal/developer/media
- content.developers.agreement.url 属性指向包含提交内容所需条款和条件的文件。将该属性设置为文件本地化版本的 URL。
- login.devguide.link 属性指向包含内容开发者指南的文件。将该属性设置为文件本地化版本的 URL。

对 Catalog Manager 管理控制台进行本地化

以下步骤介绍了以不同语言显示 Catalog Manage 管理控制台的过程。

在 $CDS_HOME/deployment/deployment-name/localization 目录中，制作 AdminConsoleMessages.properties 文件的副本，在该文件的文件名末尾附加语言和国家/地区代码。
例如 AdminConsoleMessages_es_ES.properties。
在创建的文件中，使用以下指导翻译等号 (=) 右侧的字符串。
- 不要更改等号左侧的属性名称。
- 将以下属性设置为一个模式字符串，这些模式字符串是在 java.text.SimpleDateFormat 类 Javadoc 工具的 HTML 输出中定义的。
  - date.format
  - date.format.long
  - time.format
  - time.format.long
  - datetime.format
  - datetime.format.long
  - date.format.input
  - time.format.input
  - datetime.format.input
- 属性 localized.path.image_url 指定图像所在的目录。如果要更改任何图像，请将当前指定目录中的所有图像复制到新目录中。使用您的版本替换现有文件，并将 localized.path.image_url 属性设置为新的目录名称。指定的目录必须是以下目录之一的子目录，具体情况取决于所使用的应用程序服务器：
  - 如果使用的是 Sun Java System Application Server，则该目录为 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/servername/applications/j2ee-modules/CDSCatalogManager_1
  - 如果使用的是 WebLogic Server，则该目录为 $CDS_HOME/deployment/deployment-name/weblogic/domains/server-domain/applications/adminconsole
- login.form.stylesheet 属性和所有以 .layout 结尾的属性名称指定了用于生成 Web 页的模板的文件名。如果必须更改模板，则将相应的属性设置为正确的文件名。更改模板时一定要非常小心，因为任何错误都可能造成页面显示错误或根本不显示。

对 Vending Manager 管理控制台进行本地化

以下步骤介绍了以不同语言显示 Vending Manager 管理控制台的过程。

在 $CDS_HOME/deployment/deployment-name/localization 目录中，制作 VendingManagerMessages.properties 文件的副本，在该文件的文件名末尾附加语言和国家/地区代码。
例如 VendingManagerMessages_es_ES.properties。
在创建的文件中，使用以下指导翻译等号 (=) 右侧的字符串。
- 不要更改等号左侧的属性名称。
- 将以下属性设置为一个模式字符串，这些模式字符串是在 java.text.SimpleDateFormat 类 Javadoc 工具的 HTML 输出中定义的。
  - campaign.time.pattern
  - date.format
  - date.format.long
  - time.format
  - time.format.long
  - datetime.format
  - datetime.format.long
  - date.format.input
  - time.format.input
  - datetime.format.input
- 对于以 common.names.status 或 common.names.gender 开头的属性名称，不要更改垂直条 (|) 之前的字符。只翻译垂直条之后的单词。
- 属性 localized.path.image_url 指定图像所在的目录。要更改任何图像，请将当前指定目录中的所有图像复制到新目录中。使用您的版本替换现有文件，并将 localized.path.image_url 属性设置为新的目录名称。指定的目录必须是以下目录之一的子目录，具体情况取决于所使用的应用程序服务器：
  - 如果使用的是 Sun Java System Application Server，则该目录为 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/servername/applications/j2ee-modules/CDSVendingManager_1
  - 如果使用的是 WebLogic Server，则该目录为 $CDS_HOME/deployment/deployment-name/weblogic/domains/server-domain/applications/vsadmin
- 以 .layout 和 .stylesheet 结尾的属性名称指定了用于生成 Web 页的模板的文件名。如果必须更改模板，则将相应的属性设置为正确的文件名。更改模板时一定要非常小心，因为任何错误都可能造成页面显示错误或根本不显示。
- 不使用以 form.view 开头的属性名称。

[页首]

设备问题

本节介绍设备的问题。

预定义的设备

Sun Java System Content Delivery Server 预定义了几个设备，其中四个设备尚未使用本发行版进行全面测试。某些功能在以下设备上可能不会按预期方式运行：

NEC 515
Nokia 3200
Nokia 6310i
Samsung SPH-A500

支持 MIDP 2.0 的设备

用于标记 MIDP 2.0 MIDlet 的密钥库（私钥和证书链）可能无效，或与设备上的应用程序管理系统（以前称为 Java Application Manager）不兼容。将密钥库用于 Sun Java System Content Delivery Server 之前，请使用工具（如 Nokia 开发者套件）来标记采用密钥库的 MIDlet，然后验证标记的 MIDlet 是否可供下载，并且可安装在支持的设备上。如果发生错误，则可能需要获取不同的密钥库。

[页首]

软件错误

本节按照以下类别介绍已知错误：

一般错误
Developer Portal 错误
Catalog Manager 错误
Vending Manager 错误
Subscriber Portal 错误
设备错误

一般错误

本节介绍与整体系统操作或多个组件有关的错误。

错误 ID	描述
4904820	搜索内容时，搜索结果中出现异常项目。搜索功能搜索出现搜索字符串的描述和标题。因此，标题不包含搜索字符串但是其描述中包含该字符串的内容，将出现在搜索结果中。操作：了解搜索功能的工作方式，以便理解显示的结果。
4975088	系统不阻止您使用重复的包名称或内容项名称。操作：为避免混淆，请对添加到系统的内容和包使用唯一的名称。
5018097	关闭 WebLogic Server 上运行的 Sun Java System Content Delivery Server 的实例时出现异常。操作：无需执行操作。Content Delivery Server 正常关闭，可忽略该异常。
5034602	如果创建循环相关性，则不会添加为包含在另一计划中而选择的计划，也不会发送通知。例如，假设您有三个售卖计划，名为 VP1、VP2 和 VP3。VP1 包含 VP2。VP2 包含 VP3。由于创建了循环相关性，因此不能在 VP3 中包含 VP1。接口允许您进行这样的选择，但在您查看 VP3 时，将看到其中并未包含 VP1。操作：不要尝试在计划间创建循环相关性。如果以前选择要包含的计划未显示在您正使用的计划中，请检查您尝试要包含的计划，确保它或它包含的计划不引用您正使用的计划。
5047500	使用“类别价格编辑”功能在超过 1000 个项目的类别中更改项目价格时出现错误。操作：将一个类别中的项目数量限制在 1000 以下。
5062812	在 WebLogic Server 上启动 Sun Java System Content Delivery Server 时，可能显示下列消息： `2004-06-10 17:03:07,941 [org.apache.struts.util.RequestUtils,Thread-8] DEBUG Could not find Java 1.4 encode method. Using deprecated version. java.lang.NoSuchMethodException at java.lang.Class.getMethod0(Native Method) at java.lang.Class.getMethod(Class.java:883) at org.apache.struts.util.RequestUtils.<clinit>(RequestUtils.java:160)` 操作：无需执行操作。Content Delivery Server 正常启动，可忽略该异常。
5067414	在未运行 JMS 时生成的事件丢失。操作：使用诸如复制或群集之类的技术，设置可用性较高的 JMS。
5068141	高速缓存无效时性能下降。某些管理任务（如更新设备定义或编辑内容）导致了高速缓存的内容无效。此时重新填充高速缓存，完成事务会需要较长的时间。操作：在系统使用率很低的时候执行可能影响高速缓存内容的管理任务。
5097974	无法创建开发者帐户或 Catalog Manager 管理员帐户。错误消息指出存在具有指定登录 ID 的帐户，但是该帐户未显示在帐户列表中。操作：使用不同的登录 ID。对于 Catalog Manager 中的所有帐户类型，ID 必须唯一。
6199306	在 Catalog Manager 和 Vending Manager 中使用相同的搜索字符串时，接收到不同的结果。操作：无。在 Catalog Manager 中，搜索功能选择标题的任何部分与搜索字符串相匹配的内容。在 Vending Manager 中，搜索功能选择标题或描述的任何部分与搜索字符串中的任何单词相匹配的内容。
6203459	选中带有冒号的类别名称时，无法提交内容。操作：在提交内容时，删除类别名称中的冒号或让开发者选择其他类别。
6203474	在名称中使用 '<' 符号时，类别名称会在该符号处截断。操作：删除名称中的该特殊字符。
6220721	为诊断数据库运行诊断工具时，列出“无结果”。操作：将使用的数据库配置文件中的 `<Catalog>` 和 `<Vending>` 元素的前缀大写。使用数据库配置文件创建模式时，前缀将自动变为大写。然而，诊断工具不会将值大写，因此找不到模式。
6239164	在 Sun Java System Application Server 上运行时，收到“内部服务器错误”或 `java.lang.OutOfMemoryError`。操作：通过编辑 `server.xml` 文件增加堆大小。此文件位于 `$CDS_HOME/deployment/deployment-name/sun/domains/server-domain/server-name/config` 目录中。更改指定给 `jvm-options` 元素的值。例如，使用以下语句将堆大小设置为 1024 MB： `<jvm-options>-Xms1024m -Xmx1024m</jvm-options>`
6242370	使用 Sun Java System Application Server 时，Sun Java System Content Delivery Server 未指向正确的 Java 主目录。操作：为每个部署编辑 `server.xml` 文件。此文件位于 `$CDS_HOME/deployment/deployment-name/sun/domains/server-domain/server-name/config` 目录中。将 `java-config` 元素的 `java-home` 属性设置为某个目录，该目录是为 `init_env.sh` 文件中的 `SUN_AS_JAVA_HOME` 变量指定的。

[页首]

Developer Portal 错误

错误 ID	描述
6225842	如果在单次提交多个项目时使用置备归档 (Provisioning Archive, PAR) 文件，则提交确认只列出一个项目。操作：在单次提交多个项目时，对所有文件使用 Zip 格式，而不是 PAR 格式。有关信息，请参见内容开发者指南。
6226013	如果在单次提交多个项目时使用置备归档 (Provisioning Archive, PAR) 文件，则第一个项目的内容可用于所有项目。操作：在单次提交多个项目时，对所有文件使用 Zip 格式，而不是 PAR 格式。有关信息，请参见内容开发者指南。
6235197	当内容的当前状态为“已拒绝”时，内容版状态不能按预期方式运行。开发者更新“已拒绝”内容的描述后，在浏览内容时，该开发者和 Catalog Manager 将看到一个错误。操作：请与支持人员联系，以获得暂时解决问题的解决方法。

[页首]

Catalog Manager 错误

错误 ID	描述
5053221	从包查看时，包中包含的未储存内容的属性页包含“编辑”和“取消储存”按钮。编辑属性将导致内容被储存起来。操作：如果不想重新储存未储存的内容，请不要编辑其属性。
5062940	只有当“类别价格编辑”功能用于更改类别中单个项目的价格时，才发出 `price_changed` 事件。该事件不包含价格数据。操作：使用 `content_changed` 事件监视并响应价格变更。
5067467	创建设备时出现 GUI 错误。选择“设备功能”部分的某个字段时，“支持的库”字段被禁用。操作：选择 MicroEdition-Profile 或 MicroEdition-Configuration 可启用“支持的库”字段。
6218881	已从“开发者计划”中删除的开发者仍然与该计划关联，而不是被重新指定给缺省计划。操作：将开发者从其他计划中删除之前，请先将其指定给缺省“开发者计划”。
6231867	当内容的当前状态为“已拒绝”时，内容版状态不能按预期方式运行。在开发者添加了“已拒绝”内容版，并且 Catalog Manager 发布了以前“已拒绝”内容后，将不会发布在添加新版之前存在的版。操作：Catalog Manager 必须将内容状态更改为“已拒绝”，然后改回“已发布”，以便发布所有版。

[页首]

Vending Manager 错误

错误 ID	描述
4978930	活动到期日期造成误导。在活动属性中显示的到期日期是不再以特殊价格提供内容的日期。例如，如果到期日期为 2004 年 12 月 31 日，则能够以活动价格购买内容的最后日期为 2004 年 12 月 30 日。操作：将活动持续时间设置为比计划持续时间多一天，以便确保在活动期的最后一天可以活动价格提供内容。
5039834	当成员数量超出单页显示能力时，“订户计划”视图中的成员无法排序。对于多页，成员是按页排序的，而不是所有成员一起排序。操作：将成员逐页排序。
5047774	在查看活动的内容时“促销详细资料”页显示的数据，与编辑活动的内容时“活动内容”页显示的数据不一样。查看某活动时，会显示其不活动项目；但编辑时，则不会显示这些不活动项目。如果保存包含不活动项目的活动，则不活动项目会从活动中删除。操作：如果活动中包含不希望删除的不活动项目，则不要对其进行更改。如果必须进行更改，应首先激活不活动项目。
5058338	如果包中只有一个活动项目，则无法取消激活。操作：向该包添加另一个项目，或者激活一个不活动项目，以便该包中包含一个以上的活动项目。
6186696	已从包中删除的内容仍然显示在包中。操作：要从包中删除某项内容，必须从显示该项的所有类别中清除对该项的选择。展开选择树中的所有类别，并确保在任何类别下都未选中该项。
6230208	在查看包列表时，Vending Manager 管理员可以激活无效包。操作：不要激活包含两个以下活动内容项的包。包必须至少有两个活动项才能有效。
6232768	如果在活动中包含多于 200 个内容项，则系统可能没有响应，此时系统实际上要花费很长的时间才能响应。操作：您可能要限制活动中包含的内容项数量。
6233270	在更新了内容或添加了新版后，已购买包的订户无法从该包下载内容。操作：请与支持人员联系，以获得暂时解决问题的解决方法。
6246997	在下列情况下，当 Catalog Manager 重新发布以前储存的内容，并且 Vending Manager 将其自动储存后，该内容不会出现在正确的类别中。 Catalog Manager 管理员发布某项内容时，该内容储存在一个类别中。 Catalog Manager 管理员取消发布内容，并将其指定到其他类别中，然后在启用自动储存功能的情况下重新发布该内容。在 Vending Manager 的“储存的内容”页中，该内容出现在原始类别而不是新类别中。操作：手动取消储存，然后重新储存内容。

[页首]

Subscriber Portal 错误

错误 ID	描述
5040147	订阅到期是按照安装 Sun Java System Content Delivery Server 的时区，而不是订户所在的时区。如果服务器和订户位于不同的时区且内容按日订阅定价，则在使用的第一天，订户可使用内容的时数可能比预期使用时数多或少。此错误仅在使用 "Disconnected Time Sensitive" DRM 代理时出现。使用 "Connected Use and Time Sensitive" DRM 代理时，不会出现该问题。操作：无。
5051410	从设备手动登录 Subscriber Portal 时，订户还会收到“登录”页面。仅当在 Sun Java System Application Server 上部署 Sun Java System Content Delivery Server 后订户首次尝试访问 Subscriber Portal 时，才出现此问题。操作：请再次登录。最多尝试三次即可实现成功登录。
5063641	打不开“购买”链接。单击“购买”时，订户返回到“购买”页。操作：在 Sun Java System Application Server 上运行时，请不要使用别名转发。例如，订户应键入 `http://server/subscriber/dv1.do`，而不是 `http://server/device`。
5066306	订户看到的价格与 Vending Manager 管理员设置的价格不同。操作：无。系统按指定的方式运行。如果订户购买内容或试用在试用期内的内容，则在订户查看内容详细资料时，将显示购买时的价格或试用价格。只有在以下情况，订户才能看到价格变化：对于按订阅付费的内容，在取消订阅时显示更新的价格。对于只按照定期下载付费的内容，当超过下载天数或下载次数，并且 `$CDS_HOME/deployment/deployment-name/conf/SubscriberPortal.properties` 文件中的 `subscriber.every_download.update_license` 属性设置为 `true` 时，显示更新的价格。
6189597	当唯一设备 ID 映射到 LDAP 订户系统信息库中的多个字段时，订户无法登录。操作：请确保在映射到唯一设备 ID 的字段中指定的值不会用于其他任何订户。
6227960	从系统中删除接收者之后，礼品的赠予者还要继续为礼品订阅付费。操作：让客户服务代理手动取消已删除订户帐户的所有礼品订阅。从系统中删除赠予者之后，礼品的接收者无法访问礼品。操作：无。这是该系统当前的一个局限。
6233107	在 Subscriber Portal 上，类别列表中类别旁边的内容计数器所显示的计数可能与在该类别中实际看到的内容项数不匹配。操作：登录到 Catalog Manager，并同步受影响的售卖帐户。请参见“文档问题”下管理员指南部分中的 "Catalog Manager" 一章的子段“同步 Vending Manager”。
6247275	查看促销活动通知时，描述部分显示 "null"。操作：在创建促销活动时，始终提供描述。如果未输入描述，则会出现 "Null"。

[页首]

设备错误

错误 ID	描述
6226438, 6226439	在 Motorola T720 上，浏览器运行错误。操作：使用 Catalog Manager 管理控制台将该设备的浏览器类型更改为 `WML-1_2`。编辑 `WML-1_2.xsl` 模板，将屏幕宽度更改为 120。有关使用设备特定的用户界面式样表的信息，请参见集成指南。

[页首]

其他 Sun 资源

在以下位置可找到有关 Sun 产品和服务的有用信息：

Sun Java System 软件产品和服务
http://www.sun.com/software
Sun 开发者信息
http://developers.sun.com/
Sun 开发者支持服务
http://www.sun.com/developers/support
Sun 软件支持服务
http://www.sun.com/service/support/software/
Sun 支持和培训服务
http://www.sun.com/supportraining
Sun Java System 服务套件
http://www.sun.com/service/sunps/sunone

[页首]

发行说明

Sun Java™ System Content Delivery Server 2004Q1 产品更新 1

2005 年 3 月

文件号码 819-2478-10

目录

简介

此次更新中修复的错误

系统要求

产品更新的内容

安装

安装完整产品

将此更新应用于现有安装

查看更新历史

新增工具

诊断工具

命令语法

组件诊断

Application Server 诊断

Content Delivery Server 配置

Java Virtual Machine 诊断

数据库诊断

操作系统诊断

日志过滤实用程序

在 HP-UX 上运行诊断工具

许可证审计工具

配置

执行

每月执行

周期结束执行

手动执行

API 更改

已知错误和问题

文档问题

安装指南

第 4.1.1.2 节“配置 SMS 的消息传送服务”

第 4.1.3 节“配置后付费服务”

第 4.1.6 节“配置事件服务”

第 4.4.3 节“设置 Subscriber Portal 属性”

第 4.7.1 节“Java 应用程序的工作流”

第 4.7.1.1 节“数字权限管理设置程序校验”

第 4.8.1 节“设置缺省语言”

第 4.12 节“配置对定制报告的支持”

第 5.3 节“确定服务的状态”

第 B.1.1 节“设置数据库连接池大小”

第 B.1.3 节“设置数据库内存分配”

第 D 节“报告”

管理员指南

"Catalog Manager" 一章的子段“搜索内容”

"Catalog Manager" 一章的子段“编辑内容”

"Catalog Manager" 一章的子段“删除版”

"Catalog Manager" 一章的子段“管理设备”

"Catalog Manager" 一章的子段“同步 Vending Manager”

"Catalog Manager" 一章的子段“添加开发者帐户”

"Catalog Manager" 一章的子段“添加 Catalog Manager 管理员帐户”

"Vending Manager" 一章中的字段“储存内容”和“编辑储存的内容”

"Vending Manager" 一章的子段“查找储存的内容”

"Vending Manager" 一章的子段“创建包”

"Vending Manager" 一章的子段“管理包”

"Vending Manager" 一章的子段“查看包信息”

"Vending Manager" 一章的子段“添加 Vending Manager 管理员帐户”

"Vending Manager" 一章的子段“添加订户帐户”

"Vending Manager" 一章的子段“查看订户的下载历史”

"Vending Manager" 一章的子段“管理订户许可证”

"Vending Manager" 一章的子段“创建 MMS 消息”

附录“包和礼品”

包价格

不可用的内容

包和内容方案

赠予信息

署名指南

容量计划指南

补充资料

第 2.1 节“试用配置”

内容开发者指南

“通过向导提交新内容”一节

“创建内容提交文件”一节

“创建置备文件”一节

定制指南

第 2.3 节“事件和事件数据”

第 6.1 节“用户管理器类”

Sun Java™ System Content Delivery Server 2004Q1
产品更新 1