Sun Microsystems,Inc. has intellectual property rights relatingto technology embodied in theproduct that isdescribed inthis document. In
particular,and without limitation, these intellectualproperty rights mayinclude oneor more ofthe U.S. patents listed at
http://www.sun.com/patents and one or more additional patents or pendingpatent applicationsin the U.S.and inother countries.
U.S. GovernmentRights -Commercial software. Government users are subject to the SunMicrosystems, Inc. standardlicense agreement and
applicable provisionsof the FAR and its supplements.
This distributionmay includematerials developed by third parties.
Sun, SunMicrosystems, the Sun logo, Java,and J2ME aretrademarks or registeredtrademarks of SunMicrosystems, Inc. in the U.S.and other
countries.
UNIX isa registered trademarkin the U.S. and othercountries, exclusively licensed through X/Open Company, Ltd.
Netscape andNetscape Navigatoris a trademark or registered trademarkof Netscape Communications Corporation inthe United States and
other countries.
Products covered by and informationcontained in this service manualare controlled byU.S. Export Controllaws and may be subjectto the
export orimport lawsin other countries. Nuclear, missile, chemical biologicalweapons or nuclear maritime enduses orend users, whether
direct orindirect, are strictly prohibited.Export orreexportto countriessubject to U.S. embargo or to entities identifiedon U.S. export exclusion
lists, including,but notlimited to, the denied personsand specially designated nationals listsis strictly prohibited.
DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESSFOR APARTICULAR PURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Sun Microsystems,Inc. détient les droits de propriétéintellectuels relatifs àla technologieincorporée dans leproduit qui est décrit dansce
document. Enparticulier, et ce sanslimitation, ces droitsde propriété intellectuellepeuvent inclure unou plusdes brevets américainslistés à
l’adresse http://www.sun.com/patents et unou lesbrevets supplémentaires ou les applications debrevet en attenteaux Etats- Unis et
dans lesautres pays.
Cette distributionpeut comprendre descomposants développés par des tierces parties.
Sun, SunMicrosystems, le logo Sun, Java,et J2ME sont des marques de fabrique oudes marques déposéesde SunMicrosystems,Inc. auxEtatsUnis etdans d'autres pays.
UNIX estune marque déposée aux Etats-Uniset dans d’autrespays et licenciée exlusivement parX/Open Company, Ltd.
Netscape etNetscape Navigatorest une marquede Netscape Communications Corporation auxEtats-Unis et dans d'autres pays.
Les produitsqui font l'objet de cemanuel d'entretien etles informations qu'il contient sontregis par lalegislation americaineen matiere de
controle desexportations et peuvent etre soumis au droit d'autres paysdans ledomaine des exportationset importations.Les utilisations
finales, ouutilisateurs finaux,pour des armes nucleaires, des missiles, des armesbiologiques et chimiques ou dunucleaire maritime,
directement ouindirectement, sont strictementinterdites. Les exportationsou reexportations versdes payssous embargo desEtats-Unis, ou
vers desentites figurantsur les listes d'exclusion d'exportationamericaines, y compris, mais demaniere non exclusive,la liste de personnes qui
font objetd'un ordre dene pas participer, d'une facon directe ouindirecte,aux exportationsdes produits oudes services qui sont regi par la
legislation americaineen matiere de controle des exportations et laliste de ressortissantsspecifiquement designes, sont rigoureusement
interdites.
LA DOCUMENTATION ESTFOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONSET GARANTIES EXPRESSES
OU TACITES SONT FORMELLEMENT EXCLUES, DANSLA MESURE AUTORISEEPAR LA LOI APPLICABLE, YCOMPRIS NOTAMMENT
TOUTE GARANTIEIMPLICITE RELATIVEA LAQUALITE MARCHANDE, AL'APTITUDE AUNE UTILISATIONPARTICULIERE OU A
L'ABSENCE DECONTREFACON.
Contents
Prefacexv
1.Introduction1
Sun Java System Content Delivery Server1
Catalog Manager3
Catalog Manager Processes4
Automated Content Validation5
Content Management5
Device Management6
Account Management6
Plan Management6
Fulfillment Manager7
Vending Manager7
Vending Manager Processes9
Content Management9
Plan Management9
Account Management9
Reporting10
Administration Consoles10
Browser Requirements10
iii
Accessing the Administration Consoles11
▼Logging in to the Catalog Manager11
▼Logging in to the Vending Manager12
2.Catalog Manager13
Managing Content13
Managing Content Categories14
▼Viewing Categories14
▼Adding a Category16
▼Editing a Category17
▼Deleting a Category18
Managing Content Types19
Content Submissions19
Content Protection20
Inapplicable Content21
Using CDS DRM Agents and CDS OMA
Forward Lock21
Using OMA DRM 1.023
OMA DRM 1.0 and Non-Compliant Devices24
MIME Types for OMA DRM 1.024
Associating Content Types with DRMs25
Enabling and Disabling a DRM26
Pricing Content26
Pricing Options29
Changing the Pricing of Content29
Disassociating Content From Pricing Options30
▼Viewing Supported Content Types and MIME Types31
▼Viewing Properties for a Supported MIME Type32
▼Adding a Content Type32
ivAdministrator Guide • 2005Q4
▼Editing a Content Type34
▼Creating a Pricing Option35
▼Editing a Pricing Option37
▼Deleting a Content Type39
▼Disabling a Pricing Option39
▼Registering a MIME Type40
▼Editing a MIME Type41
▼Deleting a MIME Type43
Managing Submitted Content44
▼Viewing Submitted Content44
▼Viewing Submitted Editions47
▼Removing an Edition48
▼Searching for Content49
▼Changing the Status of Content50
▼Changing the Status of Editions52
▼Editing Content52
Managing Published Content55
▼Viewing Published Content56
▼Removing Content57
▼Viewing Published Editions57
▼Copying or Moving Categories of Content58
▼Copying or Moving Content Items62
Setting Custom Prices for Published Content66
Managing Devices68
Managing Device Libraries69
▼Viewing Device Libraries70
▼Viewing Properties for a Specific Device Library70
TABLE A-3User Interface and Software Capabilities 235
xiii
TABLE A-4Nokia 6310i Device Specifications 238
TABLE A-5Device Specifications for a User-Defined Device 1 239
TABLE A-6Device Specifications for a User-Defined Device 2 239
TABLE B-1Associated DRMs, Content Types, and Pricing Models 241
TABLE B-2Initial Pricing Set for Items 1 and 2 244
TABLE B-3Resulting Pricing for Items 1 and 2 in Scenario 1 244
TABLE B-4Resulting Pricing for Items 1 and 2 in Scenario 2 244
TABLE B-5Resulting Pricing for Items 1 and 2 in Scenario 3 245
TABLE B-6Resulting Pricing for Items 1 and 2 in Scenario 4 245
TABLE B-7Resulting Pricing for Items 1 and 2 in Scenario 5 245
TABLE B-8Resulting Pricing for Items 1 and 2 in Scenario 6 246
xivAdministrator Guide • 2005Q4
Preface
This guide provides an overview of the Sun Java™ System Content Delivery Server.
It describes how to administer the Catalog Manager and Vending Manager
components. It describes the device capabilities and the content pricing models
supported by the Sun Java System Content Delivery Server.
Before You Read This Document
This guide is written for system administrators who are responsible for
administering the Catalog Manager or Vending Manager. It assumes some
knowledge of networking, database, and web technologies.
Note – Sun is not responsible for the availability of third-party web sites mentioned
in this document, and does not endorse and is not responsible or liable for any
content, advertising, products, or other materials available through such sites.
How This Document Is Organized
This guide is divided into the following chapters:
■ Chapter 1 introduces the Content Delivery Server and describes the content life
cycle as it relates to the Catalog Manager and Vending Manager. It describes the
automatic content validation process that the Content Delivery Server performs
on submitted content. It also describes how to log in to the Catalog Manager and
Vending Manager administration consoles.
xv
■ Chapter 2 describes how to administer the Catalog Manager. It provides
instructions on how to review, categorize, and publish content. It describes how
to define the mobile devices supported and their capabilities. It also describes
how to manage access for developers and Vending Managers.
■ Chapter 3 describes how to administer the Vending Manager. It describes how to
stock content, manage Administrator and Subscriber Accounts, and run system
reports.
■ Appendix A describes the capability matching process and defines the device
capabilities currently supported by the Content Delivery Server.
■ Appendix B provides a description of the digital rights management types
supported in the Content Delivery Server and provides a set of business scenarios
involving content pricing and availability in the Catalog and Vending Managers.
■ The Glossary defines the terms used in the context of this guide.
Typographic Conventions
The following tables define the typographical conventions and terms used
throughout this guide:
a
Typeface
AaBbCc123The names of commands, files,
AaBbCc123
AaBbCc123Book titles, new words or terms,
a The settings on your browser might differ from these settings.
xvi Administrator Guide • 2005Q4
MeaningExamples
Edit your .login file.
and directories; on-screen
computer output
What you type, when
contrasted with on-screen
computer output
words to be emphasized
Command-line variable; replace
with a real name or value
Use ls -a to list all files.
% You have mail.
% su
Password:
Read Chapter 6 in the User’s Guide.
These are called class options.
Yo u must be super user to do this.
To delete a file, type rm filename.
Related Documentation
The Sun Java System Content Delivery Server manuals are available as Portable
Document Format (PDF) and Hypertext Markup Language (HTML) files. These files
are available in the Documentation subdirectory of the directory where the
Content Delivery Server is installed as well as online at http://docs.sun.com.
The following table summarizes the books included in the Content Delivery Server
documentation set.
Book TitleDescriptionPart Number
Sun Java System Content Delivery Server
Branding and Localization Guide
Sun Java System Content Delivery Server
Capacity Planning Guide
Sun Java System Content Delivery Server
Content Developer Guide
Sun Java System Content Delivery Server
Customization Guide
Sun Java System Content Delivery Server
Error Messages
Sun Java System Content Delivery Server
Installation Guide
Sun Java System Content Delivery Server
Integration Guide
Sun Java System Content Delivery Server
Migration Guide
Sun Java System Content Delivery Server
System Management Guide
Describes how to customize the Subscriber Portal
and Developer Portal components of the Content
Delivery Server for the look and feel of your
enterprise. This guide also describes how to localize
the Content Delivery Server interfaces.
Provides guidelines for determining what hardware
and software is needed to efficiently run the Content
Delivery Server.
Describes how to submit content to the Content
Delivery Server.
Describes the Content Delivery Server APIs that can
be used to create customized adapters for use in
integrating Content Delivery Server with the existing
infrastructure.
Describes error messages that are generated by the
Content Delivery Server and suggests actions to take
to resolve problems reported.
Provides information about installing and
configuring the Content Delivery Server.
Describes adapters for integrating the Content
Delivery Server with existing systems such as billing,
user data, WAP gateway, and push delivery. It also
describes the framework for creating device-specific
versions of the Subscriber Portal.
Describes how to migrate from a previous version of
the Content Delivery Server to the current version.
Provides information on running and maintaining
the Content Delivery Server.
819-3210-10
819-3211-10
819-3212-10
819-3213-10
819-3214-10
819-3215-10
819-3216-10
819-3217-10
819-3218-10
Prefacexvii
Accessing Sun Documentation Online
The Sun Product Documentation web site enables you to access Content Delivery
Server documentation on the web at http://docs.sun.com.
Sun Welcomes Your Comments
Sun is interested in improving its documentation and welcomes your comments and
suggestions.
To share your comments, go to http://docs.sun.com and click Send Comments.
In the online form, provide the document title and part number.
xviii Administrator Guide • 2005Q4
CHAPTER
1
Introduction
This chapter provides an overview of the Sun Java™ System Content Delivery
Server. It describes the content lifecycle and provides an overview of the Catalog
Manager, Fulfillment Manager, and Vending Manager components. It describes the
automatic content validation process that takes place when content is submitted to
the Content Delivery Server.
This chapter also describes how to log in to the Catalog Manager and Vending
Manager administration components.
Sun Java System Content Delivery
Server
The Sun Java System Content Delivery Server is a high-performance software
solution that lets operators manage the complexity of delivering virtually any type
of wireless content over-the-air (OTA) to their subscribers. The Content Delivery
Server separates content aggregation, presentation, and delivery into two distinct
managers, the Catalog Manager and the Vending Manager. With these managers,
operators can centrally manage content, customize multiple subscriber interfaces,
and provide fast downloads.
The following figure provides a high-level overview of the Content Delivery Server.
1
Content
Providers
Java ApplicationsRingtonesWallpapers
GamesMusicVideosExtensible...
Operator
Subscriber
Java System Content Delivery Server
Catalog Manager
Vending Manager
Subscriber
Portal
Fulfillment
Manager
Vending Manager
Subscriber
Portal
Fulfillment
Manager
Vending Manager
Subscriber
Portal
Fulfillment
Manager
1. The content provider creates an application and submits it to the Catalog
Manager using the web-based Developer Portal.
2. The Catalog Manager validates the content.
2Administrator Guide • 2005Q4
3. The Catalog Manager administrator publishes the content, making it available to
the Vending Manager.
4. The Vending Manager administrator selects content published from the Catalog
Manager and stocks the content, making it available to subscribers.
Catalog Manager
The Catalog Manager is the content aggregator or warehouse. It manages all the
content coming from the developer community. After the content is authorized, the
Catalog Manager makes the content available to the Vending Managers. The
Vending Managers then sell the content to their unique subscriber community.
The Catalog Manager supports any type of content. The Catalog Manager
administrators define the type of content that they want to accept for their
enterprise.
The Catalog Manager administrator manages these functions:
■ Submitted and published content
■ Supported mobile devices
■ Content provider access and pricing
■ Vending Manager access and content
■ Administrator access
The following figure provides a high-level overview of the role of the Catalog
Manager in the lifecycle of an application. It also illustrates the Catalog Manager
processes.
Chapter 1 Introduction3
1. Developers submit content to the Catalog Manager. The Catalog Manager runs an
automated validation process on the content to ensure there is no malicious
content and that the content matches the supported devices.
2. The content goes to the Submitted Content section of the Catalog Manager for
review by the administrator. The administrator reviews the content and, if
required, edits the content and modifies the pricing and category assignments.
The administrator can accept or reject the content.
3. The Catalog Manager publishes the content, which makes it available to the
Vending Manager.
Catalog Manager Processes
As shown in the previous figure, the Catalog Manager manages content submitted
by developers and controls which Vending Managers access which content. The
Catalog Manager is responsible for the following functions:
■ Automated Content Validation
■ Content Management
■ Device Management
■ Account Management
■ Plan Management
4Administrator Guide • 2005Q4
Automated Content Validation
The Sun Java System Content Delivery Server performs an automated validation of
content. If an application fails at any stage of validation, it is not submitted to the
Catalog Manager.
Note – The default implementation of content validation performs automated
validation on MIDlets only. You can customize the validation process to validate
other types of content.
Content validation includes the following tasks:
■ API Filtering. The API Filter checks that the APIs used in the MIDlet application
are allowed. Developer Plans define the set of APIs allowed. When a developer
submits content, the API Filter checks the APIs used by the submitted application.
If any API is not allowed by the Developer Plans associated with the developer,
the content fails.
■ Instrumentation. The instrumentation process inserts code into the MIDlet
application to interpret the pricing model assigned. For example, the inserted
code interprets whether the application is priced per download, on first
download only, by subscription, or any combination of these.
The instrumented code maintains licensing information on the device and
periodically communicates with the Sun Java System Content Delivery Server to
verify that the subscriber is authorized to run the application. If a license has
expired, the subscriber is given the opportunity to renew the license.
■ Customized Steps. You can customize the validation process to meet the needs of
your organization. You can disable selected processes or add processes as needed.
For example, you might want to add a step to obfuscate an application.
Obfuscation makes the code difficult to understand when it is decompiled and
can reduce the size of the Java Archive (JAR) file.
Content Management
Once content passes the automated validation process, it goes to the submitted
content section for review by the Catalog Manager administrator. This section
describes the content and categories managed by the Catalog Manager:
Chapter 1 Introduction5
■ Submitted Content. The administrator reviews submitted content and, if
required, edits the content and modifies the pricing and category assignments.
The administrator can accept or reject the content.
■ Published Content. After accepting the content, the administrator publishes the
content to make it available to the Vending Manager.
■ Categories. Content categories are central to content management. They are
logical containers or buckets that hold the content managed by the Sun Java
System Content Delivery Server. The Catalog Manager uses content categories to
control Vending Manager access.
See “Managing Content” on page 13 for more information.
Device Management
The Catalog Manager defines the devices and the device capabilities supported by
the Content Delivery Server. As a Catalog Manager administrator, you can add new
devices, delete devices no longer supported, and edit the characteristics and
capabilities of any device model. “Managing Devices” on page 68 describes how to
manage the devices supported for your network.
Account Management
Accounts define access to the Catalog Manager. The Catalog Manager has three
types of accounts:
■ Vending Manager. A Vending Manager Account is for a specifically-branded
Vending Manager that stocks content from the Catalog Manager. It is associated
with one or more Vending Plans.
■ Developer. Developer Accounts are for corporations or individuals that submit
content to the Catalog Manager. Developer Accounts are associated with one or
more Developer Plans.
■ Administrator. Administrator Accounts are for individuals who administer the
Catalog Manager.
See “Managing Accounts” on page 94 for more information.
Plan Management
The Catalog Manager uses the following plans to control content submission for
developers and content access for Vending Managers:
6Administrator Guide • 2005Q4
■ Vending Plans. Vending Plans define the categories that a Vending Manager can
access. Vending Plans can contain a nested hierarchy of other Vending Plans. Each
Vending Manager Account is associated with one or more Vending Plans.
■ Developer Plans. Developer Plans define the set of APIs that developers can use
in applications that they submit. Profiles define the classes in a specific library
that developers can use. A Developer Plan contains one or more Profiles.
See “Managing Plans” on page 107 for more information.
Fulfillment Manager
The Fulfillment Manager controls and delivers content to subscribers through a
high-performance and cost-effective download architecture. The following figure
provides a high-level overview of the Fulfillment Manager processes.
No administration tasks are associated with the Fulfillment Manager.
Vending Manager
The Vending Manager handles selling and pricing content. Vending Managers are
generally configured to serve separate enterprises. A single Catalog Manager can
serve multiple Vending Managers.
The Vending Manager manages content published by the Catalog Manager. Content
stocked on the Vending Manager is available for subscribers to download.The
Vending Manager also controls subscriber access and purchase pricing, and provides
daily statistical reports on the Content Delivery Server.
Chapter 1 Introduction7
The Vending Manager administrator manages the following functions:
■ Stocked content
■ Subscriber access and subscriber licenses
■ Purchase pricing and trial periods
■ Administrator access
■ Statistical reports
In addition to the Vending Manager administrator, the Content Delivery Server can
have Vending Manager Customer Care Agents. Customer Care Agents have limited
administrator privileges. A Customer Care Agent manages the following functions:
■ Subscriber access and subscriber licenses
■ Statistical reports
The following figure provides a high-level overview of the role of the Vending
Manager in the lifecycle of an application. It also illustrates the Vending Manager
processes.
1. The Catalog Manager publishes content and makes it available to the Vending
Manager.
2. The Vending Manager administrator accesses the content published by the
Catalog Manager. The administrator can change the subscriber pricing of the
content, assign it to a new category, and change the properties of the content.
3. The Vending Manager administrator stocks the content and makes it available to
the subscriber. The administrator uses Subscriber Plans to define the content
categories that subscribers can access.
8Administrator Guide • 2005Q4
Vending Manager Processes
The previous figure illustrates the Vending Manager processes. The Vending
Manager is responsible for the following practices:
■ Content Management
■ Plan Management
■ Account Management
■ Reporting
Content Management
The Catalog Manager publishes content to the Vending Manager. The Vending
Manager is responsible for stocking this content to make it available to the
subscriber. The Vending Manager administrator can change the subscriber pricing of
the content, allow trial usage, and assign the content to a new category. The
administrator can also change the category assignments and add new categories to
control subscriber access to content. See “Managing Catalog Content” on page 134
for more information.
Plan Management
The Vending Manager uses Subscriber Plans to control subscriber access to content.
Each Subscriber Account is assigned to one or more Subscriber Plans. Subscriber
Plans determine what content a subscriber can access and download.
A Subscriber Plan is mapped to selected categories in the Vending Manager. The
content in the selected categories is made available to plan members. If content is in
a category that is not supported by the Subscriber Plan, the subscriber cannot access
it for download. See “Managing Subscriber Plans” on page 216 for more
information.
Account Management
Accounts define access to the Vending Manager. The Vending Manager is
responsible for two types of accounts:
■ Subscriber. Subscriber Accounts are for individuals who subscribe to a service
plan that provides them with the download service. Each Subscriber Account is
associated with one or more Subscriber Plans. See “Managing Subscriber
Accounts” on page 209 for more information.
■ Administrator. Administrator Accounts are for individuals who administer the
Vending Manager. There are two administrator roles: Administrator for
administrators with full privileges for administering the Vending Manager, and
Chapter 1 Introduction9
Customer Care Agent for administrators with privileges for viewing content and
managing subscribers. Administrator Accounts can be disabled when you do not
want an individual accessing the Vending Manager. See “Managing Vending
Manager Administrator Accounts” on page 201 for more information.
Reporting
The Vending Manager provides daily statistical reports that enable you to view and
track application download information and usage statistics downloads. See
“Viewing Reports” on page 223 for more information.
Administration Consoles
Administer the Catalog Manager using the Catalog Manager administration console.
You administer the Vending Manager using the Vending Manager administration
console. These consoles are accessed through a web browser.
Developers can submit content to the Sun Java System Content Delivery Server
using the Developer Portal. Subscribers can download content from the Sun Java
System Content Delivery Server using the Subscriber Portal from either a PC or a
mobile device.
Note – The Developer Portal and Subscriber Portal are outside the scope of this
guide. See the Sun Java System Content Delivery Server Content Developer Guide for
information on submitting content through the Developer Portal.
Browser Requirements
The administration consoles can be run with:
■ Internet Explorer 6.0
■ Netscape Navigator
■ Firefox 1.0
Note – Cookies must be enabled in the browser to use the administration consoles.
10Administrator Guide • 2005Q4
TM
7.0
Accessing the Administration Consoles
To access the Catalog Manager and Vending Manager administration consoles for
the first time, use the default login ID and password that were created when you
installed the Sun Java System Content Delivery Server. The default values for the
Login ID and Password are admin and admin.
Change the password after you initially log in (note that the password is case
sensitive). After you log in to the Catalog Manager and Vending Manager, you can
add additional accounts as needed. See “Adding a Catalog Manager Administrator
Account” on page 105 and “Adding a Vending Manager Administrator Account” on
page 202 for more information.
▼ Logging in to the Catalog Manager
To log in to the Catalog Manager, follow these steps:
1. Start the Catalog Manager.
For information on starting the Catalog Manager, see the Sun Java System Content
Delivery Server Installation Guide.
2. From a browser window, enter the following address:
http://
The Catalog Manager Log In page is displayed.
localhost
/admin/main
Chapter 1 Introduction11
3. Enter your administrator name and password.
4. Click Log In.
▼ Logging in to the Vending Manager
1. Start the Vending Manager. For information on starting the Vending Manager, see
the Sun Java System Content Delivery Server Installation Guide.
2. From a browser window, enter http://localhost/vsadmin/main.
The Vending Manager Log In page is displayed.
3. Enter your administrator name and password.
4. Click Log In.
12Administrator Guide • 2005Q4
Loading...
+ 253 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.