Sun Java System Content Delivery Server 系统管理指南 目录上一章下一章本书索引


1

系统监视

Content Delivery Server 提供了用于监视 Content Delivery Server 状态的应用程序监视代理。此代理支持简单网络管理协议 (Simple Network Management Protocol, SNMP) 并可以与现有网络监视系统集成。

Content Delivery Server 组件还在日志文件中记录信息，您可以使用这些信息查看系统状态。

本章包括以下主题：

1.1 应用程序监视代理

应用程序监视代理提供有关 Content Delivery Server 的状态信息。通过此代理，现有网络监视系统可以监视 Content Delivery Server 组件的可用性。您还可以监视 Content Delivery Server 与外部系统（例如记帐系统或订户数据库）之间的连接。启动监视服务时，将激活该代理。

应用程序监视代理提供用于说明 Content Delivery Server 所发出的状态和警报的管理信息库 (Management Information Base, MIB)。此信息包含在 $CDS_HOME/deployment/ deployment-name/conf 目录的 CDSMibModule.mib 文件中。将您的网络监视系统配置为使用此 MIB 规范。有关装入 MIB 的信息，请参见所使用的网络监视系统的产品文档。

表 1-1 显示了通过 MIB 提供的状态信息。网络监视系统可以查询应用程序监视代理的任何状态。状态 1 表示该组件正在运行。状态 0 表示该组件已停止工作。


表 1-1 组件状态

状态

描述

cdsServerStatus

Content Delivery Server 核心服务器的状态

eventServiceStatus

Content Delivery Server 事件服务的状态

messagingServiceStatus

Content Delivery Server 消息传送服务的状态

postPaidServiceStatus

Content Delivery Server 后付费服务的状态


 

表 1-2 显示了 Content Delivery Server 发送的通知，用于报告所发生的事件。通常情况下，通知表示特定的组件不可用，或者启动了某个组件。如果组件不可用，请确定原因并重新启动该组件，以确保 Content Delivery Server 继续正常运行。


表 1-2 Content Delivery Server 发送的通知

警报

描述

catalogJMSDown

与 Catalog Manager 关联的 Java 消息服务 (Java Message Service, JMS) 没有运行。

catalogStarted

Catalog Manager 已启动。

dbConnectionDown

数据库连接已关闭。

downloadFailure

尝试为订户下载内容时出现下载故障。订户可能已取消了下载、网络可能出现问题，或者下载过程中可能出现问题。

httpPushConnectionDown

基于 HTTP 的 SMSC 的连接已关闭。

missingExternalContent

无法从远程位置获得外部托管的内容。URL 可能无效、开发者可能需要提交更新的项目位置，或者防火墙可能阻止访问项目。

newVendingAccountRegistered

Catalog Manager 管理员注册了新的 Vending Manager Server 帐户。

notificationProcessingFailure

Vending Manager 无法处理来自 Catalog Manager 的更改通知。

ppgConnectionDown

推送代理网关 (Push Proxy Gateway, PPG) 的连接已关闭。

remoteVendingDown

Catalog Manager 注意到 Vending Manager 未运行。

smscConnectionDown

短消息服务中心 (Short Message Service Center, SMSC) 的连接已关闭。

smtpConnectionDown

简单邮件传输协议 (Simple Mail Transfer Protocol, SMTP) 服务器的连接已关闭。

streamingConnectionDown

流式传输服务器的连接已关闭。

subscriberDirectoryConnectionDown

外部订户数据库连接已关闭。

vendingAccountUnregistered

Catalog Manager 管理员删除了 Vending Manager Server 帐户。

vendingJMSDown

与 Vending Manager 关联的 JMS 没有运行。

vendingNetworkIdUpdated

Catalog Manager 管理员更改了 Vending Manager Server 帐户的网络 ID。

vendingStarted

Vending Manager 已启动。


 

1.2 日志文件

Content Delivery Server 执行时，组件将信息记录到以下日志文件中（这些文件位于 $CDS_HOME/deployment/deployment-name/logs 目录中）：

n 是介于 0 和 $CDS_HOME/cfg/logging.properties 文件中为 cds.FileHandler.count 属性指定的最大归档文件数量之间的值。CDS.log.0 是当前日志。启动 Content Delivery Server 时，或者达到 logging.properties 文件中为 cds.FileHandler.limit 属性指定的最大记录数时，将创建归档文件。

使用 cdse startserver 命令启动 Content Delivery Server 时，将执行数据库编码检查。

请检查这些日志文件是否存在异常、是否存在标记为 SEVERE 的行或其他问题指示。有关可能收到的消息描述以及可以采取的应对措施建议，请参见《Sun Javatrademark System Content Delivery Server 5.1 错误消息》。

Content Delivery Server 使用 Java 软件开发工具包中提供的日志记录实用程序。通过设置 $CDS_HOME/cfg/logging.properties 文件中的属性，可以根据该实用程序的功能来管理日志文件。此文件控制所有 Content Delivery Server 功能的日志记录属性。

写入到日志中的消息是由设置的日志记录级别决定的。以下有效级别按从限制性最强到限制性最弱的顺序列出。


表 1-3 有效的日志记录级别

标签

描述

OFF

不记录任何消息。

SEVERE

仅记录指示严重问题的消息。

WARNING

记录警告。

INFO

记录说明性消息。

CONFIG

记录静态配置消息。

FINE

记录跟踪信息。

FINER

记录相当详细的跟踪信息。

FINEST

记录极其详细的跟踪信息。

ALL

记录所有消息。


 

日志包含指定级别的消息以及较高级别的消息。例如，如果将级别设置为 WARNING，则日志包含标记为 SEVERE 和 WARNING 的消息。Content Delivery Server 仅对其消息使用 SEVERE、WARNING、INFO 和 FINE。

日志记录实用程序支持几种处理程序。Content Delivery Server 仅使用文件处理程序和控制台处理程序。此外，一些 Content Delivery Server 组件也会记录消息。如果需要，可以分别设置这些日志程序所记录的消息级别。下表包含 Content Delivery Server 所使用的日志程序的名称。


表 1-4 Content Delivery Server 中的日志程序

Admin

EventServiceLog

PricingModel

SubscriberV1

BillingManager

EventService_config

PricingPlan

SubscriberXmlRpc

Cache

Foundation

RAS

Synchronization

CapabilityMgr

Fulfillment

Reporting

SynchronizationAPI

Catalog

I18NConverter

RiMatcher

Task

ConfirmListener

I18n

Root

TaskMgr

ContentManager

Jobs

SearchService

UserManager

DBAccess

LDAPUserManager

Security

VmAPI

DBCommand

Mms

ServicePlanManager

VmAPIXmlRpc

DBPoolManager

MsgServer

SnmpLog

Watermarking

DRM

MultiPart

Stock

Web

DRMMobile

OMA

Streaming

Webapps

DeveloperPortal

OTA

SubscriberAPI

Webresource

EMF

Pricing

SubscriberPortal

 


 

要管理日志文件，请在 $CDS_HOME/cfg/logging.properties 文件中设置属性，如下表中所述。


表 1-5 日志记录属性

属性

描述

cds.level

写入到日志中的信息的默认级别。如果没有为特定日志程序设置任何级别，则使用此级别。表 1-3 中介绍了有效的值。默认值为 INFO。

cds.FileHandler.level

写入到文件中的信息的级别。

cds.FileHandler.pattern

日志文件的默认位置。如果创建日志的组件未指定位置，则使用此位置。默认位置为 /tmp/CDS.log。

  • Content Delivery Server 日志位于 $CDS_HOME/deployment/deployment-name/logs 目录中。如果未明确指定其他位置，则编写的适配器或其他集成代码可能会将日志写入到此目录中。

cds.FileHandler.limit

在创建归档文件之前写入到日志中的最大记录数。默认值为 10000000。

cds.FileHandler.count

最大归档文件数。默认值为 50。

cds.FileHandler.formatter

用于设置消息格式的类的全限定名称。默认名称为 com.sun.content.server.foundation.log.pattern.PatternFormatter。

cds.ConsoleHandler.level

写入到控制台中的信息的级别。

cds.ConsoleHandler.formatter

用于设置消息格式的类的全限定名称。默认名称为 com.sun.content.server.foundation.log.pattern.PatternFormatter。

com.sun.content.server.foundation.log.pattern.PatternFormatter.pattern

为文件处理程序和控制台处理程序格式化程序指定的类在设置消息格式时使用的模式。可以使用以下元素：

  • %c - 日志程序类别名称
  • %C - 生成日志事件的类名称
  • %d - 生成事件的日期
  • %m - 事件提供的消息
  • %M - 生成日志事件的方法名称
  • %n - 新行
  • %p - 事件的日志记录级别
  • %t - 线程 ID

默认模式为 %d [%c,%t] %p %m%n，它可生成类似于以下样例的消息： 

Tue May 01 16:58:47,608 PDT 2007 [cds.DRM,20] SEVERE <0052> Purchase authorization failed.

注 - 如果为格式化程序指定不同的类，则可能需要不同的属性。

cds.logger.level

（可选）特定日志程序的日志记录级别，其中 logger 是表 1-4 中的值之一。


 

1.3 同步

Catalog Manager 和每个 Vending Manager 具有其自己的数据库。诸如内容状态或支持的设备类型之类的信息必须跨数据库进行维护。在 Catalog Manager 中进行更改时，将向 Vending Manager Server 帐户所标识的 Vending Manager 发送通知。

如果 Vending Manager 未收到更改通知或同步失败，请验证 Vending Manager Server 帐户是否包含正确的 Vending Manager 帐户名称和密码。如果需要，请使用 Catalog Manager 管理控制台更正 Vending Manager Server 帐户中的名称或密码。如果仅更改 Vending Manager Server 帐户，则不需要重新启动 Vending Manager。如果更改 $CDS_HOME/deployment/deployment-name/conf/CDS.properties 文件中的 vs.account.name 或 vs.account.password 属性，则必须重新启动 Vending Manager。如果在基本部署中将 Catalog Manager 与 Vending Manager 一起部署，则也必须重新启动 Catalog Manager。

如果删除或取消激活某个 Vending Manager Server 帐户，Catalog Manager 将停止向该 Vending Manager 发送更改通知。如果稍后重新创建或重新激活了该 Vending Manager Server 帐户，则必须重新启动 Vending Manager 才能启动同步。如果在基本部署中将 Catalog Manager 与 Vending Manager 一起部署，则也必须重新启动 Catalog Manager。

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

1.4 查找索引

Content Delivery Server 的目录搜索服务和售卖搜索服务组件使用 Solr 查找服务器来编索内容以及处理查找查询。对于每个服务，Solr 为 Catalog Manager 和 Vending Manager 中的内容创建一个索引。查找索引是独立于内容数据库进行管理的。

在添加或更改内容时，将自动更新查找索引。不过，索引可能会与内容出现不同步，而需要手动重新生成。下面的列表中介绍了一些需要手动重新生成的情况：

如果出现上述情况之一或者没有从查找查询中获得所需的结果，请重新生成查找索引。您可以重新生成完整的索引，也可以将特定项添加到索引中。如果重新生成有时无法解决问题，您也可以从索引中删除某个项，或者删除索引的全部内容以准备重新开始生成。

1.4.1 重新生成完整索引

请注意，重新生成完整索引可能需要一段时间，具体取决于内容项的数目和系统上的负载。您还可能要避免在运行其他资源密集型操作时重新生成索引，例如，批量内容提交、批量内容管理或设备功能匹配。

要为 Catalog Manager 重新生成查找索引，请登录到 Catalog Manager 管理控制台，然后在浏览器的地址字段中输入以下 URL： 

http://host:port/admin/main/search_update?action=rebuild

host:port 是运行 Catalog Manager 的服务器的主机名和端口号。在完成重新生成过程后，将显示一条消息。

要为 Vending Manager 重新生成查找索引，请登录到 Vending Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/vsadmin/main/search_update?action=rebuild

host:port 是运行 Vending Manager 的服务器的主机名和端口号。在完成重新生成过程后，将显示一条消息。

1.4.2 在索引中添加项

在索引中添加项需要的时间比重新生成完整索引少；如果您知道查询结果中未显示的特定项的类 ID，则可以选择该选项。

要为 Catalog Manager 索引添加特定项，请登录到 Catalog Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/admin/main/search_update?action=add&rcid=content-class-id

host:port 是运行 Catalog Manager 的服务器的主机名和端口号，content-class-id 是内容项的类 ID。在此过程完成后，将显示一条消息。

要为 Vending Manager 索引添加特定项，请登录到 Vending Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/vsadmin/main/search_update?action=add&rcid=class-id

host:port 是运行 Vending Manager 的服务器的主机名和端口号，class-id 是内容项的类 ID。在此过程完成后，将显示一条消息。

1.4.3 删除索引中的所有条目

如果重新生成索引无法解决查找结果不正确的问题，则可以删除索引中的所有内容，然后按照 1.4.1 重新生成完整索引中所述重新生成索引。

要从 Catalog Manager 查找索引中删除所有内容，请登录到 Catalog Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/admin/main/search_update?action=delete_all

host:port 是运行 Catalog Manager 的服务器的主机名和端口号。在此过程完成后，将显示一条消息。

要从 Vending Manager 查找索引中删除所有内容，请登录到 Vending Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/vsadmin/main/search_update?action=delete_all

host:port 是运行 Vending Manager 的服务器的主机名和端口号。在此过程完成后，将显示一条消息。

1.4.4 从索引中删除某个项

如果查找结果中显示了您确定不应显示的项，并且您知道该项的类 ID，则可以从查找索引中手动删除该项。

要从 Catalog Manager 索引中删除特定项，请登录到 Catalog Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/admin/main/search_update?action=delete&rcid=class-id

host:port 是运行 Catalog Manager 的服务器的主机名和端口号，class-id 是内容项的类 ID。在此过程完成后，将显示一条消息。

要从 Vending Manager 索引中删除特定项，请登录到 Vending Manager 管理控制台，并在浏览器的地址字段中输入以下 URL： 

http://host:port/vsadmin/main/search_update?action=delete&rcid=class-id

host:port 是运行 Vending Manager 的服务器的主机名和端口号，class-id 是内容项的类 ID。在此过程完成后，将显示一条消息。

 



  Sun Java System Content Delivery Server 系统管理指南 820-5381-10 目录上一章下一章本书索引


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