SAP 4.1 Support Package 5 Business Intelligence Web Application Deployment Guide

SAP BusinessObjects Business Intelligence 平台

文档版本：

4.1 Support Package 5 - 2014-11-14

Web 应用程序部署指南

Unix 版 Windows

版

目录

1

文档历史记录

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2

2.1

入门

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

关于本文档

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.2

《

Web 应用程序部署指南》中的新增内容. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

2.3

本文档的读者

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.4

变量

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.5

术语

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3

3.1

Web 应用程序部署概述. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

OSGi WAR 文件概述. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2

故障转移和负载平衡

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2.1 Web 应用程序群集支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.3 SAP BusinessObjects Business Intelligence 平台

WAR 和 EAR 文件. . . . . . . . . . . . . . . . . . . . . . . . . 12

3.3.1

部署支持移动应用程序的

MobileOTA14.war. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.3.2

部署支持

OpenSearch 的 OpenSearch.war. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

3.4

默认上下文根

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.5

自定义根上下文和上下文路径

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.5.1

3.5.2

更改根上下文

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

更改

Web 应用程序的上下文路径. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4

4.1

使用

WDeploy 工具部署 Web 应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

WDeploy 概述. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2 WDeploy 先决条件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

4.2.1

在部署

Web 应用程序之前. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

4.2.2

硬件要求

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.2.3

4.2.4

4.2.5

4.2.6

64 位支持. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

以另一帐户部署

Web 应用程序所需的最小权限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

将

ulimit 设置为“无限制”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

设置

Java 环境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Web 应用程序服务器参数配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

在远程

Web 应用程序服务器上安装 WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

4.2.7

4.2.8

4.3 SAP 系统架构目录（SLD）注册. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

4.3.1

4.3.2

4.3.3

启用

SAP NetWeaver 技术平台的 SLD 注册. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

为

Tomcat 启用 SLD 注册. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

启用

WebSphere 的 SLD 注册. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

4.4

部署模式

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4.4.1

独立部署

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

目录

4.4.2

分离

Web 层部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

4.5 WDeploy 配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

4.5.1 WDeploy 配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

4.5.2

4.6.3

4.6.4

4.6.5

Web 应用程序服务器配置文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

4.5.3 Web 应用程序配置属性文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

4.6

使用

WDeploy 命令行工具. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

4.6.1

4.6.2

语法

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

使用

WDeploy 的示例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

特殊注意事项

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

无需访问

Web 应用程序服务器的分离 Web 层预部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

禁用

CMC 或 BI 启动板 Web 应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

4.7

4.6.6

更改为已安装的语言

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

使用

WDeploy GUI 工具. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

4.7.1

4.7.2

WDeploy GUI 工具先决条件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

启动

WDeploy GUI 工具. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

4.7.3

4.7.4

WDeploy GUI 工具窗口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

通过

WDeploy 进行 Web 应用程序更新. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

4.7.5 WDeploy GUI 工具选项. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

4.7.6

将密码添加至

WDeploy GUI 文件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

4.8

部署

Web 应用程序之后. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

4.9

日志文件

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

5

5.1

使用管理控制台部署

Web 应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

手动部署

Web 应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5.1.1 JBoss 7.1 管理控制台手动部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

5.1.2

5.1.3

5.1.4

5.1.5

SAP NetWeaver 技术平台. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Tomcat 6 和

7 管理控制台手动部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

WebLogic 11gR1 管理控制台手动部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77

WebSphere 7.0 和

8.5 管理控制台手动部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

6

已知问题和解决方法

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

6.1 wdeploy.sh 脚本中的

Windows 行结束符. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

6.2

重命名

BOE Web 应用程序或 Web 应用程序源树. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

6.3

在纯

IPv6 环境中使用 WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84

6.4

分离

Web 层服务器的 Web 服务 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

6.5

在

WDeploy 中使用非英语语言时应注意的问题. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

6.6

未从服务器中删除的

Web 应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

6.7

在

Red Hat Linux Enterprise 服务器上启动 WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85

6.8

执行

Web 层安装后，复制 MobileOTA14.properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

6.9 WDeploy GUI 工具中的

“取消”按钮. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Web 应用程序部署指南

Unix 版 Windows 版

目录

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

3

6.10 JBoss. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

6.10.1

将

AdminTools、dswsbobje 或 BusinessProcessBI 应用程序部署到 JBoss 7.1 时出现安全

异常

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

6.11 SAP NetWeaver 技术平台. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

6.11.1

使用

SUM 部署到 SAP NetWeaver 技术平台时显示的服务级别、修补程序级别和名称参数

不正确

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

6.11.2 WDeploy 工具不支持从

SAP NetWeaver 技术平台部署或取消部署. . . . . . . . . . . . . . . . . . . 87

6.12 Tomcat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

6.12.1

使用

WDeploy 从 Tomcat 取消部署 Web 应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

6.12.2

运行

WDeploy 之后，Tomcat 可能不会立即加载 Web 应用程序. . . . . . . . . . . . . . . . . . . . . 88

6.13 WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

6.13.1

从

WebLogic 取消部署 Web 服务. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

6.14 WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

6.14.1

在安全模式下部署到

WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

6.14.2

将

Web 服务部署到 WebSphere 7.0 之后出现内部服务器错误. . . . . . . . . . . . . . . . . . . . . . .89

6.14.3 WASX7017E： 在

WebSphere 中部署时出现异常. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

4

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

目录

1

文档历史记录

下表概述了最重要的文档更改。

注意

有关此版本支持的

Web 应用程序服务器的最新列表，请参阅 SAP Support Portal 的 SAP BusinessObjects

部分提供的《

Product Availability Matrix》（产品可用性矩阵）（支持的平台/PAR），网址是：

https:// service.sap.com/bosap-support

。

版本

SAP

BusinessObjects

Business Intelligence

平台

4.1

SAP

BusinessObjects

Business Intelligence

平台

4.1 支持包 1

日期

月

2013 年

5

说明

本文档的第一个版本。

月

2013 年

8

已更新

将

AdminTools、dswsbobje 或 BusinessProcessBI 应用程序

部署到

JBoss 7.1 时出现安全异常 [第 86 页]。 部署到 JBoss 7.1 时，

dswsbobje 和 BusinessProcessBI 应用程序可能也需要解决方法。

现在使用

SAP Software Update Manager (SUM)（而不是 SAP Java

Support Package Manager (JSPM)）将

Web 应用程序部署到 SAP

NetWeaver 技术平台。 已更新

使用

SAP Software Update Manager

(SUM) 部署

SAP NetWeaver 技术平台

[第 75 页]。

SAP

BusinessObjects

Business Intelligence

平台

4.1 支持包 2

2013 年

11 月

● 已从所支持平台中卸载 Weblogic 10

● “Changes to installed languages”（更改为已安装的语言）已更

新，因为通过修改安装而非完整的重新安装即可添加语言。

● 已更新 “wdeploy predeploy” 和 “wdeploy predeployall”，以便包

含

jrockit 参数

● 已添加 WebSphere 8.5.5 作为支持平台

SAP

BusinessObjects

Business Intelligence

平台

4.1 支持包 4

月

2014 年

6

● 将 MOBIServer 添加到了《分离 Web 层部署》

● 在《使用 SAP Software Update Manager (SUM) 部署 SAP

NetWeaver 技术平台》一节中，将 weblogic11 更改为 sapappsvr73

● 更改了《部署到单独的 IHS Web 和 WebSphere Web 应用程序服

务器》一节中

config.apache 的内容

● 更新了《分离 Web 层服务器的 Web 服务》、《Web 应用程序群

集支持》和《故障转移和负载平衡》。

● 更新了《分离 Web 层部署》，现在声明支持 Web 应用程序（尽

管不实现性能改进）。

● 删除了《SAP 配置文件》一节，因为部署到 SAP NetWeaver 技

术平台不支持

WDeploy。

Web 应用程序部署指南

Unix 版 Windows 版

文档历史记录

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

5

版本

SAP

BusinessObjects

Business Intelligence

平台

4.1 支持包 5

日期

2014 年

11 月

说明

● 更新了“Web 应用程序群集支持”一节。 更新了“BI 启动板和 CMC

的容错

”。

6

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

文档历史记录

2

入门

2.1

关于本文档

本文档描述如何使用

WDeploy 工具将 BI 平台 Web 应用程序部署到 Web 应用程序服务器上。

有关安装

BI 平台的信息，请参阅《SAP BusinessObjects Business Intelligence 平台安装指南》。

有关管理

SAP BusinessObjects Business Intelligence 平台服务器的信息，请参阅 《SAP BusinessObjects

Business Intelligence 平台管理员指南》。

2.2 《Web 应用程序部署指南》中的新增内容

Web 应用程序服务器支持

有关此版本支持的平台、数据库、

Web 应用程序服务器、Web 服务器和其他系统的列表，请参阅

SAP Support

Portal 中

SAP BusinessObjects 部分的产品可用性矩阵（支持的平台/PAR），网址为：

https:// service.sap.com/bosap-support

。当存在差异时，产品可用性矩阵的优先级将高于《

Web 应用程序部署指

南》。

BI 平台

4.x

BI 平台

4.x 引入了以下功能：

表

1： WDeploy 部署工具的新增功能

功能 说明

GUI 界面

用于

deployall 和 undeployall 操作的新 GUI 界面。

件

两个级别的日志文 一个日志摘要可帮助管理员了解部署状态：另一个详细日志可帮助开发人员解决部署

难题。

更简易的配置 用于

WDeploy 全局参数的集中配置文件；通过 WDeploy GUI 访问服务器和 WDeploy

参数。

本地化支持

无中间

WAR 文件

简化部署

WDeploy GUI 本地化支持。

在部署过程中不再创建中间

WAR 文件。如果需要创建不是为特定 Web 应用程序服务

器定制的

WAR 文件，请使用 wdeploy buildwarall 命令。

用于

BI 平台 Web 应用程序的 WAR 文件数已减少。这有助于减少重复资源消耗和从

Web 应用程序服务器到

CMS 产生的查询数。

Web 应用程序部署指南

Unix 版 Windows 版

入门

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

7

表

2： 此文档中的新增内容

功能

内容重组

新增功能文档

说明

此前，文档为每个

Web 应用程序服务器列出所有 WDeploy 命令。现在，每

个

WDeploy 命令只显示一次，并为每个受支持的 Web 应用程序服务器提供示

例。

提供了

WDeploy 新增功能文档。

支持网站上提供

BI 平台产品文档的受支持语言版本，并且在下一版本发布之前，一旦有最新内容，便会相应地

更新产品文档。要获得最新产品文档，请访问

http://help.sap.com

。

2.3 本文档的读者

本文档面向为

BI 平台安装工作提供支持的系统管理员或 IT 专业人员。必需熟悉整体网络环境、端口使用约定、

数据库环境和

Web 服务器软件。

2.4 变量

以下变量的使用贯穿本指南。

变量

<BIP_INSTALL_DIR>

<WAS_HOSTNAME>

<WEB_APP>

<WEB_APP_SERVER>

8

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

说明

BI 平台的安装目录。

部署了

BI 平台 Web 应用程序的 Web 应用程序服务器的

主机名或

IP。

BI 平台

Web 应用程序的名称。 例如，

<WEB_APP>

的值

是

BOE

。

此应用程序中存在名为 BOE.properties

的配

置文件，并且

WDeploy 工具在预部署步骤中将为特定的应用

程序服务器创建

BOE.war

。

有关

BI 平台 Web 应用程序的完整列表，请参阅

SAP

BusinessObjects Business Intelligence 平台

WAR 和 EAR 文

件

[第 12 页]。

WDeploy 工具使用的

Web 应用程序服务器的缩略名。 例

如，

Tomcat 7.0 的

<WEB_APP_SERVER>

的值是 tomcat7

。

有关完整值列表，请参阅

WEB_APP_SERVER 的值

[第

46 页]。

Web 应用程序部署指南

Unix 版 Windows 版

入门

2.5 术语

整个

BI 平台文档中使用的术语如下：

术语

加载项产品

审核数据存储（

ADS）

BI 平台

捆绑的数据库；捆绑的

Web 应用程序服务器

群集（名词）

群集（动词）

群集密钥

CMS

CMS 数据库

部署

安装

计算机

主要版本

定义

可以与

BI 平台一起使用，但有自己的安装程序的产

品，例如

SAP BusinessObjects Explorer

用于存储审核数据的数据库

SAP BusinessObjects Business Intelligence 平台的

缩写

器

与

BI 平台一起交付的数据库或

Web 应用程序服务

两个或多个一起工作并使用单一

CMS 数据库的中央

管理服务器（

CMS）。

创建群集。

例如，要创建群集：

1. 在计算机

A 上安装 CMS 和 CMS 数据库。

2. 在计算机

B 上安装 CMS。

3. 将计算机

B 上的 CMS 指向计算机 A 上的 CMS

数据库。

用于解密

CMS 数据库中的密钥。

可以在

CCM 中更改群集密钥，但不能像重置密码一

样重置此密钥。

该密钥包含加密内容，因此切勿丢失。

中央管理服务器的缩写

CMS 用来存储有关 BI 平台的信息的数据库

在一台或多台计算机上安装、配置和运行的

BI 平台

软件

由计算机上的安装程序创建的

BI 平台文件的实例

安装了

BI 平台软件的计算机

软件的完整版本（例如

4.0）

Web 应用程序部署指南

Unix 版 Windows 版

入门

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

9

术语

迁移

次要版本

节点

修补程序

升级

服务器

服务器智能代理（

SIA）

支持包

Web 应用程序服务器

升级

定义

使用升级管理工具传输早期主要版本（例如

XI 3.1）

中的

BI 内容的过程。

此术语不适用于具有相同主版本的部署。

请参见

“升

级

”。

软件的其中部分组件的版本（例如

4.1）

在同一计算机上运行且由相同的服务器智能代理

（

SIA）管理的一组 BI 平台服务器

特定支持包版本的小范围更新

使用升级管理应用程序在具有相同主版本的部署之

间（例如

4.0 到 4.0）传输 BI 内容的过程

BI 平台流程。 托管一项或多项服务的服务器。

管理一组服务器的过程（包括停止、启动和重新启

动服务器）

次要或主要版本的软件更新

处理动态内容的服务器。

例如，4.1 的捆绑的

Web

应用程序服务器是

Tomcat 7。

完成迁移过程所需的计划、准备、迁移和后处理

10

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

入门

3

Web 应用程序部署概述

BI 平台安装程序只能将

Web 应用程序部署到捆绑的 Tomcat Web 应用程序服务器。所有其他支持的 Web 应用

程序服务器要求在安装完成之后部署

Web 应用程序。建议使用 WDeploy Web 应用程序部署工具。有关如何使用

WDeploy 工具进行部署的信息和说明，请参阅本指南的

““使用 WDeploy 工具部署 Web 应用程序””一节。

如果需要，也可以使用应用程序服务器的管理控制台部署

Web 应用程序。首先，必须将使用 Web 应用程序服

务器的管理控制台部署的

Web 应用程序修改为可部署的 WAR 或 EAR 文件。wdeploy predeploy 和 wdeploy predeployall 命令可自动执行此过程。使用这些预部署命令后，请跳到本指南的““使用管理控制台部署 Web 应

用程序

””一节以了解相关说明。但是，如果非常了解 Web 应用程序服务器并且知道如何自定义要部署的 Web 应用

程序，则可手动完成此操作。本指南未涵盖对部署到

Web 应用程序服务器的 Web 应用程序的手动定制。

3.1

OSGi WAR 文件概述

针对

Java Web 应用程序的 OSGi 框架简化了与 BI 平台绑定的 Web 应用程序的部署过程。它允许单个包中存在

Web 应用程序、语言包、SDK、插件和其他资源。用一个步骤就能把该捆绑包部署到

Web 应用程序服务器。

部署单个

WAR 文件后，只需较少的 Web 会话，就能访问多个 Web 应用程序，从而降低了对 Web 应用程序服

务器的内存、磁盘和处理负荷要求。

3.2 故障转移和负载平衡

BI 平台利用负载平衡支持群集化

Web 应用程序服务器。 硬件或软件负载平衡器可用作 Web 应用程序服务器的

入口点，以确保在

Web 应用程序服务器之间平均分配处理工作。

目前支持以下持久性类型：

● 源 IP 地址持久性。

● Cookie 持久性插入模式（ArrowPoint Cookie）

注意

不需要对

BI 平台服务器群集配置负载平衡，因为中央管理服务器（CMS）已经将工作分发到各群集节点

上。

3.2.1

Web 应用程序群集支持

BI 平台可用于具有各种不同群集配置、负载平衡配置或容错配置的环境。 下表列出了

Web 承载的 BI 工具、

CMC 和

BI 启动板 Web 应用程序支持的配置。

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述 © 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

11

Web 应用程序

态）

BI 启动板（无状

具

CMC（有状态）

Web 承载的

BI 工

群集式

Web 应用

程序服务器

使用会话相似性

的负载平衡器

不使用会话相似

性的负载平衡器

支持 支持 不支持

是否容错

（请参阅《容错

说明》）。

否

支持

支持

支持

支持

不支持

不支持

否

是

注意

WDeploy 工具不支持在群集或群集软件中部署，如

Websphere Application Server Network 部署。

容错说明

容错（或故障转移）在

BI 平台工具中受支持的方式是文档序列化。 CMC 和 BI 启动板不支持故障转移。如果

Web 层配置正确，则在

Web 服务器发生故障时支持以下行为：

Web 应用程序

BI 启动板

CMC

Web 承载的

BI 工具

容错说明

需要再次登录。

需要再次登录。

需要再次登录但文档内容将保留。

配置故障转移时，必须考虑序列化对象中的数据的频率。

过于频繁地保存状态可能导致

Web 应用程序服务器上

有额外的系统开销，从而导致用户体验较慢。

关于建议的配置设置，请查阅

Web 应用程序供应商的文档。

3.3 SAP BusinessObjects Business Intelligence 平台

WAR

和

EAR 文件

BI 平台所包含的功能在若干

Web 应用程序之间进行了划分，这使得仅部署组织所需的组件变得非常容易。 在

BI 平台

4.2 中，先前版本所含的许多核心 Web 应用程序都已捆绑到单个 OSGi 存档文件中。 这样，可节省 Web 应

用程序服务器内存，减少先前具有多个存档文件的

Web 应用程序所需的 Web 会话数。

例如，

BI 平台

XI 3.x 包含存档为 CMC.war 和 InfoView.war 的中央管理控制台（CMC）和 InfoView（现在

称为

BI 启动板）。 BI 平台 4.2 已将 CMC 和 InfoView（现在称为 BI 启动板）Web 应用程序及其他应用程序合并

到一个名为

BOE.war 或 BOE.ear 的存档文件中。

WDeploy 工具用于自动定制可在支持的

Web 应用程序服务器上部署的 Web 应用程序。 尽管经验丰富的管理员

可以手动定制特定

Web 应用程序服务器的 Web 应用程序，但仍建议使用 WDeploy 工具自动完成该操作。

12

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述

下表列出了

Web 应用程序存档文件以及需要这些文件的 Web 应用程序。 必须对安装程序没有自动部署的 Web

应用程序进行安装后部署。

Web 应用程序存档文件（可能是

WAR 或

EAR）

BOE

是否自动部署？

是

说明

BusinessProcessBI

使用） clientapi dswsbobje

（不赞成 是

是

是

核心

Web 应用程序的 OSGi 存档文

件，包括：

●

Analytical Reporting

●

CMC

●

SAP Crystal Reports

●

BI 启动板（原来称为

InfoView）

●

Eclipse IDE 支持

●

生命周期管理控制台

●

监控

●

OpenDocument

●

BI 工作区（原来称为

Dashboard Builder）

●

平台搜索

●

平台服务

●

差异可视化工具

●

SAP BusinessObjects

Dashboards（原来称为

Xcelsius）

不赞成使用此

Web 应用程序。 它为

原先的

Crystal Reports Web 服务和

SDK 组件提供支持，包括：

●

Crystal Enterprise

●

Crystal Reports 报表应用程序

服务器（

RAS）

●

SAP BusinessObjects

Dashboards（原来称为

Xcelsius）

●

SAP BusinessObjects Analysis

OLAP 版（原来称为

Voyager）

SAP Crystal Reports JavaScript

API 支持。

Web 服务组件，包括：

●

会话

●

BI 平台

●

BI 目录

●

联合管理工具

●

Live Office

●

Web 服务查询工具（原来称为

“作为 Web 服务的查询”）

●

发布

●

报表引擎

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述 © 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

13

Web 应用程序存档文件（可能是

WAR 或

EAR）

是否自动部署？ 说明 jsfplatform

MobileOTA14

OpenSearch

AdminTools

否

是

否

否

●

SAP BusinessObjects Web

Intelligence（原来称为

Interactive

Analysis）

●

SAP BusinessObjects

Dashboards Web 服务（原来称为

Xcelsius）

Java Server Faces 支持和示例。

支持移动客户端的

Web 应用程序。

OpenSearch 支持。

查询生成器支持。

下表将先前版本的

WAR 文件和 BI 平台 4.2 中功能的所在位置进行了比较。

以前的

Web 应用程序存档文件（可以是 WAR 或

EAR）

AdminTools

AnalyticalReporting

BusinessProcessBI

CmcApp

CmcAppActions

CrystalReports

Xcelsius dswsbobje

InfoViewApp

InfoViewAppActions

LCM

OpenDocument

PerformanceManagement

PlatformServices

PMC_Help

VoyagerClient

XCTemplateUploader

BOE

BOE

BOE

BOE

BOE

BOE

BOE

新的

Web 应用程序存档文件（可以是 WAR 或

EAR）

AdminTools

BOE

BusinessProcessBI （不赞成使用）

BOE

BOE

BOE

BOE dswsbobje

BOE

BOE

3.3.1

部署支持移动应用程序的

MobileOTA14.war

BI 平台安装程序不会部署支持移动应用程序的

MobileOTA14 Web 应用程序。

14

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述

要使用移动应用程序，必须在安装进程完成之后立即手动部署

MobileOTA14 存档文件（MobileOTA14.war 或

MobileOTA14.ear）。

注意

WDeploy GUI 工具不能用于部署单个

Web 应用程序。 要部署单个 Web 应用程序，如 MobileOTA14，请使

用

WDeploy 命令行工具。

1. 在部署

MobileOTA14 Web 应用程序之前，请确保已经为您的 Web 应用程序服务器正确配置了 WDeploy 配置

文件

config.

<WEB 应用程序服务器> 。

请参阅

WDeploy 配置文件

[第 31 页]。

2. 部署

MobileOTA14 Web 应用程序。

要部署

MobileOTA14 Web 应用程序，请使用以下 WDeploy 命令： wdeploy.sh

<WEB_APPLICATION_SERVER>

-Dwar_dir=

<LOCATION_OF_MOBILEOTA14.WAR>

-DAPP=MobileOTA14

deploy

例如，以下命令将

MobileOTA14 部署到 WebSphere 7 Web 应用程序服务器： wdeploy.sh websphere7

-Dwar_dir=/sap/sap/businessobjects_xi40/mobile_14/Client

-DAPP=MobileOTA14

deploy

3. 重新启动

Web 应用程序服务器。

4. 访问以下

URL 以确保 MobileOTA14 Web 应用程序正常运行： http://

<HOSTNAME>

:

<PORT>

/MobileOTA14

将

<HOSTNAME>

替换为

Web 应用程序服务器主机名，将

<PORT>

替换为

Web 应用程序服务器端口号。

有关

Mobile 产品的更多信息，请参阅 《SAP BusinessObjects Mobile 安装和部署指南》。

3.3.2 部署支持

OpenSearch 的 OpenSearch.war

安装程序不会部署支持

OpenSearch 应用程序的 OpenSearch Web 应用程序。

要使用

OpenSearch 应用程序，必须在安装过程完成后手动部署 OpenSearch.war 存档。

注意

WDeploy GUI 工具不能用于部署单个

Web 应用程序。 要部署单个 Web 应用程序，如 OpenSearch，请使

用

WDeploy 命令行工具。

1. 确保已在

WDeploy Web 应用程序服务器配置文件中设置了 Web 应用程序服务器的详细连接信息。 该文件位

于：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/config.

<WEB 应用程序服务器>

有关

WDeploy Web 应用程序服务器配置文件的更多信息，请参阅《SAP BusinessObjects Business

Intelligence 平台

Web 应用程序部署指南》中的“配置文件”。

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述 © 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

15

2. 更新

OpenSearch Web 应用程序 config.properties 文件中的 OpenSearch 配置。 该文件位于：

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/OpenSearch/WEB-INF

确保为服务器配置了下列参数：

○ cms： CMS 主机名和 CMS 端口号。 例如，使用下列格式：

<CMS_HOSTNAME>

:

<PORT>

。

○ opendoc： OpenDocument Web 应用程序的 URL。 例如： http://

<WAS_HOSTNAME>

:

<PORT>

/BOE/OpenDocument/opendoc/openDocument.jsp。

○ proxy.rpurl： 反向代理 URL（如果贵组织使用反向代理服务器）。

○ proxy.opendoc.rpurl： OpenDoc 反向代理服务器 URL（如果贵组织使用 OpenDoc 反向代理服

务器）。

3. 部署

OpenSearch Web 应用程序。

要部署

OpenSearch Web 应用程序，请使用以下 WDeploy 命令： wdeploy.sh <WEB_APPLICATION_SERVER>

-Dapp_source_dir=<LOCATION_OF_OPENSEARCH_WEB_APP_SOURCE_TREE>

-DAPP=OpenSearch

deploy

例如，以下命令将

OpenSearch Web 应用程序部署到 WebSphere 7 Web 应用程序服务器： wdeploy.sh websphere7

-Dwar=/sap/sap_bobj/enterprise_xi40/warfiles/OpenSearch

-DAPP=OpenSearch

deploy

有关

OpenSearch 相关产品的更多信息，请参阅《SAP BusinessObjects Business Intelligence 平台管理员指南》

中的

“OpenSearch”一节。

3.4 默认上下文根

所有

Web 应用程序都可部署到 Web 应用程序服务器上的自定义上下文根。 下表列出了每个 Web 应用程序的

上下文根。

Web 应用程序

中央管理控制台（

CMC）

BI 启动板

OpenDocument

SAP Crystal Reports JavaScript API

Web 服务提供者

BI 业务流程（不赞成使用）

上下文路径

/BOE/CMC

/BOE/BI

/BOE/OpenDocument

/clientapi

/dswsbobje

/BusinessProcessBI

16

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述

3.5 自定义根上下文和上下文路径

BI 平台

Web 应用程序可以部署到 Web 应用程序服务器上的自定义位置。此位置通常叫做上下文。从 Web 浏

览器访问

Web 应用程序的 URL 中包含此位置。

根上下文是

Web 应用程序服务器上的顶层文件夹，也是 Web 应用程序所在的文件夹。BI 平台 Web 应用程序

的默认根上下文是

/BOE。例如，在一个名为 www.mycompany.com 的 Web 应用程序服务器上，用于访问服务器

上的

Web 应用程序的 URL 前缀是 http://www.mycompany.com/BOE/。

上下文路径（有时叫做虚拟路径）是根上下文中的文件夹，即

Web 应用程序所在的文件夹。例如，BI 启动板应

用程序的默认上下文路径是

/BI。在一个名为 www.mycompany.com 的 Web 应用程序服务器上，用于访问 BI 启

动板

Web 应用程序的 URL 是 http://www.mycompany.com/BOE/BI/。

用户可以根据组织的需要更改根上下文和上下文路径。下表列出了将名为

MyApp 的 Web 应用程序部署到不同

根和

Web 应用程序上下文路径的示例。 下面介绍如何自定义根和 Web 应用程序上下文路径。

3.5.1

更改根上下文

用户可以更改

BI 平台 Web 应用程序使用的根上下文（AdminTools Web 应用程序除外）。 AdminTools 必

须使用默认根上下文才能正确运行）。

默认设置是使用一个空的根上下文，这样

Web 应用程序上下文路径将直接

显示在

URL 中的服务器地址之后。

例如，空的根上下文会获得类似如下的

URL：http://localhost:8080/BOE/CMC，其中 http:// localhost:8080/ 是服务器和端口号，这里没有根上下文，BOE/CMC 是 Web 应用程序上下文路径。 将根上下

文设置为

/MY_COMPANY 会将上面所示的 URL 示例更改为 http://localhost:8080/

MY_COMPANY/BOE/CMC。

使用

WDeploy 工具时，可以在 “选项”

屏幕中设置根上下文。

使用

WDeploy 命令行工具时，在以下配置文件中

设置

BI 平台 Web 应用程序的根上下文：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/wdeploy.conf

使用文本编辑器更新

wdeploy.conf 中提供的 root_context_path 的值。

例如，默认情况下，wdeploy.conf 配置文件包含下列参数： as_lang=en work_dir= war_dir= app_source_tree= disable_CMC=false disable_InfoView=false

JCoStandalone= root_context_path= recent_app_svr=

<WEB_APP_SERVER>

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述 © 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

17

3.5.2 更改

Web 应用程序的上下文路径

用户可以更改

BI 平台 Web 应用程序的默认上下文路径（有时也称作虚拟目录）。

例如，

BOE Web 应用程序的默认上下文路径为 BOE，在示例 URL http://localhost:8080/BOE/CMC 中可

看到此路径。

在此示例中，http://localhost:8080/ 为服务器和端口号，BOE 为 Web 应用程序，/CMC 为包

括在

BOE Web 应用程序内的一个组件。

在以下配置文件中设置

BI 平台 Web 应用程序的上下文路径：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/apps/

<WEB_APP>

.properties

使用文本编辑器更新在配置文件

WEB_APP.properties 中找到的 appvdir 参数的值。

例如，默认情况下，BOE.properties 配置文件包含下列参数： warfile=BOE.war

appvdir=BOE buildfile=BOE.xml

osgisupported=true

18

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

Web 应用程序部署概述

4 使用

WDeploy 工具部署 Web 应用程序

4.1 WDeploy 概述

BI 平台提供

WDeploy 工具，可简化将 Web 应用程序部署到基于 Java 的 Web 应用程序服务器。

WDeploy 有两种不同界面：

● 基于文本的传统界面，用于处理通过命令行提供的命令和参数。

●新的基于控制台的引导式助理（类似于 BI 平台安装程序），它会提示用户输入部署参数。

虽然每个受支持的

Web 应用程序服务器需要不同的命令和 Web 应用程序包更新，但是 WDeploy 为管理员提供

统一的界面，并自动进行必要的调整，以便部署到特定的

Web 应用程序服务器。

例如，要将

Web 应用程序部署到 IBM WebSphere Web 应用程序服务器，只需一个 WDeploy 命令即可执行以

下任务：

1. 在

Web 应用程序的 web.xml 文件中创建特定于 IBM WebSphere 的设置。

2. 将

Web 应用程序内容捆绑到 Web 存档。

3. 创建包含

Web 应用程序的 EAR 文件。

4. 调用

IBM WebSphere 部署工具以部署 Web 应用程序。

4.2 WDeploy 先决条件

本节详细介绍了将

BI 平台 Web 应用程序部署到受支持的 Web 应用程序服务器的先决条件。

注意

在将

Web 应用程序部署到 WebSphere 之前，请参阅

WASX7017E： 在

WebSphere 中部署时出现异常 [第

89 页]。

有关

WDeploy GUI 先决条件的更多信息，请参阅

WDeploy GUI 工具先决条件

[第 68 页]。

4.2.1 在部署

Web 应用程序之前

安装

BI 平台之前，Web 应用程序服务器必须已安装并正在工作。 有关安装说明，请查阅 Web 应用程序服务器

文档。

除了满足计算机上所安装的其他软件所指定的要求外，

Web 应用程序服务器还至少应有

5 GB 的空闲磁盘空

间。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

19

建议将

JVM 的堆大小和最大持久大小的设置更改为

-Xms128m -Xmx2048m -XX:MaxPermSize=512m

。

例

如，如果使用

Tomcat，则修改的设置应类似于以下内容：

JAVA_OPTS="-Xms128m -Xmx2048m -XX:MaxPermSize=512m"

注意

对于

SAP NetWeaver 技术平台，确保最大堆大小至少为 4096 MB。 例如：JAVA_OPTS="-Xms128m -

Xmx4096m -XX:MaxPermSize=512m"

有关更改

Java 内存设置的信息，请查阅 JVM 文档。

在开始部署过程之前，请确保

Web 应用程序服务器已安装，并启动 Web 应用程序服务器的管理控制台，以验

证应用程序服务器是否正确运行。

4.2.2 硬件要求

使用

WDeploy 工具向 Web 应用程序服务器部署 Web 应用程序要求至少具有 4 GB RAM（SAP NetWeaver 技

术平台要求

8 GB）和 15 GB 可用磁盘空间，此外，承载 /tmp 临时文件夹的分区上应至少具有 5 GB 可用空间，用

于部署

Web 应用程序。 除此之外，还应满足主机上所安装的 Web 应用程序服务器或其他服务器或服务的任何其他

要求。

4.2.3 64 位支持

BI 平台只能在

64 位操作系统中运行，并且只支持安装有 64 位 JDK 的 64 位 Web 应用程序服务器。

4.2.4 以另一帐户部署

Web 应用程序所需的最小权限

提示

建议使用安装

Web 应用程序服务器的同一用户帐户安装 BI 平台并运行 WDeploy 工具 (wdeploy.sh)。

要使用与安装

Web 应用程序服务器不同的用户帐户部署 Web 应用程序 和 WDeploy 工具，必须确保该帐户有

访问某些

Web 应用程序服务器目录的适当权限。 在运行 WDeploy 工具之前对下表所列权限进行设置。 或者确保

这一帐户与

Web 应用程序服务器帐户属于同一组，然后只需设置用户和组两列的权限即可。

注意

除了需要有执行下表中提到的文件或文件夹的权限外，还需要有父目录的执行权限。

20

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

Tomcat 6 和

7

目录

Tomcat 用户帐

户主目录和

BI 平台

用户文件夹子目录

递归性

否

用户 rwx

Web 应用程序

部署目录

（

$as_dir/ webapps ）

否

目录

Tomcat 二进制

（

$as_dir/ bin

）

否

Tomcat 配置目

录（

$as_dir/ conf

）

是

Tomcat 库目录

（

$as_dir/ lib

）

否 rwx rwx rwx rwx

组 r-x rwx rwx rwx r-x

其他 r-x rwx rwx rwx r-x

示例命令

755 chmod

~<TOMCAT_U

SER>

777 chmod

<TC_HOME>/ webapps

777 chmod

<TC_HOME>/ bin chmod -

R 777

<TC_HOME>/ conf

755 chmod

<TC_HOME>/ lib/*

WebLogic 11gR1

目录

WebLogic 用户

帐户主目录和

BI 平

台用户文件夹子目

录

递归性

否

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

用户 rwx

组 r-x

其他 r-x

示例命令 chmod

755

<WL_USER>

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

21

目录

文件

Web 域二进制

（

$WL_HOME/

<PROJECT>/

<DOMAIN>/

<BASE>/bin

）

递归性

否

用户 rwx rwx

器库

WebLogic 服务

（

$WL_HOME/ server/lib

）

否

组 rwx r-x rwx rwx

WebLogic 服务

器二进制文件

（

$WL_HOME/ server/ domains/ base_domain common/bin ）

WebLogic 服务

器模块目录

（

$WL_HOME/ server/ domains/ base_domain modules

）

WebLogic

Java 目录

（

$WL_HOME/ jdk150_06

）

否

否

否 rwx rwx rwx rwx

其他 rwx r-x r-x r-x r-x chmod

775

<WL_SERVER

>/ user_proje cts /bin

775 chmod

<WL_SERVER

>/ modules

775 chmod

<WL_SERVER

>/ jdk150_06

示例命令

777 chmod

<WL_HOME>/ user_proje cts/ domains/ base_domai n/bin chmod

755

<WL_SERVER

>/ user_proje cts

/lib

22

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

WebSphere 7.0、8.5 和

8.5.5

目录

WebSphere 用

户帐户主目录和

BI

平台用户文件夹子

目录

递归性

否

用户 rwx rwx

WebSphere 配

置文件目录

（

$WEBS_HOME/

AppServer/ profiles

）

是 rwx

WebSphere 管

理脚本

（

$as_dir/bin

/wsadmin.sh

）

否

组 r-x rwx r-x rwx r-x

WebSphere 插

件脚本

（

$as_dir/bin

/

GenPluginCfg

.sh

）

否

WebSphere 安

全

（

$as_dir/bin

/ securityProc s.jacl

）

否 rwx r-x

其他 r-x rwx r-x r-x r-x

示例命令

755 chmod

~<WEBSPHER

E_USER> chmod -

R 777

<WEBSPHERE

_HOME>/

AppServer/ profiles

755 chmod

<WEBSPHERE

_HOME>/ bin/ wsadmin.sh

755 chmod

<WEBSPHERE

_HOME>/ bin/

GenPluginC fg.sh

755 chmod

<WEBSPHERE

_HOME>/ bin/ securityPr ocs.jacl

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

23

目录

WebSphere 安

全

（

$as_dir/bin

/

LTPA_LDAPsec urityProcs.j

acl ）

递归性

否

用户 rwx

组 r-x rwx r-x

WebSphere 插

件目录

（

$as_dir/ plugins

）

否

WebSphere

Java 目录

（

$as_dir/ java

）

否

WebSphere 部

署工具目录

（

$as_dir/ deploytool

）

否

WebSphere 属

性目录

（

$as_dir/ properties ）

否 rwx rwx rwx r-x r-x r-x

其他 r-x r-x r-x r-x r-x

示例命令

755 chmod

<WEBSPHERE

_HOME>/ bin/

LTPA_LDAPs ecurityPro cs.jacl

755 chmod

<WEBSPHERE

_HOME>/ plugins

755 chmod

<WEBSPHERE

_HOME>/ java

755 chmod

<WEBSPHERE

_HOME>/ deploytool

755 chmod

<WEBSPHERE

_HOME>/ properties

24

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

注意

必须接受

WebSphere Web 应用程序服务器 SSL 证书才能使用 WDeploy。 要接受证书，请使用 wsadmin

命令，格式为

<WEBSPHERE_HOME>/AppServer/bin/wsadmin

-conntype SOAP -port <ADMIN_PORT> -user <AS_ADMIN_USERNAME>

-password <AS_ADMIN_PASSWORD>

. 例如：

./wsadmin -conntype SOAP

-port 8880 -user administrator -password websphere

4.2.5 将

ulimit 设置为“无限制”

要成功构建并部署

BI 平台 Web 应用程序，主机操作系统或用户帐户 ulimit 设置必须配置为“无限制”。

使用

ulimit 命令设置 ulimit 配置，在 Linux 系统中，也可以修改系统配置文件 /etc/security/ limits.con。 有关 ulimit 设置的更多信息，请参阅操作系统随附的文档。

4.2.6 设置

Java 环境

主机系统上必须安装

Java 虚拟机才能使用 WDeploy。 Java Development Kit (JDK) 1.6 会由 BI 平台安装程序

自动安装，但在专用计算机上手动安装时，必须从

BI 平台服务器设置或复制。

默认情况下，使用

BI 平台安装程序安装的 JDK。 如果使用专用 Web 应用程序服务器，必须通过执行 Web 层

安装或手动安装相应

JDK（1.5 或 1.6，Web 应用程序服务器支持的版本）设置 JDK。 手动安装 JDK 时，请确保已

配置下列环境设置：

● WDeploy 首先尝试使用与 BI 平台一起安装的 JVM。 如果找不到此 JVM，则 WDeploy 将尝试使用已设置

为有效

Java 目录的

<JAVA_HOME>

环境变量设置。 如果未找到有效或适用的

JVM，WDeploy 将退出。

● 用户帐户 PATH 环境变量包含：

<JAVA_HOME>

/bin

● 要允许从任何目录运行 WDeploy，请将 PATH 环境变量更新为包含：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy

4.2.7 Web 应用程序服务器参数配置文件

使用

WDeploy 命令行界面部署 Web 应用程序之前，请确保在 WDeploy Web 应用程序部署服务器参数配置文

件中设置正确的参数。

设置的参数用作默认设置，不需要在命令行中再提供这些参数。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

25

注意

如果使用

GUI 界面，或者仅使用 wdeploy predeploy 或 wdeploy predeployall 命令进行预部署，则

无需在这些部署配置文件中设置参数。

适用于

Web 应用程序服务器的配置文件位于以下文件夹中：

<BIP 安装目录> /sap_bobj/ enterprise_xi40/wdeploy/conf。 例如，如果使用 Tomcat 7，则选择 /opt/sap/sap_bobj/ enterprise_xi40/wdeploy/conf/config.tomcat7。

使用文本编辑器更新特定于贵组织中

Web 应用程序服务器的值。 有关如何配置 WDeploy 配置文件的更多信

息，请参阅

WDeploy 配置文件

[第 31 页]。

从命令行调用

WDeploy 时，可以覆盖在 WDeploy Web 应用程序服务器参数配置文件中设置的参数，同时使用

切换和参数更改默认行为。

但是，强烈建议在适用于部署的 config.

<WEB_APP_SERVER>

配置文件中配置参

数。

4.2.8 在远程

Web 应用程序服务器上安装 WDeploy

要将

Web 应用程序部署到专用 Web 应用程序服务器，请使用 BI 平台安装程序执行 “Web 层”

或

“定制/扩展”

安

装。

如果要手动复制

WDeploy 工具，请将下列文件夹复制到 Web 应用程序服务器：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy

注意

手动复制

WDeploy 工具时，确保在 Web 应用程序服务器上适当配置了环境变量 JAVA_HOME。

4.3 SAP 系统架构目录（SLD）注册

贵组织可以使用

SAP 系统架构目录（SLD）数据提供者（DS）维护所用 SAP 软件的中央信息资源库。 该资源

库为管理员提供有关系统拓扑和软件组件的详细信息。

有关为

SLD 设置 BI 平台的更多信息，请参阅《SAP

BusinessObjects Business Intelligence 平台管理员指南》中的

““在系统架构中注册 BI 平台””和 SAP Note

1653689。

SLD 注册可以在部署或取消部署

Web 应用程序时向 SLD 发出通知，使 SLD 数据库与有关您组织 Web 应用程

序部署的最新信息保持同步。

可以使用

SLD 在以下 Web 应用程序服务器上注册 Web 应用程序组件：

● SAP Netweaver 技术平台

● Apache Tomcat 6.0 和 7.0

● IBM WebSphere 7.0

26

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

4.3.1 启用

SAP NetWeaver 技术平台的 SLD 注册

SAP 系统架构目录数据提供者（SLD-DS）集成可用于

SAP NetWeaver 技术平台。 有关 SLD-DS 集成和 SAP

Netweaver 技术平台的信息，请参阅

“系统架构目录”SCN 文档，地址为：

http://scn.sap.com/docs/DOC-8042

。

4.3.2 为

Tomcat 启用 SLD 注册

要将

SAP 系统架构目录数据提供者（SLD-DS）用于 Apache Tomcat，必须在每个 Apache Tomcat Web 应用程

序服务器上安装

SLDREG 注册工具。

注意

SLDREG 不是作为

BI 平台的一部分进行安装的。 有关 SLDREG 的安装信息，请参阅 SAP 注释 1018839。

要配置

SLDREG 以便从 Apache Tomcat Web 应用程序服务器部署或取消部署 Web 应用程序时更新 SLD，请

参阅

SAP 注释 1508421。

注意

在

Web 层

安装过程中安装了

“Java Web 应用程序”

功能之后，也可以在

<BIP 安装目录> /sap_bobj/ enterprise_xi40/warfiles/webapps 文件夹中找到所需的附加在 SAP Note 1508421 中的 sap.com~TomcatSLDDataSupplierWEB.war 文件。

4.3.3 启用

WebSphere 的 SLD 注册

要将

SAP 系统架构目录数据提供者（SLD-DS）用于 WebSphere，必须在每个 WebSphere Web 应用程序服务器

上安装

SLDREG 注册工具。

注意

SLDREG 不是作为

BI 平台的一部分进行安装的。 有关 SLDREG 的安装信息，请参阅 SAP 注释 1018839。

要配置

SLDREG 以便从 WebSphere 应用程序服务器部署或取消部署 Web 应用程序时 SLD 都相应更新，请参

阅

SAP 注释 1482727。

4.4 部署模式

WDeploy 支持两种不同的部署模式：

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

27

1. 独立模式（Web 应用程序服务器）

Web 应用程序服务器提供静态内容（HTML 页面、图像、文档、JavaScript、级联样式表）和动态内容（Java

服务器页面、

JAR 文件、XML 文件）。

2. 分离

Web 层模式（Web 应用程序服务器加专用 Web 服务器）

专用

Web 服务器接收来自 Web 浏览器的请求，并提供所有静态内容（HTML 页面、图像、文档、

JavaScript、级联样式表）。对动态内容（Java 服务器页面、JAR 文件、XML 文件）的请求则转发到专用应

用程序服务器，并在形成内容后返回给

Web 浏览器。

此模式适用于对可伸缩性和性能要求较高的大型生产部署。

也可以使用

WDeploy 将 Web 应用程序部署到与 BI 平台安装在同一系统上的 Web 应用程序服务器。此配置可

用于小型开发或测试系统。对于生产系统，不建议使用此配置。

4.4.1 独立部署

独立模式是指

Web 应用程序服务器同时向 Web 客户端提供静态和动态内容。Web 应用程序服务器可在装有 BI

平台的主机上运行，也可在由网络连接的另一台计算机上运行。

下图中，

Web 客户端通过防火墙连接到

Web 应用程序服务器 [1]。该服务器同时提供静态内容和动态内容。

Web 应用程序服务器的处理请求将发送到

BI 平台中央管理服务器（CMS）[2]。

上图中，

WDeploy 以

CMS [2] 组件形式安装，而 Web 应用程序分为静态和动态内容目录。现在，动态内容可

以复制到

Web 应用程序服务器 [1]。

WDeploy 工具也可以安装或复制到专用

Web 应用程序服务器 [1]，以便轻松部署来自 CMS [2] 的分离内容。

此模式最适用于用户数有限的小型部署。独立部署的优势在于便于部署和维护。不过，由于

Web 应用程序服务

器同时传送静态和动态内容，此模式不能扩展到适合较大用户数。

4.4.2 分离

Web 层部署

Web 层部署会隔开静态和动态

Web 应用程序内容，这样，静态内容由 Web 服务器进行处理，动态内容由 Web

应用程序服务器进行处理。

Web 和 Web 应用程序服务器可在同一台计算机上运行，也可在连接到网络的不同计算

机上运行。

注意

如果在分离

Web 层模式下部署下列 Web 应用程序，则无性能改进。 WDeploy 会将这些 Web 应用程序作为

独立

Web 应用程序处理，即便是在分离层模式下：

28

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

● Web 服务

● MobileOTA14

● MOBIServer

● OpenSearch

● jsfplatform

下图中，

Web 客户端通过防火墙连接到

Web 服务器 [1]。该服务器仅提供静态内容（HTML 页面、图像、文

档、

JavaScript、级联样式表）。 当需要动态内容时，Web 服务器会向

Web 应用程序服务器 [2] 发送请求。 如果

有任何请求需要

BI 平台作进一步处理，则发送至中央管理服务器（CMS）进行处理 [3]。

上图中，

WDeploy 以

CMS [3] 组件形式安装，而 Web 应用程序分为静态和动态内容目录。 现在，动态内容可

以复制到

Web 应用程序服务器 [2]，静态内容可以复制到 Web 服务器 [1]。

WDeploy 命令也可以安装在专用

Web 服务器 [1] 和 Web 应用程序服务器 [2] 上，以便轻松地部署来自 CMS

[3] 的分离内容。

如果组织实施的安全措施限制了对服务器计算机的访问，分离的静态和动态内容可以分别发送到有权部署内容

的用户。

分离部署最适用于用户数量较多或不断增加的大中型部署。

分离部署的优势在于它具有可伸缩性并且可提供良

好的性能。

注意

Web、Web 应用程序和

BI 平台服务器可配置成群集，以实现更高的可伸缩性、可用性和性能。

4.4.2.1 受支持的专用

Web 服务器和 Web 应用程序服务器组合

对于分离部署模式，

WDeploy 支持以下

Web 服务器和 Web 应用程序服务器配置：

● Apache 2.2 Web 服务器和 Tomcat 6 或 7

● Apache 2.2 Web 服务器和 WebLogic 10.3.x

● IBM IHS Web 服务器 7 和 WebSphere 7.0

● IBM IHS Web 服务器 8.5 和 WebSphere 8.5 或 8.5.5

注意

在

WDeploy 配置文件中，Apache 和 IBM IHS Web 服务器均被指定为 apache。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

29

4.4.2.2 在远程计算机上部署

Web 应用程序

使用以下过程将

Web 应用程序部署到远程计算机上。 在此过程中，计算机 1 指承载 BI 平台安装的计算机，计

算机

2 指当前已安装 Web 应用程序服务器的远程计算机。

1. 在计算机

2 中创建以下目录。

○

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy。 此文件夹包含 WDeploy 脚本和配置文

件。

○

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps

○

<BIP 安装目录> /InstallData

这些目录反映了在计算机

1 上安装的默认目录结构。

提示

虽然可以定制文件夹结构以满足特定的要求，但建议在计算机

2 中将文件保留在与计算机 1 相同的文件夹结

构或层次结构中。

2. 将以下文件从计算机

1 复制到计算机 2。

○ 文件夹

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy。

提示

复制文件之前，如果 <BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir 文件夹

中有内容，请将其删除。

○ 文件夹

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps。

○

<BIP 安装目录> /InstallData/setup.engine 文件夹。

3. 将 JAVA_HOME 环境变量设置为 JDK 1.5 或 1.6 目录。

4. 修改

Web 应用程序服务器的 WDeploy 配置文件。 提供所有必需的信息，以便通过 WDeploy 部署 Web 应用

程序。

例如，要修改

WebLogic 11 的配置文件，则将该文件修改为： as_domain_dir=C:\Oracle\Middleware\user_projects\domains\base_domain as_instance=AdminServer as_admin_port=7001 as_admin_username=weblogic as_admin_password=weblogic

配置文件位于以下目录中：

<BOE 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/config.

<WEB_APP_SERVER>

5. 在计算机

2 中从 WDeploy 脚本的位置运行此脚本，方法是打开命令行控制台，然后输入以下命令：

<BIP_INSTALL_DIR>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

<WEB_APP_SERVER>

-Dapp_source_tree=“

<BIP_INSTALL_DIR>

/sap_bobj/enterprise_xi40/warfiles/ webapps”

deployall

30

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

注意

○ 可以在 WDeploy 配置文件

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/wdeploy.conf 中设置

WDeploy 参数默认值，而无需在命令行指定参数。 例如，设置以下参数：

○ app_source_tree 或 war_dir

○ work_dir

○ root_context_path

有关更多信息，请参阅

WDeploy 配置文件

[第 32 页]。

○ 传递参数 -Dwar_dir，指定部署通用 WAR 文件的输入位置。 例如，要部署通用 BOE.war 文件：

<BIP_INSTALL_DIR>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

<WEB_APP_SERVER>

-Dwar_dir="/myGenericWarFiles/BOE.war"

-DAPP=BOE

deploy

○ 要为所有 BI 平台应用程序创建通用 WAR 文件，请运行以下命令：

<BIP_INSTALL_DIR>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

buildwarall

-Dapp_source_tree=“

<BIP_INSTALL_DIR>

/sap_bobj/enterprise_xi40/ warfiles/webapps”

-Dwar_dir=“/myGenericWarFiles”

○ 传递参数 -Dwar_dir=

<TARGET_LOCATION_OF_GENERIC_WAR_FILE>

，指定通用

WAR 文件的

输出位置。

4.5 WDeploy 配置文件

WDeploy 配置文件包含以键值对文本格式保存的设置。

WDeploy 启动时会读取配置文件中保存的选项和参数

并将其用作默认设置，因此无需在命令行上指定这些选项和参数。

但仍可在命令行上指定所有选项和参数，这样将

覆盖配置文件中的设置。

在命令行上指定的选项和参数不会更改配置文件中存储的选项。

注意

建议不要将

Web 应用程序服务器管理员帐户密码存储在 WDeploy 配置文件中，而是在命令行中通过 -

Das_admin_password=

<PASSWORD>

参数传递给

WDeploy。

WDeploy 使用三种类型的配置文件：

● WDeploy 配置文件（

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/ wdeploy.conf）： 存储适用于所有 Web 应用程序服务器的常规 WDeploy 设置。

● Web 应用程序服务器配置文件（

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/ config.

<WEB_APP_SERVER>

）：

存储特定

Web 应用程序服务器的设置。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

31

● Web 应用程序配置文件（

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/apps/

<WEB_APP>

.properties）： 存储各 Web 应用程序的单独部署设置。

4.5.1

WDeploy 配置文件

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/wdeploy.conf 配置文件存储的设置很

可能由部署中所有

Web 应用程序服务器共享。

在命令行中使用

-D

<PROPERTY>

开关参数可以覆盖存储在

WDeploy 配置文件中的属性。 但是，强烈建议在部

署的相应

config.

<WEB_APP_SERVER>

配置文件中配置参数。

有关

WDeploy 属性的完整列表，请参阅

WDeploy 属性参数

[第 38 页]。

4.5.2 Web 应用程序服务器配置文件

由于每个

Web 服务器和 Web 应用程序服务器需要不同的 WDeploy 设置，WDeploy 工具会为每个受支持的服

务器推荐一个配置文件。

配置文件存储在

WDeploy conf 文件夹中，如下所示：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/config.

<WEB 应用程序服务器>

将

<WEB_APP_SERVER>

替换为部署

WDeploy 工具的 Web 应用程序服务器的名称。

下面列出了当前支持的

Web 应用程序服务器的所有配置文件：

● config.jboss7 (JBoss 7.1)

● config.sapappsvr73 (SAP NetWeaver 技术平台)

● config.tomcat6 (Tomcat 6.0)

● config.tomcat7 (Tomcat 7.0)

● config.weblogic11 (WebLogic 10.3.x (11gR1))

● config.websphere7 (WebSphere 7.0)

● config.websphere8 (WebSphere 8.5 或 8.5.5)

以下各节列出了每个受支持的

Web 和 Web 应用程序服务器的可用配置选项。

4.5.2.1

JBoss 7.1 配置文件

在

config.jboss7（JBoss 7.1）中设置以下参数的默认值，以避免每次都要在命令行中提供参数值。

表

3： JBoss 7.1 的必需 WDeploy 参数

参数名称 说明 as_dir

JBoss Web 应用程序服务器的安

装位置（

<JBOSS_HOME>

）。

示例

/opt/jbossas-7.1.1.Final

32

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

参数名称 as_instance

说明

JBoss 应用程序服务器实例的名

称。

示例

default

4.5.2.2 Tomcat 6 或

7 配置文件

在

config.tomcat6 或 config.tomcat7 中设置以下参数的默认值，以避免每次都要在命令行中提供参数

值。

部署到分离环境时，此环境中

Tomcat Web 应用程序服务器与专用 Apache Web 服务器一起使用，请参见

部署

到单独的

Apache Web 和 Tomcat Web 应用程序服务器

[第 59 页]。

表

4： Tomcat 6 或 7 必需的 WDeploy 参数

参数名称 说明 as_instance as_service_name

应用程序服务器实例名称。 as_dir

Tomcat 服务的名称，此时

应用程序服务器作为

Windows

服务安装（仅限

Microsoft

Windows 上的安装）。

Tomcat 6 或

7 的安装位

置。 as_service_key as_service_key_value

示例

localhost

Tomcat6

或

Tomcat7

/opt/tomcat

Tomcat 使用的注册表项，

用于提供

Java 参数（仅限

Microsoft Windows 上的安

装）。

Tomcat 的

Java 参数：注册

表项

as_server_key 的值。

HKLM\SOFTWARE\Wow6432Node

\Apache Software Foundation

\Procrun 2.0\$<AS 服务名称>

\Parameters\Java

Options.

4.5.2.3 WebLogic 11gR1 配置文件

在

config.weblogic11 中设置以下参数的默认值，以避免每次都要在命令行中提供参数值。

表

5： WebLogic 11gR1 必需的 WDeploy 参数

参数名称 说明 as_admin_port

WebLogic 管理请求端口。 as_admin_username

WebLogic 管理帐户用户名。 as_admin_password

WebLogic 管理帐户密码。

示例

7001 weblogic password

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

33

参数名称 as_instance as_domain_dir

说明

WebLogic 应用程序服务器实例

名称。

WebLogic 域目录。

示例

AdminServer

/opt/bea/weblogic/ user_projects/domains/ base_domain

4.5.2.4 WebSphere 7、8.5 或

8.5.5 配置文件

在

config.websphere7 或 config.websphere8 中设置以下参数的默认值，避免每次都要在命令行中提供

参数值。

表

6： WebSphere 7、8.5 或 8.5.5 必需的 WDeploy 参数

参数名称 说明 as_soap_port

SOAP 应用程序服务器管理使用的

端口号。

如果未设置，则使用默认的

SOAP 端口号。 as_instance

WebSphere 应用程序服务器实例

的名称。 as_admin_password as_admin_username

WebSphere 管理帐户密码。

WebSphere 管理帐户用户名。 as_profile_name

为

Websphere 应用程序服务器创

建的配置文件名称。

当使用非默认配

置文件进行部署时，提供此参数。 as_virtual_host as_admin_is_secure

应用程序必须绑定到的虚拟主机。

通知

WDeploy 已启用 WebSphere

安全设置。

示例值

8880 server1 password administrator

AppSrv01 default_host false

注意

当

as_admin_is_secure 为

“true”时，必须设置 as_admin_username 和 as_admin_password 的值。 as_dir ws_instance

WebSphere 的安装位置。

部署到分离环境的

Web 服务器实

例（专用

Web 服务器）。

/opt/IBM/

WebSphere/

AppServer webserver1

34

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

参数名称 enforce_file_limit as_plugin_cfg_dir

说明

通知

WDeploy，Web 应用程序服

务器在加载包含超过

65,535 个文件的

应用程序时是否会遇到问题（默认为

false

）。

示例值

“假”

WebSphere plugin-cfg.xml 文

件的位置。

仅分离

Web 层部署需要此

参数。

/opt/

AppServers/IBM/

WebSphere7/profiles/

AppSrv01/config/ cells/

<单元格名称>

/ nodes/

<web 服务器节

点>

/servers/

<web 服

务器名称>

4.5.2.5 分离部署中的专用

Web 服务器

当在分离部署中将

Web 应用程序部署到专用的 Web 服务器时，使用以下受支持 Web 服务器的名称：

● config.apache（Apache Web 服务器或 IBM IHS）

注意

建议不要将

Web 应用程序服务器管理员帐户密码存储在 WDeploy 配置文件中，而是在命令行中通过 -

Das_admin_password=

<PASSWORD>

参数传递给

WDeploy。

分离部署使用专用的

Web 应用程序服务器提供动态内容，并使用专用 Web 服务器提供静态内容。 下表列出了

可为

BI 平台的分离部署配置的 Web 应用程序服务器。

应用程序服务器

JBoss 7.1

SAP NetWeaver 技术平台

Tomcat 6.0

Tomcat 7.0

WebLogic 11gR1

WebSphere 7

WebSphere 8.5 和

8.5.5

Apache Web 服务器

否

不适用

是

是

是

是（

IHS 7）

是（

IHS 8.5）

4.5.2.5.1

Apache 或

IBM IHS（分离部署）配置文件

在

config.apache 中设置以下参数的默认值，以避免每次都要在命令行中提供参数值。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

35

注意

Apache 2.2 或

IBM IHS 使用同一配置文件（config.apache）。

表

7： Apache 2.2 或 IBM IHS（分离部署）必需的 WDeploy 参数

参数名称 说明 connector_type

用于配置分离模式的

Apache 连

接器类型 deployment_dir

WDeploy 为 Web 服务器提供的

静态内容创建子目录时所在的目录。

WDeploy 在

Web 服务器上创建虚拟

目录，并将子目录映射到

URL plugin_install_dir

WebSphere 应用程序服务器的

根插件安装目录。 ws_dir

Apache Web 服务器安装目录。

示例

tomcat6

/opt/apache2/htdocs

${ws_dir}/Plugins

/opt/apache2

注意

IBM IHS 与

WebSphere 7、8.5 或 8.5.5 Web 应用程序服务器一同使用时，请确保已在 config.websphere7 或 config.websphere8 中正确配置 as_plugin_cfg_dir。

4.5.3 Web 应用程序配置属性文件

每个

Web 应用程序均可部署到 Web 应用程序服务器上的不同位置，并且可以使用不同的封装选项进行配置。

所有可部署的

Web 应用程序均在配置文件

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/ conf/app/

<WEB_APP>

.properties 中配置。

<WEB_APP>

.properties 配置文件中提供以下设置：

变量 warfile appvdir

说明

要为此

Web 应用程序创建

的

WAR 文件的名称。

Web 应用程序将部署到的上

下文路径（也称为虚拟目录）

的名称。 buildfile

用于构建

Web 应用程序的

Ant 构建文件。 ree deploy_as_a_filet

当为

true 时，切换为启用分

离

WAR 文件的部署。

示例 dswsbobje.war

dswsbobje dswsbobje.xml

true

36

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

变量 classloader_packa ge_filtering

说明 classloading_mode

用于确定类加载程序顺序的

设置。

用于类加载程序的过滤器。

示例

PARENT_LAST com.ctc.wstx.*、javax.xml.*、 org.apache.*

将某个

Web 应用程序部署到 Web 应用程序服务器上的特定位置时，请使用 appvdir 变量设置该 Web 应用程

序在服务器根上下文中的位置。

例如，如果

Web 应用程序服务器的根上下文为 http:// www.mycompany.com/BOE，则将 appvdir 设置为 mywebapp/ 后，可以从 http:// www.mycompany.com/BOE/mywebapp/ 访问该 Web 应用程序。

4.6 使用

WDeploy 命令行工具

在使用

WDeploy 命令行工具之前，请确保已经为 Web 应用程序服务器适当配置了 WDeploy 配置文件。 请参

阅

WDeploy 配置文件

[第 31 页]。

有关

WDeploy 先决条件的信息，请参阅：

●

WDeploy 先决条件

[第 19 页]

●

WDeploy GUI 工具先决条件

[第 68 页]

作为

BI 平台的一部分安装 WDeploy 命令行工具：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

有两种类型的命令：

● 常规命令

用于提供关于工具本身和可用

Web 应用程序服务器部署的高级信息。 它们不与服务器名称、属性或操作一起

使用。

例如：

○ wdeploy.sh help

○ wdeploy.sh listappservers

● 部署命令

用于将特定

Web 应用程序部署到特定 Web 应用程序服务器。 这些命令总是遵循如下格式： 服务器、属性、

操作。

例如： wdeploy.sh

<WEB_APP_SERVER>

[-D

<PROPERTY>

=

<value>

]

<ACTION>

其中：

○

<WEB_APP_SERVER>

是

Web 服务器或 Web 应用程序服务器的名称，必须与 WDeploy 配置文件

<BIP 安

装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/config.

<WEB_APP_SERVER>

的名称匹

配。

例如，对于

SAP NetWeaver 技术平台，配置文件名为

<BIP 安装目录> /sap_bobj/ enterprise_xi40/wdeploy/conf/config.sapappsvr73，因此为

<WEB_APP_SERVER>

参数提供

的名称为

sapappsvr73。

○ -D

<PROPERTY>

=

<value>

至少为一对键值对。 命令行上给定的参数将覆盖配置文件中的参数。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

37

例如，要部署

BOE Web 应用程序，请使用 -DAPP=BOE。 这会覆盖存储在 Web 应用程序服务器配置文件 config.

<WEB_APP_SERVER>

中的 -DAPP= 的任意值。

○

<ACTION>

是要执行的操作的名称。

例如，deployall 操作会将所有 Web 应用程序部署到第一个参数中指定为

<WEB_APP_SERVER>

的

Web

应用程序服务器。

4.6.1 语法

4.6.1.1

WDeploy 服务器名称

WDeploy 在命令行上使用服务器名称，并将其作为服务器配置文件的部分文件名。 当运行

WDeploy 工具时，

服务器名称是在命令行上给出的第一个参数： wdeploy.sh

<WEB_APP_SERVER>

[-D

<PROPERTY>

=

<value>

]

<ACTION>

<WEB_APP_SERVER>

是

Web 服务器或 Web 应用程序服务器的名称。 给定的名称必须与

<BIP 安装目录> / sap_bobj/enterprise_xi40/wdeploy/conf 中的配置文件的名称匹配。

有关

<WEB_APP_SERVER>

的有效名称完整列表，请参见

WEB_APP_SERVER 的值

[第 46 页]。

4.6.1.2

WDeploy 属性参数

可在命令行中使用

-D

<PROPERTY>

切换参数设置

WDeploy 属性。 为要设置的每个属性重复 -D

<PROPERTY>

切换参数。

例如，下列命令多次调用

-D

<PROPERTY>

切换参数来设置

Tomcat 6 Web 应用程序服务器的多个属性

（as_dir、as_instance、as_service_name 和 APP）： wdeploy.sh Tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

deployonly

也可在

wdeploy.config 配置文件中配置属性。 这允许在默认情况下设置属性，并在需要时从命令行进行覆

盖。

有关 wdeploy.conf 配置文件的更多信息，请参阅

WDeploy 配置文件

[第 32 页]。

下表列出了

WDeploy 的所有属性。

38

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

表

8： WDeploy 的属性

属性

APP

说明

要部署的

Web 应用程序的名称，包含在 WAR 或

EAR 文件名以及

Web 应用程序属性文件中： app_source_dir app_source_tree e as_admin_is_secur

适用于在

Web 应用程序部署期间使用 SSL 加密的

Web 应用程序服务器，例如

WebSphere。

示例值

BOE

<BIP 安装目录> /sap_bobj/enterprise_xi40/ wdeploy/conf/apps/

<WEB_APP>

.properties

处理单个

Web 应用程序时将使用此属性，例如使用 wdeploy predeploy、wdeploy deploy 或 wdeploy deployonly 命令时。

单个

Web 应用程序源文件的位置。

处理单个

Web 应用程序时将使用此属性，例如使用 wdeploy predeploy、wdeploy deploy 或 wdeploy deployonly 命令时。

<BIP 安装目录> / sap_bobj/ enterprise_xi40/ warfiles/webapps/

<WEB_APP>

所有可用

Web 应用程序的源文件的位置

（app_source_dir 的父文件夹）。

同时处理所有可用的

Web 应用程序时将使用此属

性，例如使用

wdeploy predeployall、wdeploy deployall 或 wdeploy deployonlyall 命令时。

<BIP 安装目录> sap_bobj/

/ enterprise_xi40/ warfiles/webapps false（默认值） true

注意

将此值设置为

true 还需要提供管理员帐户名和密

码。 as_admin_password

Web 应用程序服务器管理帐户密码。 password as_admin_port

Web 应用程序服务器管理访问使用的端口号。

8080 as_admin_username as_dir as_domain_dir as_instance

Web 应用程序服务器管理帐户用户名。 administrator

Web 应用程序服务器的安装目录。

对于所有应用程序服务器是必需的。

Web 应用程序服务器实例的名称。

/opt/tomcat6

Web 应用程序服务器的安装目录。

对于

WebLogic 应用程序服务器，as_domain_dir

是域根目录。

/opt/bea/ weblogic localhost

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

39

属性 as_lang

说明

WDeploy 用户界面的首选语言。

示例值

● 捷克语：CS

● 丹麦语：DA

● 荷兰语：NL

● 英语：EN

● 芬兰语：FI

● 法语：FR

● 德语：DE

● 匈牙利语：HU

● 意大利语：IT

● 日语：JA

● 韩语：KO

● 挪威语（伯克梅

尔）：NB

● 波兰语：PL

● 葡萄牙语：PT

● 罗马尼亚语：RO

● 俄语：RU

● 简体中文：zh_CN

● 斯洛伐克语：SK

● 西班牙语：ES

● 瑞典语：SV

● 泰语：TH

● 繁体中文：zh_TW

● 土耳其语：TR as_mode Web 应用程序部署的类型。

独立部署是指

Web 应用程序服务器同时提供静态和

动态

Web 内容。 分离部署使用专用的 Web 服务器提供

静态内容，而使用

Web 应用程序服务器提供动态内容。 standalone split as_service_key

适用于运行在

Windows 上的 Tomcat。

安装为服务时，存储

JVM 启动参数的 Windows 注册

表项的名称。

HKLM\SOFTWARE

\Apache Software

Foundation\Procrun

2.0\ <AS 服务名称>

\Parameters\Java lue as_service_key_va

适用于在

Windows 上运行的 Tomcat。

安装为服务时，存储

JVM 启动参数的 Windows 注册

表项的值。 as_service_name

适用于在

Windows 上运行的 Tomcat。

Tomcat 服务的名称。

Tomcat6

40

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

属性 as_sid as_soap_port as_virtual_host

说明

目标实例的系统

ID。

WebSphere 的必备项。

SOAP 应用程序服务器管理

使用的端口号。

如果未设置，则使用默认的

SOAP 端口

号。

仅适用于

WebSphere。 connector_type

应用程序必须绑定到的虚拟主机。

适用于运行在分离模式下的

Web 服务器，例如

Apache。

将

connector_type 设置为供 Web 服务器使用的

专用

Web 应用程序服务器的名称。 ree deploy_as_a_filet

适用于

WebLogic Web 应用程序服务器。

指明是否必须按文件树（扩展格式）或打包的

WAR

或

EAR 文件的形式部署应用程序。 deployment_dir

WDeploy 在此目录下创建静态内容子目录，其内容

由专用

Web 服务器提供。

WDeploy 在

Web 服务器上创建虚拟目录，并将子目

录映射到

URL。 disable_CmcApp

设置为

true 时，禁用 CMC Web 应用程序。

示例值

AS1

8880 default_host tomcat6 false（默认值） true

/opt/apache2 disable_InfoView

设置为

true 时，禁用 BI 启动板 Web 应用程序。 false true false true false（默认值） true t enforce_file_limi

通知

WDeploy Web 应用程序包含的文件数目是否超

过

65,535 个。

默认设置为

false，但 WebSphere 除外。

JCoStandalone recent_app_svr

当

BI 平台与 SAP BW 系统相集成时使用。

部署到

SAP NetWeaver Web 应用程序服务器时设置

为

false。

部署到任何其他应用程序服务器时设置为

true。

最近一次将

Web 应用程序部署到的 Web 应用程序服

务器。 root_context_path

所有

Web 应用程序部署到的 Web 应用程序根上下文

路径。

要将某个

Web 应用程序部署到根上下文内的某

个文件夹中，请查看该

Web 应用程序 .properties 配

置文件中的

appvdir 设置。 false true

Tomcat6

/BOE

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

41

属性 work_dir ws_dir ws_instance ws_type war_dir

说明 示例值

WDeploy 在其中操纵

Web 应用程序 WAR 或 EAR 存

档文件的文件夹（例如，在

Web 应用程序中分离静态和

动态内容）。

此文件夹存储 wdeploy predeploy 操

作的结果，并存储取消部署

Web 应用程序所需的数据。

<BIP 安装目录> / sap_bobj/ enterprise_xi40/ wdeploy/workdir

适用于在分离模式下运行的

Web 服务器，例如

Apache。

Web 服务器主目录。

仅适用于

WebSphere。

以分离模式在其中安装了应用程序的

Web 服务器的

名称。

/opt/apache2 webserver1 apache

适用于在分离模式下运行的

Web 服务器，例如

Apache。

Web 服务器的名称，包含在

<BIP 安装目录> / sap_bobj/enterprise_xi40/wdeploy/conf/ config.

<WEB_SERVER>

文件中。

注意

Apache 和

IBM HTTP 服务器的 apache 均为 ws_type。

要部署

WAR 或 EAR 存档的位置，或要创建通用

WAR 文件的目标输出位置。

/ myGenericWarFiles

4.6.1.2.1

分离

Web 层部署的必需属性参数

分离

Web 层部署（分隔 Web 和 Web 应用程序服务器）需要配置一些属性。 部署到分离 Web 层部署时，确保

在命令行指定了下列属性参数，或在

Web 或 Web 应用程序服务器配置文件（config.

<WEB_APP_SERVER>

）中

配置了下列属性参数。

● 设置 -Das_mode=split 属性，分离 Web 服务器的静态内容和 Web 应用程序服务器的动态内容。

● 将 -Dconnector_type=

<CONNECTOR_TYPE>

属性设置为相应的连接器类型。 将 connector_type 设

置为供

Web 服务器使用的专用 Web 应用程序服务器的名称。 例如，使用 Apache Web 服务器和 Tomcat 6

Web 应用程序服务器时，应将 connector_type 设置为 tomcat6。

● 完成 Web 服务器与 Web 应用程序服务器运行于同一主机上的部署后，必须指定 -

Dws_type=

<WEB_SERVER_TYPE>

和 -Dws_dir=

<WEB_SERVER_DIR>

属性。

42

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

4.6.1.3 WDeploy 操作

WDeploy 命令的最后一个参数是要执行的操作。 下节定义了每个有效的操作以及具体内容。

表

9： WDeploy 操作

操作 predeploy

说明

使用

wdeploy predeploy 命令，可以准备要部署到目标 Web 应用程序服务器的

Web 应用程序。

此命令将更新

Web 应用程序的 web.xml 配置文件，并进行其他所需更改，以便

Web 应用程序能够部署到

Web 应用程序服务器。

在配置完成后，

Web 应用程序被打包成

WAR 或 EAR 文件，并保存到

<BIP 安装

目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/

<WEB_APP_SERVER>

。

可以通过

Web 应用程序服务器的管理控制台或使用 wdeploy deploy 命令手动

部署此文件。

使用

wdeploy predeploy 命令准备 BOE Web 应用程序，以便将其部署到特定

的

Web 应用程序服务器。 例如： wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

predeploy predeployall

使用

wdeploy predeployall 命令对位于 BI 平台 Web 应用程序源目录中的所

有

Web 应用程序执行 wdeploy predeploy 命令：

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps

使用

wdeploy predeployall 对所有 Web 应用程序应用 wdeploy predeploy 命令。 例如： wdeploy.sh

<WEB_APP_SERVER>

predeployall

注意

预部署不要求访问

Web 应用程序服务器，但 WebSphere 例外。 部署到

WebSphere 时，default_virtual_host 参数是必需的。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

43

操作 deploy deployall deployonly deployonlyall

说明 wdeploy deploy 命令是 wdeploy predeploy 和 wdeploy deployonly 命

令的拼接，单独使用此命令即可准备

Web 应用程序并将其部署到目标 Web 应用程序

服务器。

使用

wdeploy deploy 准备 BOE Web 应用程序并将其部署到目标 Web 应用程序

服务器。 wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

deploy

使用

wdeploy deployall 命令对 BI 平台 Web 应用程序源目录中的所有 Web 应

用程序执行

wdeploy deploy 命令：

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps

使用

wdeploy deployall 对所有 Web 应用程序应用 wdeploy deploy 命令。

例如： wdeploy.sh

<WEB_APP_SERVER>

deployall

使用

wdeploy deployonly 命令，将准备好的 Web 应用程序部署到目标 Web

应用程序服务器。

通过调用

Web 应用程序服务器的命令行界面，使用 wdeploy deployonly 命令

可将位于 <BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/

<WEB_APP_SERVER>

中的

WAR 或 EAR 可部署文件部署到 Web 应用程序服务器。

如果

Web 应用程序尚未准备好进行部署，则会自动调用 wdeploy predeploy 命

令。

使用

wdeploy deployonly 将准备好的 BOE Web 应用程序部署到 Web 应用程

序服务器。

例如： wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

deployonly

使用

wdeploy deployonlyall 命令对所有准备好的 Web 应用程序执行 wdeploy deployonly 命令。

使用

wdeploy deployonlyall 命令对所有准备好的 Web 应用程序应用 wdeploy deployonly 命令。 例如： wdeploy.sh

<WEB_APP_SERVER>

deployonlyall

44

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

操作 buildwarall

说明

从

Web 应用程序源树构建通用 WAR 文件。 例如： wdeploy.sh buildwarall

-Dapp_source_tree=

<LOCATION_OF_APP_SOURCE_TREE>

-Dwar_dir=

<TARGET_LOCATION_OF_GENERIC_WAR_FILE>

listapps listdeployedapps

列出当前部署到

Web 应用程序服务器的所有 Web 应用程序。 此操作只能在 Web

服务器或

Web 应用程序服务器系统上运行。 例如： wdeploy.sh

<WEB_APP_SERVER>

listdeployedapps undeploy

使用

wdeploy undeploy 命令调用目标 Web 应用程序服务器的命令行界面，以

便从服务器中删除已部署的

BI 平台 Web 应用程序。

使用

wdeploy undeploy 命令取消 BOE Web 应用程序在目标 Web 应用程序服

务器上的部署。 wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

undeploy undeployall

使用

wdeploy undeployall 命令对部署到目标 Web 应用程序服务器的所有 BI

平台

Web 应用程序执行 wdeploy undeploy 命令。 例如： wdeploy.sh

<WEB_APP_SERVER>

undeployall validateconfig

列出可部署到

Web 应用程序服务器的 Web 应用程序。 例如： wdeploy.sh

<WEB_APP_SERVER>

listapps

验证受支持的

Web 应用程序服务器的 WDeploy 配置，以确保部署成功。 例如： wdeploy.sh

<WEB_APP_SERVER>

validateconfig

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称。

4.6.1.4 WDeploy 常规命令

WDeploy 常规命令用于提供关于工具本身和可用

Web 应用程序服务器部署的高级别信息。它们不与服务器名

称、属性或操作一起使用。下面是可用的常规命令：

● wdeploy help：列出可用 WDeploy 命令行用法的摘要。

● wdeploy listappservers：列出本版本的 WDeploy 支持的所有 Java Web 应用程序服务器。

● wdeploy version：列出 WDeploy 工具本身的版本号。

● wdeploy buildwarall：通过使用 Web 应用程序源树生成通用 WAR 文件。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

45

用法： wdeploy.sh

buildwarall

-Dapp_source_tree=<LOCATION_OF_WEB_APP_SOURCE>

-Dwar_dir=<TARGET_LOCATION_OF_GENERIC_WAR_FILES>

例如： wdeploy.sh

buildwarall

-Dapp_source_tree=/sap/sap_bobj/enterprise_xi40/warfiles/webapps

-Dwar_dir=/myGenericWarFiles

4.6.2 使用

WDeploy 的示例

此节介绍对受支持

Web 应用程序服务器使用 WDeploy 命令的示例。

记忆

在使用

WDeploy 之前，请确保已经为 Web 应用程序服务器适当配置了 WDeploy 配置文件。请参阅

WDeploy 配置文件

[第 31 页]。请阅读“

特殊注意事项

[第 58 页]”，以获取 Web 应用程序服务器特定的重要信

息列表。

4.6.2.1

WEB_APP_SERVER 的值

在以下示例中，将变量

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

Web 应用程序服务器

JBoss 7.1

SAP Netweaver 技术平台

Tomcat 6.0

Tomcat 7.0

WebLogic 11gR1

WebSphere 7.0

WebSphere 8.5 或

8.5.5

<WEB_APP_SERVER>

jboss7 sapappsvr73 tomcat6 tomcat7 weblogic11 websphere7 websphere8

名称

4.6.2.2 wdeploy predeploy

wdeploy predeploy 命令准备要部署到目标 Web 应用程序服务器的 Web 应用程序。

46

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

Web 应用程序的内部 web.xml 配置文件由 WDeploy 设置，并进行其他所需更改，以便 Web 应用程序能够部

署到目标

Web 应用程序服务器。

在配置完成后，

Web 应用程序被打包成

WAR 或 EAR 文件，并保存到

<BIP 安装目录> /sap_bobj/ enterprise_xi40/wdeploy/

<WEB_APP_SERVER>

。

可以通过

Web 应用程序服务器的管理控制台或使用 wdeploy deploy 命令手动部署生成的 WAR 或 EAR 文

件。

示例

例如，使用

wdeploy predeploy 命令准备 BOE Web 应用程序，以便可将其部署到特定的 Web 应用程序

服务器。 wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

predeploy

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于将

BOE Web 应用程序预部署到特定 Web 应用程序服务器的示例参数。 除非在配置文件中标

记为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在 config.

<WEB_APP_SERVER>

配置文件中配置适当的部署参数。

服务器

JBoss 7.1 (jboss7)

参数 wdeploy.sh jboss7

-Das_instance=default

-DAPP=BOE

predeploy

SAP Technology

(sapappsvr73) wdeploy.sh sapappsvr73

-DAPP=BOE

predeploy

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-DAPP=BOE

predeploy

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-DAPP=BOE

predeploy

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

47

服务器

WebLogic 11gR1

(weblogic11)

参数 wdeploy.sh weblogic11

-DAPP=BOE

predeploy

如果

WegLogic Web 应用程序服务器承载于使用 JRockit Java 虚拟机的

Linux 计算机上，并且您打算预先部署

dswsbobje 或 BOE Web 应用程序，则

必须包括

-Djvm_is_jrockit=true 选项： wdeploy weblogic11

-DAPP=dswsbobje

-Djvm_is_jrockit=true

predeploy wdeploy weblogic11

-DAPP=BOE

-Djvm_is_jrockit=true

predeploy

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_virtual_host=default_host

-DAPP=BOE

predeploy

WebSphere 8.5 或

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_virtual_host=default_host

-DAPP=BOE

predeploy

4.6.2.3 wdeploy predeployall

wdeploy predeployall 命令对位于 BI 平台 Web 应用程序源目录中的所有 Web 应用程序执行 wdeploy predeploy 命令：

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps

示例

例如，使用

wdeploy predeployall 对所有 Web 应用程序应用 wdeploy predeploy 命令。 wdeploy.sh

<WEB_APP_SERVER>

predeployall

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于将所有

Web 应用程序预部署到特定 Web 应用程序服务器的示例参数。 除非在配置文件中标

记为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在 config.

<WEB_APP_SERVER>

配置文件中配置适当的部署参数。

48

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

服务器

JBoss 7.1 (jboss7)

参数 wdeploy.sh jboss7

predeployall

SAP Technology

(sapappsvr73) wdeploy.sh sapappsvr73

predeployall

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

predeployall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

predeployall

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

predeployall

如果

WegLogic Web 应用程序服务器承载于使用 JRockit Java 虚拟机的

Linux 计算机上，并且您打算预先部署

dswsbobje 或 BOE Web 应用程序，则

必须包括

-Djvm_is_jrockit=true 选项： wdeploy.sh weblogic11

-Djvm_is_jrockit=true

predeployall

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_virtual_host=default_host

predeployall

WebSphere 8.5 和

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_virtual_host=default_host

predeployall

4.6.2.4 wdeploy deployonly

wdeploy deployonly 命令将准备好的 Web 应用程序部署到目标 Web 应用程序服务器。

通过调用

Web 应用程序服务器的命令行界面，wdeploy deployonly 命令可将位于

<BIP 安装目录> / sap_bobj/enterprise_xi40/wdeploy/workdir/

<WEB_APP_SERVER>

中的

WAR 或 EAR 可部署文件部署

到

Web 应用程序服务器。

如果

Web 应用程序尚未准备好进行部署，则会自动调用 wdeploy predeploy 命令。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

49

示例

例如，使用

wdeploy deployonly 将准备就绪的 BOE Web 应用程序部署到 Web 应用程序服务器。 wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

deployonly

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于将

BOE Web 应用程序部署到特定 Web 应用程序服务器的示例参数。 除非在配置文件中标记

为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在 config.

<WEB_APP_SERVER>

配置文件中配置适当的部署参数。

服务器

JBoss 7.1 (jboss7)

参数 wdeploy deployonly 命令不支持 JBoss 7.1。 必须使用 WDeploy 工具

的

wdeploy predeploy 或 wdeploy predeployall 命令创建 WAR 文

件，并使用

JBoss 命令行界面（CLI）或文件系统部署扫描器进行手动部署。

SAP NetWeaver 技术平

台

(sapappsvr73) wdeploy deployall 命令不支持 SAP NetWeaver 技术平台。 必须使用

WDeploy 工具的 wdeploy predeploy 或 wdeploy predeployall 命令来

创建

SCA 文件，并使用 SAP Software Update Manager (SUM) 执行手动部

署。

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

deployonly

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

-DAPP=BOE

deployonly

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

-DAPP=BOE

deployonly

50

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

服务器

WebSphere 7.0

(websphere7)

参数 wdeploy.sh websphere7

-Das_dir=/opt/IBM/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deployonly

WebSphere 8.5 或

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/IBM/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deployonly

4.6.2.5 wdeploy deployonlyall

wdeploy deployonlyall 命令对所有准备好的 Web 应用程序执行 wdeploy deployonly 命令。

示例

例如，使用

wdeploy deployonlyall 命令对所有准备就绪的 Web 应用程序应用 wdeploy deployonly 命令。 wdeploy.sh

<WEB_APP_SERVER>

deployonlyall

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于将所有

Web 应用程序部署到特定 Web 应用程序服务器的示例参数。 除非在配置文件中标记

为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在 config.

<WEB_APP_SERVER>

配置文件中配置适当的部署参数。

服务器

JBoss 7.1 (jboss7)

参数 wdeploy deployonlyall 命令不支持 JBoss 7.1。 必须使用 WDeploy 工

具的

wdeploy predeploy 或 wdeploy predeployall 命令创建 WAR 文

件，并使用

JBoss 命令行界面（CLI）或文件系统部署扫描器进行手动部署。

SAP Technology

(sapappsvr73) wdeploy deployonlyall 命令不支持 SAP Technology。 必须使用

WDeploy 工具的 wdeploy predeploy 或 wdeploy predeployall 命令来

创建

SCA 文件，并使用 SAP Software Update Manager (SUM) 执行手动部

署。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

51

服务器

Tomcat 6.0 (tomcat6)

参数 wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

deployonlyall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

deployonlyall

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

deployonlyall

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployonlyall

WebSphere 8.5 或

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployonlyall

4.6.2.6 wdeploy deploy

wdeploy deploy 命令是 wdeploy predeploy 和 wdeploy deployonly 命令的拼接，单独使用此命令即

可准备

Web 应用程序并将其部署到目标 Web 应用程序服务器。

示例

例如，使用

wdeploy deploy 准备 BOE Web 应用程序并将其部署到目标 Web 应用程序服务器。 wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

deploy

52

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于将

BOE Web 应用程序部署到特定 Web 应用程序服务器的示例参数。 除非在配置文件中标记

为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在适用于

部署的

config.

<WEB_APP_SERVER>

配置文件中配置参数。

服务器

JBoss 7.1 (jboss7)

参数 wdeploy deploy 命令不支持 JBoss 7.1。 必须使用 WDeploy 工具的 wdeploy predeploy 或 wdeploy predeployall 命令创建 WAR 文件，并

使用

JBoss 命令行界面（CLI）或文件系统部署扫描器进行手动部署。

SAP Technology AS

Java (sapappsvr73) wdeploy deploy 命令不支持 SAP Technology AS Java。 必须使用

WDeploy 工具的 wdeploy predeploy 或 wdeploy predeployall 命令创

建

SCA 文件，并使用 SAP Software Update Manager (SUM) 执行手动部署。

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

deploy

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

-DAPP=BOE

deploy

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

-DAPP=BOE

deploy

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deploy

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

53

服务器

WebSphere 8.5 或

8.5.5

(websphere8)

参数 wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deploy

4.6.2.7 wdeploy deployall

wdeploy deployall 命令对 BI 平台 Web 应用程序源目录中的所有 Web 应用程序执行 wdeploy deploy 命

令：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/warfiles/webapps

示例

例如，使用

wdeploy deployall 对所有 Web 应用程序应用 wdeploy deploy 命令。 wdeploy.sh

<WEB_APP_SERVER>

deployall

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于将所有

Web 应用程序部署到特定 Web 应用程序服务器的示例参数。 除非在配置文件中标记

为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在 config.

<WEB_APP_SERVER>

配置文件中配置适当的部署参数。

服务器

JBoss 7.1 (jboss7)

参数 wdeploy deployall 命令不支持 JBoss 7.1。 必须使用 WDeploy 工具的 wdeploy predeploy 或 wdeploy predeployall 命令创建 WAR 文件，并

使用

JBoss 命令行界面（CLI）或文件系统部署扫描器进行手动部署。

SAP NetWeaver 技术平

台

(sapappsvr73) wdeploy deployall 命令不支持 SAP NetWeaver 技术平台。 必须使用

WDeploy 工具的 wdeploy predeploy 或 wdeploy predeployall 命令来

创建

SCA 文件，并使用 SAP Software Update Manager (SUM) 执行手动部

署。

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

deployall

54

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

服务器

Tomcat 7.0 (tomcat7)

参数 wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

deployall

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

deployall

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployall

WebSphere 8.5 或

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployall

4.6.2.8 wdeploy undeploy

使用

wdeploy undeploy 命令调用目标 Web 应用程序服务器的命令行界面，以便从服务器中删除已部署的 BI

平台

Web 应用程序。

示例

例如，使用

wdeploy undeploy 命令取消在目标 Web 应用程序服务器上部署 BOE Web 应用程序。 wdeploy.sh

<WEB_APP_SERVER>

-DAPP=BOE

undeploy

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于取消在特定

Web 应用程序服务器上部署 BOE Web 应用程序的示例参数。 除非在配置文件中

标记为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在适

用于部署的

config.

<WEB_APP_SERVER>

配置文件中配置参数。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

55

服务器

JBoss 7.1 (jboss7)

SAP NetWeaver 技术平

台

(sapappsvr73)

Tomcat 6.0 (tomcat6)

参数 wdeploy undeploy 命令不支持 JBoss 7.1。 wdeploy undeploy 命令不支持 SAP NetWeaver 技术平台。 wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-DAPP=BOE

-Das_service_name=Tomcat6

undeploy

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-DAPP=BOE

-Das_service_name=Tomcat7

undeploy

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

-DAPP=BOE

undeploy

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

undeploy

WebSphere 8.5 或

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

undeploy

4.6.2.9 wdeploy undeployall

使用

wdeploy undeployall 命令对部署到目标 Web 应用程序服务器的所有 BI 平台 Web 应用程序执行 wdeploy undeploy 命令。

56

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

示例 wdeploy.sh

<WEB_APP_SERVER>

undeployall

将

<WEB_APP_SERVER>

替换为

Web 应用程序服务器的名称，如下表所示。

下表列出了用于取消特定

Web 应用程序服务器上的所有 Web 应用程序部署的示例参数。 除非在配置文件中

标记为可选，否则所有参数都是必需的。

在命令行上指定的参数会覆盖配置文件中的参数。 但是，仍建议在适

用于部署的

config.

<WEB_APP_SERVER>

配置文件中配置参数。

服务器

JBoss 7.1 (jboss7)

参数 wdeploy undeployall 命令不支持 JBoss 7.1。

SAP Technology

(sapappsvr73)

Tomcat 6.0 (tomcat6) wdeploy undeployall 命令不支持 SAP Technology。 wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

undeployall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

undeployall

WebLogic 11gR1

(weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

undeployall

WebSphere 7.0

(websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

undeployall

WebSphere 8.5 或

8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

undeployall

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

57

4.6.3 特殊注意事项

下节提供关于在

Web 应用程序服务器上部署 Web 应用程序的重要信息。

4.6.3.1 SAP NetWeaver 技术平台

4.6.3.1.1

在

SAP NetWeaver 技术平台上部署的先决条件

注意

如果服务器上存在任何现有

SAP BusinessObjects Business Intelligence 平台 Web 应用程序，则必须先取

消部署这些应用程序，然后才能继续操作。

在将

BI 平台 Web 应用程序部署至 SAP NetWeaver Application Server 组件（任一版本）之前，必须确

保

.html 和 .htm 文件从未压缩过。 例如，在 SAP NetWeaver AS 组件 7.3 中：

1. 登录您的

SAP Administrator 门户。

例如：http://<服务器名>:50200/nwa

2. 导航至：

“Configuration”（配置） “Infrastructure”（基础设施） “Java System Properties”（Java 系统

属性） 。

3. 在

“Services”

（服务）选项卡上，选择

“HTTP provider”

（

HTTP 提供程序）。

4. 在 “Extended Details”

（扩展详细信息）下，按如下方式修改

“AlwaysCompressed”

（始终压缩）和

“NeverCompressed”

（从未压缩）属性：

○

AlwaysCompressed

（始终压缩）：

从此属性中删除 *.htm、*.html、text/html。 此字段不能留

空，如果没有内容，请输入一个空格。

○

NeverCompressed

（从未压缩）：

为此属性添加 *.htm、*.html、text/html。

表

10： 示例

名称

AlwaysCompressed

NeverCompressed

默认的计算所得值

（如果没有内容，则设置空格。）

*.htm、*.html、text/html

5. 在退出之前保存更改。

58

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

4.6.3.2 Tomcat

4.6.3.2.1

部署到单独的

Apache Web 和 Tomcat Web 应用程序

服务器

要减少

Web 应用程序服务器上的工作负载，可以设置一个单独的专用 Web 服务器提供静态内容。 该 Web 服务器

将提供所有静态内容，而

Web 应用程序服务器将提供动态内容。 以下说明将介绍如何使用 WDeploy 工具将 Web

应用程序资源拆分为静态和动态内容并进行相应部署。

1. 设置

Apache Web 服务器并确保其正常工作。 加载网页（如 Apache 的默认测试页），验证 Web 服务器是否

可以正确提供内容。

打开

Web 浏览器并输入 Web 服务器 URL。 例如： http://apache.mycompany.com。

2. 确保

Tomcat Web 应用程序服务器正常工作。

打开

Web 浏览器并输入 Web 应用程序服务器的 IP 地址或主机名以及一个端口号。 例如： http:// tomcat.mycompany.com:8080。

注意

如果具有在服务器上运行的任何现有

BI 平台 Web 应用程序，则在继续之前必须取消部署这些应用程序。

3. 从

Tomcat 网站下载 Apache Tomcat 连接器。 通过使用 Apache Tomcat 连接器，可以将 Apache Web 服务

器与

Tomcat Web 应用程序服务器相连，以便 Apache 可以将动态资源请求转发给 Tomcat。

4. 按照

Apache 网站上的插件配置说明配置 Apache Web 服务器与 Tomcat Web 应用程序服务器之间的桥接

器。

当

Apache 接收到动态资源请求时，它现在可以将动态资源请求转发给 Tomcat。

5. 请将浏览器指向

Web 服务器，并验证 Web 应用程序服务器是否可以正确提供动态内容，从而确保 Web 服务

器与

Web 应用程序服务器之间的桥接器可以正常工作。

例如，访问

URL： http://apache.mycompany.com/jsp-examples/。

注意

只有在手动部署了

jsp-examples Web 应用程序的情况下此示例 URL 才有用。

6. 如果

Web 应用程序服务器与 BI 平台安装在同一台计算机上，请在该计算机上以本地方式运行 WDeploy。 如

果

Web 应用程序服务器在另一台计算机上运行，将 WDeploy 命令和环境复制到 Web 应用程序服务器中。 请

参阅

“在远程计算机上部署 Web 应用程序”。

7. 配置

WDeploy 环境，以便将内容拆分到 Web 服务器与 Web 应用程序服务器。 这称为“分离”模式。

Apache 和

Tomcat 的 WDeploy 配置文件位于

<BIP 安装目录> /sap_bobj/enterprise_xi40/ wdeploy/conf 中。

○ 编辑用于 Tomcat 的 WDeploy 配置文件。 例如，对于 Tomcat 6.0，文件 config.tomcat6 文件类似于

如下： as_dir=/opt/Tomcat as_instance=localhost as_service_name=Tomcat6

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

59

○ 编辑 config.apache。 例如： ws_dir=/opt/apache224 connector_type=Tomcat6 deployment_dir=/opt/apache224/htdocs

8. 在分离模式下，使用 wdeploy predeploy 将源 Web 应用程序分成静态文件和动态文件。

例如：

○ 运行以下命令为 Apache Web 服务器提取静态内容。 wdeploy.sh Tomcat6 -Das_mode=split

-Dws_type=apache predeployall

9. 运行 wdeploy deployonlyall 命令，将动态内容部署到 Tomcat 应用程序服务器，并将静态内容部署到

Apache。

如果

Apache 和 Tomcat 在同一台计算机上，则通过以下命令将静态内容和动态内容自动部署到服务器上： wdeploy.sh Tomcat6 -Das_mode=split

-Dws_type=apache deployonlyall

注意

如果动态内容和静态内容在自定义的位置中，请使用

-Dwork_dir 参数。

如果

Apache 和 Tomcat 在不同的计算机上，则通过以下命令将动态内容自动部署到 Tomcat。 以后必须将静

态内容手动部署到远程

Apache 计算机上。 wdeploy.sh Tomcat6 -Das_mode=split

deployonlyall

注意

如果动态内容和静态内容在自定义的位置中，请使用

-Dwork_dir 参数。

将静态内容复制到

Web 服务器上的 htdocs 目录：

○ 在

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/Tomcat6/resources

下的

Web 应用程序服务器中提取 Zip 文件。

○ 将这些文件夹从 Tomcat Web 应用程序服务器复制到 Apache 服务器上的 Apache

<WS 目录> / htdocs 文件夹中。

○ 将 bobj.

<应用程序> .conf 文件从 Tomcat Web 应用程序服务器复制到 Apache 服务器上的 Apache

<WS 目录> /conf 文件夹中。

○ 使用应用程序配置文件更新

<WS 目录> /conf 下的 Apache httpd.conf。 对于每个 Web 应用程

序，在

httpd.conf 中包括一个条目。 例如，要包括 BOE，应输入：

Include conf/bobj.BOE.conf

现在，静态内容由专用的

Web 服务器提供，而动态内容由专用的 Web 应用程序服务器提供。

60

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

4.6.3.2.2 Tomcat gzip 压缩

如果安装

BI 平台的新安装，并选择使用捆绑的 Tomcat Web 应用程序服务器，Tomcat 的 HTTP gzip 压缩会自

动启用。 gzip 压缩缩短了

Web 应用程序服务器的响应时间，并提高了吞吐量。但是，如果计划将 Web 应用程序部署到

Tomcat Web 应用程序服务器，请注意：将

Web 应用程序部署到已启用 gzip 压缩的 Tomcat 服务器可能会不同于

将

Web 应用程序部署到捆绑了 BI 平台早期版本的 Tomcat 版本的过程。

4.6.3.3 WebLogic

4.6.3.3.1

部署到单独的

Apache Web 和 WebLogic Web 应用程

序服务器

要减少

Web 应用程序服务器上的工作负载，可以设置一个单独的专用 Web 服务器提供静态内容。 该 Web 服务器

将提供所有静态内容，而

Web 应用程序服务器将提供动态内容。 以下说明将介绍如何使用 WDeploy 工具将 Web

应用程序资源拆分为静态和动态内容并进行相应部署。

1. 设置

Apache Web 服务器并确保其正常工作。 加载网页（如 Apache 的默认测试页），验证 Web 服务器是否

可以正确提供内容。

打开

Web 浏览器并输入 Web 服务器的 IP 地址或主机名，如果服务器不在端口 80 上侦听，请输入端口号。例

如：

http://apache.mycompany.com。

2. 确保

WebLogic Web 应用程序服务器正常工作。

打开

Web 浏览器并输入 Web 应用程序服务器的 IP 地址或主机名以及一个端口号。 例如： http:// weblogic.mycompany.com:7001。

注意

如果具有在服务器上运行的任何现有

BI 平台 Web 应用程序，则在继续之前必须取消部署这些应用程序。

3. 从

BEA 网站中下载 WebLogic Apache HTTP 服务器插件。 通过使用该插件，可以将 Apache Web 服务器与

WebLogic Web 应用程序服务器相连，以便

Apache 可以将动态资源请求转发给 WebLogic。

4. 按照

BEA 网站上的插件配置说明配置 Apache Web 服务器与 WebLogic 之间的桥接器。

当

Apache 接收到动态资源请求时，它现在可以将动态资源请求转发给 WebLogic。

5. 请将浏览器指向

Web 服务器，并验证 Web 应用程序服务器是否可以正确提供动态内容，从而确保 Web 服务

器与

Web 应用程序服务器之间的桥接器可以正常工作。

例如，访问

URL： http://apache.mycompany.com/jsp-examples/。

注意

只有在手动部署了

jsp-examples Web 应用程序的情况下此示例 URL 才有用。

6. 如果

Web 应用程序服务器与 BI 平台安装在同一台计算机上，请在该计算机上以本地方式运行 WDeploy。 如

果

Web 应用程序服务器在另一台计算机上运行，将 WDeploy 命令和环境复制到 Web 应用程序服务器中。 请

参阅

“在远程计算机上部署 Web 应用程序”。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

61

7. 配置

WDeploy 环境，以便将内容拆分到 Web 服务器与 Web 应用程序服务器。 这称为“分离”模式。

Apache 和

WebLogic 的 WDeploy 配置文件位于

<BIP 安装目录> /sap_bobj/enterprise_xi40/ wdeploy/conf 中。

○ 编辑 config.weblogic11。 例如： as_admin_port=7001 as_admin_username=weblogic as_admin_password=weblogic as_instance=AdminServer as_domain_dir=/usr/bea/user_projects/domains/base_domain

○ 编辑 config.apache。 例如： ws_dir=/opt/apweblogic11 ache224/ connector_type=weblogic11 deployment_dir=/opt/apache224/htdocs

8. 在分离模式下使用 wdeploy predeploy 将源 Web 应用程序分成单独的静态资源和动态资源。

例如：

○ 运行以下命令为 Apache Web 服务器提取静态内容，并为 WebLogic 应用程序服务器提取动态内容。 wdeploy.sh weblogic11 -Das_mode=split

-Dws_type=apache predeployall

动态内容位于： <BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/weblogic11/ application。 静态内容位于： <BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/ weblogic11/resources。

9. 运行 wdeploy deployonlyall，将动态内容部署到 WebLogic 应用程序服务器，并将静态内容部署到

Apache。

如果

Apache 和 WebLogic 位于同一台计算机上，此命令会自动将静态内容和动态内容部署到服务器上： wdeploy.sh weblogic11 -Das_mode=split

-Dws_type=apache deployonlyall

注意

如果动态内容和静态内容在自定义的位置中，请使用

-Dwork_dir 参数。

如果

Apache 和 WebLogic 在不同的计算机上，则通过以下命令将动态内容自动部署到 WebLogic。 然后，必

须将静态内容手动复制并部署到远程

Apache 计算机。

./wdeploy.sh weblogic11 -Das_mode=split

deployonlyall

注意

如果动态内容和静态内容位于自定义位置中，请使用

-Dwork_dir 参数。

将静态内容复制到

Web 服务器上的 htdocs 目录：

62

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

○ 在

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/WebLogic11/ resources 下的 Web 应用程序服务器中提取 Zip 文件。

○ 将这些文件夹从 WebLogic Web 应用程序服务器复制到 Apache 服务器上的 Apache

<WS 目录>

\htdocs 文件夹中。

○ 将 bobj.

<应用程序> .conf 文件从 WebLogic Web 应用程序服务器复制到 Apache 服务器上的

Apache

<WS 目录> /conf 文件夹中。

○ 使用应用程序配置文件更新

<WS 目录> /conf 下的 Apache httpd.conf。 对于每个 Web 应用程

序，在

httpd.conf 中包括一个条目。 例如，要包括 BOE，应输入：

Include conf/bobj.BOE.conf

现在，静态内容由专用的

Web 服务器提供，而动态内容由专用的 Web 应用程序服务器提供。

4.6.3.4 WebSphere

4.6.3.4.1 部署到单独的

IHS Web 和 WebSphere Web 应用程序

服务器

要减少

Web 应用程序服务器上的工作负载，可以设置一个单独的专用 Web 服务器提供静态内容。 该 Web 服务器

将提供所有静态内容，而

Web 应用程序服务器将提供动态内容。 以下说明将介绍如何使用 WDeploy 工具将 Web

应用程序资源拆分为静态和动态内容并进行相应部署。

1. 设置

IBM HTTP Server (IHS) Web 服务器并确保其正常工作。 加载网页（如 IHS 默认测试页），验证 Web 服

务器是否可以正确提供内容。

打开

Web 浏览器并输入 Web 服务器的 IP 地址或主机名，如果服务器不在端口 80 上侦听，请输入端口号。例

如：

http://ihs.mycompany.com。

2. 确保

WebSphere Web 应用程序服务器正常工作。

打开

Web 浏览器并输入 Web 应用程序服务器的 IP 地址或主机名以及一个端口号。 例如： http:// websphere.mycompany.com:9080。

注意

如果具有在服务器上运行的任何现有

BI 平台 Web 应用程序，则在继续之前必须取消部署这些应用程序。

3. 运行

Web 服务器插件安装向导以安装连接 WebSphere 与 IHS 的插件，并按照说明输入有关 IHS Web 服务器

的信息。

4. 按照

WebSphere 网站上的插件配置说明配置 IHS 与 WebSphere 之间的桥接器。

当

IHS 接收到动态资源请求时，它现在可以将动态资源请求转发给 WebSphere。

5. 请将浏览器指向

Web 服务器，并验证 Web 应用程序服务器是否可以提供正确的动态内容，从而确保 Web 服

务器与

Web 应用程序服务器之间的桥接器可以正常工作。

例如，访问

URL： http://ihs.mycompany.com/snoop/。

6. 如果

Web 应用程序服务器与 BI 平台安装在同一台计算机上，请在该计算机上以本地方式运行 WDeploy。 如

果

Web 应用程序服务器在另一台计算机上运行，将 WDeploy 命令和环境复制到 Web 应用程序服务器中。 请

参阅

“在远程计算机上部署 Web 应用程序”。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

63

7. 配置

WDeploy 环境，以便将内容拆分到 Web 服务器与 Web 应用程序服务器。 这称为“分离”模式。

Apache 和

WebSphere 的 WDeploy 配置文件位于

<BIP 安装目录> /sap_bobj/enterprise_xi40/ wdeploy/conf 中。

○ 编辑 config.apache。 例如： ws_dir=C:\Program Files (x86)\IBM\HTTPServer connector_type=websphere7 deployment_dir=${ws_dir}/htdocs plugin_install_dir=C:\Program Files\IBM\HTTPServer\Plugins

○ 编辑 config.websphere7。 例如： as_soap_port=8880

#as_admin_username=admin

#as_admin_password=password as_dir=/opt/websphere/appserver as_instance=server1 as_plugin_cfg_dir=/opt/ibm/WebSphere/AppSever/profiles/AppSrv01/config/ cells/ <单元格名称> /nodes/ <节点名称> /servers/${ws_instance} as_profile_name=AppSrv01 as_virtual_host=default_host as_admin_is_secure=false enforce_file_limit=true ws_instance=webserver1

8. 在分离模式下使用 wdeploy predeploy 将源 Web 应用程序分成单独的静态资源和动态资源。

注意

在运行

wdeploy predeploy 之前，请确保 config.websphere

<X>

中的参数 as_plugin_cfg_dir 已

设置为包含

WebSphere 文件 plugin-cfg.xml 的文件夹。

例如：

○ 运行以下命令为 IHS Web 服务器提取静态内容。 wdeploy.sh websphere7

-Das_mode=split

-Dws_type=apache

predeployall

Web 应用程序的动态内容位于：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/ workdir/websphere7/application。 静态内容位于： <BIP 安装目录> /sap_bobj/ enterprise_xi40/wdeploy/workdir/websphere7/resources。

9. 运行 wdeploy deployonlyall 命令将动态内容部署到 WebSphere 应用程序服务器，将静态内容部署到

IHS。

如果

IHS 和 WebSphere 在同一台计算机上，则通过以下命令将静态内容和动态内容自动部署到服务器上： wdeploy.sh websphere7 -Das_mode=split

-Dws_type=apache deployonlyall

注意

如果动态内容和静态内容在自定义的位置中，请使用

-Dwork_dir 参数。

64

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

如果

IHS 和 WebSphere 在不同的计算机上，则通过以下命令将动态内容自动部署到 WebSphere。 以后必须

将静态内容手动部署到远程

IHS 计算机上。

./wdeploy.sh websphere7 -Das_mode=split

deployonlyall

注意

如果动态内容和静态内容在自定义的位置中，请使用

-Dwork_dir 参数。

将静态内容复制到

Web 服务器上的 htdocs 目录：

○ 在

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/websphere7/ resources 下的 Web 应用程序服务器中提取 Zip 文件。

○ 将这些文件夹从 WebSphere Web 应用程序服务器中复制到 IHS 服务器上的 IHS

<WS 目录> /htdocs

文件夹中。

○ 将 bobj.

<应用程序> .conf 文件从 WebSphere Web 应用程序服务器复制到 IHS 服务器上的 IHS

<WS

目录>

/conf 文件夹中。

○ 使用应用程序配置文件更新

<WS 目录> /conf 下的 IHS httpd.conf。 对于每个 Web 应用程序，在 httpd.conf 中包括一个条目。 例如，要包括 BOE，应输入：

Include conf/bobj.BOE.conf

10. 将 plugin-cfg.xml 文件复制到 IHS 和 WebSphere 工作文件夹。 如果使用 WebSphere 管理控制台进行部

署，并且同一主机系统上已安装

IHS 和 WebSphere，请跳至下一步。 当同一主机系统上已安装 IHS 和

WebSphere 时，WDeploy 命令行会自动复制 plugin-cfg.xml。

例如，复制下列文件：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/work_dir/websphere7/ application/PluginSplit/plugin-cfg.xml

到

WebSphere 工作文件夹：

<WS 主目录> /AppServer/profiles/AppSrv01/config/cells/ <单元格名称> /nodes/ <节点名称

>

/servers/ <服务器名称>

和到

IHS 工作文件夹:

<WS 目录> /Plugins/config/

<WEB_SERVER_NAME>

11. 尝试通过

Web 服务器访问 Web 应用程序，以确保正确配置静态内容和动态内容。 例如，使用部署到 Web 应

用程序服务器的

Web 应用程序的根上下文创建一个包含 Web 服务器地址的 URL： http:// ihs.mycompany.com/BOE/CMC/。 在本示例中，ihs.mycompany.com 是 Web 服务器，/BOE/CMC/ 是已

部署的

Web 应用程序。

现在，静态内容由专用的

Web 服务器提供，而动态内容由专用的 Web 应用程序服务器提供。

4.6.3.4.2 通过应用程序类加载程序优先加载类

应使用

WebSphere “Administrative console”

（管理控制台）将已安装

Web 应用程序的类加载行为设置为

“Classes loaded with application class loader first (parent last)”

（通过应用程序类加载程序加载的类优先（父类最

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

65

后））。

这可确保使用与

BI 平台 Web 应用程序捆绑在一起的常用类（如 JavaServer Faces (JSF) 库），而非

WebSphere 提供的其他任何实施。

使用管理员帐户登录到

WebSphere “Integrated Solutions Console”

（集成解决方案控制台）。可以运行

WebSphere

“Administrative console”

（管理控制台）程序，或使用

Web 浏览器打开 http://

<WAS_HOSTNAME>

:

<PORT>

/ibm/console，其中

<WAS_HOSTNAME>

是

WebSphere 服务器的名称，

<PORT>

是

服务器侦听登录请求所用的端口号。默认端口号为

9060。

1. 在菜单中选择

“Applications”（应用程序） “Applications Type”（应用程序类型） “WebSphere

enterprise applications

”（WebSphere 企业级应用程序）

。

将出现

“Enterprise Applications”

（企业级应用程序）屏幕。

2. 从管理资源列表中选择通过

WDeploy 部署的 Web 应用程序。

将出现

“Enterprise Applications”

（企业级应用程序）配置屏幕。

3. 单击

“Manage Modules”

（管理模块）。

将出现

“Manage Modules”

（管理模块）屏幕。

4. 选择

Web 应用程序模块（在 “Module”

（模块）列中）。

将出现

“Manage Modules General Properties”

（管理模块常规属性）屏幕。

5. 从

“Class loader order”

（类加载程序顺序）属性中选择

“Classes loaded with application class loader first

(parent last)

”

（通过应用程序类加载程序加载的类优先（父类最后））。

将出现确认消息。

6. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Manage Modules”

（管理模块）屏幕。

7. 单击

“确定”

。

将出现主配置更改确认消息。

8. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Enterprise Applications”

（企业级应用程序）屏幕。

9. 选中

Web 应用程序复选框并单击 “Start”

（启动）。

将出现一条消息确认

Web 应用程序已成功启动。

部署多个

Web 应用程序时，请对每个 Web 应用程序重复步骤 2 到 9。

4.6.4 无需访问

Web 应用程序服务器的分离 Web 层预部署

WDeploy 命令可分离静态内容和动态内容，以分别部署到

Web 服务器和 Web 应用程序服务器。不需要访问

Web 应用程序服务器的部署文件夹：可手动从承载

WDeploy 的服务器将分离的内容复制到 Web 和 Web 应用程序

服务器。

当

WDeploy 安装到专用 Web 服务器时，可以使用 wdeploy predeploy 或 wdeploy predeployall 命

令，将来自

Web 应用程序的静态内容直接创建到 Web 服务器的内容目录。对于特定的 Web 服务器或 Web 应用程

序服务器，某些参数是必需的：

Web 服务器或

Web 应用

程序服务器

WebSphere Application

Server

预部署所需的参数 as_virtual_host

66

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

Web 服务器或

Web 应用

程序服务器

Apache 和

IBM IHS

预部署所需的参数 ws_dir、deployment_dir、connector_type

4.6.5 禁用

CMC 或 BI 启动板 Web 应用程序

现在，中央管理控制台（

CMC）和

BI 启动板（以前称为 InfoView）Web 应用程序包括在 BOE 存档文件

（BOE.war 或 BOE.ear）中。 要禁用 CMC 或 BI 启动板 Web 应用程序，以便在将 BOE 存档文件部署到 Web 应

用程序服务器时无法对其进行访问，请使用

WDeploy 工具。

要禁用

CMC Web 应用程序，请在将 BOE.war 部署到 Web 应用程序服务器时使用 -

Ddisable_CmcApp=true 开关。例如，以下命令将 BOE.war 部署到 Tomcat 6 Web 应用程序服务器，但会禁用

CMC： wdeploy.sh tomcat6 -DAPP=BOE -Ddisable_CmcApp=true deploy

要禁用

BI 启动板 Web 应用程序，请在将 BOE.war 部署到 Web 应用程序服务器时包括 -

Ddisable_InfoView=true 开关。例如，以下命令将 BOE.war 部署到 Tomcat 6 Web 应用程序服务器，但会禁

用

BI 启动板： wdeploy.sh tomcat6 -DAPP=BOE -Ddisable_InfoView=true deploy

4.6.6 更改为已安装的语言

要添加

Web 应用程序支持的语言，必须重新安装 BI 平台，并在安装过程中选择所需的语言。重新安装完成

后，必须将要使用新语言的任何已部署

Web 应用程序重新部署到 Web 应用程序服务器。

这是因为安装程序不会自动重新部署

Web 应用程序。必须重新打包 Web 应用程序并将其重新部署到 Web 应用

程序服务器。

4.7 使用

WDeploy GUI 工具

WDeploy GUI 工具是作为

BI 平台的一部分安装的，该工具为运行 wdeploy deployall 或 wdeploy undeployall 命令提供了一种替代的图形方法。

注意

● 建议使用 WDeploy 命令行工具，而非 WDeploy GUI 工具。 命令行工具提供更强健的功能。

● WDeploy GUI 工具不能用于预部署 Web 应用程序。 请使用命令行工具运行 wdeploy predeployall

命令。

有关

WDeploy 要求的信息，请参阅：

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

67

●

WDeploy 先决条件

[第 19 页]

●

WDeploy GUI 工具先决条件

[第 68 页]

要执行其他部署操作，请使用

WDeploy 的命令行版本。

WDeploy GUI 工具默认为英语界面，但是如果已安装了任意语言包并且该工具是第一次运行，将会提示用户选

择语言。

BI 平台支持以下语言包：

● 捷克语

● 简体中文

● 繁体中文

● 丹麦语

● 荷兰语

● 英语

● 芬兰语

● 法语

● 德语

● 匈牙利语

● 意大利语

● 日语

● 朝鲜语

● 挪威语（伯克梅尔）

● 波兰语

● 葡萄牙语

● 罗马尼亚语

● 俄语

● 斯洛伐克语

● 西班牙语

● 瑞典语

● 泰语

● 土耳其语

4.7.1

WDeploy GUI 工具先决条件

要使用

WDeploy GUI 工具，请确保满足以下要求：

● 设置 PERL_HOME 环境变量。

如果尚未安装

Perl 5.8.9，请将 PERL_HOME 设置为

<BIP 安装目录> /InstallData/setup.engine/ perl。

建议使用随

BI 平台一同安装的 Perl 版本。 要使用自己的 Perl 5.8.9 版本，请确保已安装以下模块：

○ Text::CharWidth

获取字符串在终端占用的列数。

有关更多信息，请参阅

http://search.cpan.org

上的 CharWidth.pm

文章。

68

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

○ Text::WrapI18N

折行模块，支持多字节、全宽度、组合字符以及字间不留空白的语言。

有关更多信息，请参阅

http:// search.cpan.org

上的 WrapI18N.pm 文章。

4.7.2 启动

WDeploy GUI 工具

WDeploy GUI 工具位于

<BIP 安装目录> //sap_bobj/enterprise_xi40/wdeploy 文件夹中。 WDeploy

命令（来自

wdeploy 目录）的语法为：

./wdeployGUI.sh

当

WDeploy GUI 工具第一次运行时，它会询问在用户界面中使用哪种语言显示信息。 选择语言并继续。

4.7.3 WDeploy GUI 工具窗口

WDeploy GUI 工具允许用户在

Web 应用程序服务器上部署及取消部署 Web 应用程序。任何不是由 BI 平台安装

程序或

WDeploy 工具部署的 Web 应用程序均不受影响。

从

“选择 Web 应用程序服务器类型”

下拉列表中选择受支持的

Web 应用程序服务器。选择 Web 应用程序服务器

后，请复查

“Web 应用程序服务器信息”

部分和

“应用程序服务器域根目录”

部分中的信息，以确保是正确的用户

Web

应用程序服务器信息。

要使用更多高级选项，请选择

“选项”

。

注意

并非所有

Web 应用程序都是自动部署的。 必须使用 WDeploy 命令行工具或 Web 应用程序服务器管理控制

台部署没有自动部署的

Web 应用程序。

Web 应用程序存档文件（可能是

WAR 或 EAR）

BOE

AdminTools dswsbobje

BusinessProcessBI

（不赞成使用） clientapi

MobileOTA14 jsfplatform

OpenSearch

是否自动部署？

是

是

是

是

否

否

否

否

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

69

4.7.4 通过

WDeploy 进行 Web 应用程序更新

表

11： 通过 WDeploy 对 Web 应用程序配置所做的更改

服务器 所做的更改

Apache Web 服务器

将为每个应用程序创建

${ws_dir}/conf/bobj.${APP}.conf 文件，其

中包含连接器配置、目录和

Servlet 映射信息。将修改文件 ${ws_dir}/conf/ httpd.conf 以包括该文件。

Tomcat

在

${as_dir}/shared/lib 中将删除添加到类路径中的文件。

将创建

${as_dir}/bin/bobjeEnv.${APP}.[sh|bat] 文件，其中包含

库路径修改和要添加到应用程序属性中的

java 属性修改。

将修改

${as_dir}/bin/catalina.[sh|bat] 文件以包括此文件。

在

Windows 上，会将其他 Java 属性添加到 Tomcat 服务启动参数中。必须

手动对系统范围内的

PATH 环境变量进行库路径修改。

重新启动

Tomcat 以使更改生效。

WebLogic

要添加到类路径的文件捆绑在应用程序（已添加到

WEB-INF/lib）中。

创建了

${as_domain_dir}/bin/bobjeEnv.${APP}.[sh|cmd] 文件，

其中包含库路径和

Java 属性修改。

修改了

${as_domain_dir}/bin/startWebLogic.[sh|cmd] 文件，以

包含此文件。

WebSphere

要添加到类路径的文件捆绑在应用程序（已添加到

WEB-INF/lib）中。

将以

JVM 自定义属性形式添加属性。将通过修改 JVM 环境来完成库路径修

改。将会自动重新生成

Web 服务器插件。

4.7.5 WDeploy GUI 工具选项

通过

WDeploy GUI 工具的 “选项”

屏幕可选择要用于部署

Web 应用程序的自定义文件夹。这等同于在使用

WDeploy 命令行时设置属性。有关

WDeploy 参数的更多信息，请参阅

WDeploy 属性参数

[第 38 页]。

●

WDeploy 工作目录

（等同于

work_dir 参数）。

●

Web 应用程序源树位置

（等同于

app_source_tree 参数）或

通用

WAR 文件位置

（等同于

war_dir 参

数）。

●

Web 应用程序根上下文

（等同于

root_context_path 参数）。

注意

路径中的非英语字符当前不会被

WDeploy GUI 工具接受为有效字符。

70

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

4.7.6 将密码添加至

WDeploy GUI 文件

借助

WDeploy GUI 工具，可将输入的信息保存到文件中，然后使用该信息部署 Web 应用程序。 出于安全原

因，系统不会自动记录密码，因此，即使在运行

GUI 时输入了密码，仍然必须手动将密码添加到该文件中。

要将

Web 应用程序服务器密码添加到 WDeploy GUI 文件，请执行如下操作步骤：

1. 打开包含有

WDeploy 信息的文件：

<BOE 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/config.

<WEB_APP_SERVER>

2. 找到包含密码信息的行： as_admin_password=

3. 使用

Web 应用程序密码替换密码值（如有）。

4. 保存文件，重新运行

WDeploy GUI。

4.8 部署

Web 应用程序之后

在部署或取消部署

Web 应用程序之后，请重新启动 Web 应用程序服务器。

要验证

Web 应用程序服务器配置，请确保可以在 Web 浏览器中启动 BI 启动板和中央管理控制台（CMC）。

例如：

● http[s]://

<WEB_APP_SERVER>

:

<PORT>

/

<BI_LAUNCHPAD_CONTEXT>

● http[s]://

<WEB_APP_SERVER>

:

<PORT>

/

<CMC_CONTEXT>

请将

<WEB_APP_SERVER>

替换为

Web 服务器或 Web 应用程序服务器的主机名或 IP 地址，将

<PORT>

替换为用

于

HTTP 或 HTTPS 通信的端口号。 用于 BI 启动板的默认根上下文为 /BOE/BI；用于 CMC 的默认上下文

为

/BOE/CMC。

4.9 日志文件

借助

WDeploy 工具可以创建两个包含详细信息的日志文件，这些信息可用于诊断问题或监控活动。

1.

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/logs/WDeploy_summary.log：

WDeploy 活动的高级记录，其中包括关于以下内容的信息：WDeploy 版本、正在使用的

JDK、发出的命令、

配置、

WAR 文件位置、操作或事件及其结果，以及在运行时对用户显示的任何错误消息或警告。

2.

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/logs/WDeploy.log： 包括

WDeploy_summary.log 中的所有内容，同时还包括时间戳和任何警告或错误消息。

发出

WDeploy 命令时，当前命令会覆盖 WDeploy_summary.log.01，并且还会添加 WDeploy.log。

当

WDeploy.log 文件的大小超过 512 KB 时，系统会使用唯一编码后缀重命名该文件。 例如，WDeploy.log

将重命名为

WDeploy.log.01。 如果已存在名为 WDeploy.log.01 的文件，则将会创建 WDeploy.log.02。

Web 应用程序部署指南

Unix 版 Windows 版

使用

WDeploy 工具部署 Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

71

5

使用管理控制台部署

Web 应用程序

5.1

手动部署

Web 应用程序

用户必须使用

WDeploy 工具生成可部署的 WAR 或 EAR 文件，然后才能将这些文件部署到 Web 应用程序服务

器。

以下步骤将使用应用程序服务器的管理控制台部署

Web 应用程序。

1. 运行 wdeploy predeploy 命令以准备一个 Web 应用程序，或运行 wdeploy predeployall 以准备所有

Web 应用程序。

示例

1： 使用 wdeploy predeploy 准备 BOE.war Web 应用程序 WAR 文件，以便部署到 Tomcat。 wdeploy.sh tomcat6

-Das_dir=/opt/usr/tomcat

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

predeploy

示例

2： 使用 wdeploy predeployall 准备所有 Web 应用程序，以便部署到 Tomcat。 wdeploy.sh tomcat6

-Das_dir=/opt/usr/tomcat

-Das_instance=localhost

-Das_service_name=Tomcat6

predeployall

注意

只要指定了

predeploy 或 predeployall 命令所需的参数，即可在未承载 Web 应用程序服务器的计

算机上使用

predeploy 和 predeployall 命令。

如果未指定

-Dwork_dir 参数，WDeploy 命令将准备要在

Web 应用程序服务器上部署的 Web 应用程序，并

在

BIP 安装目录/sap_bobj/enterprise_xi40/wdeploy/workdir/

<应用程序服务器> /application

中创建

WAR 或 EAR 文件。

2. 执行特定于

Web 应用程序服务器的手动部署过程。

现在可以在

Web 应用程序服务器上手动部署 Web 应用程序。

对需要安装的任何其他

Web 应用程序重复这些步骤。

5.1.1

JBoss 7.1 管理控制台手动部署

确保该

Web 应用程序服务器已安装和配置，且正在运行（基于用户所在环境采用独立或域模式）。使用 wdeploy predeploy 命令创建可以手动部署到 JBoss 的 WAR 文件（例如 BOE.war 或 AdminTools.war）： wdeploy.sh jboss7 -DAPP=BOE predeploy

72

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

wdeploy predeploy 命令会为 Web 服务 Web 应用程序（名为 dswsbobje.war 和

BusinessProcessBI.war 的文件夹）创建一个分离 WAR 文件结构。例如： jboss7

application

dswsbobje.war

axis2-web

images

META-INF

WEB-INF

一旦创建了

WAR 文件，在使用 JBoss 命令行界面（CLI）部署到 JBoss 之前，请先将其复制到新位置。

1. 从

JBoss bin 目录中，运行 jboss-cli --connect 命令以启动 JBoss CLI 及与应用程序服务器连接。

2. 在压缩的

WAR 文件或分离的 WAR 文件夹上运行 /deployment 命令。如果要部署到管理域中，应同时运行 / server-group 命令。

在以下示例中，假设

WAR 存储在 /BIPwebapps/ 中，且服务器组名为 main-server-group。

○ 对于压缩的 .war 文件（如 BOE.war），请将“存档”值设为 true：

独立服务器：

/deployment=BOE.war:add(enabled="true",runtimename="BOE.war",content=[{"path"=>"/BIPwebapps/BOE.war","archive"=>true}])

管理域：

/deployment=BOE.war:add(runtime-name="BOE.war",content=[{"path"=>"/

BIPwebapps/BOE.war","archive"=>true}])

/server-group=main-server-group /deployment=BOE.war:add(enabled=true)

○ 对于分离的 .war 文件结构（如 dswsbobje.war），请将“存档”值设为 false：

独立服务器：

/deployment=dswsbobje.war:add(enabled="true",runtimename="dswsbobje.war",content=[{"path"=>"/BIPwebapps/ dswsbobje.war","archive"=>false}])

管理域：

/deployment=dswsbobje.war:add(runtimename="dswsbobje.war",content=[{"path"=>"/BIPwebapps/ dswsbobje.war","archive"=>false}])

/server-group=main-server-group /deployment=dswsbobje.war:add(enabled=true)

指示成功部署的消息在完成后显示：{"结果" => "成功"}

使用管理员帐户登录到

JBoss “管理控制台”

Web 界面（位于 http://

<WAS_HOSTNAME>

:9990/console），以

确认应用程序正在运行。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

73

5.1.2

SAP NetWeaver 技术平台

5.1.2.1

在

SAP NetWeaver 技术平台上部署的先决条件

注意

如果服务器上存在任何现有

SAP BusinessObjects Business Intelligence 平台 Web 应用程序，则必须先取

消部署这些应用程序，然后才能继续操作。

在将

BI 平台 Web 应用程序部署至 SAP NetWeaver Application Server 组件（任一版本）之前，必须确

保

.html 和 .htm 文件从未压缩过。 例如，在 SAP NetWeaver AS 组件 7.3 中：

1. 登录您的

SAP Administrator 门户。

例如：http://<服务器名>:50200/nwa

2. 导航至：

“Configuration”（配置） “Infrastructure”（基础设施） “Java System Properties”（Java 系统

属性） 。

3. 在

“Services”

（服务）选项卡上，选择

“HTTP provider”

（

HTTP 提供程序）。

4. 在 “Extended Details”

（扩展详细信息）下，按如下方式修改

“AlwaysCompressed”

（始终压缩）和

“NeverCompressed”

（从未压缩）属性：

○

AlwaysCompressed

（始终压缩）：

从此属性中删除 *.htm、*.html、text/html。 此字段不能留

空，如果没有内容，请输入一个空格。

○

NeverCompressed

（从未压缩）：

为此属性添加 *.htm、*.html、text/html。

表

12： 示例

名称

AlwaysCompressed

NeverCompressed

默认的计算所得值

（如果没有内容，则设置空格。）

*.htm、*.html、text/html

5. 在退出之前保存更改。

5.1.2.2

将

SAP BusinessObjects Explorer 部署到 SAP

NetWeaver 技术平台之前需要进行的配置

将

BI 平台 Web 应用程序（explorer）部署到 SAP NetWeaver 技术平台之前，必须在 /WEB-INF/ classes/default.settings.properties 文件中将 disable.compression.filter 属性设置为 true。

默认情况下，该值将设置为

false。 在以下位置修改 default.settings.properties：

●

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps/explorer/WEB-INF/classes/

●

注意

Wdeploy 工具不支持从

SAP NetWeaver 技术平台部署或取消部署。 必须使用 WDeploy 工具的 predeploy

或

predeployall 命令创建 SCA 文件，并使用 SAP Software Update Manager（SUM）执行手动部署。 有关

74

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

如何手动部署到

SAP NetWeaver 技术平台的详细说明，请参阅

使用

SAP Software Update Manager (SUM) 部

署

SAP NetWeaver 技术平台

[第 75 页]。

5.1.2.3

使用

SAP Software Update Manager (SUM) 部署

SAP NetWeaver 技术平台

确保该

Web 应用程序服务器已安装和配置，且正在运行。 使用 wdeploy predeploy 命令创建可以手动部署

到

SAP NetWeaver 技术平台的 SCA 包（例如 BOE.sca 和 AdminTools.sca）。 wdeploy.sh sapappsvr73 -DAPP=BOE predeploy

需要使用

SAP Software Update Manager (SUM) 将 Web 应用程序部署到 SAP NetWeaver 技术平台。 从以下

位置下载

SUM：

http://service.sap.com/swdc >

“Support Packages and Patches”（支持包和修补程序）

>

“A – Z Index”

（

A

–Z 索引）> “S”(S)

>

“SL Toolset <版本>”

>

“Entry by Component”

（按组件查看）

>

“Software Update Manager

(SUM)

”

。

在承载

SAP NetWeaver 技术平台并对即将部署的 SCA 包具有网络访问权限的系统上安装 SUM。

1. 使用以下命令解压

Software Update Manager 软件包：

SAPCAR - xvf <下载目录>\<路径>\<存档>.SAR -R <SAPNW 安装目录>:\usr\sap\<sapsid>

2. 运行 predeploy 或 predeployall 命令生成 SCA 文件。

生成的

BI 平台 Web 应用程序位于：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/sapappsvr73/application

3. 将所有

SCA 文件复制到以下文件夹：

<SAPNW 安装目录>/usr/sap/Trans/EPS/in

4. 启动

SAP NetWeaver 应用程序服务器组件。

5. 使用 <SID>ADM 用户，按照以下命令启动 Software Update Manager 服务器流程：

<SAPNW 安装目录>:\<update directory>\STARTUP

6. 通过在浏览器中输入 http://<主机名>:4239 或在本机运行以下命令，启动 SUM 的 GUI：

<SAPNW 安装目录>:\usr\sap\<sapsid>\SUM\sdt\exe\DSUGui

7. 根据系统提示创建一个临时管理员用户以执行维护过程。 请参阅

SAP Service Marketplace 上的 SUM 指南中

的

“Update of SAP Systems Using Software Update Manager 1.0 SP08”（使用 Software Update Manager 1.0

SP08 更新

SAP 系统）。

8. 在

“Select Target”

（选择目标）路线图步骤中得到提示时，请使用

SUM 选项 “Manually Prepared Download

Directory

”

（手动准备的下载目录）。

9. 导航以选择

<SAPNW 安装目录> \usr\sap\Trans\EPS\in，并单击

“Next”

（下一步）。

10. 执行更新程序，直到完成部署并显示确认选项卡。 有关详细信息，请参阅最新的 ProcessOverview.html

报告，该报告位于： <SAPNW 安装目录> :\usr\sap\

<sapsid>

\SUM\sdt\htdoc。

有关

Software Update Manager 的更多信息，请参阅位于

http://help.sap.com

的用户指南和其他文档。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

75

注意

如果在访问成功部署的应用程序（如

CMC）时发生 HTTP 或会话错误，请等待几分钟，然后尝试重新刷新页

面。

5.1.3

Tomcat 6 和

7 管理控制台手动部署

确保该

Web 应用程序服务器已安装和配置，且正在运行。使用 wdeploy predeploy 命令创建可以手动部署

到

Tomcat 的 WAR 文件（例如 BOE.war 和 AdminTools.war）： wdeploy.sh tomcat7 -DAPP=BOE predeploy

1. 登录到位于 http://

<WAS_HOSTNAME>

:

<PORT>

/manager/html 的

Tomcat 管理器

的管理控制台应用程

序。

默认端口号为

8080。

2. 设置要部署的

Web 应用程序的 “Context Path”

（上下文路径）。

上下文路径必须是

WAR 文件的名称，但不含其扩展名，并且前面带有一个正斜线。例如，要部署打包为

<YOUR_WEB_APPLICATION>

.war 的 Web 应用程序，上下文路径必须为 /

<YOUR_WEB_APPLICATION>

。

3. 将

“XML Configuration File”

（

XML 配置文件）设置设定为包含上下文路径和文档基的

XML 文件的位置。

文档基是使用

wdeploy predeploy 命令创建的预部署 WAR 文件。例如：

<Context

docBase="<BOE_INSTALL_DIR>/sap_bobj/enterprise_xi40/wdeploy/workdir/tomcat7/ application/

<YOUR_WEB_APPLICATION>

.war"

path="<context_path>"

crossContext="false" debug="0" reloadable="false" trusted="false"

/>

4. 输入

WAR 文件的完整路径，然后按 “Deploy”

（部署）。

WAR 文件即被部署。

5.1.3.1

部署到

Tomcat 群集

要将

Web 应用程序手动部署到分布在多台计算机中的 Tomcat Web 应用程序群集，请将这些 Web 应用程序部

署到每个

Tomcat Web 应用程序服务器。请使用管理控制台将 Web 应用程序部署到每个服务器实例的 Tomcat 主

目录内的

webapps 子文件夹中。

注意

使用

Tomcat 时，请在发出 wdeploy undeployall 操作命令前停止 Web 应用程序服务器。

提示

如果在

Tomcat Web 应用程序群集上运行 BI 平台 Web 应用程序，则建议安装并配置硬件负载平衡器或软件

负载平衡器。有关在

Tomcat 群集上设置负载平衡的信息，请参见 Tomcat 文档。

76

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

5.1.4

WebLogic 11gR1 管理控制台手动部署

部署前，请确保该

Web 应用程序服务器已安装和配置，且正在运行。 创建要在其中运行 BI 平台 Web 应用程序

的

WebLogic 域。

使用

wdeploy predeploy 命令创建可以手动部署到 WebLogic 的 WAR 文件（例如 BOE.war 和

AdminTools.war）： wdeploy.sh weblogic11 -DAPP=BOE predeploy

注意 wdeploy predeploy 命令会为 Web 服务 Web 应用程序（dswsbobje 和 BusinessProcessBI）创建一

个未打包的文件夹结构，而不会创建一个

WAR 文件。 例如： weblogic11

application

dswsbobje

dswsbobje

axis2-web

images

META-INF

WEB-INF

lib

META-INF

Resources

部署到

WebLogic 时，必须选择第二层 dswsbobje 或 BusinessProcessBI 文件夹。

1. 使用

Web 浏览器登录到 “WebLogic Server Administrative Console”

（

WebLogic 服务器管理控制台）（位于： http:// <WAS 主机名> : <端口> /console）。

默认端口号为

7001。

将显示

“WebLogic Server Administration Console”

（

WebLogic 服务器管理控制台）网页。

2. （可选）在

“Change Center”

（更改中心）面板上，单击

“Lock & Edit”

（锁定并编辑）。

仅当域配置锁定时（如在生产环境中）才需要执行此步骤。

3. 在

“Domain Structure”

（域结构）面板上，单击

“Deployments”

（部署）。

4. 在 “Summary of Deployments”

（部署摘要）页面上，单击

“Install”

（安装），然后在

Install Application

Assistant

（安装应用程序助手）页面上导航到

WAR 文件或文件夹路径：

选项 说明

WAR 文件（例如

BOE.war

）

选择

WAR 文件的路径。 例如：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/ weblogic11/application/BOE.war

文件夹结构（例如

dswsbobje

）

选择文件夹结构的路径。

例如：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/workdir/ weblogic11/application/dswsbobje/dswsbobje

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

77

选项 说明

注意

部署到

WebLogic 时，必须选择第二层 dswsbobje 或 BusinessProcessBI 文

件夹。

单击

“Next”

（下一步）。

5. 选择

“Install this deployment as application”

（将此部署安装为应用程序）并单击

“Next”

（下一步）。

在向导中

查看并提供任何附加参数后，单击

“Finish”

（完成）。

6. （可选）在

“Change Center”

（更改中心）面板上，单击

“Activate Changes”

（激活更改）将更改应用到

Web

应用程序服务器。

仅当域配置锁定时（如在生产环境中）才需要执行此步骤。

在

Web 浏览器中打开 Web 应用程序以确认此应用程序正在运行。

5.1.5

WebSphere 7.0 和

8.5 管理控制台手动部署

5.1.5.1

WebSphere 7.0 管理控制台手动部署

确保该

Web 应用程序服务器已安装和配置，且正在运行。使用 wdeploy predeploy 命令创建可以手动部署

到

WebSphere 的 EAR 文件（例如 BOE.ear 和 AdminTools.ear）： wdeploy.sh websphere7 -DAPP=BOE predeploy

如果要部署

BOE 应用程序或所有 Web 应用程序中部署，请提高超时设置以免出现超时消息和部署失败（请参阅

更改

WebSphere 7.0 或 8.5 部署超时设置 [第 81 页]）。

1. 使用管理员帐户登录到

WebSphere “Integrated Solutions Console”

（集成解决方案控制台）（位于： http://

<WAS_HOSTNAME>

:

<PORT>

/ibm/console）。

默认端口号为

9060。

2. 在菜单中选择

“Applications”（应用程序） “Application Types”（应用程序类型） “WebSphere

enterprise applications

”（WebSphere 企业级应用程序）

。

将出现

“Enterprise Applications”

（企业级应用程序）屏幕。

3. 单击

“Install”

（安装）。

在

“Preparing for the application installation”

（准备安装应用程序）屏幕中，将出现

“Path to the new

application

”

（新应用程序的路径）。

4. 单击

“Browse”

（浏览）并选择

Web 应用程序的 EAR 文件。

Web 应用程序

EAR 文件的绝对路径将出现在 “Full Path”

（完整路径）字段中。

5. 进入下一个屏幕。

将出现

“How do you want to install the application?”（请选择应用程序的安装方式）

屏幕。

6. 接受默认选项

“Fast Path”

（快速路径），然后进入下一个屏幕。

在

“Install New Application”

（安装新应用程序）屏幕中，出现

“Step 1: Select install options”

（步骤

1：选择安

装选项）。

78

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

7. 接受默认选项，然后进入下一个屏幕。

将出现

“Step 2: Map modules to servers”

（步骤

2：将模块映射到服务器）屏幕。

8. 接受默认选项，然后进入下一个屏幕。

将出现

“Step 3: Summary”

（步骤

3：摘要）屏幕。

9. 查看摘要，然后单击

“Finish”

（完成）。

Web 应用程序即被安装并显示一条主配置更改确认消息。

10. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Enterprise Applications”

（企业级应用程序）屏幕。请注意，

Web

应用程序尚未运行。

11. 从已部署应用程序（管理资源）的列表中选择

Web 应用程序。

将出现

“Configuration”

（配置）屏幕。

12. 单击

“Manage Modules”

（管理模块）。

将出现

“Manage Modules”

（管理模块）屏幕。

13. 选择

Web 应用程序模块（在 “Module”

（模块）列中）。

将出现

“Manage Modules General Properties”

（管理模块常规属性）屏幕。

14. 从

“Class loader order”

（类加载程序顺序）属性中选择

“Classes loaded with local class loader first (parent

last)

”

（通过本地类加载程序加载的类优先（父类最后））。

将出现确认消息。

15. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Manage Modules”

（管理模块）屏幕。

16. 单击

“确定”

。

将出现主配置更改确认消息。

17. 单击

“Class loading and update detection”

（类加载和更新检测）。

显示

“Class loader”

（类加载程序）配置屏幕。

18. 在

“Polling interval for updated files”

（更新文件的轮询间隔时间）框中输入所需轮询间隔时间，然后单击

“OK”

（确定）。

将出现主配置更改确认消息。

19. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Enterprise Applications”

（企业级应用程序）屏幕。

20. 选中

Web 应用程序复选框并单击 “启动”

。

将出现一条消息确认

Web 应用程序已成功启动。

Web 应用程序完成部署和配置，现已启动。使用上面提供的根上下文测试

Web 应用程序。对每个 Web 应用程序

重复以上步骤。

5.1.5.2

WebSphere 8.5 管理控制台手动部署

确保该

Web 应用程序服务器已安装和配置，且正在运行。使用 wdeploy predeploy 命令创建可以手动部署

到

WebSphere 的 EAR 文件（例如 BOE.ear 和 AdminTools.ear）： wdeploy.sh websphere8 -DAPP=BOE predeploy

如果要部署

BOE 应用程序或所有 Web 应用程序中部署，请提高超时设置以免出现超时消息和部署失败（请参阅

更改

WebSphere 7.0 或 8.5 部署超时设置 [第 81 页]）。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

79

1. 使用管理员帐户登录到

WebSphere “Integrated Solutions Console”

（集成解决方案控制台）（位于： http://

<WAS_HOSTNAME>

:

<PORT>

/ibm/console）。

默认端口号为

9060。

2. 在菜单中选择

“Applications”（应用程序） “Application Types”（应用程序类型） “WebSphere

enterprise applications

”（WebSphere 企业级应用程序）

。

将出现

“Enterprise Applications”

（企业级应用程序）屏幕。

3. 单击

“Install”

（安装）。

在

“Preparing for the application installation”

（准备安装应用程序）屏幕中，将出现

“Path to the new

application

”

（新应用程序的路径）。

4. 单击

“Browse”

（浏览）并选择

Web 应用程序的 EAR 文件。

Web 应用程序

EAR 文件的绝对路径将出现在 “Full Path”

（完整路径）字段中。

5. 进入下一个屏幕。

将出现

“How do you want to install the application?”（请选择应用程序的安装方式）

屏幕。

6. 接受默认选项

“Fast Path”

（快速路径），然后进入下一个屏幕。

在

“Install New Application”

（安装新应用程序）屏幕中，出现

“Step 1: Select install options”

（步骤

1：选择安

装选项）。

7. 接受默认选项，然后进入下一个屏幕。

将出现

“Step 2: Map modules to servers”

（步骤

2：将模块映射到服务器）屏幕。

8. 选择要部署的模块，转到下一屏幕。

将出现

“Step 3: Summary”

（步骤

3：摘要）屏幕。

9. 查看摘要，然后单击

“Finish”

（完成）。

Web 应用程序即被安装并显示一条主配置更改确认消息。

10. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Enterprise Applications”

（企业级应用程序）屏幕。请注意，

Web

应用程序尚未运行。

11. 从已部署应用程序（管理资源）的列表中选择

Web 应用程序。

将出现

“Configuration”

（配置）屏幕。

12. 单击

“Manage Modules”

（管理模块）。

将出现

“Manage Modules”

（管理模块）屏幕。

13. 选择

Web 应用程序模块（在 “Module”

（模块）列中）。

将出现

“Manage Modules General Properties”

（管理模块常规属性）屏幕。

14. 从

“Class loader order”

（类加载程序顺序）属性中选择

“Classes loaded with local class loader first (parent

last)

”

（通过本地类加载程序加载的类优先（父类最后））。

将出现确认消息。

15. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Manage Modules”

（管理模块）屏幕。

16. 单击

“确定”

。

将出现主配置更改确认消息。

17. 单击

“Class loading and update detection”

（类加载和更新检测）。

显示

“Class loader”

（类加载程序）配置屏幕。

18. 在

“Polling interval for updated files”

（更新文件的轮询间隔时间）框中输入所需轮询间隔时间，然后单击

“OK”

（确定）。

将出现主配置更改确认消息。

80

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

19. 单击

“Save directly to the master configuration”

（直接保存到主配置）。

Web 应用程序配置即被保存，然后返回到

“Enterprise Applications”

（企业级应用程序）屏幕。

20. 选中

Web 应用程序复选框并单击 “启动”

。

将出现一条消息确认

Web 应用程序已成功启动。

Web 应用程序完成部署和配置，现已启动。使用上面提供的根上下文测试

Web 应用程序。对每个 Web 应用程序

重复以上步骤。

5.1.5.3

更改

WebSphere 7.0 或 8.5 部署超时设置

将

BI 平台 Web 应用程序部署到 WebSphere 7、8.5 或 8.5.5 Web 应用程序服务器可能需要一些时间。

如果在将

Web 应用程序部署到 WebSphere 7、8.5 或 8.5.5 时收到超时消息，可以延长部署超时设置。

1. 使用文本编辑器编辑配置文件 deployment.xml。 deployment.xml 的位置将会不同，具体取决于服务器的

安装和配置方式。 deployment.xml 配置文件通常位于

<DEPLOYMENT_CELL>

/applications/isclite.ear/ deployments/isclite/deployment.xml 中。

使用部署服务器单元名称替代

<DEPLOYMENT_CELL>

。

例如，如果单元名称为

NetworkDeploymentCell01，则 deployment.xml 的完整路径为 /opt/ibm/

WebSphere/AppServer/profiles/Dmgr01/config/cells/NetworkDeploymentCell01/ applications/isclite.ear/deployments/isclite/deployment.xml。

2. 将属性 invalidationTimeout 设置为所需值，以分钟为单位，其中最大值为 -1（无超时）。

3. 保存 deployment.xml。

4. 重新启动

WebSphere 服务。

已更改

WebSphere 超时设置。

5.1.5.4

部署到

WebSphere 群集

要将

BI 平台 Web 应用程序手动部署到分布于多台计算机上的 WebSphere Web 应用程序群集，需要将 Web 应

用程序部署到承载

WebSphere Deployment Manager 的计算机上。 在安装了所有必需的 Web 应用程序之后，可

以使用

WebSphere Integrated Solutions Console（集成解决方案控制台）单独将这些应用程序部署到群集中。

提示

如果在

WebSphere Web 应用程序群集上运行 BI 平台 Web 应用程序，则建议安装并配置硬件负载平衡器或

软件负载平衡器。

要配置负载平衡器和群集设置，请参见

WebSphere 文档。

要将

Web 应用程序部署到 WebSphere 群集，请使用以下常规工作流：

1. 如果

BI 平台安装在承载 WebSphere Deployment Manager 的计算机上，请跳至第 3 步。如果 BI 平台和

WebSphere Deployment Manager 在不同的计算机上运行，请先将

WDeploy 工具和环境复制到承载

WebSphere 管理服务器的计算机。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

81

2. 修改位于

<BIP 安装目录> \SAP BusinessObjects Enterprise XI 4.0\wdeploy\conf 中的 config.websphere

<X>

文件。

需要提供管理服务器的信息。

例如： as_dir=C:\Program Files\IBM\WebSphere\AppServer as_soap_port=8779 as_virtual_host=default_host as_admin_is_secure=false enforce_file_limit=true

3. 打开命令行控制台，并运行以下命令： wdeploy.sh websphere7 predeployall

注意

如果是

WebSphere 8.5 或 8.5.5，请使用 websphere8。

4. 打开

WebSphere Integrated Solutions Console（集成解决方案控制台）。

5. 转至

“Applications（应用程序）” “Enterprise Applications”（企业级应用程序）

，以单独安装要从以下

目录进行部署的每个

Web 应用程序：

<BIP 安装目录> \SAP BusinessObjects Enterprise XI

4.0\wdeploy\workdir\websphere

<X>

\application\

注意

所有

Web 应用程序被存储为 EAR 模块。

6. 在控制台中执行

“安装新应用程序”步骤以安装 Web 应用程序

注意

在

“Map modules to servers”

（将模块映射到服务器）中，确保先突出显示目标群集并选择要安装的模块，

然后单击

“Apply”（应用）。

7. 安装应用程序后，单击

“Save”

（保存）。

8. 对要安装的每个

EAR 文件重复步骤 5 到 7。

9. 转至

“System administration”（系统管理） “Nodes”（节点）

，并选择群集中未指明为同步的所有节点

10. 单击

“Synchronize”

（同步）。

11. 对于群集中的每个应用程序服务器，转到

“Servers”（服务器） “Application servers”（应用程序服务器）

“<app_server_name>”（<应用程序服务器名称>） “Session management”（会话管理） “Distributed

environment settings

”（分布式环境设置） “Tuning parameters”（微调参数） “Custom tuning

parameters

”（自定义微调参数）

并从

“Write contents”

（写内容）属性中选择

“All session attributes”

（所有

会话属性）。

“Write contents”

（写内容）属性必须设置为

“All session attributes”

（所有会话属性），以确保实现

Web 应用

程序的适当故障转移。

如果未使用自定义设置，请确保为部署使用适当微调级别，例如

“High”

（高）或

“Low”

（低），以便将此属性设置为

“All session attributes”

（所有会话属性）。

12. 转至

“Applications”（应用程序） “Enterprise Applications”（企业级应用程序）

以启动刚安装的应用程

序。

82

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

使用管理控制台部署

Web 应用程序

6

已知问题和解决方法

6.1 wdeploy.sh 脚本中的

Windows 行结束符

将

wdeploy.sh 脚本从 Windows 计算机复制到 Unix 或 Linux 系统时，其中可能会包含 Windows DOS 行结束

符。

要解决此问题，请使用文本编辑器或类似于

dos2unix 的实用程序，将 wdeploy.sh 中的 Windows DOS 行结

束符（回车符、换行符）转换为

Unix 行结束符（回车符）。

6.2 重命名

BOE Web 应用程序或 Web 应用程序源树

重命名

BI 平台 Web 应用程序源树文件夹时，WDeploy 工具可能无法对其进行部署。 在所有支持的平台上都可

能发生这种情况。

源树文件夹路径为：

<BIP 安装目录> /enterprise_xi40/warfiles/webapps

要解决此问题，请按照以下步骤操作：

1. 在如下位置中找到

BOE Web 应用程序配置文件 BOE.properties：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/conf/apps

2. 重命名 BOE.properties，使其反映 Web 应用程序 WAR 文件的新名称。

例如，如果要将

Web 应用程序从 BOE 重命名为 MYBOE，并且已经将 BOE.war 重命名为 MYBOE.war，请将

BOE.properties 重命名为 MYBOE.properties。

3. 使用文本编辑器更新新命名的 .properties 文件的内容。 更新配置文件中的 Web 应用程序信息。

#Business Objects Configuration Utility

#BOE specific properties warfile=

<WEB_APP_NAME>

.war

appvdir=

<WEB_APP_NAME>

buildfile=

<WEB_APP_NAME>

.xml

osgisupported=true

例如，如果想要将

Web 应用程序从 BOE 重命名为 MYBOE，请将上面的

<WEB_APP_NAME>

替换为 MYBOE。

4. 重命名 BOE.xml，使其反映 Web 应用程序 WAR 文件的新名称。

例如，如果要将

Web 应用程序从 BOE 重命名为 MYBOE，并且已经将 BOE.war 或 BOE.ear 重命名为

MYBOE.war 或 MYBOE.ear，请将 BOE.xml 重命名为 MYBOE.xml。

现在，

WDeploy 工具可以将新命名的

Web 应用程序部署到 Web 应用程序服务器。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

83

6.3 在纯

IPv6 环境中使用 WDeploy

如果在包含

Oracle Java 开发工具包（JDK）的纯 IPv6 环境中使用 wdeploy 命令，Oracle JDK 可能不允许

Web 应用程序服务器绑定到

IPv6 地址，从而导致 wdeploy 命令失败。

这是因为

Oracle JDK 在默认情况下使用 IPv4 地址。请更改 Oracle JDK 设置，方法是在您所在环境或启动脚本

中设置

JAVA_OPTIONS 变量，这样 Java 就可以使用 IPv6 地址：

JAVA_OPTIONS="-Djava.net.preferIPv6Addresses=true"

例如，在

WebLogic Web 应用程序服务器上，将 JJAVA_OPTIONS="-

Djava.net.preferIPv6Addresses=true" 添加到 setDomainEnv.sh 或 setDomainEnv.cmd 脚本中。

重新启动

Web 应用程序服务器，使用 hosts 文件中的 ::1 或 localhost 别名验证连接。

6.4 分离

Web 层服务器的 Web 服务

分离

Web 层部署不支持 Web 服务 Web 应用程序（dswsbobje.war）。 分离 Web 层部署已分离 Web 和

Web 应用程序服务器。

WDeploy 将把 Web Services Web 应用程序作为独立 Web 应用程序处理，即使是在分离

Web 层部署中也是这样。

6.5 在

WDeploy 中使用非英语语言时应注意的问题

在

WDeploy 工具中使用非英语语言时：

● WDeploy GUI 工具不支持 config.

<WEB_APP_SERVER>

配置文件的服务器管理用户名或密码参数中存在

非英语字符。

● 在 Windows 上，WDeploy GUI 和命令行工具在传递包含 UTF-8 字符的非英语文件路径时可能会失败并出

现异常。

日志文件表明路径包含无效字符，找不到路径。

6.6 未从服务器中删除的

Web 应用程序

如果

WDeploy undeploy 或 undeployall 命令未能删除 Web 应用程序，请使用管理控制台停止所有 Web 应用

程序并重新启动服务器，然后重新运行

undeploy 或 undeployall 命令。

84

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

6.7 在

Red Hat Linux Enterprise 服务器上启动 WDeploy GUI

在已启用

SE Linux 的 Red Hat Linux Enterprise Server 5.1 或 Red Hat Linux Advanced Server 5.x 上启动

WDeploy GUI，会出现以下错误消息：

Can't load 'perl/lib/site_perl/auto/XML/LibXML/Common/Common.so' for module

XML::LibXML::Common:

[...]/perl/extlibs/libz.so.1: cannot restore segment prot after reloc

要解决此问题，请禁用

SE Linux：

1. 使用根权限运行 /usr/sbin/setenforce 0。

例如： sudo /usr/bin/setenforce 0

2. 更新配置文件 /etc/sysconfig/selinux 将 SELINUX 参数设置为 “已禁用”。

例如：

SELINUX=disabled

3. 重新启动系统。

WDeploy GUI 现在可以正常启动。

6.8 执行

Web 层安装后，复制 MobileOTA14.properties

如果计划使用

BI 平台 Mobile 支持，并且已经执行 Web 层安装，则必须将 MobileOTA14.properties 文件

复制到接收

Web 层安装的主机（最可能是 Web 应用程序服务器）。

要将

MobileOTA14.properties 复制到接收 Web 层安装的主机，请使用以下步骤。

1. 在接收

BI 平台 “完整”

或

“定制/扩展”

安装的主机上，找到

MobileOTA14.properties。

文件

MobileOTA14.properties 的路径为：

<BIP 安装目录> /enterprise_xi40/wdeploy/conf/apps

2. 将 MobileOTA14.properties 复制到接收 Web 层安装的主机上的对应路径。

6.9 WDeploy GUI 工具中的

“取消”按钮

在

Web 应用程序服务器上部署 Web 应用程序时，按下 WDeploy “取消”

按钮不会删除

Web 应用程序或已经复制

到

Web 应用程序服务器上的支持文件。

要解决此问题，需要手动取消部署或从

Web 应用程序服务器上删除这些文件。对于一些 Web 应用程序服务

器，

“取消”

按钮可能会禁用。这是用于部署的

JDK 的已知限制。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

85

6.10 JBoss

6.10.1 将

AdminTools、dswsbobje 或 BusinessProcessBI 应

用程序部署到

JBoss 7.1 时出现安全异常

将

AdminTools、dswsbobje 或 BusinessProcessBI Web 应用程序部署到 JBoss 7.1 时，可能会遇到以下

错误： java.lang.SecurityException: Toolkit not encapsulated by a jar.

此错误是由

RSA 库引发的。 要解决该问题，必须在预部署和部署 Web 应用程序之前更改 Web 应用程序源文件和

JBoss 应用程序服务器。 下面的示例使用 AdminTools 应用程序。 对 dswsbobje 和 BusinessProcessBI 应

用程序执行相同步骤：

1. 从以下

WDeploy RSA 模块目录中复制所有文件：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/rsa_module

2. 在

JBoss 应用程序服务器的 modules\com 下，创建 rsa\main 目录并粘贴第 1 步中复制的所有文件：

<JBOSS 安装目录> /modules/com/rsa/main

3. 从以下位置移动 jboss-deployment-structure.xml 文件：

<JBOSS 安装目录> /modules/com/rsa/main

并将文件放在以下

AdminTools 源文件目录中：

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps/AdminTools/WEB-INF

4. 从 AdminTools 源文件中删除 RSA JAR 文件 certjFIPS.jar、cryptojFIPS.jar 和 ssljFIPS.jar：

<BIP 安装目录> /sap_bobj/enterprise_xi40/warfiles/webapps/AdminTools/WEB-INF/lib

5. 使用

WDeploy 工具预部署已修改的 AdminTools Web 应用程序。 例如： wdeploy jboss7 predeploy -DAPP=AdminTools

6. 使用

JBoss 命令行界面（CLI）部署已修改的 AdminTools WAR 文件。 有关使用 CLI 的示例，请参阅

JBoss 7.1 管理控制台手动部署

[第 72 页]。

6.11 SAP NetWeaver 技术平台

6.11.1 使用

SUM 部署到 SAP NetWeaver 技术平台时显示的服务

级别、修补程序级别和名称参数不正确

使用

SAP Software Update Manager (SUM) 将 BI 平台 4.0 支持包 1 或更高版本的 Web 应用程序部署到 SAP

NetWeaver 应用程序服务器组件时，servicelevel、patchlevel 和 scn 参数可能会显示不正确的值并需要纠

正。

要解决此问题，请确保每个

Web 应用程序捆绑包的 SAP_metadata.Properties 文件都将其参数设置为以

下值：

86

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

● servicelevel 和 patchlevel 参数必须与所应用的实际支持包和修补程序版本相匹配。 例如：

○ 对于支持包 1，将 servicelevel 设置为 1，patchlevel 设置为 0。

○ 对于支持包 2 修补程序 1，将 servicelevel 设置为 2，patchlevel 设置为 1。

● scn 和 name 参数必须具有相同的值。 例如，如果 name 属性设置为值 BOEWEBAPPJAVA，则 scn 属性必

须也设置为

BOEWEBAPPJAVA。

不同

Web 应用程序捆绑包的 SAP_metadata.Properties 文件可在以下位置找到：

● BOE.sca：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/SLDSupport/NWSLD/BOE

● dswsbobje.sca：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/SLDSupport/

NWSLD/dswsbobje

● BusinessProcessBI.sca（不赞成使用）：

<BIP 安装目录> /sap_bobj/enterprise_xi40/ wdeploy/SLDSupport/NWSLD/BusinessProcessBI

● MobileOTA14.sca：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/SLDSupport/

NWSLD/MobileOTA14

● OpenSearch.sca：

<BIP 安装目录> /sap_bobj/enterprise_xi40/wdeploy/SLDSupport/

NWSLD/OpenSearch

6.11.2 WDeploy 工具不支持从

SAP NetWeaver 技术平台部署或

取消部署

WDeploy 工具不支持从

SAP NetWeaver 技术平台部署或取消部署。 必须使用 WDeploy 工具的 predeploy 或 predeployall 命令来创建 SCA 文件，并使用 SAP Software Update Manager (SUM) 执行手动部署。 有关如何

手动部署到

SAP NetWeaver 技术平台的详细说明，请参阅

使用

SAP Software Update Manager (SUM) 部署 SAP

NetWeaver 技术平台

[第 75 页]。

6.12 Tomcat

6.12.1 使用

WDeploy 从 Tomcat 取消部署 Web 应用程序

如果

Tomcat Web 应用程序服务器尚未关闭且仍在使用，在此 Web 应用程序服务器上执行 wdeploy undeploy 命令可能会出错。要解决此问题，请在尝试运行 wdeploy undeploy 命令之前关闭 Tomcat Web 应

用程序服务器。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

87

6.12.2 运行

WDeploy 之后，Tomcat 可能不会立即加载 Web 应

用程序

如果使用非默认的上下文路径，则

Tomcat 上可能不会立即加载使用 WDeploy 工具新部署的 Web 应用程序。

请重启

Tomcat 使所做更改生效。

6.13 WebLogic

6.13.1 从

WebLogic 取消部署 Web 服务

wdeploy undeploy 或 wdeploy undeployall 命令可能无法从 WebLogic 10.3.x Web 应用程序服务器中

删除

BusinessProcessBI 或 dswsbobje Web 服务 Web 应用程序。

要解决此问题，请通过管理控制台停止

BusinessProcessBI 和 dswsbobje Web 应用程序，然后重新启动 Web

应用程序服务器。重新启动

Web 应用程序服务器后，使用 wdeploy undeploy 或 wdeploy undeployall 命

令删除

BusinessProcessBI 和 dswsbobje。

6.14 WebSphere

6.14.1 在安全模式下部署到

WebSphere

将

WDeploy 与启用了安全套接字层（SSL）加密的 WebSphere 安装配合使用时，可能会生成验证错误。 要解

决此问题，请在尝试使用

WDeploy 进行部署之前，使用 wsadmin 命令手动接受 SSL 证书。

例如，将目录更改为

<WEBSPHERE 安装目录> /AppServer/bin，然后运行以下命令：

./wsadmin -conntype SOAP -port

<SOAP_admin_port>

-user

<as_admin_username>

password

<as_admin_password>

将

<SOAP_admin_port>

替换为

WebSphere 使用的端口号（例如 8880），将

<as_admin_username>

替

换为管理员帐户的用户名（例如

admin），将

<as_admin_password>

替换为为

<as_admin_username>

指定

的帐户密码。

按

Y

接受证书，然后继续使用

wdeploy 进行 Web 应用程序部署。

88

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

6.14.2 将

Web 服务部署到 WebSphere 7.0 之后出现内部服务器

错误

将

Web 服务提供者（dswsbobje.war）部署到 WebSphere 7.0 并启用 Axis2 WS 地址解析模块之后，可能会

遇到内部服务器错误。

Web 服务提供者应用程序（dswsbobje.war）构建在包含此模块的

Apache Axis2 Web 服务

框架上。

要解决此问题，可在

BI 平台的默认安装中禁用该地址解析模块。

如果要部署到

WebSphere 7.0 以外的 Web 应用程序服务器，并希望启用 Axis2 WS 地址解析模块，可编辑 axis2.xml 文件并取消 <!--<module ref="addressing"/>--> 行的注释。axis2.xml 文件位于 Web 服务

提供者

WAR 文件中的 /WEB-INF/conf。重新启动 Web 应用程序服务器使更改生效。

6.14.3 WASX7017E： 在

WebSphere 中部署时出现异常

在使用

WebSphere 时，可能会遇到以下异常： com.ibm.websphere.management.exception.ConfigServiceException

com.ibm.websphere.management.exception.ConnectorException

org.apache.soap.SOAPException: [SOAPException: faultCode=SOAP-ENV:Client; msg=Read timed out; targetException=java.net.SocketTimeoutException: Read timed out]

要解决此问题，请尝试修改以下位置中的超时值：

●打开 soap.client.props 文件，并增加或删除通过以下属性设置的 SOAP 连接超时： com.ibm.SOAP.requestTimeout=0 soap.client.props 位于：

<WAS 安装目录> /profiles/ <配置文件> /properties/soap.client.props

●在 WebSphere 的 “Integrated Solutions Console”

（集成解决方案控制台）中，在应用程序服务器的

JMX

SOAP 连接器上增加 requestTimeout 的属性值：

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

89

图

1： （英文示例）

注意

访问

WebSphere 控制台，地址是 http://

<WAS 主机名> : <端口> /ibm/console。 默认端口号为

9060。

90

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

Web 应用程序部署指南

Unix 版 Windows 版

已知问题和解决方法

法律角度的重要免责声明

本文档仅为提供信息之用。 其内容如有变更，恕不另行通知，并且

SAP 不保证其内容准确无误。 SAP 不做任何明示或默示的担保，也不做任何适销性、特定用途适应性的

担保。

编码示例

在本文档中包含的任何软件代码和

/或代码行/字符串（简称 “代码”）仅为示例，并非供在生产性系统环境中使用的。 代码的目的仅在于提供更好的解释和可视化特定编码的

语法和句法规则。

SAP 不担保本文档中所提供的代码的正确性和完整性，并且 SAP 对于由使用代码造成的错误或损害概不负责，除非损害是由 SAP 故意或重大过失造成

的。

辅助功能

SAP 文档中包含的信息代表

SAP 在文档发布之日对辅助功能标准的当前观点，完全不是针对如何确保软件产品的辅助功能方面的具有约束力的准则。 SAP 特别排除针对本

文档的任何责任，并且本文档不形成任何直接或间接的合同义务或承诺。

性别中立语言

SAP 文档尽可能做到性别中立。 依据上下文，或直接用

“您”称呼读者，或使用性别中立的名词（诸如：销售人员或工作日）。 但是，如果需要提及两种性别的成员，而又无

法避免使用第三人称单数形式或不存在性别中立的名词，

SAP 保留使用名词和代词的阳性形式的权利。 这是为确保文档易于理解。

互联网超链接

SAP 文档中可能包含指向互联网的超链接。 这些超链接意在用做查找相关信息的指引。

SAP 不保证此相关信息的可得性和正确性或此信息符合特定需求的能力。 对于使用

相关信息造成的损害， SAP 不应承担任何责任，除非损害是由于

SAP 的重大过失或有意过错行为造成的。 至于链接的分类，请参阅： http://help.sap.com/disclaimer 。 http://help.sap.com/disclaimer .

Web 应用程序部署指南

Unix 版 Windows 版

法律角度的重要免责声明

© 2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

91

www.sap.com/contactsap

©

2014 SAP 股份公司或其关联公司版权所有， 保留所有权利。

未经

SAP 股份公司或其关联公司明确许可，不得以任何形式或为任何

目的复制或传播本文的任何内容。

本文包含的信息如有更改，恕不另

行事先通知。

由

SAP 股份公司及其分销商营销的部分软件产品包含其他软件供应商

的专有软件组件。

各国的产品规格可能不同。

上述资料由

SAP 股份公司或其关联公司提供，仅供参考，不构成任何

形式的陈述或保证，其中如若存在任何错误或疏漏，

SAP 或其关联公

司概不负责。

与

SAP 或 SAP 关联公司产品和服务相关的保证仅限于该

等产品和服务随附的保证声明（若有）中明确提出之保证。

本文中的

任何信息均不构成额外保证。

SAP 和本文提及的其它

SAP 产品和服务及其各自标识均为 SAP 股份公

司（或

SAP 关联公司）在德国和其他国家的商标或注册商标。 提及的

所有其它产品和服务名称均为其各自公司的商标。

如欲了解更多商标信息和声明，请访问： http://www.sap.com/ corporate-en/legal/copyright/index.epx

。