3 部署 Content Delivery Server

本章提供了有关部署 Content Delivery Server 组件的说明。继续操作之前，请确保按照 2 的说明正确设置您所在的环境。

本节介绍了以下部署类型：

基本部署。将所有组件部署到同一主机上。这是可实现运行 Content Delivery Server 的最简单配置。

Catalog Manager 部署。将 Catalog Manager 和支持组件部署到主机上。

Vending Manager 部署。将 Vending Manager 和支持组件部署到主机上。要设置多售卖配置，请执行一个基本部署或 Catalog Manager 部署以及一个或多个 Vending Manager 部署。

高级部署。您可以创建完全定制配置，并有选择地将组件部署到不同主机上。只有在基本配置或多售卖配置无法满足需要时，才需要执行高级部署。

本节包括以下主题：

基本部署

Catalog Manager 部署

Vending Manager 部署

高级部署

3.1 基本部署

本节介绍了部署基本配置的步骤，其中所有 Content Delivery Server 组件都部署到同一服务器。基本部署通常是开始使用 Content Delivery Server 的第一个部署。

如果要运行具有单个 Vending Manager 的简单配置，则只需要执行基本部署。如果要运行具有多个 Vending Manager 的比较复杂的配置，请先执行基本部署，然后再执行一个或多个 Vending Manager 部署。如果不想同时部署 Catalog Manager 和 Vending Manager，请先执行 Catalog Manager 部署，然后再执行一个或多个 Vending Manager 部署。

3.1.1 编辑 `init_env` Shell 脚本

Content Delivery Server 包含一个名为 init_env.sh 的 shell 脚本（位于 $CDS_HOME/bin 目录）。此脚本将根据您提供的值设置下表中所述的环境变量。

表 3-1 在 `init_env` 中设置的环境变量
变量名	描述
`BEA_HOME`	BEA 主目录。请将其设置为包含 `license.bea` 文件的目录，例如，`/usr/local/bea`。注 - 只有在使用 WebLogic Server 时才需要此变量。
`WL_HOME`	WebLogic Server 安装目录。请将其设置为包含 `/server` 目录的目录，例如，`/usr/local/bea/weblogic92`。注 - 只有在使用 WebLogic Server 时才需要此变量。
`SUN_AS_HOME`	Sun Java System Application Server 的安装目录，例如，`/opt/SUNWappserver/appserver`。注 - 只有在使用 Sun Java System Application Server 时才需要此变量。
`JAVA_HOME`	Java 编程语言的主目录。必须正确设置此变量才能运行 Content Delivery Server install 命令 (`cdsi`) 和 Content Delivery Server execute 命令 (`cdse`)。注 - Sun Java System Application Server 和 WebLogic Server 均需要此变量。

3.1.2 设置数据库

请提供所使用的 Oracle 数据库实例的以下信息：

主机名或 IP 地址

端口号

系统用户 ID

系统用户密码

数据库 SID

Content Delivery Server 需要 Catalog Manager 和每个 Vending Manager 的数据库结构。这些结构通过创建时提供的前缀进行标识。这些结构可以位于相同数据库服务器上，也可以位于不同数据库服务器上。

随 Content Delivery Server 提供的 Content Delivery Server Install 命令将根据数据库配置文件中提供的信息创建模式。此配置文件用于标识数据库的位置和创建的模式。

执行基本部署时，将为 Catalog Manager 和 Vending Manager 创建模式。要创建基本部署模式，请执行以下操作：

1. 创建数据库配置文件。

请将位于 $CDS_HOME/cfg 目录中的样例文件 DBConf.xml 用作指南。以下代码示例显示了样例数据库配置文件。

代码示例 3-1 样例数据库配置文件
<CDSDatabase> <DBServer name="DBServer1"> <Hostname>dbhost.domain.com</Hostname> <Port>1521</Port> <SID>dbsid</SID> <Tablespace>USERS</Tablespace> <Tablespace name="catalog">USERS</Tablespace> <Tablespace name="catalog indexes">USERS</Tablespace> <Tablespace name="content">USERS</Tablespace> <Tablespace name="content indexes">USERS</Tablespace> <Tablespace name="event">USERS</Tablespace> <Tablespace name="event indexes">USERS</Tablespace> <Tablespace name="subscriber">USERS</Tablespace> <Tablespace name="subscriber indexes">USERS</Tablespace> <Tablespace name="vending">USERS</Tablespace> <Tablespace name="vending indexes">USERS</Tablespace> <TempTablespace>TEMP</TempTablespace> </DBServer> <Catalog> <Prefix>CDS</Prefix> <Password>dbpassword</Password> <DBServer>DBServer1</DBServer> </Catalog> <Vending name="suncds.vending.server.1"> <Prefix>CDS</Prefix> <Password>dbpassword</Password> <DBServer>DBServer1</DBServer> </Vending> <!-- Additional Vending Managers, if any <DBServer name="DBServer2"> <Hostname>dbhost2.domain.com</Hostname> <Port>1521</Port> <SID>dbsid2</SID> <Tablespace>USERS</Tablespace> <Tablespace name="catalog">USERS</Tablespace> <Tablespace name="catalog indexes">USERS</Tablespace> <Tablespace name="content">USERS</Tablespace> <Tablespace name="content indexes">USERS</Tablespace> <Tablespace name="event">USERS</Tablespace> <Tablespace name="event indexes">USERS</Tablespace> <Tablespace name="subscriber">USERS</Tablespace> <Tablespace name="subscriber indexes">USERS</Tablespace> <Tablespace name="vending">USERS</Tablespace> <Tablespace name="vending indexes">USERS</Tablespace> <TempTablespace>TEMP</TempTablespace> </DBServer> <Vending name="suncds.vending.server.2"> <Prefix>CDS2</Prefix> <Password>dbpassword2</Password> <DBServer>DBServer2</DBServer> </Vending> --> </CDSDatabase>

代码示例 3-1 样例数据库配置文件

<CDSDatabase>

    <DBServer name="DBServer1">
        <Hostname>dbhost.domain.com</Hostname>
        <Port>1521</Port>
        <SID>dbsid</SID>
        <Tablespace>USERS</Tablespace>
        <Tablespace name="catalog">USERS</Tablespace>
        <Tablespace name="catalog indexes">USERS</Tablespace>
        <Tablespace name="content">USERS</Tablespace>
        <Tablespace name="content indexes">USERS</Tablespace>
        <Tablespace name="event">USERS</Tablespace>
        <Tablespace name="event indexes">USERS</Tablespace>
        <Tablespace name="subscriber">USERS</Tablespace>
        <Tablespace name="subscriber indexes">USERS</Tablespace>
        <Tablespace name="vending">USERS</Tablespace>
        <Tablespace name="vending indexes">USERS</Tablespace>
        <TempTablespace>TEMP</TempTablespace>
    </DBServer>

    <Catalog>
        <Prefix>CDS</Prefix>
        <Password>dbpassword</Password>
        <DBServer>DBServer1</DBServer>
    </Catalog>

    <Vending name="suncds.vending.server.1">
        <Prefix>CDS</Prefix>
        <Password>dbpassword</Password>
        <DBServer>DBServer1</DBServer>
    </Vending>

    <!-- Additional Vending Managers, if any
    <DBServer name="DBServer2">
        <Hostname>dbhost2.domain.com</Hostname>
        <Port>1521</Port>
        <SID>dbsid2</SID>
        <Tablespace>USERS</Tablespace>
        <Tablespace name="catalog">USERS</Tablespace>
        <Tablespace name="catalog indexes">USERS</Tablespace>
        <Tablespace name="content">USERS</Tablespace>
        <Tablespace name="content indexes">USERS</Tablespace>
        <Tablespace name="event">USERS</Tablespace>
        <Tablespace name="event indexes">USERS</Tablespace>
        <Tablespace name="subscriber">USERS</Tablespace>
        <Tablespace name="subscriber indexes">USERS</Tablespace>
        <Tablespace name="vending">USERS</Tablespace>
        <Tablespace name="vending indexes">USERS</Tablespace>
        <TempTablespace>TEMP</TempTablespace>
    </DBServer>

    <Vending name="suncds.vending.server.2">
        <Prefix>CDS2</Prefix>
        <Password>dbpassword2</Password>
        <DBServer>DBServer2</DBServer>
    </Vending>
    -->

</CDSDatabase>

注 - 该文件包含未加密的密码。请设置文件权限以限制对此文件的访问。

按照以下步骤中所述，编辑所创建的数据库配置文件：

a. 按照以下步骤中所述，设置 DBServer 元素：

i. 将名称属性设置为用于标识数据库服务器的字符串。

在 Catalog 和 Vending 元素中使用该字符串来标识在其上创建每个模式的数据库服务器。

ii. 将 Hostname、Port 和 SID 元素设置为所定义的 Oracle 数据库实例的主机名、端口号和数据库 SID。

iii. 将 Tablespace 和 TempTablespace 元素设置为所定义的 Oracle 数据库实例的名称。

要对每一组表使用单独的表空间，请将各组的 Tablespace 元素设置为不同的值。每组中包括的表都基于大小和活动，而且在以下列表中进行了说明：

default - 包含不会发生更改的小型表。

catalog - 包含不经常更改的从小型到中型的表。

content - 包含随内容更改而经常发生更改的小型到大型表。

event - 包含当事务发生时发生更改的中型表。

subscriber - 包含随添加订户而发生更改的小型到中型表。

vending - 包含不经常更改的从小型到大型的表。

b. 按照以下步骤所述，设置 Catalog 元素：

i. 将 Prefix 元素设置为要用于标识和访问此模式的名称，例如，CDS。

前缀是不超过 21 个字符的字母数字字符串。有关其他可能的命名限制，请参见 Oracle 数据库文档。

ii. 将 Password 元素设置为用于访问此模式的密码。

iii. 将 DBServer 元素设置为标识要使用的数据库服务器的字符串。

该字符串必须与用于 a 中设置的 DBServer 元素的名称相匹配。

c. 按照以下步骤所述，设置 Vending 元素：

i. 将名称属性设置为用于标识 Vending Manager 的字符串。

为 Vending 元素指定的名称必须用于在 3.1.3, 设置部署配置文件中设置的部署配置文件中的 vs.account.name 属性。使用 Catalog Manager 管理控制台创建 Vending Manager Server 帐户时，还必须将此名称用作帐户 ID。请参见 3.1.6.2, 准备 Catalog Manager。

ii. 将 Prefix 元素设置为要用于标识和访问此模式的名称，例如，CDS。

前缀是不超过 21 个字符的字母数字字符串。有关其他可能的命名限制，请参见 Oracle 数据库文档。

iii. 将 Password 元素设置为用于访问此模式的密码。

iv. 将 DBServer 元素设置为标识要使用的数据库服务器的字符串。

该字符串必须与用于 a 中设置的 DBServer 元素的名称相匹配。

提示 - 如果具有其他 Vending Manager 的信息，则可以在创建基本部署模式的同时创建所需的所有模式。对于要部署的每个其他 Vending Manager，请另外添加一个 Vending 元素，并为名称属性和 Prefix 元素提供唯一的值。另外添加一个 DBServer 元素，以使该 Vending Manager 使用不同的数据库服务器。

d. 将创建的文件保存在 $CDS_HOME/cfg 目录中。

2. 为所使用的数据库服务器创建一个用于标识系统用户名和密码的数据库用户文件。

请将位于 $CDS_HOME/cfg 目录中的样例文件 DBSysUser.xml 用作指南。以下代码示例显示了样例数据库用户文件。

代码示例 3-2 样例数据库用户文件
<DBUsers> <DBServer name="DBServer1"> <User>system</User> <Password>dbsyspassword</Password> </DBServer> <!-- <DBServer name="DBServer2"> <User>system2</User> <Password>dbsyspassword2</Password> </DBServer> --> </DBUsers>

代码示例 3-2 样例数据库用户文件

<DBUsers>

    <DBServer name="DBServer1">
        <User>system</User>
        <Password>dbsyspassword</Password>
    </DBServer>

    <!--
    <DBServer name="DBServer2">
        <User>system2</User>
        <Password>dbsyspassword2</Password>
    </DBServer>
    -->

</DBUsers>

注 - 该文件包含未加密的密码。请设置文件权限以限制对此文件的访问。

对于所使用的每个数据库服务器，请按照以下步骤所述创建一个 DBServer 元素：

a. 将名称属性设置为用于标识数据库服务器的字符串。

此名称必须与在 1 中创建的数据库配置文件中所使用的名称相匹配。

b. 将 User 元素设置为用于访问数据库服务器的系统用户名。

c. 将 Password 元素设置为与系统用户名相关联的密码。

d. 将创建的文件保存在 $CDS_HOME/cfg 目录中。

3. 在 init_env.sh shell 脚本中设置以下变量：

DEFAULT_DB。在 1 中创建的数据库配置文件的名称。没有给命令（该命令接受文件名作为参数）提供文件名时，此变量指定所使用的默认数据库配置文件。

DEFAULT_SYS_USER。在 2 中创建的数据库用户文件的名称。没有给命令（该命令接受文件名作为参数）提供文件名时，此变量指定所使用的默认数据库用户文件。

有关此 shell 脚本的详细信息，请参见 3.1.1, 编辑 init_env Shell 脚本。

4. （可选）要支持 iAppli 应用程序，请跳过此步骤。如果不需要支持 iAppli 应用程序，请从 $CDS_HOME/dist/cds/database/cs 目录中删除 iappli.sql 文件。

将 iappli.sql 文件的副本保存在系统中的其他位置。如果删除了此文件，但以后又决定支持 iAppli 应用程序，请参见《Sun
Java trademark System Content Delivery Server 5.1 集成和配置指南》以了解相应的说明。

5. 将 ojdbc14.jar 文件从数据库服务器复制到 $CDS_HOME/dist/cds/lib/external 目录中。

要使 Java 数据库连接 (Java Database Connectivity, JDBC trademark ) API 驱动程序可供 Content Delivery Server 使用，必须执行此步骤。

6. 运行以下命令创建 Content Delivery Server 使用的用户帐户、创建模式并使用初始数据填充模式：

     cdsi db init [-conf db-configuration-file] [-user db-user-file]

db-configuration-file 是数据库配置文件的名称，该文件包含用于创建模式的信息。如果未提供 db-configuration-file，则使用 init_env.sh 脚本中为 DEFAULT_DB 变量指定的值。db-user-file 是数据库用户文件的名称，该文件包含用于访问数据库的用户名和密码。如果没有提供 db-user-file，则使用 init_env.sh 脚本中为 DEFAULT_SYS_USER 变量指定的值。

注 - 如果不具有创建用户帐户的权限，则请让数据库管理员为您创建以下帐户：
catalog-prefix_ps_owner
catalog-prefix_ps_app
vending-prefix_vs_owner
vending-prefix_vs_app

创建用户帐户后，请运行以下命令创建模式并使用初始数据填充这些模式，而不是运行 cdsi db init：
cdsi db schemas [-conf db-configuration-file] cdsi db data [-confdb-configuration-file]

3.1.3 设置部署配置文件

设置数据库后，创建用于标识要部署的组件的部署配置文件。部署配置文件是每行都包含一个名称值对的标准属性文本文件，并用于将 Content Delivery Server 的设置传播到所有组件。A 中介绍了部署配置文件。

Content Delivery Server 发行套件中包含可用于创建自己的文件的样例配置文件。这些样例配置文件位于 $CDS_HOME/cfg 目录中。与 Sun Java System Application Server 一起使用的样例文件是 sn_sample.cfg（请参见 A.2, 与 Sun Java System Application Server 一起使用的样例文件）。与 WebLogic Server 一起使用的样例文件是 wl_sample.cfg（请参见 A.3, 与 WebLogic Server 一起使用的样例文件）。

要将所有 Content Delivery Server 组件部署到一个服务器上，请按照下列步骤来创建配置文件：

1. 从某个样例文件中创建部署配置文件。

此文件的扩展名必须是 .cfg，而且必须位于 $CDS_HOME/cfg 目录中。

2. 设置常规属性。

有关这些属性的描述，请参见 A.1, 配置属性。

3. 确保未注释掉每个组件的 prefix.include 属性。

属性不能以井号 (#) 开头。

4. 将配置文件保存在 $CDS_HOME/cfg 目录中。

5. 编辑 init_env.sh shell 脚本，将 DEFAULT_CONFIG 变量设置为刚刚创建的部署配置文件的名称。

没有给命令（该命令接受文件名作为参数）提供文件名时，DEFAULT_CONFIG 变量指定所使用的默认部署配置文件。请参见 3.1.1, 编辑 init_env Shell 脚本。

3.1.4 部署

创建部署配置文件并设置环境变量后，请使用以下命令部署 Content Delivery Server 组件：

cdsi deploy [-deployment deployment-name] [-cfg cfg-file-name]

下表介绍了可选参数。

表 3-2 `deploy` 命令的可选参数
参数名	描述
deployment-name	用于标识部署的名称。将会在 `$CDS_HOME/deployment` 目录下创建一个具有此名称的部署目录。该名称必须唯一。
cfg-file-name	用于说明部署的部署配置文件的名称。此文件必须位于 `$CDS_HOME/cfg` 目录中。
注 - 如果省略这些参数，则使用 `init_env.sh` 脚本中为 `DEFAULT_DEPL` 和 `DEFAULT_CONFIG` 指定的值。

提示 - 要获得有关 cdsi 命令的其他信息，请输入 cdsi help。

部署过程将部署配置文件中标识的组件安装在指定的应用服务器上，并使用为部署指定的名称在 $CDS_HOME/deployment 目录下创建一个部署目录。例如，如果将部署命名为 cds1，则将创建 $CDS_HOME/deployment/cds1 目录。

3.1.5 设置应用服务器

成功部署 Content Delivery Server 后，要使用的应用服务器还需要其他一些配置。如果使用的是 Sun Java System Application Server，则必须设置 Message Queue 代理和应用服务器域。如果使用的是 WebLogic Server，则必须获取通过安全套接字层 (Secure Sockets Layer, SSL) 协议进行操作的证书以及更改应用服务器管理员的密码。

3.1.5.1 设置 Sun Java System Application Server

如果使用的是 Sun Java System Application Server，则必须设置 Message Queue 代理和应用服务器域。随 Content Delivery Server 提供了两个 shell 脚本供您使用：deploymq.sh 和 deploy.sh。这些脚本位于 $CDS_HOME/deployment/deployment-name/sun/applications 目录中。

要设置 Sun Java System Application Server，请执行以下操作：

1. 从命令行转到 $CDS_HOME/deployment/deployment-name/sun/applications 目录。

2. 要设置 Message Queue 代理，请输入 deploymq.sh type。

type 可以是 server 或 client。指定 server 可以创建新的 Message Queue 代理。指定 client 可以使用以前创建的 Message Queue 代理。

3. 输入提示您输入的信息。

默认值适用于没有专门要求的安装。要使用默认值，请在出现提示后按 Enter 键。下表说明了这些参数。

表 3-3 `deploymq.sh` 参数
提示	描述
Broker's Host Name（代理的主机名）	在其中运行 Message Queue 代理的主机的名称。默认值为 `localhost`。
Broker's Port（代理的端口）	Message Queue 代理在其中进行监听的端口号。默认值为 `7676`。
Broker's Name（代理的名称）	为 Message Queue 代理指定的实例名称。默认值为 `cdsbroker`。注 - 只有将 `server` 指定为 type 时才显示此提示。
Broker's Admin Name（代理的管理名称）	用于管理 Message Queue 代理的名称。默认值为 `admin`。注 - 只有将 `server` 指定为 type 时才显示此提示。
Broker's Admin Password（代理的管理密码）	用于管理 Messaging Queue 代理的密码。默认值为 `admin`。注 - 只有将 `server` 指定为 type 时才显示此提示。
Broker's User Name（代理的用户名）	用于访问 Message Queue 代理的名称。默认值为 `guest`。
Broker's User Password（代理的用户密码）	用于访问 Message Queue 代理的密码。默认值为 `guest`。
Message Queue "bin" Directory Path（Message Queue "bin" 目录路径）	包含 `imqbrokerd` 和 `imqcmd` 命令文件的目录的全限定路径名。默认值为 `$SUN_AS_HOME/imq/bin`。
Message Queue "lib" Directory Path（Message Queue "lib" 目录路径）	包含 `fscontext.jar` 和 `imq.jar` 文件的目录的全限定路径名。默认值为 `$SUN_AS_HOME/imq/lib`。
Message Queue License Name（Message Queue 许可证名称）	正在使用的 Message Queue 版的许可证类型。有效值为： `pe` - 如果正在运行 Message Queue 的 Platform Edition。（这是与 Solaris 操作系统捆绑的版本。） `try` - 如果正在运行 Message Queue 的 Platform Edition，此版本支持在试用期内试用 Enterprise Edition 功能。 `unl` - 如果正在运行 Message Queue 的 Enterprise Edition。注 - 只有将 `server` 指定为 type 时才显示此提示。

提示 - 要获得有关 deploymq.sh 命令的其他信息，请输入：deploymq.sh -h。

除了设置 Message Queue 代理以外，此脚本还将创建 broker.sh 脚本，用于启动和停止 Message Queue 代理。此脚本位于 $CDS_HOME/deployment/deployment-name/sun/applications 目录中。

4. 使用 $CDS_HOME/deployment/deployment-name/sun/applications 目录中的 broker.sh start 命令启动代理。

5. 设置应用服务器域。

可以在创建应用服务器域时对使用 JavaServer Pages trademark 技术（JSP 页）创建的页面进行预编译，或在第一次访问该页面时对其进行编译。JSP 页预编译可能会使域创建过程增加一小时左右的时间。如果在第一次访问 JSP 页时对其进行编译，则可能会延迟页面的初始显示过程。依据所需的 JSP 页编译时间，使用以下某个命令设置应用服务器域：

要预编译 JSP 页，请输入 deploy.sh command。

要在第一次访问页面时对其进行编译，请输入 deploy.sh command fast。

command 是 create 或 recreate。如果以前没有为 Content Delivery Server 创建应用服务器域，请指定 create 以创建新的域。指定 recreate 可替换以前为 Content Delivery Server 创建的现有应用服务器域。

6. 输入提示您输入的信息。

默认值适用于没有专门要求的安装。要使用默认值，请在出现提示后按 Enter 键。下表说明了这些参数。

表 3-4 `deploy.sh` 参数
提示	描述
Domain's Admin Name（域的管理名称）	用于访问 Sun Java System Application Server 管理控制台的名称。默认值为 `cdsadmin`。
Domain's Admin Password（域的管理密码）	用于访问 Sun Java System Application Server 管理控制台的密码。默认值为 `cdsadmin`。
Domains Master Password（域的主密码）	用于保护域的主密码。默认值为 `cdsmaster`。
Domain's Admin Server Port（域的管理服务器端口）	Sun Java System Application Server 管理控制台在其中进行监听的端口号。默认值为 `4848`。

提示 - 要获得有关 deploy.sh 命令的其他信息，请输入：
deploy.sh -h。

除了设置应用服务器域外，此脚本还将创建 admin.sh 脚本，用于启动和停止该域的 Sun Java System Application Server 管理服务器。此脚本位于 $CDS_HOME/deployment/deployment-name/sun/applications 目录中。

7. 使用 $CDS_HOME/deployment/deployment-name/sun/applications 目录中的 broker.sh stop 命令停止代理。

3.1.5.2 设置 WebLogic Server

如果使用的是 WebLogic Server，则必须获取通过 SSL 协议进行操作的证书以及更改应用服务器管理员的密码。如果将多个部署放在同一个主机上，则还需要更改所使用的 Cookie 名称以避免不正确的会话超时。

获取证书

Content Delivery Server 使用 SSL（SSL 要求证书）连接到应用服务器。有关获得有效证书以用于此目的的信息，请参见 WebLogic Server 文档。

更改管理员密码

部署过程中，将为 Content Delivery Server 创建用户名和密码，以便在访问应用服务器时使用。出于安全方面的考虑，可能会需要更改默认的密码。

要更改默认密码，请执行以下操作：

1. 启动 Content Delivery Server。

请参见 5.1, 启动 Content Delivery Server。

2. 在浏览器中，转到 https://hostname:port/console。

hostname 是为 app.server.admin.hostip 属性指定的名称，port 是为部署配置文件中的 app.server.admin.port 属性指定的端口号。

3. 以管理员身份登录。

默认的用户名是 system。默认的密码是 system。

4. 按照 WebLogic Server 文档中的说明更改管理员密码。

5. 编辑 $CDS_HOME/deployment/deployment-name/conf/wladmin.prop 文件以设置以下属性：

WL_ADMIN_USER。将此属性设置为管理员的用户名。

WL_ADMIN_PASSWORD。将此属性设置为管理员的密码。

更改 Cookie 名称

如果使用具有不同端口号的同一主机对 Content Delivery Server 进行多个部署，则需要更改在第一次部署后添加的部署的 Cookie 名称。否则，如果通过浏览器访问主机上的多个部署，则可能会与为每个会话创建的 Cookie 发生冲突，这可能会导致在部署之间切换时出现会话超时消息。

例如，如果将两个 Vending Manager 部署到同一个主机上并登录到每个 Vending Manager 的管理控制台上，则为第二个 Vending Manager 的会话创建的 Cookie 将覆盖第一个 Vending Manager 的会话的 Cookie。在切换回第一个 Vending Manager 的管理控制台时，将会出现会话超时消息，因为 Cookie 对该会话不再有效。

可以为主机（已包含一个部署）上的每个其他部署的 Cookie 提供不同的名称以防止发生冲突。要更改 Cookie 名称，请执行以下操作：

1. 停止该部署。

使用 cdse stopserver -depl deployment-name 命令停止所使用的部署中的所有组件。

2. 编辑包含部署中每个组件的 Cookie 名称的文件。

Cookie 名称是在以下文件中定义的，其中 root 是 $CDS_HOME/deployment/deployment-name/weblogic/domains/server-domain/applications；server-domain 是在部署配置文件中为 app.server.domain 属性指定的值：

Catalog Manager - root/admin/WEB-INF/weblogic.xml

Developer Portal - root/developer/WEB-INF/weblogic.xml

Vending Manager - root/vsadmin/WEB-INF/weblogic.xml

Subscriber Portal - root/subscriber/WEB-INF/weblogic.xml

Fulfillment Manager - root/fs/WEB-INF/weblogic.xml

事件服务 - root/es/WEB-INF/weblogic.xml

消息传送服务 - root/ms/WEB-INF/weblogic.xml

通知服务 - root/ns/WEB-INF/weblogic.xml

后付费服务 - root/pps/WEB-INF/weblogic.xml

不需要更改未列出的组件，例如，目录搜索服务。

在部署的每个 weblogic.xml 文件中，请执行以下操作：

a. 找到以下语句：

          <param-name>CookieName</param-name>
          <param-value>SID</param-value>

b. 将为 param-value 元素指定的字符串更改为唯一的值。

部署中的每个文件可以使用相同的值，例如 SID2。

c. 保存所做的更改。

3. 重新启动部署。

使用 cdse startserver -depl deployment-name 命令启动所使用的部署中的所有组件。

3.1.6 准备 Content Delivery Server 的使用

使部署可用之前，请配置功能并设置要使用的计划、帐户和设备。本节介绍了所需的准备工作。

3.1.6.1 配置 Content Delivery Server

可以按照需要配置 Content Delivery Server 的很多功能。例如，可以设置页面上显示的项目数或者对 Catalog Manager、Vending Manager、Subscriber Portal 和 Developer Portal 而言缓存刷新的速率。

《Sun Java trademark System Content Delivery Server 5.1 集成和配置指南》介绍了如何配置要使用的功能。使部署可供使用之前，请完成配置并准备组件。

3.1.6.2 准备 Catalog Manager

使用 Catalog Manager 管理控制台准备 Catalog Manager 的以下元素。有关启动 Catalog Manager 的信息，请参见 5.1, 启动 Content Delivery Server。有关使用管理控制台的信息，请参见《Sun Java trademark System Content Delivery Server 5.1 参考手册》。

1. 准备内容。

a. 定义要支持的内容类型。

b. 定义要支持的 MIME 类型。

c. 为要保护的内容类型指定 DRM 方法。

d. 选择要使用的价格模型。

e. 创建价格选项。

f. 定义要使用的类别。

2. 准备设备。

a. 定义要使用的模板。

b. 添加要支持的设备。

c. 提交尚未在 Content Delivery Server 中并且是设备运行内容所需的库。

d. 指定默认设备。

e. 定义要支持的语言环境。例如，使用下表中的值来添加加拿大法语和简体中文支持。

表 3-5 样例语言环境
语言	语言代码	国家/地区代码
加拿大法语	`fr`	`CA`
简体中文	`zh`	`CN`

3. 设置 Vending Manager Server 帐户。

注 - 对于基本部署，Catalog Manager 通过部署配置文件中的信息来创建 Vending Manager Server 帐户。对于 Vending Manager 部署，您必须创建 Vending Manager Server 帐户。在成功创建 Vending Manager Server 帐户之前，Vending Manager 将同步错误记录在 Content Delivery Server 日志中。

a. 选择要使用的售卖计划。

b. 设置默认的售卖计划。

注 - Content Delivery Server 附带的默认售卖计划只允许访问分配给“特色”类别的内容。

4. 准备开发者帐户。

a. 添加要使用的开发者计划和配置文件。

b. 设置默认的开发者计划。

注 - Content Delivery Server 附带的默认开发者计划不限制开发者在提交的应用程序中可以使用的 API。

c. 添加所需的开发者帐户。

3.1.6.3 准备 Vending Manager

使用 Vending Manager 管理控制台准备 Vending Manager 的以下元素。有关启动 Catalog Manager 的信息，请参见 5.1, 启动 Content Delivery Server。有关使用管理控制台的信息，请参见《Sun Java trademark System Content Delivery Server 5.1 参考手册》。

1. 准备内容。

a. 定义要使用的类别。

b. 设置首选项。

c. 设置储存选项。

d. 使用语言环境的价格来设置价格选项。

2. 准备订户帐户。

a. 添加要使用的订户计划。

b. 设置默认的订户计划。

注 - Content Delivery Server 附带的默认订户计划允许访问所有类别中的内容。

c. 添加所需的任何订户帐户。

3.2 Catalog Manager 部署

本节介绍部署 Catalog Manager 的步骤。部署 Catalog Manager 时，还会部署事件服务、消息传送服务、监视服务以及目录搜索服务。继续操作之前，请确保按照 2 中所述设置环境。

3.2.1 编辑 `init_env` Shell 脚本

按照 3.1.1, 编辑 init_env Shell 脚本中所述设置 init_env.sh 脚本。

init_env.sh 脚本包含默认部署、默认数据库配置文件和默认部署配置文件的设置。如果主机包含多个部署，则必须确定将哪个部署指定为默认部署。通过默认设置，可以运行 Content Delivery Server execute 命令 (cdse) 和 Content Delivery Server install 命令 (cdsi)，而无需输入所有参数。如果找不到所需的参数，则使用在 init_env.sh 脚本中指定的默认值。

3.2.2 设置数据库

要部署 Catalog Manager，请为 Catalog Manager 及其关联的事件服务创建模式。按照 3.1.2, 设置数据库中所述，设置数据库配置文件和数据库用户文件。需要 DBServer 和 Catalog 元素。还需要使用与系统中的任一 Vending Manager 对应的 Vending 元素，才能成功设置 DB 连接池。

可以使用以下命令为 Catalog Manager 创建模式：

cdsi db init [-conf db-configuration-file] [-user db-user-file] -cs

注 - 如果不具有创建用户帐户的权限，则请让数据库管理员为您创建以下帐户：
catalog-prefix_ps_owner
catalog-prefix_ps_app

创建用户帐户后，请运行以下命令创建模式并使用初始数据填充这些模式，而不是运行 cdsi db init：
cdsi db schemas -conf db-configuration-file -cs
cdsi db data -conf db-configuration-file -cs

3.2.3 设置部署配置文件

设置数据库后，创建用于标识要部署的组件的部署配置文件。有关配置文件的概述，请参见 3.1.3, 设置部署配置文件。

可以使用以下指导来创建部署配置文件。部署 Catalog Manager 的同时，还会部署事件服务、消息传送服务以及监视服务的实例。

1. 从某个样例文件中创建部署配置文件。

此文件的扩展名必须是 .cfg，而且必须位于 $CDS_HOME/cfg 目录中。

2. 设置常规属性。

有关这些属性的描述，请参见 A.1, 配置属性。

3. 确保未注释掉以下属性，即这些属性名不能以井号 (#) 开头：

cs.include

dp.include

es.include

ms.include

mos.include

css.include

4. 确保注释掉以下属性，即属性名以井号 (#) 开头：

vs.include

sp.include

fs.include

ns.include

pps.include

vss.include

5. 将配置文件保存在 $CDS_HOME/cfg 目录中。

6. 编辑 init_env.sh shell 脚本，将 DEFAULT_CONFIG 变量设置为刚刚创建的部署配置文件的名称。

如果要将 Catalog Manager 部署到以前部署了其他 Content Delivery Server 组件的主机上，则将 DEFAULT_CONFIG 设置为要用作默认值的配置文件的名称。

没有给命令（该命令接受文件名作为参数）提供文件名时，DEFAULT_CONFIG 变量指定所使用的默认部署配置文件。请参见 3.1.1, 编辑 init_env Shell 脚本。

3.2.4 部署

有关部署 Catalog Manager 和支持组件的说明，请参见 3.1.4, 部署。

3.2.5 设置应用服务器

按照 3.1.5, 设置应用服务器中所述，设置所使用的应用服务器。如果使用的是 Sun Java System Application Server，并且在以前的部署中创建了 Message Queue 代理，请在运行 deploymq.sh 命令时输入 client 作为 type，从而创建此部署的 Message Queue 代理客户机。

3.2.6 准备 Catalog Manager 以供使用

有关配置要使用的功能的信息，请参见《Sun Java trademark System Content Delivery Server 5.1 集成和配置指南》。使用 Catalog Manager 之前，必须部署至少一个 Vending Manager 并创建一个 Vending Manager Server 帐户。

有关 Catalog Manager 所需的其他准备工作，请参见 3.1.6.2, 准备 Catalog Manager。

3.3 Vending Manager 部署

本节介绍部署 Vending Manager 的步骤。部署 Vending Manager 时，还会部署 Fulfillment Manager 以及除目录搜索服务以外的所有服务。

部署 Vending Manager 之前，必须部署 Catalog Manager。可以将 Catalog Manager 作为基本部署（请参见 3.1, 基本部署）、Catalog Manager 部署（请参见 3.2, Catalog Manager 部署）或高级部署（请参见 3.4, 高级部署）的一部分进行部署。

可以在已部署 Content Delivery Server 其他组件的主机或者在未部署任何其他组件的主机上部署 Vending Manager。如果主机包含现有部署，则使用现有安装和 CDS_HOME 目录。如果主机不包含现有部署，则请确保在继续操作之前按照 2 中所述设置环境。

3.3.1 编辑 `init_env` Shell 脚本

如果要将 Vending Manager 部署到未部署其他组件的主机上，请按照 3.1.1, 编辑 init_env Shell 脚本中所述设置 init_env.sh 脚本。

如果要将 Vending Manager 部署到已经部署了其他组件的主机上，请确认 $CDS_HOME/bin 目录中的 init_env.sh shell 脚本包含 SUN_AS_HOME、JAVA_HOME、BEA_HOME 和 WL_HOME 变量的正确设置。该主机上的所有部署都使用这些设置。

init_env.sh 脚本还包含默认部署、默认数据库配置文件、默认数据库用户文件以及默认部署配置文件的设置。如果主机包含多个部署，则必须确定将哪个部署指定为默认部署。通过默认设置，可以运行 Content Delivery Server execute 命令 (cdse) 和 Content Delivery Server install 命令 (cdsi)，而无需输入所有参数。如果找不到所需的参数，则使用在 init_env.sh 脚本中指定的默认值。

3.3.2 设置数据库

要部署 Vending Manager，需要为该 Vending Manager 创建模式。此模式可以与 Catalog Manager 模式位于相同的数据库服务器上，也可以位于不同的服务器上。

如果在设置基本部署的数据库时为当前正在部署的 Vending Manager 创建了模式，则无需对此数据库进行进一步操作。继续执行 3.3.3, 设置部署配置文件。

如果没有为 Vending Manager 创建模式，则按照 3.1.2, 设置数据库中所述设置数据库配置文件和数据库用户文件。仅需要 DBServer 和 Vending 元素。

可以使用以下命令为 Vending Manager 创建模式：

cdsi db init [-conf db-configuration-file] [-user db-user-file] -vs vending-name

注 - 如果不具有创建用户帐户的权限，则请让数据库管理员为您创建以下帐户：
vending-prefix_vs_owner
vending-prefix_vs_app

创建用户帐户后，请运行以下命令创建模式并使用初始数据填充这些模式，而不是运行 cdsi db init：
cdsi db schemas -conf db-configuration-file -vs vending-name
cdsi db data -conf db-configuration-file -vs vending-name

3.3.3 设置部署配置文件

设置数据库后，创建用于标识要部署的组件的部署配置文件。有关配置文件的概述，请参见 3.1.3, 设置部署配置文件。

如果以前部署了 Catalog Manager 并希望将其他 Vending Manager 添加到配置中，请按照下列步骤创建部署配置文件。部署 Vending Manager 的同时，还会部署 Fulfillment Manager 和所有 Content Delivery Server 服务的实例。

1. 从某个样例文件中创建部署配置文件。

此文件的扩展名必须是 .cfg，而且必须位于 $CDS_HOME/cfg 目录中。如果要部署到包含其他部署的主机，则请为此部署创建新的配置文件以避免混淆。

2. 设置常规属性。

有关这些属性的描述，请参见 A.1, 配置属性。

3. 确保未注释掉以下属性，即这些属性名不能以井号 (#) 开头：

vs.include

sp.include

fs.include

es.include

ms.include

ns.include

mos.include

pps.include

vss.include

4. 确保通过在属性名前面添加井号 (#) 来注释掉以下属性：

cs.include

dp.include

css.include

5. 将配置文件保存在 $CDS_HOME/cfg 目录中。

6. 编辑 init_env.sh shell 脚本，将 DEFAULT_CONFIG 变量设置为刚刚创建的部署配置文件的名称。

如果要将 Vending Manager 部署到已部署了其他 Content Delivery Server 组件的主机上，请将 DEFAULT_CONFIG 设置为要用作默认值的配置文件的名称。

没有给命令（该命令接受文件名作为参数）提供文件名时，DEFAULT_CONFIG 变量指定所使用的默认部署配置文件。请参见 3.1.1, 编辑 init_env Shell 脚本。

3.3.4 部署

有关部署 Vending Manager 和支持组件的说明，请参见 3.1.4, 部署。

3.3.5 设置应用服务器

3.3.6 准备 Vending Manager 以供使用

有关配置要使用的功能的信息，请参见《Sun Java trademark System Content Delivery Server 5.1 集成和配置指南》。

使用刚刚部署的 Vending Manager 之前，必须在 Catalog Manager 中为其创建一个 Vending Manager Server 帐户。有关信息，请参见 Catalog Manager 管理控制台联机帮助中的“添加 Vending Manager Server 帐户”主题。创建 Vending Manager Server 帐户时，必须将帐户 ID 设置为用于部署配置文件中 vs.account.name 属性的值。帐户密码必须设置为用于部署配置文件中 vs.account.password 属性的值。这些值还必须与为 Vending Manager 创建数据库结构时使用的名称和密码相匹配。

注 - 在 Catalog Manager 中成功创建 Vending Manager Server 帐户之前，Vending Manager 将同步错误记录在 Content Delivery Server 日志中。

有关 Vending Manager 所需的其他准备工作，请参见 3.1.6.3, 准备 Vending Manager。

3.4 高级部署

对一个服务器上的所有 Content Delivery Server 组件执行了基本部署后再执行一个或多个其他的 Vending Manager 部署，应可以满足大多数企业的需要。如果有特殊需要（例如限制部署方式的有限资源或安全性要求），则 Content Delivery Server 支持高度定制部署。

通过高级部署，可以在配置中有选择地安装满足需要的组件。由于高级部署具有独特的特性，因此本节只提供了设置部署的指导，而不是具体说明。

3.4.1 编辑 `init_env` Shell 脚本

如果要将组件部署到未部署其他组件的主机上，请设置 init_env.sh 脚本，如 3.1.1, 编辑 init_env Shell 脚本中所述。

如果要将组件部署到已经部署了其他组件的主机上，请确认 $CDS_HOME/bin 目录中的 init_env.sh shell 脚本包含 SUN_AS_HOME、JAVA_HOME、BEA_HOME 和 WL_HOME 变量的正确设置。该主机上的所有部署都使用这些设置。

init_env.sh 脚本还包含默认部署、默认数据库配置文件和默认的部署配置文件的设置。如果主机包含多个部署，则必须确定将哪个部署指定为默认部署。通过默认设置，可以运行 Content Delivery Server execute 命令 (cdse) 和 Content Delivery Server install 命令 (cdsi)，而无需输入所有参数。如果找不到所需的参数，则使用在 init_env.sh 脚本中指定的默认值。

3.4.2 设置数据库

为配置中的 Catalog Manager 和每个 Vending Manager 创建所需的模式。根据需要，数据库可以共享数据库服务器或使用单独的服务器。

要设置数据库，请执行以下操作：

1. 按照 3.1.2, 设置数据库中所述，创建数据库配置文件和数据库用户文件。

为所有要部署的 Vending Manager 创建条目。

注 - 数据库配置文件和数据库用户文件包含未加密的密码。请设置文件权限以限制对这些文件的访问。

2. 将数据库配置文件和数据库用户文件复制到要部署 Content Delivery Server 组件的所有主机。

将此文件放在每个主机的 $CDS_HOME/cfg 目录中。

3. 在每个主机上的 init_env.sh shell 脚本中设置以下变量：

DEFAULT_DB。在 1 中创建的数据库配置文件的名称。没有给命令（该命令接受文件名作为参数）提供文件名时，此变量指定所使用的默认数据库配置文件。

DEFAULT_SYS_USER。在 1 中创建的数据库用户文件的名称。没有给命令（该命令接受文件名作为参数）提供文件名时，此变量指定所使用的默认数据库用户文件。

有关此 shell 脚本的详细信息，请参见 3.1.1, 编辑 init_env Shell 脚本。

4. 将 ojdbc14.jar 文件从数据库服务器复制到 $CDS_HOME/dist/cds/lib/external 目录中。

要使 JDBC API 驱动程序可供 Content Delivery Server 使用，必须执行此步骤。

5. 创建在数据库配置文件中所定义的模式。

从要部署 Catalog Manager 的主机运行以下命令。

      cdsi db init [-conf db-configuration-file] [-user db-user-file]

以后要部署其他 Vending Manager，请按照 3.3.2, 设置数据库中所述创建所需的其他模式。

3.4.3 设置部署配置文件

设置数据库后，创建用于标识要部署的组件的部署配置文件。有关配置文件的概述，请参见 3.1.3, 设置部署配置文件。

部署配置文件用于标识要部署的组件。为避免混淆，请为每个部署创建一个单独的配置文件。要创建配置文件，请执行以下操作：

1. 从某个样例文件中创建部署配置文件。

此文件的扩展名必须是 .cfg，而且必须位于 $CDS_HOME/cfg 目录中。

2. 设置常规属性。

有关这些属性的描述，请参见 A.1, 配置属性。

3. 对于部署中包含的每个组件，请确保未注释掉 prefix.include 属性。

属性不能以井号 (#) 开头。

4. 对于部署中未包含的每个组件，请确保注释掉 prefix.include 属性。

属性必须以井号 (#) 开头。

5. 将配置文件保存在 $CDS_HOME/cfg 目录中。

6. 编辑 init_env.sh shell 脚本，将 DEFAULT_CONFIG 变量设置为刚刚创建的部署配置文件的名称。

如果要将组件部署到已部署了其他 Content Delivery Server 组件的主机上，请将 DEFAULT_CONFIG 设置为要用作默认值的配置文件的名称。

没有给命令（该命令接受文件名作为参数）提供文件名时，DEFAULT_CONFIG 变量指定所使用的默认部署配置文件。有关此 shell 脚本的信息，请参见 3.1.1, 编辑 init_env Shell 脚本。

3.4.4 部署

有关部署的说明，请参见 3.1.4, 部署。

3.4.5 设置应用服务器

按照 3.1.5, 设置应用服务器中所述，设置所使用的应用服务器。如果使用的是 Sun Java System Application Server，请根据以下指导设置 Message Queue 代理：

部署 Catalog Manager 时，应在运行 deploymq.sh 命令时输入 server 作为 type，从而创建新的 Message Queue 代理。

如果独立于 Catalog Manager 部署 Vending Manager 或服务，则该组件可以共享现有的 Message Queue 代理或创建一个新的代理。

要共享现有的 Message Queue 代理，请在运行 deploymq.sh 命令时输入 client 作为 type。要创建新的 Message Queue 代理，请指定 server。

3.4.6 准备高级部署以供使用

有关配置所部署组件的功能的信息，请参见《Sun Java trademark System Content Delivery Server 5.1 集成和配置指南》。

部署 Catalog Manager 之后，请参见 3.1.6.2, 准备 Catalog Manager 以了解设置信息。部署 Vending Manager 之后，请参见 3.3.6, 准备 Vending Manager 以供使用。

3

部署 Content Delivery Server

3.1 基本部署

3.1.1 编辑 init_env Shell 脚本

表 3-1 在 init_env 中设置的环境变量

3.1.2 设置数据库

代码示例 3-2 样例数据库用户文件

3.1.3 设置部署配置文件

3.1.4 部署

表 3-2 deploy 命令的可选参数

3.1.5 设置应用服务器

3.1.5.1 设置 Sun Java System Application Server

表 3-3 deploymq.sh 参数

表 3-4 deploy.sh 参数

3.1.5.2 设置 WebLogic Server

获取证书

更改管理员密码

更改 Cookie 名称

3.1.6 准备 Content Delivery Server 的使用

3.1.6.1 配置 Content Delivery Server

3.1.6.2 准备 Catalog Manager

表 3-5 样例语言环境

3.1.6.3 准备 Vending Manager

3.2 Catalog Manager 部署

3.2.1 编辑 init_env Shell 脚本

3.2.2 设置数据库

3.2.3 设置部署配置文件

3.2.4 部署

3.2.5 设置应用服务器

3.2.6 准备 Catalog Manager 以供使用

3.3 Vending Manager 部署

3.3.1 编辑 init_env Shell 脚本

3.3.2 设置数据库

3.3.3 设置部署配置文件

3.3.4 部署

3.3.5 设置应用服务器

3.3.6 准备 Vending Manager 以供使用

3.4 高级部署

3.4.1 编辑 init_env Shell 脚本

3.4.2 设置数据库

3.4.3 设置部署配置文件

3.4.4 部署

3.4.5 设置应用服务器

3.4.6 准备高级部署以供使用

3.1.1 编辑 `init_env` Shell 脚本

表 3-1 在 `init_env` 中设置的环境变量

表 3-2 `deploy` 命令的可选参数

表 3-3 `deploymq.sh` 参数

表 3-4 `deploy.sh` 参数

3.2.1 编辑 `init_env` Shell 脚本

3.3.1 编辑 `init_env` Shell 脚本

3.4.1 编辑 `init_env` Shell 脚本