You are on page 1of 200

Machine Translated by Google

OpenText™  外流

通信服务器管理
指导

本指南包含有关如何设置和维护用于运行  Communications  
Server、
服务网关和任务调度程序应用程序的组件和存储库以及如
何部署和运行  Web  应用程序(例如  WorkShop、
StoryBoard、
ReTouch  
和  Supervisor)
的信息。

CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

OpenText™  Exstream  通信服务
器管理指南CCMSYS160400‑AGD‑EN‑01  修订版:
2018  年  4  月  13  日

本文档是为软件版本  16.4  创建的。
只要产品随附没有新的文档版本或在https://knowledge.opentext.com  上发布,
它也适用于后续软件版本。

开放文本公司

275  Frank  Tompa  Drive,  滑铁卢,  安大略省,  加拿大,  N2L  0A1

电话: +1‑519‑888‑7111  
加拿大/美国免费电话: 1‑800‑499‑6544  国际: +800‑4996‑5440  传真:
+1‑519‑888‑0677  支持:  https://support.opentext .com欲了解更多信息,
请访问https://www.opentext.com

版权所有  ©  2018  开放文本。
版权所有。

开放文本拥有的商标。

免责声明

无保证和责任限制

已尽一切努力确保本出版物中介绍的功能和技术的准确性。
但是,
Open  Text  Corporation  及其附属公司对本出版物的准确性不承担任何责任,
也不提供任何
明示或暗示的保证。
Machine Translated by Google

目录
第  1  部分  入门 11

1 租赁概念 .................................................... .....................  13

2 需要哪些组件才能开始? .....................  15

3 步骤清单  –  设置  Exstream  环境.....  19

4 为  Exstream  设置  OTDS ................................................... ..  21
4.1 访问控制概念 ................................................... .....................  21
4.2 选项和建议 ................................................... ............  24
4.2.1 选项  1  –  单独的  OTDS  后端 .................................................... ...  25
4.2.2 选项  2  –  单一  OTDS  后端 .................................................... ......  26
4.2.3 选项  3     单租户  Exstream  环境 ...................................................  27
4.3 OTDS  配置要求 ................................................... .....  28
4.4 分配访问角色 ................................................... .....................  31
4.5 示例  –  为  Exstream  设置  OTDS ....................................................  34
4.5.1 示例:
安装  OTDS ................................................... .....................  35
4.5.2 示例:
配置多租户  OTDS ...................................................  37
4.5.3 示例:
添加租户  OTDS ................................................... ............  45
4.5.4 示例:
配置租户  OTDS ................................................... ...  45
4.6 故障排除 ................................................. .............................  52

5 准备数据库 ................................................... ......  53

6 设置  Exstream  环境 ....................................  57
6.1 关于  ss_tenantadmin  实用程序.......................... ......  57
6.2 配置管理网关并创建多租户
存储库.................................................. ...................................................  57
6.3 添加租户 ................................................... ................................................  64
6.4 添加管理网关 ................................................... ......  71
6.5 手动创建多租户或租户存储库 ...................................................  72
6.6 为管理网关设置安全通道 ....................................  73
6.7 为虚拟主机配置管理网关..........................  75

7 管理租户 ................................................... .....................  77
7.1 列出租户 ................................................... .............................  77
7.2 获取租户  ID .................................................... ......................  78
7.3 更改租户名称、
描述或连接配置文件..........................  79
7.4 向租户添加  OTMM  或  Content  Server  连接配置文件.....  80

8 实现  OpenText  私人帮助服务器..........................  87
8.1 为  Exstream  实现  OpenText  私人帮助服务器............  87

OpenText  Exstream  –  通信服务器管理指南 三
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

目录

8.1.1 下载  OpenText  Private  Help  Server  Kit  和产品
在线帮助文件 .................................................. ................................................  88
8.1.2   部署私人帮助服务器 ................................................... .......  88
8.1.2.1   对私人帮助服务器进行故障排除.........................................................  95
8.1.3 将帮助呼叫重定向到专用帮助服务器 .....................................................  96

第  2  部分  许可证管理 97

9 管理许可证文件 .................................................. .............  99
10 测量事务和微消息
许可目的 ................................................... .............  101

第  3  部分使用  Control  Center  管理应用程序 103

11 控制中心入门 ....................................................  105
11.1 控制中心中的步骤清单.......................... .......  105
11.2 从控制中心连接到租户环境..........................  106
11.3 了解控制中心用户界面 ...................................................  107
11.4 更改字体和语言选项 ...................................................  108
11.5 租户和主机属性描述 ...................................................................  109

12 创建域 ................................................... ......  111
12.1 了解域 ................................................... ..................  111
12.2 域需要哪些存储库.........................................................  115
12.2.1 关于处理统计 ................................................... .............  117
12.2.2 跟踪存储库使用说明 ................................................... .......  117
12.2.3 关于工作跟踪 ................................................................ ......................  118
12.3 创建域 ................................................... ......................  119
12.3.1 更新存储库连接配置文件..........................................  120
12.3.2 删除域 ................................................... ......................  120
12.4 主题资源的审批选项 ...................................  120
12.5 控制对域的访问 ................................................... ......  122

13 创建存储库 ................................................... ......  125
13.1 配置存储库设置 ................................................... ........  125
13.1.1 为数据库驱动程序指定自定义参数..........................  129
13.2 在  Control  Center  中创建存储库.........................................................  129
13.3 手动创建存储库.......................................... ......  130
13.4 将存储库链接到域 ................................................... ......  134
13.5 调整存储库................................................................. .....................  134

14 设置  Communications  Server  应用程序 .............................  139
14.1 设置  Communications  Server  应用程序 .................................  139
14.2 部署  Communications  Builder  项目 ....................................................  140

iv OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

目录

14.3 为  Exstream  生产引擎设置启动参数 ....  143
14.4 使用  FastCopy  测试  Communications  Server  应用程序..........................  144
14.5   Communications  Server  应用程序中的服务版本控制 ......  145
14.5.1   搜索服务 ................................................................ .....................  146
14.6 为队列配置线程池 .....................................................  147

15 设置服务网关 ................................................... ..  151
16   归档文件 .................................................. ......  153
16.1   添加存档应用程序................................................................ ......  153
16.2   为  Archiver  配置任务 ................................................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯154

16.3   添加  Content  Server  存储库 ................................... ...  154
16.4 配置  Content  Server  存储库 ...................................................  154

17 管理应用程序................................................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯157

17.1   启动、
停止和重新启动应用程序 ...................................................  157
17.2   管理远程主机上的应用程序 ...................................................  158
17.3   探索管理网关基目录 ..................................  158
17.4   在域中调度任务............................................................ ......  158
17.4.1   设置时间表 ................................................... ......................  161
17.5   删除应用程序.......................... .....................  163
17.6   更新和导出应用程序属性 ...................................................  164
17.6.1   Communications  Server  应用程序属性 ...................................................  164
17.6.2   服务网关和任务调度程序应用程序属性 ....................................  167
17.7   应用程序的启动选项和帐户 ...................................................  168
17.8   为应用程序配置  Java  参数 ....................................................  169
17.9 为  Windows  上的应用程序生成转储文件..........................  171

18 登录控制中心 ...................................................  ⋯⋯  173
18.1 关于日志 ................................................... ................................  173
18.2 指定日志级别.......................... .....................  174
18.3 在启动时创建一个新的日志文件.......................... ......  174
18.4 日志文件截断 ................................................... ......................  175
18.5 编辑日志提供程序  ‑  参考 ................................................... .......  175
18.5.1 一般提供者设置 .................................................... .............  176
18.5.2 控制台提供程序特定设置 ................................................... ....  176
18.5.3 日志文件提供程序特定设置 ................................................... ......  177
18.5.4 日志数据库提供程序特定设置 ..................................................  178
18.6 调试应用程序 .................................................. ......  178
18.7 使用数据库日志记录.......................... ......  179

19 维护  Exstream  组件 ...................................................  181
19.1 查找已安装的组件 ...................................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯181

OpenText  Exstream  –  通信服务器管理指南 在

CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

目录

第  4  部分  使用命令行实用程序管理应用程序 183

20 关于命令行实用程序.........................................................  185
20.1 命令行实用程序入门 ....................................................  186
20.2 命令行实用程序的场景.........................................................  186

21 论据和描述 ...................................................  189
21.1 ss_scm  实用程序参数和描述 ...................................................  189
21.2 ss_territory  实用程序参数和描述 ...................................................  194
21.3 ss_deploy  实用程序参数和描述 ...................................................  204
21.4 ss_rcp  实用程序参数和描述..........................................  206
21.5 可选参数(所有实用程序).......................... ......  207

22 示例和故障排除.........................................................  209
22.1 例子 ................................................. .....................................  209
22.1.1 创建域 ................................................... ......................  209
22.1.2 创建存储库.................................................................. ......................  209
22.1.3 创建通信服务器应用程序 ................................................  210
22.1.4 为  Communications  Server  应用程序创建服务..........................  210
22.1.5 将发布包部署到  Communications  Server .................................  211
22.1.6 修改  Communications  Server  服务 ...................................................  211
22.1.7 启动  Communications  Server  服务 .................................................  212
22.1.8 启动  Communications  Server  服务并禁用其输入
连接器 .................................................... ......................................  212
22.1.9 禁用正在运行的  Communications  Server  的输入连接器
服务 ................................................. ......................................  212

22.1.10  启用正在运行的  Communications  Server  的输入连接器
带有暂停输入连接器的服务..........................  212
22.1.11  检查  Communications  Server  服务是否正在运行 .............................  213
22.1.12  停止  Communications  Server  服务 ...................................................  213
22.2  故障排除 ................................................... ......................  213

第  5  部分  管理  Web  应用程序 215

23 关于  Web  应用程序 ................................... ....  217

24 部署  Web  应用程序 ..................................................  219

25 编辑  Web  应用程序属性 ...................................................  221
25.1 服务网关属性 ................................................... .............  221
25.1.1 服务网关安全模式 ...................................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯223
25.2 管理网关属性 ................................... ....  224
25.3 连接属性 ................................................... .....................  226
25.4 StoryBoard、
ReTouch、
Writer  和  CAS  浏览器的属性............  229

我们
OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

目录

25.4.1  管理配置文件资源 ................................................... ..  229
25.4.2  配置.json ................................... ................................  230
25.4.3  配置_ipad.json ...................................... ......................  233
25.4.4  设备配置.json ................................................... ..................  237
25.4.5  属性.json ................................... .....................................  238

25.4.5.1  类型 ................................................... ................................................  239
25.4.5.2  验证者 ................................................... ......................................  241
25.4.5.3  属性 ................................................... ......................................  244
25.4.5.4  属性 ................................................... ......................................  246

25.4.5.5  类别 ................................................... ......................................  248
25.4.5.6  对象 ................................... ......................................  250
25.4.5.7  过滤属性和属性 ................................................... ...........  251
25.4.6  模拟设置.json ................................... ......................  252

25.4.6.1  类型 ................................... ................................................  252
25.4.6.2  验证者 ................................... ......................................  254

25.4.6.3  设置 ................................... ......................................  256
25.4.6.4  模板 ................................................... ......................................  257
25.4.6.5  主题 ................................................... ......................................  259
25.5  文本编辑器属性 ................................... ......................  261

26 运行  Web  应用程序..........................  263
26.1   访问车间................................................................ .....................  263
26.2   访问主管 .................................................... .....................  266
26.3   访问  StoryBoard ................................................... ......  269
26.4   访问  ReTouch .................................................... ......................  270
26.5   访问  Writer .............................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯271
26.6   访问规则编辑器.......................................... .....................  272
26.7 访问控制 ...................................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯273

27 监控  Web  应用程序 ..................................................  275
27.1   服务网关  REST  日志 .................................... .............  275
27.2   管理网关  REST  日志 ...................................  ⋯⋯  276
27.3 应用程序日志 ................................... ................................  277

28   车间和主管中的  Solr  集成 .....................  279
28.1   单机模式实现.................................................................. ...  279
28.2   云模式实现.................................................................. ......  286
28.3 元模型更改后更新收集核心................................................  297

29 附加控制配置 ...................................................  299

第  6  部分  维护存储库 301

30 关于维护  Exstream  存储库..........................  303

OpenText  Exstream  –  通信服务器管理指南 七
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

目录

31 删除过期内容.......................... ...........  305
31.1   调度删除任务的建议..........................  306
31.2   计划任务计划程序以删除或使内容过期 .................................................  306
31.3 DBQ  示例 .................................................... ...............  308

32   运行索引维护(Microsoft  SQL  Server)........  309
32.1   索引维护建议(Microsoft  SQL  Server)............  309
32.2 通过  SQL  Server  代理运行索引维护(Microsoft  SQL
服务器) ................................................ ......................................  310

33   重建或合并索引(Oracle  数据库)........  313
33.1 使用  coalesce_indexes  过程合并索引(Oracle
数据库).................................................. ......................................  313
33.2   重建索引(Oracle  数据库)..........................  314
33.2.1 确保有足够的可用空间(Oracle  数据库)............................................  316

34 通过任务安排索引维护或合并
调度器.................................................. ...............  319

35 收集统计信息(Oracle  数据库)..........................  323
35.1 收集样本统计信息(Oracle  数据库).................................................  323
35.2 收集系统统计信息(Oracle  数据库).................................................  325

36 通过  EXPLAIN  PLAN  对性能进行故障排除
(甲骨文数据库).................................................. .....................  327

37 备份存储库.......................... ...  329

第  7  部分安装和应用修补程序 331

38 关于安装和应用修补程序 .................................  333

39 安装修补程序 .................................................. .....................  335

40 将修补程序应用于存储库 ...................................................  337
40.1 将修补程序应用到租户存储库.........................................................  338
40.2 使用  Control  Center  将修补程序应用于存储库 ...................................  340
40.3 使用  hotfix‑repo  脚本将修补程序应用于存储库............  341
40.4 手动将修补程序应用到存储库 ...................................................  343

41 将修补程序应用于  Web  应用程序..........................  345

第  8  部分  运行并行版本 347

42 运行并行版本..........................  ⋯⋯  349

第  9  部分  分析和调整您的环境 351

八 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

目录

43 关于剖析 ................................................... .....................  353
44 设置探查器 ................................................................ ......  355
44.1   启用探查器 ................................................................  ⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯⋯355
44.2   配置  Profiler ................................................... ......................  356
44.2.1   配置配置文件提供程序................................................................ ......  356
44.2.2   应用事件过滤器.......................... ......................  359
44.2.3   将  Profiler  数据刷新到输出文件 ................................................... .  360
44.2.4   调度  Profiler  计数器事件.........................................................  360
44.3 分析探查器输出.......................... ....................  360

第  10  部分  使用文档跟踪框架 361

45 关于文档跟踪框架 ...................................................  363
46 设置文档跟踪框架 ....................................  367
46.1 步骤清单 ................................................................ ...............  367
46.2 安装文档跟踪框架 ...................................................  367
46.3 创建文档跟踪存储库.......................................................  368
46.4 配置文档跟踪框架 ...................................................  369
47 分析跟踪数据.......................... ....  371
48 维护文档跟踪框架 ....................................  377

Part  11  加密工具 379

49 在  Windows  上使用安全工具 ....................................................  381
50 在  UNIX/Linux  上使用安全工具 ................................................  387
51 替换证书文件..........................  ⋯⋯  393
52 加密工具疑难解答 ................................................................  395
52.1   丢失的钥匙.................................................. ......................................  395
52.2 管理网关未启动..........................  396

OpenText  Exstream  –  通信服务器管理指南 九
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第1部分
入门
Machine Translated by Google
Machine Translated by Google

第1章
租赁概念

Exstream  支持单租户和多租户环境。
在单租户环境中,
公司或组织在一台或多台计算机或主机上运行  
Exstream  组件。
该公司开发和管理自己的通信服务器和存储库。

在多租户环境中, 多个客户组织(或租户) 共享一个或多个框架和管理网关实例。  Exstream  环境中的每个租


户都有一个唯一的  ID  并运行自己的  Communications  Server  应用程序。
环境中的所有应用程序和数据都由
租户  ID  分隔。
这允许租户共享数据库或模式或使用单独的数据库或模式。

每个租户在  OTDS  中都有自己的用户,
该用户控制谁可以访问租户的应用程序和数据。
当用户登录到  WorkShop、
StoryBoard、Control  Center、
Describer  等时,
他们只能查看和访问属于其租户的数据和资源。 例如, 如果  
Exstream  环境有两个租户, 租户  1和租户2, 那么当租户  1的用户登录控制中心时,
只会显示属于租户  1的应用程
序和存储库。

示例环境(两个租户)
Exstream  组件、
存储库和  OTDS  服务器可以通过多种方式进行设置。
下图显示了一个示例环境,
其中
两个租户共享一个框架和管理网关实例。

每个租户都有自己的一组:

‧  Communications  Server  应用程序,
在共享框架上运行
和管理网关。
‧  OTDS  中可以访问租户环境的用户。

‧用于存储设计资源、
队列数据、
处理统计等的存储库。
在本示例中,
这些存储库位于中央环境中的数据库
服务器中。

OpenText  Exstream  –  通信服务器管理指南 13
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第一章  租赁概念

图  1‑1:
具有不同用户、
应用程序和存储库的租户

注意:
此图并未显示  Exstream  环境中所需的所有组件。

基于角色的访问控制

角色控制  Exstream  环境中的访问和权限。 整个环境有一组多租户管理员, 他们通过命令行实用


程序管理租户。 每个租户都有自己的用户, 这些用户被分配到租户管理员、 租户用户、 审阅者和按需用户
等角色。这些角色可以访问  WorkShop、 StoryBoard、
Control  Center、
Supervisor、
Describer、
Communications  Builder  等。
对元数据模型中的  CAS  资源和类型的访问级别也可以与角色相关
联。

元数据模型

Exstream  环境中的每个租户都有自己的元数据模型, 其中包含租户的  Exstream  解决方
案中使用的所有属性。 元数据模型是版本化的并集中存储。 这允许解决方案开发人员在设计时
访问中央模型, 并在开发、测试和生产环境中由  Exstream  应用程序在运行时访问。

14 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第2章
需要哪些组件才能开始?

安装  Exstream  后,
您必须设置以下基础组件:

‧多租户存储库‧管理网关

‧多租户  OTDS

您还必须为每个租户设置以下组件:

‧租户存储库
‧租户  OTDS

本节介绍每个组件以及如何在具有单租户和多租户的环境中安排这些组件。 有关设置组件的步骤的信息,
请参阅
第  19  页的“步骤清单  ‑  设置  Exstream  环境”。

在这个部分

‧第  15  页的“基础组件”  ‧第  16  页的“租户相关组

件”  ‧第  17  页的“单租户环境中的组件”  ‧第  17  页的

“多租户环境中的组件”

底层组件
多租户存储库
此存储库存储有关整个  Exstream  环境的信息,
其中包括以下内容:

‧租户名称、
描述等。
‧环境中的主机。

‧  Exstream  中每个租户、
租户  OTDS  和租户之间的映射
存储库。

多租户存储库中的所有信息都分配有一个租户  ID,
以确保一个租户无法访问另一个租户的应用程序或数
据。

管理网关管理网关将计算机上
的  Exstream  应用程序连接到  OTDS、 租户和多租户存储库以及  Exstream  桌面工具,
例如  Control  
Center  和  Communications  Builder。

OpenText  Exstream  –  通信服务器管理指南 15
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  2  章  入门需要哪些组件?

管理网关是Communications  Server安装组件的一部分。
在  Windows  上,
管理网关服务使用本地管
理员帐户并需要本地管理员访问权限才能创建和删除其他  Windows  服务。 管理网关  Windows  服务
称为StreamServe  管理网关。
管理网关进程称为ManagementGateway。

<版本>

管理网关使用三个端口。
默认端口号为:

‧  28700  –  此端口用于Exstream  应用程序、
OTDS、
存储库和桌面工具之间的通信。

‧  28701  –  此端口用于通过  REST  API  进行的通信。

‧  28702  –  此端口用于内部通知。

在  Linux  上,
您可以在Communications  Server安装期间更改用于通信和内部通知的默认端口。 无法
更改用于  REST  API  的默认端口,
该端口将始终是通信端口  +1。 在  Windows  上,
您无法更改端口。

多租户  OTDS
这包含整个环境的多租户管理员。
多租户管理员可以访问  ss_tenantadmin  工具,
该工具用于设置管理网关并将租户添加到整体环境中。
该组件始终在  OTDS  中创建。

租户相关组件
每个租户都需要访问租户存储库和租户  OTDS。

租户存储库
此存储库存储租户特定信息,
其中包括:

‧租户的元数据模型。

‧作为环境一部分的应用程序、
域和计算机或主机。

‧通过通用资产服务提供的资源,
例如模板、
图像、
和  Communications  Builder  项目文件。
‧安全信息。

租户存储库中的所有信息都分配有一个租户  ID。

在多租户环境中,多个租户可以共享一个租户存储库。 在这种情况下,每个租户在存储库中都有自己的元数
据模型、资源等。
因为所有信息都分配了一个租户  ID,
所以一个租户无法访问或查看另一个租户的信息。

租户  OTDS
这包含有权访问租户环境的用户,
这些用户被分配了租户管理员、
租户用户、
审阅者等角色

16 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

需求用户。
这些是访问  Exstream  设计和管理工具以及  Web  应用程序的用
户。
租户  OTDS  始终在  OTDS  中创建。

单租户环境中的组件
在单租户环境中, 有一个多租户存储库和一个多租户  OTDS。
一个或多个管理网关可用
于运行  Exstream  应用程序。
如果使用多个管理网关,
它们都连接到同一个多租户存储
库。
有一个租户存储库和一个租户  OTDS。

图  2‑1:
单租户环境

多租户环境中的组件
在具有多个租户的  Exstream  环境中,有一个多租户存储库。
一个或多个管理网
关可用于运行  Exstream  应用程序。
如果使用多个管理网关,它们都连接到同一个
多租户存储库。

有两种设置租户存储库的选项 租户可以共享单个租户存储库或使用单独的租户存
储库。
使用单独的租户存储库适用于每个租户都需要高级别数据隔离或您希望租户存储
库负载高的环境。

有一个多租户  OTDS  供管理整个环境的用户使用。
每个租户都连接到一个租户  OTDS。 有关设置  OTDS  的选项的更多信息,
请参阅第  24  页
的“选项和建议”。

OpenText  Exstream  –  通信服务器管理指南 17
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  2  章  入门需要哪些组件?

图  2‑2:
多租户环境示例:
租户共享租户存储库

图  2‑3:
多租户环境示例:
租户使用单独的租户存储库

18 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第3章
步骤清单  ‑  设置  Exstream  环境

本节列出了设置  Exstream  环境所需的高级步骤。

脚步: 看:

第  1  步  –  为  Exstream  设置  OTDS “为  Exstream  设置  OTDS”
(第  
21  页)
步骤  2  –  准备数据库 “准备数据库”
(第  53  页)
外流存储库
第  3  步  –  配置管理网关并创建多租户存储库 “配置管理网关和创建多租户存储库”
(第  
57  页)

第  4  步  ‑  添加租户并设置租户存储库 “添加租户”
(第  64  页)

步骤  5  –(可选)–向  Exstream  环境添加更 第  71  页的  “添加管理网关”
多管理网关
步骤  6  –(可选)–为管理网关设置安全通道 “为管理网关设置安全通道”
(第  73  页)

步骤  7  –(可选)–为虚拟主机配置 第  75  页的  “为虚拟主机配置管理网关”
管理网关

下一步
设置环境后, 分配了相应角色的用户可以登录到  Control  Center、
Communications  
Builder  和  Describer。

有关登录租户环境和准备在控制中心运行  Exstream  应用程序的信息,
请参阅第  
105  页的“控制中心中的步骤清单”。

OpenText  Exstream  –  通信服务器管理指南 19
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第  4  章
为  Exstream  设置  OTDS

4.1  访问控制概念
本节介绍了与  Exstream  中的访问控制如何工作相关的一些关键概念。

概念:
每个  Exstream  租户都有自己的用户
一个  Exstream  环境可以有一个租户,也可以有多个租户。租户可以是拥有自己的一组用户的客户、
公司或组织单位。 当用户以租户身份登录时,他们对系统的看法基于他们的租户。一个租户的用户无
法查看或访问另一个租户的应用程序或数据。

在下图中,来自租户  A  的  John、Robert  和  Amy  可以访问属于租户  A  的应用程序、
存储库
和数据。
而  Mary、
Sam  和  Fiona  可以访问属于的应用程序、 存储库和数据租户  B。

概念:
角色控制访问和权限
每个  Exstream  租户的用户都被分配了一个或多个角色。
这些角色控制以下内容:

‧用户可以访问哪些桌面应用程序和Web  应用程序。  ‧用户在每个应用程序中拥
有哪些权限。

例如, 如果为  John  分配了租户管理员角色, 则  John  可以访问控制中心、 通信生成器、 描述器


和  Web  应用程序。
然而, 如果  Robert  被分配到  Reviewer  角色,
则  Robert  只能访问  Web  应用程序。

OpenText  Exstream  –  通信服务器管理指南 21
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

概念:
租户  OTDS

一个租户的用户是在称为租户  OTDS  的组件中创建的。
该组件是在  OTDS  中创建的。

将租户添加到  Exstream  环境时,
它会连接到其租户  OTDS  (请参阅“添加租户”)。
此连接
控制谁可以登录到租户的  Exstream  环境。

下图显示了租户  A  如何连接到租户  A  的租户  OTDS , 其中包含用户  John、
Robert  和  Amy。
租户  B  连接到包含用户  Mary、
Sam  和  Fiona的租户  OTDS 。

理念:
多租户用户管理整体环境

为了管理整体环境,
有一组用户可以通过管理网关添加租户。
这些用户无法查看或访问属于租户的
任何应用程序、
存储库或数据。

下图显示了  Linda  和  Bob  如何访问管理网关,
但无法访问租户的应用程序或数据。

22 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.1。
访问控制概念

管理整体环境的用户组被分配了多租户管理员角色。
多租户管理员只能访问  Exstream  
ss_tenantadmin  实用程序。

概念:
多租户  OTDS
多租户管理员用户是在多租户  OTDS  组件中创建的。

配置管理网关时, 它连接到多租户  OTDS。
此后,
分配到多租户管理员组的用户可以使
用  ss_tenantadmin  实用程序。

OpenText  Exstream  –  通信服务器管理指南 23
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

4.2  选项和建议
要为  Exstream  设置  OTDS,
您需要配置以下组件:

‧多租户  OTDS

这包含分配了多租户管理员角色并管理整个环境的用户。

‧租户  OTDS

这包含每个  Exstream  租户的用户。
这些用户可以通过  Communications  Builder、
控制中心、
Web  应
用程序等访问  Exstream  中的租户环境。

设置这些组件的选项

您可以通过多种方式配置这些组件:

‧选项  1  –  使用单独的  OTDS  后端您可以在单独的  OTDS  

后端中配置这些组件中的每一个。
这意味着每个  Exstream  租户都有自己的  OTDS  后端,
有自己的用户、
组、
分区和资源。

这种方法具有最高级别的安全性, 因为每个租户的用户都位于不同的  OTDS  后端。
它还允许单独管理每个
租户的  OTDS  服务器。

有关详细信息,
请参阅第  25  页的“选项  1  –  单独的  OTDS  后端”。
‧选项  2  –  使用单个  OTDS  后端,
每个租户都有一个分区

您可以在一个由多个  Exstream  租户共享的  OTDS  后端中配置所有这些组件。
使用这种方法,
每个  
Exstream  租户在  OTDS  后端都有自己的分区和自己的资源。

这种方法允许  OTDS  服务器由单个  OTDS  管理员集中管理。

有关详细信息,
请参阅第  26  页的“选项  2  –  单一  OTDS  后端”。
‧选项  3  –  具有所有  Exstream  用户和组的单一  OTDS  后端(仅适用于单租户  Exstream  环境)

在具有单个租户的  Exstream  环境中,
您可以使用包含所有  Exstream  组的单个  OTDS  服务器或后
端。

有关详细信息,
请参阅第  27  页的“选项  3  ‑  单租户  Exstream  环境”。

Exstream  租户的  OTDS  要求

‧您可以通过多种方式为  Exstream  设置  OTDS。
然而,
每个
Exstream  租户只能连接到一个  OTDS  后端。
无法将  Exstream  租户连接到多个不同的  OTDS  后端或  
OTDS  服务器。

24 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.2.选项和建议

注意:
Exstream多租户  OTDS和租户  OTDS在本节中以斜体书写,
以将这些组件与  OTDS  
组件区分开来。

了解  OTDS  租赁概念
OTDS  支持在单个  OTDS  服务器中运行多个租户后端。
每个后端都有自己的一组  OTDS  数据:
资源、用户分区、 访问角色、 身份验证处理程序和系统属性。  OTDS  的默认安装包括默认后端。
可以通过命令行界面将租户后端添加到  OTDS。

有关  OTDS  中的租户以及围绕  OTDS  默认后端和租户后端的概念的更多信息,
请参阅
OpenText  目录服务  ‑  租户管理指南  (OTDS‑CCS) 。

4.2.1  选项  1  –  单独的  OTDS  后端
如果您想为每个  Exstream  租户使用单独的  OTDS  后端,
OpenText  建议您使用具有多个后端
的  OTDS  安装,
并按以下方式配置  OTDS:

‧在默认的  OTDS  后端配置多租户  OTDS 。
这个后端有自己的  Exstream  分区、
资源和用户。
它将
仅包含多租户管理员组(OTDS  组名称:  strsmultitenantadmins)。

‧在单独的OTDS  租户后端为每个Exstream  租户配置租户OTDS 。 这要求您为  Exstream  环境中
的每个租户添加一个租户到  OTDS。 然后每个  Exstream  租户都有自己的  OTDS  后端,带有  
Exstream  分区、
资源、
用户和组(即租户管理员、 租户用户、 自定义组等与  OTDS  组>等)。 名
称:  strstenantusers、  strstenantadmins、  <

定制组

图  4‑1:
示例配置  –  Exstream  多租户环境

OpenText  Exstream  –  通信服务器管理指南 25
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

图  4‑2:
示例配置  ‑  Exstream  单租户环境

也可以为每个  Exstream  租户使用单独的  OTDS  服务器。在这种情况下,
每个  Exstream  租
户仍然会有自己的  Exstream  资源、
用户分区、 组等, 但这些都是在单独的  OTDS  服务器中创
建的。

4.2.2  选项  2  –  单一  OTDS  后端
如果您想使用由多个  Exstream  租户共享的单个  OTDS  服务器,
OpenText  建议您通过以下方式配置  OTDS:

‧在OTDS  中,
为每个Exstream  租户创建一个分区,
为每个Exstream  租户创建一个资
源。
‧将每个  Exstream  租户的分区分配给每个  Exstream  的资源
租户。

‧将每个Exstream  租户分区中的用户或组分配给strs.role分区中的Exstream  组。  ‧创建分配
给strsmultitenantadmins组的用户

strs.role分区。
请注意,
多租户管理员是应该在strs.role分区中创建的唯一用户。

‧创建分配给strs.role分区的单独资源。

26 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.2.选项和建议

图  4‑3:
示例配置:
单个  OTDS  后端中的两个  Exstream  租户

此示例显示了由两个  Exstream  租户(租户  A  和租户  B)
共享的单个  OTDS  后端。
每个  
Exstream  租户都有自己的分区和自己的  Exstream  资源。每个租户分区中组的用户被分
配到strs.role分区中的  Exstream  组。

分配给strsmultitenantadmins组的用户是在strs  中创建的。
角色划分。  strs.role分区
分配给一个单独的资源, 该资源在您设置环境时连接到管理网关(请参阅第57页的“配
置管理网关和创建多租户存储库” )。

4.2.3  选项  3 单租户  Exstream  环境
在具有单个租户的  Exstream  环境中,
您可以使用包含所有  Exstream  组的单个  OTDS  
服务器或后端。

OpenText  Exstream  –  通信服务器管理指南 27
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

图  4‑4:
OTDS  配置示例:
单租户  Exstream  环境

4.3  OTDS配置要求
本节介绍  OTDS  for  Exstream  中所需的配置。

支持的  OTDS  版本
‧有关支持的  OTDS  版本的信息,
请参阅OpenText  Exstream  16.4
发行说明。

安装  OTDS
您可以从  OpenText  My  Support  下载  OTDS。

有关安装  OTDS  的信息,
请参阅OpenText  目录服务  ‑  安装和管理指南  (OTDS‑IWC)。

有关将租户后端添加到  OTDS  的信息,
请参阅OpenText  目录服务  ‑  租户管理指南  (OTDS‑CCS)中的第  
1.1  节“添加租户”

Exstream  所需的  OTDS  后端配置
您需要分别在每个  OTDS  后端或  OTDS  服务器中为  Exstream  进行  OTDS  配置。
您可以使用  OpenText  
管理客户端或  OTDS  Web  管理客户端在默认的  OTDS  后端进行这些配置。 您必须使用  Web  管理客户端在  
OTDS  租户后端进行这些配置。 您通过  OTDS  API  激活资源。

28 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.3.  OTDS  配置要求

所需配置

‧  strs.role  分区
您必须使用名称创建一个分区:  strs.role

‧外流组

您必须在strs.role分区中创建适当的  Exstream  组。

‧如果  OTDS  后端将连接到管理网关,请创建组:
多租户管理员 strsmultitenantadmins

(MTA)

‧如果  OTDS  后端将连接到租户,请创建组:
租户管理 管理员

租户用户strstenantusers

审稿人 strsreviewers

一经请求 strson需求用户
用户

内容作者 压力原因
用户

<自定义组> <自定义组>

‧将用户分配到组

您必须将用户或组分配给  Exstream  组。

我们建议分配给strsmultitenantadmins组的用户将永不过期作为  OTDS  中的密码策略。

提示:
配置  Exstream  环境需要分配给strsmultitenantadmins组的用户的用户
名和密码。

‧外流资源

您必须为  Exstream  创建并激活资源。
资源可以有任何
姓名。

提示:
配置  Exstream  需要资源  ID  和密钥
环境。

‧为资源分配分区、
组或用户

您必须将需要访问  Exstream  的分区、
组和用户添加到资源的默认访问角色。

‧创建浏览器用户

OpenText  Exstream  –  通信服务器管理指南 29
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

您必须创建一个对  OTDS  具有读取权限的用户。
此用户必须在strs.role分区中创建,
但不需要
是任何组的成员。
此用户必须在  OTDS  中将永不过期作为密码策略。

提示:
配置  Exstream  环境需要浏览器用户名和密码。

设计和生产以及  CAS  浏览器要求

有关如何将用户和组从  OTDS  添加到设计和生产以及  CAS  浏览器的信息,请参阅Exstream  
设计和生产文档集中的OpenText  Exstream  设计和生产系统管理中的将外部用户添加到设计
组。

Web  应用程序的  OTDS  安全要求

如果您计划运行  Supervisor、
WorkShop  或其他  Exstream  Web  应用程序,
OpenText  
建议您在
OTDS  和  Tomcat:

‧将OTDS  系统属性directory.auth.XFrameOptions设置为SAMEORIGIN以防止点击劫持漏洞。
有关详细信息, 请参阅OpenText  目录服务  ‑  安装和管理指南  (OTDS‑IWC)中的第  12.1  节“系
统属性” 。

‧关闭Tomcat  server.xml文件中的Tomcat  Access  Log  Valve选项,
以防止OTDS  登录页面将
OTDS  密码参数作为查询参数发送。 有关更多信息, 请参阅  Apache  Tomcat  文档。

‧默认情况下, OTDS  可能会尝试使用  Windows  集成身份验证单点登录  (SSO)。 如果您不想使


用本机  Windows  本机  SSO,
请关闭  OTDS  http.negotiate身份验证处理程序。有关详细信
息,
请参阅OpenText  目录服务  ‑  安装和管理指南  (OTDS‑IWC)中的第  4.1  节“使用身份验证
处理程序” 。

HTTPS  和  HTTP  通信

默认情况下, Exstream  使用  HTTPS  与  OTDS  通信。
要使用不安全的  HTTP  通信,
您必须在  
OTDS  和  Exstream  中禁用  HTTPS。

要在  Exstream  中禁用  HTTPS  通信,
请在为  OTDS  配置连接配置文件时使用‑unsecure标志。
有关详细信息, 请参阅以下部分:

‧  “步骤  2  –  使用  configure_multitenant_otds  操作创建到多租户  OTDS  的连接配置
文件”(第  60  页)

‧  “步骤  2  –  使用  configure_tenant_otds  操作创建租户  OTDS  的连接配置文
件”(第  66  页)

要在  OTDS  中禁用  HTTPS,
您必须添加系统属性directory.auth.EnforceSSL
并在系统属性页面上将值设置为false

30 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.4.分配访问角色

在  OTDS  Web  客户端中。
有关在  OTDS  中禁用  HTTPS  通信的更多信息,
请参阅
以下文档:

‧  OpenText  目录服务  ‑  安装和管理指南  (OTDS‑IWC)中的第  12.1  节“系统属性”

‧  OpenText  目录服务  ‑  安装和管理指南  (OTDS‑IWC)中的第  3.5.1.2  节“使用加密”

注意:
HTTP  通信只适用于开发和测试环境。

4.4  分配访问角色
您将用户和组分配给  OTDS  中的  Exstream  访问角色。

为  Exstream  设置  OTDS  后,
租户可以使用  OTDS  Web  管理客户端来管理其用户并分配访问
角色。

关于分配角色

Exstream  访问角色在  OTDS  中表示为组。在  OTDS  中, 可以为每个  Exstream  组分配一个或多个
用户、 组或组织单位。
例如, 您可以将用户  Bob  和组织单位  Quality  Assurance  都分配给租户管理员组。

图  4‑5:
分配给一个角色的多个成员

您还可以将一个用户、
组或组织单位分配给多个角色。

每个角色的权限都是专有的

访问角色的权限是角色专有的。
其他访问角色不会继承权限。例如,
租户用户权限仅适用于具有租
户用户角色的用户,
租户管理员权限仅适用于具有租户管理员角色的用户。

如果为用户分配了多个角色,
则该用户根据分配的所有角色拥有权限。

在  WorkShop(在  Unversioned  资源视图中),
您可以控制角色背后的  OTDS  组可以访问哪些
域。 例如, 您可以提供对开发域的组访问权限, 但阻止该组访问生产域。
当用户登录域时, 该用户将拥

OpenText  Exstream  –  通信服务器管理指南 31
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

根据有权访问当前域的所有分配角色的权限。

角色描述
本节介绍默认的  Exstream  角色及其权限。

注意:
如果您已将自定义组添加到租户  OTDS中的strs.role分区,
则必须使用  Supervisor  应用程序创建相
应的角色并为角色分配适当的权限。
在  Supervisor  中,
您还可以更改租户默认  Exstream  角色的权限。

有关详细信息, 请参阅OpenText  Exstream  ‑  主管用户指南  (CCMWEBRETR‑UGD)中的第  
10  节“管理角色” 。

‧多租户管理员  (MTA)

对ss_tenantadmin命令行实用程序的完全访问权限,
用于添加租户和更新租户信息等。

无法访问  Communications  Builder、
控制中心、
Describer  或  Web  应用程
序。
‧租户管理员

对  Communications  Builder、
控制中心、
Describer  以及ss_territory、  ss_scm、  
ss_deploy和ss_rcp命令行实用程序的完全访问权限。
访问网络应用程序:

‧  WorkShop  –  访问所有视图。
例如,
可以在  Resources  视图中发布主题和删除资源。

‧主管  –  访问所有视图,
但不能在  Review  中编辑文档
看法。

‧  StoryBoard  –  例如,
可以预览主题。  ‧  ReTouch  –  例如,
可以预

览文档。
‧租户用户

完全访问  Communications  Builder。

对以下应用程序的一些访问:

‧控制中心 例如,
启动和停止应用程序,
以及查看属性和日志。  ‧描述器 查看模型。

访问网络应用程序:

‧  WorkShop  –  访问所有视图。
例如,
可以编辑和签入主题
资源视图。

‧主管–  访问除“角色”
视图之外的所有视图。

32 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.4.分配访问角色

‧  StoryBoard  –  完全访问。
‧  ReTouch  –  完全访问权限。

‧审稿人

无法访问  Communications  Builder、
控制中心、
Describer  或命令行实用程序。

访问网络应用程序:

‧  WorkShop  –  对资源视图的一些访问。
例如,
可以审查和
批准资源,
但不能编辑或删除资源。

‧主管–  对审阅视图的某些访问权限。
例如,
可以审查和
批准文件,
但不能编辑或删除文件。

‧  StoryBoard  –  例如,
可以预览主题。  ‧  ReTouch  –  例如,
可以

预览文档。
‧内容作者用户

该组在  Web  应用程序中与租户用户具有相同的访问权限,
但它只能在  CAS  浏览器中查看已批
准的资源。
‧按需用户

无法访问  Communications  Builder、
控制中心、
Describer  或命令行实用程序。

访问网络应用程序:

‧  WorkShop  –  对资源视图的一些访问。
例如,
可以检查图像和文本。

‧主管–  无权访问。  ‧  StoryBoard  

–  无法访问。
‧  ReTouch  –  完全访问权限。

关于角色和访问权限的说明

‧有关如何将用户和组从  OTDS  添加到设计和生产以及  CAS  浏览器的信息,请参阅Exstream  
设计和生产文档集中的OpenText  Exstream  设计和生产系统管理中的将外部用户添加到设
计组。

‧  StoryTeller  无需登录。

OpenText  Exstream  –  通信服务器管理指南 33
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

4.5  示例  –  为  Exstream  设置  OTDS
本节提供的示例描述了在多租户  OTDS  和租户  OTDS  使用单独后端的场景中
为  Exstream  设置  OTDS  的一种方法。

在这些示例中,
进行了以下类型的配置:

‧  OTDS  是使用Apache  Tomcat  作为应用服务器安装的。

‧使用自签名证书为  OTDS  设置  HTTPS  通信。
‧  Exstream多租户OTDS在默认OTDS  后端配置。
‧  Exstream租户OTDS在OTDS  租户后端配置。
‧在两个后端,
使用非同步分区,
所有用户都是手动添加的。

‧在两个后端中,  strs.role分区都分配给Exstream  资源。

图  4‑6:
OTDS  配置

注意:
此示例中未配置内容组。

高级步骤

步: 看:

1.  安装  OTDS。 “示例:
安装  OTDS”
(第  35  页)

34 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

2.  在默认后端,
配置多租户OTDS。 “示例:
配置多租户
OTDS”
(第  37  页)
3.  将租户后端添加到  OTDS。 “示例:
添加租户  OTDS”
(第  45  页)

4.  配置租户OTDS。 “示例:
配置租户  OTDS”
(第  45  页)

4.5.1  示例:
安装  OTDS
本示例介绍如何配置  Tomcat  8  以与  OTDS  一起使用、
如何以  Tomcat  作为应用服务器安装  
OTDS,
以及如何为  OTDS  配置  HTTPS  通信。

此示例假定计算机上已安装以下软件:

‧雄猫  8

‧  Java  运行时环境版本  1.8.x

有关  OTDS  安装的更多信息,
请参阅OpenText  目录服务  ‑  安装和管理指南  (OTDS‑IWC)。

第  1  步  –  配置  Tomcat  以与  OTDS  一起使用

1.  打开  Tomcat  属性对话框。
例如,
使用命令“C:
\Program  Files\Apache  Software  Foundation\Tomcat8.5\apache  
tomcat‑8.5.11\bin\tomcat8w.exe  //ES/ <Tomcat服务名称>

2.  在Java选项卡上,
配置以下设置:

‧初始内存池
256

‧最大内存池
1024

注意:
在本例中,
使用了最低设置。

3.  从以下位置打开server.XML文件:
<Tomcat安装目录> \conf

4.  将新属性maxHttpHeaderSize= 65536 添加到以下元素:

<连接器端口= 8080   协议= HTTP/1.1   connectionTimeout= 20000

redirectPort= 8443   maxHttpHeaderSize= 65536  />

5.  重启Tomcat。

OpenText  Exstream  –  通信服务器管理指南 35
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

第  2  步  –  安装  OTDS
重要在开始
安装之前验证  Tomcat  是否正在运行。

1.  从  OpenText  我的支持上的目录服务区域下载  OTDS  Windows  安装程序。

2.  启动安装程序,
在欢迎页面单击下一步,
并接受许可证
协议。

3.  按照向导使用以下选项安装  OTDS:

应用服务器Apache  
Tomcat。

安装类型不要选中
复制服务器选项。

Java  虚拟机Java  运行时
环境的路径。

目录服务参数使用默认端口。

OTDS  管理员选择该选项
以强制使用复杂密码并为管理员用户输入密码。

提示:
记下用户名和密码。
这些是登录  OTDS  Web  客户端所必需的。

OTDS  数据导入选择
不导入。

第  3  步  –  为  OTDS  设置  HTTPS  通信
在此示例中,
使用了自签名证书。

注意:
自签名证书仅适用于开发和测试环境。

1.  打开命令提示符并导航到C:\Program  Files\Java\\bin。 <Java
版本>

2.运行命令:  keytool  ‑genkey  ‑alias  tomcat  ‑keyalg  RSA  ‑keystore  C:\mycerts\mykey.keystore

3.  输入密码、
您的用户、
组织、
位置详细信息,
然后输入YES
确认。

4.输入tomcat的密钥密码。

36 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

5.  打开  Windows  资源管理器,
然后从以下文件中打开server.XML文件
目录:

C:\Program  Files\Apache  Software  Foundation\Tomcat  8.0\conf

6.  取消注释下面的元素并为元素添加以下属性:

‧  keystoreFile  ‑  这是在步骤  2  中创建的密钥库文件的路径。.ie  C:
\mycerts\mykey.keystore

‧  keystorePass  ‑  在步骤3中输入的密码。

<连接器
协议= org.apache.coyote.http11.Http11NioProtocol   端口= 8443   
SSLEnabled= true
maxThreads= 150   scheme= https   secure= true   keystoreFile= C:
\mycerts\mykey.keystore   keystorePass= MyPass16!
clientAuth= false   sslProtocol= SSL  />

7.  重新启动  Tomcat。

4.5.2  示例:
配置多租户  OTDS
本示例介绍如何使用以下内容配置多租户  OTDS  :

‧  strs.role分区

‧外流资源

‧分配给Exstream  资源的strs.role分区

‧一组多租户管理员

‧分配给多租户管理员组的一位用户

‧只读(浏览器)
用户

访问  OTDS  Web  客户端

通过以下  URL  打开默认后端的  Web  客户端:

https:// <OTDS  主机> :<端口> /otds‑管理员/

第  1  步  –  创建一个名为  strs.role  的分区

在此示例中,
创建了一个非同步分区。

‧在分区页面上,
单击添加>新建非同步用户分区,
输入strs.role,
然后单击保存。

OpenText  Exstream  –  通信服务器管理指南 37
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

第  2  步  –  创建  strsmultitenantadmins  组

创建一个名为:  strsmultitenantadmins  的组。

创建组:

1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击组选项卡,
然后单击添加>新组。

3.  在组名框中,输入适当的 <组名> , 然后点击


节省。

其中<group  name>是strsmultitenantadmins。

第  3  步  –  创建用户并将用户分配到组

在默认后端,
创建一个用户并将该用户分配给strsmultitenantadmins组。
在此示例中,
为方便起见,
密码策略设置为用户无法更改密码和密码永不过期。

38 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

要创建用户:

1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击用户选项卡,
然后单击添加>新用户。

3.输入用户名,点击下一步,
配置如下密码
选项:

‧重置时不需要更改密码‧用户无法更改密码–  选择‧密码永

不过期–  选择

4.  输入密码。

5.  单击保存。

提示

‧记下用户名和密码。

分配给strsmultitenantadmins组的用户需要使用  ss_tenantadmin  工具(‑mtauser和‑
mtapassword参数)。

要将用户分配到组:

1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击用户选项卡,
选择用户,
然后单击操作>编辑成员资格。

3.  单击添加到组。

4.  选择合适的组来添加用户,
点击Add  Selected,
然后
单击关闭。

5.  单击返回返回上一页。

OpenText  Exstream  –  通信服务器管理指南 39
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

第  4  步  –  为  Exstream  创建资源
1.  在资源页面,
单击添加。
2.  在资源名称框中,
输入资源的名称。
注意:
资源可以有任何名称。

3.  在显示名称框中,
输入资源的显示名称。
4.  单击“保存” ,
然后在“资源激活”
对话框中单击“确定”。
5.  选择  Exstream  资源,
单击操作、
属性,
然后从资源标识符框中复制资源  ID。

40 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

提示: 记下资源  ID。 需要激活资源和


设置  Exstream  环境。

第  5  步  –  激活资源
可以通过以下  URL  访问默认后端的  OTDS  Rest  API:

https:// :
<otds_host><端口> /otdsws/api/index.html?rest#!

要激活资源:

1.  打开  OTDS  Rest  API。
2.在列表中点击资源:
对资源的操作
列表已展开。

3.  点击/resources/{resource_id}/activate激活资源

4.  在resource_id字段中,
粘贴资源  ID,
然后单击试用!

OpenText  Exstream  –  通信服务器管理指南 41
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

提示:
记下返回的密钥。

设置  Exstream  环境需要资源  ID(例如71953643‑a163‑4123‑b312‑4fe225c34f08)
和密钥(例如
“Z0yWzfu8UeDge6ZBlxiDLw==”) 。 这些是在第  60  页的“第  2  步  ‑  使用  
configure_multitenant_otds  操作创建到多租户  OTDS  的连接配置文件” 期间输入的‑otdsresource
和‑otdsresourcepassword参数。

要验证激活:

1.  在  OTDS  Web  客户端的Resources页面上, 选择  Exstream  资源,
单击Actions、  
Activation  Status,
然后单击Verify  Activation。
将出现一条消息“资源已激活”。

2.  单击确定关闭对话框。

第  6  步  –  将  strs.role  分区分配给资源
1.  在访问角色页面上,
选择资源,
然后单击操作>查看访问权限
角色详细信息。

2.  在User  Partitions选项卡上,
单击Add,
选择strs.role分区,
然后
单击将选定项目添加到访问角色。

出现一条消息“strs.role  added  to  the  Access  Role。”。

42 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

3.  单击关闭对话框,
然后单击保存。
4. 可选通过单击资源、 单击操作>查看访问角色详细信息来验证strs.role分区是否已分配给资源。
这里strs.role应该列在  User  Partitions  选项卡上。

第  7  步  –  添加具有读取权限的用户
1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击添加>新用户,
然后输入用户详细信息。
示例用户  ID:

‧用户  ID:  strsbrowser

3.  单击下一步并输入密码。

笔记

‧此用户必须将永不过期作为  OTDS  中的密码策略。  ‧此用户不需要是任何组
的成员。

OpenText  Exstream  –  通信服务器管理指南 43
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

4.  单击保存。

提示: 记下此用户名和密码。 这些是在第  60  页的“第  2  步  ‑  使用  


configure_multitenant_otds  操作创建多租户  OTDS  的连接配置文件” 期间输入的‑otdsusername
和‑otdspassword参数。

第  8  步  –  添加受信任的站点
在此示例中,
仅授予本地主机访问权限。

1.  在受信任的站点页面上,
单击添加。

2.  输入https://localhost。

3.  单击保存。

44 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

4.5.3  示例:
添加租户  OTDS
本示例介绍如何在  OTDS  中创建租户。

1.  从目录\install运行以下命令: <OTDS安装

目录>

命令:

C:\OpenText\目录服务 <版本> \安装>otdstenant


‑附加 <租户名称>  <密码>

笔记

‧  <  tenantname>必须为小写。

‧您需要操作系统管理员权限才能运行此
命令。

‧您输入的密码是租户特定管理帐户的密码
即otadmin@otds.admin。
这是登录网络所必需的
管理客户端。

4.5.4  示例:
配置租户  OTDS
本示例介绍如何使用以下内容配置租户  OTDS  :

‧  strs.role分区

‧外流资源

‧分配给Exstream  资源的strs.role分区

‧租户管理员、
租户用户、
审阅者和按需组
用户

‧四个用户 每个组分配一个用户

‧只读(浏览器)
用户

访问  OTDS  Web  客户端

通过以下  URL  打开租户后端的  Web  客户端:

https:// <OTDS  主机><端口>
: /otdstenant/ <租户名称> /otds‑管理员/

第  1  步  –  创建一个名为  strs.role  的分区

在此示例中,
创建了一个非同步分区。

‧在分区页面上,
单击添加>新建非同步用户分区,
输入strs.role,
然后单击保存。

OpenText  Exstream  –  通信服务器管理指南 45
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

第  2  步  ‑  创建组
在租户  OTDS  中,
创建下面列出的组。

创建组:

1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击组选项卡,
然后单击添加>新组。

3.  在组名框中,输入适当的 <组名> , 然后点击


节省。

其中<group  name>是以下之一:

‧  strstenantadmins

‧  strstenantusers

‧  strsreviewers

‧  strsondemandusers

46 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

提示

‧记下用户名和密码。
这些是拥有
访问  Communications  Builder、
控制中心、
Describer  和  Web
应用程序。

第  3  步  –  添加用户并将每个用户分配给一个角色
在租户  OTDS  中,
创建以下四个用户,
然后将每个用户分配给
相应的组。

用户名: 小组作业:

租户管理员 管理员

租户用户 strstenantusers

审稿人 strsreviewers

按需用户 strson需求用户

在此示例中,
密码策略设置为用户无法更改密码并且
为方便起见,
密码永不过期。

要创建用户:

1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >
查看成员。

2.  单击用户选项卡,
然后单击添加>新用户。

3.输入用户名,点击下一步,
配置如下密码
选项:

OpenText  Exstream  –  通信服务器管理指南 47
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

‧重置时不需要更改密码‧用户无法更改密码–  选择‧密码永

不过期–  选择

4.  输入密码。

5.  单击保存。

要将用户分配到组:

1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击用户选项卡,
选择用户,
然后单击操作>编辑成员资格。

3.  单击添加到组。

4.  选择合适的组来添加用户,
点击Add  Selected,
然后
单击关闭。

5.  单击返回返回上一页。

第  4  步  –  为  Exstream  创建资源
1.  在资源页面,
单击添加。

2.  在资源名称框中,
输入资源的名称。
注意:
资源可以有任何名称。

3.  在显示名称框中,
输入资源的显示名称。

4.  单击“保存” ,
然后在“资源激活”
对话框中单击“确定”。

48 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

5.  选择Exstream资源,
点击Actions,  Properties,
然后复制
资源标识符框中的资源  ID 。

提示: 记下资源  ID。 需要激活资源和


设置  Exstream  环境。

第  5  步  –  激活资源
可通过以下  URL  访问  tefault  后端的  OTDS  Rest  API:

http:// :
<otds_host><端口> /otdstenant/ <租户名称> /otdsws/api/索引。
html?rest#!

要激活资源:

1.  打开  OTDS  Rest  API。
2.在列表中点击资源:
对资源的操作
列表已展开。

3.  点击/resources/{resource_id}/activate激活资源

4.  在resource_id字段中,
粘贴资源  ID,
然后单击试用!

OpenText  Exstream  –  通信服务器管理指南 49
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

提示:
记下密钥。

资源  ID(例如f9b7fbf3‑dc85‑4ca1‑8046‑b0e987b3d4c3)
和密钥(例如
“cWMahqHTXxSFdRcVrnsE2g==”) 是在“步骤  2  –  创建与租户  OTDS  的连接配置文件” 期间输
入的‑otdsresource和‑otdsresourcepassword参数configure_tenant_otds  操作”
(第  66  页)。

第  6  步  –  将  strs.role  分区分配给资源
1.  在访问角色页面上,
选择资源,
然后单击操作>查看访问权限
角色详细信息。

2.  在User  Partitions选项卡上,
单击Add,
选择strs.role分区,
然后
单击将选定项目添加到访问角色。

出现一条消息“strs.role  added  to  the  Access  Role。”。

3.  单击关闭对话框,
然后单击保存。

4. 可选通过单击资源、 单击操作>查看访问角色详细信息来验证strs.role分区是否已分配给资源。
这里
strs.role应该列在  User  Partitions  选项卡上。

第  7  步  –  添加具有读取权限的用户
1.  在Partitions页面,
选择strs.role分区,
然后单击Actions  >  View  Members。

2.  单击添加>新用户,
然后输入用户详细信息。

示例用户  ID:

50 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

4.5.示例  –  为  Exstream  设置  OTDS

‧用户  ID:  strsbrowser

3.  单击下一步并输入密码。

笔记

‧此用户必须将永不过期作为  OTDS  中的密码策略。  ‧此用户不需要是任何组的成员。

4.  单击保存。

提示:
记下此用户名和密码。 这些是在第  66  页的“步骤  2  –  使用  configure_tenant_otds  
操作创建租户  OTDS  的连接配置文件” 期间输入的‑otdsusername和‑otdspassword参数。

第  8  步  –  添加受信任的站点
在此示例中,
仅授予本地主机访问权限。

1.  在受信任的站点页面上,
单击添加。

2.  输入https://localhost。

3.  单击保存。

OpenText  Exstream  –  通信服务器管理指南 51
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  4  章为  Exstream  设置  OTDS

4.6  故障排除
‧如果您收到错误消息“OTDSProviderSupportServices:无法针对  OTDS  验证票证。错
误=无法将  Otds  用户:
strsuser@otds.admin  映射到资源:
7ac319d2‑bfbf‑44d9‑ad26‑

d27ba2ad1dbb..”,
您的资源可能无效。
解决此问题的方法是
重新创建资源。

52 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  5  章
准备数据库

本节介绍如何准备用于  Exstream  存储库的数据库以及所需的数据库配置。
不包括如何在第三方产品中进
行配置。
有关此信息,
请参阅数据库供应商提供的用户文档。

在这个部分

‧第  53  页的“软件要求”  ‧第  53  页的“硬件要求”  

‧第  53  页的“数据库配置:
Microsoft®  SQL  Server®”  

‧第  54页的“数据库配置:
Oracle®数据库”

‧  “数据库配置:
PostgreSQL”
(第  55  页)  ‧  “数据库配置:
SAP®  

HANA”
(第  56  页)

软件要求
有关支持的数据库供应商和版本的信息,
请参阅OpenText  Exstream  16.4  发行说明。

注意:同一  Exstream  环境中的所有  Exstream  存储库必须使用相同的数据库供应商。
在多租户环境中,

约束适用于所有客户端组织或租户的所有存储库。

选择数据库版本时,
您应该遵循数据库供应商的指导方针。
请注意,
不支持在生产环境中运行  Express  版
本,
例如  Microsoft  SQL  Server  Express。

Exstream  存储库是逻辑数据库。
这意味着所有存储库都可以驻留在单个  Oracle  模式或  SQL  Server  数据库中,
或者每个存储库都可以驻留在单独的模式或数据库中。

硬件要求
在设置  Exstream  存储库时,
您应该遵循数据库供应商提供的硬件指南。

数据库配置:
Microsoft®  SQL  Server®
数据库必须按照以下配置:

‧启用  TCP/IP。

OpenText  Exstream  –  通信服务器管理指南 53
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  5  章  准备数据库

‧指定混合模式身份验证。  ‧指定用于
从所有  IP  访问数据库的静态  TCP  端口号
地址。

‧选择要使用的排序规则。
避免不同Exstream中的冲突
存储库, 您必须为安装  Exstream  存储库的所有数据库设置相同的排序规则。
有关信息和建议,
请参阅
Microsoft  SQL  Server  联机丛书。

排序规则根据特定语言和区域设置的规范指定如何对字符串进行排序和比较的规则。 默认设置是安装  
SQL  Server  的计算机的排序规则。
例如,
如果您在芬兰安装  SQL  Server,
则建议使用芬兰排序规则。

当您在  Exstream  存储库中搜索项目时,
排序规则决定了搜索结果的排序方式。
例如,
当您通过公共资
产服务搜索资源时。 如果排序规则区分大小写,这也会影响搜索结果。

数据库配置:
Oracle®数据库
数据库必须按照以下配置:

1.  在创建数据库之前指定以下数据库服务器参数:

db_block_size:  8192  (最小值)

如果数据库服务器的内存超过  4  GB,
您可以将此值增加到16384。

2.  创建一个  UTF  数据库:

‧字符集:  AL32UTF8

‧国家字符集:  AL16UTF16

3.  使所有表空间本地管理。

4.  在适用的情况下,
确保表空间是自动段空间
管理。

5.  如果数据库字符集使用多字节字符编码方案,
默认的Unicode支持不够,
可以按照如下所述增加Unicode
支持。

Oracle  Database  12c  配置

‧在tnsnames.ora文件中为要用于  Exstream  存储库的每个  PDB(可插入数据库)
创建一个服务名
称。

如果使用  Oracle  Database  12c  第  2  版,
请将这些行插入到sqlnet.ora文件中:

‧  SQLNET.ALLOWED_LOGON_VERSION_SERVER=11
‧  SQLNET.ALLOWED_LOGON_VERSION=11

54 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

‧  SQLNET.ALLOWED_LOGON_CLIENT=11

增加对  Oracle  数据库的  Unicode  支持

‧默认情况下,
Exstream  使用NVARCHAR2,
它通常提供足够的  Unicode
支持。
要实现更通用的  Unicode  支持,您可以指定
数据库服务器参数如下。 必须在参数之前指定参数
已创建  Exstream  存储库。

‧  nls_length_semantics:
字符

注意:  char值在数据库中需要的空间比
默认字节值。

更改  Oracle  数据库的非默认数据库参数

如果您对  Oracle  安装不满意,
您可能需要更改
以下非默认数据库服务器参数(由
开放文本):

‧  job_queue_processes: <默认>

Communications  Server  应用程序不使用任何数据库作业。
但是,
数据库管理员可能需要job_queue_processes
管理作业的参数。

进程:  300  (最少)

对于较大的环境,
其中有多个  Communications  Server  应用程序
被使用,
您可能需要更高的值。

‧  pga_aggregate_target: <机器内存> ‑ <非  Oracle  RAM> ‑  sga_target

pga_aggregate_target和sga_target的关系取决于
关于用户数量。 从sga_target  =  pga_target开始。

‧  sga_target: <机器内存> ‑ <非  Oracle  RAM> ‑  pga_aggregate_target

pga_aggregate_target和sga_target的关系取决于
关于用户数量。 从sga_target  =  pga_target开始。

‧更改参数后,
您可能必须重新启动  Oracle  数据库。

数据库配置:
PostgreSQL

在postgresql.conf文件中,
配置以下参数:

‧  shared_buffers:
必须至少为  2  GB。

‧  autovacuum  =关闭。
仅需要此设置以避免争用失败
在安装和设置  Exstream  存储库时。

‧  max_prepared_transactions和max_connections必须具有相同的值。

OpenText  Exstream  –  通信服务器管理指南 55
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  5  章  准备数据库

注意:
Postgres  数据库参数配置和数据库服务器
配置将根据估计的事务、 负载和
存储库大小。

数据库配置:
SAP®  HANA
‧  Exstream  支持以单容器或多容器模式安装的SAP  HANA。

注意: 在多容器模式下, OpenText  建议


Exstream  模式安装在一个或多个  SAP  HANA  租户中
数据库(即不在SYSTEMDB数据库中)。  SAP  HANA  租户
必须在任何  Exstream之前在数据库系统中创建数据库
可以在数据库中创建模式。

‧然后必须从  SAP  Service  Marketplace  下载  SAP  HANA  客户端,
并且
安装在将访问  SAP  HANA  系统的所有计算机上。 提供
客户端安装在安装过程中建议的默认位置, 否
客户需要采取进一步行动。

如果  SAP  HANA  客户端安装在默认位置以外的位置, 您
必须手动更新Exstream  脚本中ngdbc.jar文件的路径
以下。 对于  UNIX, 您还必须更新libodbcHDB.so文件的路径。
Windows  ‑   <Exstream_Installation_directory> \ <版本> \服务器\bin\
create‑repo.bat|list‑hotfix‑repo.bat|hotfix‑repo.bat

打开每个脚本并更新以下行中的路径:

设置  CP= ../lib/repoadm.jar;C:\Program  Files\sap\hdbclient\ngdbc.
罐”

UNIX  ‑ .../Exstream‑create‑ <版本> .GA。<构建> / <版本> /服务器/bin/


repo.sh|list‑hotfix‑repo.sh|hotfix‑repo.sh

打开每个脚本并更新以下行中的路径:

classPath= lib/repoadm.jar:/usr/sap/hdbclient/ngdbc.jar

UNIX  ‑ .../Exstream‑ <版本> .GA。<构建> /平台/odbcinst.ini

打开脚本并更新以下行中的路径:

驱动程序=/usr/sap/hdbclient/libodbcHDB.so

56 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  6  章
设置  Exstream  环境

6.1  关于  ss_tenantadmin  实用程序
ss_tenantadmin命令行实用程序用于配置管理网关、
设置和管理  Exstream  租户以
及创建多租户和租户存储库。

在  UNIX  上使用  ss_tenantadmin  实用程序

1.  将$STRS_LOCATION环境变量设置为您安装  Exstream  软件的位置,
例如:

STRS_LOCATION=/usr/Exstream/Exstream‑16.3.0.GA。 <构建>

导出  STRS_LOCATION

2.  运行实用程序:
./启动器解决方案/sstools/start  ss_tenantadmin <参数>

在  Windows  上使用  ss_tenantadmin  实用程序

1.  在命令行窗口中,
浏览到以下目录:
<Exstream_Installation_directory> \ <版本> \服务器\bin

2.  运行以下命令:
ss_tenantadmin.exe <参数>

6.2  配置管理网关和创建多租户仓库

要设置新的  Exstream  环境,
您需要创建多租户存储库,
然后将管理网关连接到多
租户存储库和多租户  OTDS。

为此,
您可以使用  ss_tenantadmin  实用程序执行以下操作:

1.  为多租户存储库创建连接配置文件。
2.  为多租户  OTDS创建连接配置文件。
3.  在数据库中创建多租户存储库(基于之前创建的连接配置文件)。

提示:
如果您不想直接从  ss_tenantadmin.exe  实用程序创建多租户存储库,
您可
以生成用于创建存储库的脚本

OpenText  Exstream  –  通信服务器管理指南 57
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

然后使用外部工具运行脚本。
请参阅第  72  页的“手动创建多租户或租户存储库”。

4.  配置管理网关以使用连接配置文件。
此步骤将管理网关连接到多租户  OTDS和多租户存储库。

完成这些步骤后,
您可以启动管理网关。

先决条件

‧在您将要安装的计算机上安装了Communications  Server
运行命令。

‧数据库已准备好与  Exstream  一起使用。
您拥有数据库管理用户名和密码。

‧多租户OTDS在OTDS  中配置。

您拥有多租户  OTDS的以下信息:

‧  URL  和端口‧资源  

ID  和资源密码‧对  OTDS  服务器具有读取权限的用

户的用户名和密码

第  1  步  –  使用  configure_multitenant_repository  操作创建到多租户存
储库的连接配置文件

句法

示例  6‑1:
使用默认值的  configure_multitenant_repository

此示例在您运行命令的目录中的文件multitenant_respository_profile.xml
中创建连接配置文件。

命令:

示例  6‑2:
configure_multitenant_repository

命令:

58 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

6.2.配置管理网关并创建多租户存储库

‑dbhost  WIN‑53RDK69N3DN\SQLEXPRESS  ‑dbport  1433  ‑dbvendor  sqlserver  
‑dbname  StrsMultiTenantDb  ‑dbusername  MultiTenUsr123
‑dbpassword  MultiTenPwd123  ‑输出“C:\MyConnectionProfiles\
multitenant_respository_profile.xml

参数说明

所有参数都是可选的。

‑dbhost数 <数据库主机>

据库服务器的  IP  地址或主机名。
如果您使用命名实例
对于  SQL  Server,
您必须使用
语法<主机名>\<实例名>。 例如:  gbg5000\instance1。

‑dbport用 <数据库端口号>
于与数据库服务器通信的端口。

‑dbvendor <供应商>

存储库的数据库供应商。
这可以是sqlserver、  oracle、
postgres或hana。

‑dbname <数据库名称>
适用于  SQL  Server、
Postgres  和  SAP  HANA  –  数据库的名称
对于存储库。

‧如果  SAP  HANA  以单容器模式安装,则必须省略‑
dbname参数。

‧如果  SAP  HANA  以多容器模式安装,则分配的  SAP
运行前必须在数据库系统中设置  HANA  租户数据库
ss_tenantadmin。

‑db  服务名 <SID>
适用于  Oracle  –  存储库的  Oracle  服务名称。

‑dbusername管理 <用户名/模式所有者>

网关用于连接的数据库管理用户
到存储库。存储库时自动创建用户
创建的。
您不能使用系统管理员作为用户名(例如,
在)。

在  Oracle  和  SAP  HANA  上,
这将是模式所有者。

‑dbpassword访问 <密码>
存储库的密码。

‑output带 <路径文件>
有连接配置文件的  XML  文件所在的路径和文件名
保存。
如果未指定,则在文件所在的目录中创建文件
命令以默认名称运行。

OpenText  Exstream  –  通信服务器管理指南 59
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

环境文件的路径和文件名。

有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

步骤  2  –  创建到多租户  OTDS  的连接配置文件
使用  configure_multitenant_otds  操作

句法

示例  6‑3:
使用默认值的  configure_multitenant_otds

此示例在名为的文件中创建连接配置文件

命令。

命令:

示例  6‑4:
configure_multitenant_otds

命令:

参数说明

(可选的)

60 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

6.2.配置管理网关并创建多租户存储库

对于默认的  OTDS  后端,
这是
带有  OTDS  服务器的计算机。
这可以指定为  IP  地址或
主机名。
使用主机名时,
OpenText  建议使用完全
限定域名  (FQDN),
以便所有访问  Exstream  的客户端都可以解析
主机名。
例如:  myhostname.mydomain.com

对于  OTDS  租户后端,
这还必须包括  OTDS  的名称
租户格式为/otdstenant/例如myhostname.mydomain.com/otdstenant/
<IP  地址/主机名> <otdstenantname> .
myotdstenantname

‑otdsport  (可 <端口>
选)
用于与  OTDS  通信的端口。

‑otds用户名 <用户名>
OTDS  用户名。
此用户需要对  Exstream  分区的读取权限
OTDS。  Exstream  应用程序使用此用户浏览  OTDS。
‑otdspassword  OTDS  <密码>
密码。

‑otdsresource  OTDS   <resource_ID>
资源  ID。

‑otdsresourcepassword  OTDS  资 <密码>
源的密码。

‑不安全

(可选)
指示使用不安全  HTTP  通信的标志
OTDS。
如果省略,
则使用  HTTPS。
要使用不安全的  HTTP  通信,
还必须在  OTDS  中禁用  HTTPS。

要在  OTDS  中禁用  HTTPS,
必须添加系统属性
directory.auth.EnforceSSL并在系统属性上将值设置为false
OTDS  Web  客户端中的页面。
有关禁用  HTTPS  的更多信息
OTDS  中的通信,
请参阅以下文档:

‧  OpenText  目录服务  ‑  安装中的第  12.1  节“系统属性”
和管理指南  (OTDS‑IWC)

‧  OpenText  目录服务  ‑  安装中的第  3.5.1.2  节“使用加密”
和管理指南  (OTDS‑IWC)

注意:
HTTP  通信只适用于开发和测试
环境。

‑output  (可<路径文件>
选)
与连接的  XML  文件所在的路径和文件名
个人资料将被保存。如果未指定,
则在目录中创建文件
命令以默认名称运行的位置。

‑env <路径文件>
(可选)
环境文件的路径和文件名。

OpenText  Exstream  –  通信服务器管理指南 61
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

第  3  步  –  创建多租户存储库
create_multitenant_db  操作

句法

示例  6‑5:
create_multitenant_repository

本示例基于连接创建多租户存储库

命令:

参数说明

包含连接配置文件的  XML  文件的路径和名称
多租户存储库。

用于创建存储库的数据库管理用户。
为了

(可选)
环境文件的路径和文件名。
有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

62 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

步骤  4  –  配置管理网关以使用
带有  configure_mgw  操作的连接配置文件

句法

例  6‑6:
configure_mgw

此示例将管理网关配置为使用以下内容
在前面的示例中创建的连接配置文件。

命令:

参数说明

包含连接配置文件的  XML  文件的路径和名称
多租户存储库。

包含多租户  OTDS的连接配置文件的文件的路径和名称。

(可选)
环境文件的路径和文件名。

有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

第  5  步  –  启动管理网关服务或进程
视窗

‧在Windows  上,
您可以从Windows  控制面板启动管理网关。

Unix

‧在  UNIX  上,
使用以下命令启动管理网关:

OpenText  Exstream  –  通信服务器管理指南 63
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  6  章  设置  Exstream  环境

例如: ./launcher  ‑后台管理
有关选项的信息,
请输入./launcher  ‑‑help要停止管理网关,
请输入./
launcher  shutdown  management

6.3  添加租户
您必须在每个  Exstream  环境中添加至少一个租户。

将租户添加到  Exstream  环境涉及将租户连接到适当的租户  OTDS,
以及创建新的租户存储
库或将租户连接到现有存储库(共享租户存储库方案)。

为此,
您可以使用  ss_tenantadmin  实用程序执行以下操作:

1.  为租户  OTDS创建连接配置文件。

2.  为租户存储库创建连接配置文件。

3.  如果需要,
在数据库中创建租户存储库。
提示:
如果您不想直接从  ss_tenantadmin.exe  实用程序创建租户存储库, 您
可以生成用于创建存储库的脚本, 然后使用外部工具运行脚本。 请参阅第  72  页的“手动
创建多租户或租户存储库”。

4.  将租户添加到  Exstream  环境。
此步骤将租户连接到租户  OTDS和租户存储库。

添加租户后,
您可以(可选)
使用  ss_tenantadmin  实用程序获取租户  ID。

先决条件

‧在您将要安装的计算机上安装了Communications  Server
运行命令。

‧您拥有多租户管理员用户名和密码。

‧数据库已准备好与  Exstream  一起使用。
您拥有数据库管理用户名和密码。

‧租户OTDS在OTDS  中配置。
您拥有租户  OTDS的以下信息:

‧  URL  和端口

‧资源  ID  和资源密码

‧对  OTDS  服务器具有读取权限的用户的用户名和密码

64 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

步骤  1  –  创建到租户存储库的连接配置文件
使用  configure_tenant_repository  操作

您必须保存连接配置文件并记下位置。这个文件是
需要将修补程序应用于租户存储库。

句法

示例  6‑7:
使用默认值的  configure_tenant_repository

此示例在文件中创建连接配置文件

命令。

命令:

提示:
有关默认值的信息,
请参阅  ss_tenantadmin  帮助(‑h)。

示例  6‑8:
configure_tenant_repository

命令:

参数说明

所有参数都是可选的。

对于  SQL  Server,
您必须使用
语法<主机名>\<实例名>。
例如:  gbg5000\instance1。

OpenText  Exstream  –  通信服务器管理指南 65
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  6  章  设置  Exstream  环境

‑dbvendor <供应商>

存储库的数据库供应商。
这可以是sqlserver、  oracle、
postgres或hana。

‑dbname <数据库名称>
适用于  SQL  Server、
Postgres  和  SAP  HANA  –  数据库的名称
对于存储库。

‧如果  SAP  HANA  以单容器模式安装,则必须省略‑
dbname参数。

‧如果  SAP  HANA  以多容器模式安装,则分配的  SAP
运行前必须在数据库系统中设置  HANA  租户数据库
ss_tenantadmin。

‑db  服务名 <SID>
适用于  Oracle  –  存储库的  Oracle  服务名称。
‑dbusername管理 <用户名/模式所有者>

网关用于连接的数据库管理用户
到存储库。存储库时自动创建用户
创建的。
您不能使用系统管理员作为用户名(例如,
在)。

在  Oracle  和  SAP  HANA  上,
这将是模式所有者。

‑dbpassword访问 <密码>
存储库的密码。

‑output带 <路径文件>
有连接配置文件的  XML  文件所在的路径和文件名
保存。
如果未指定,
则在文件所在的目录中创建文件
命令以默认名称运行。

‑env <路径文件>
环境文件的路径和文件名。
有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

第  2  步  –  创建与租户  OTDS  的连接配置文件
configure_tenant_otds  操作

句法

ss_tenantadmin.exe  ‑action  configure_tenant_otds  ‑otdsusername  ‑otdspassword  
<用户名> ‑otdsresource  otdsresourcepassword
<密码>  <密码> <resource_ID>

示例  6‑9:
使用默认值的  configure_tenant_otds

此示例在名为的文件中创建连接配置文件
运行命令的目录中的tenant_otds_profile.xml 。

66 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

命令:

示例  6‑10:
configure_tenant_otds

命令:

参数说明

对于默认的  OTDS  后端,
这是
带有  OTDS  服务器的计算机。 这可以指定为  IP  地址或
主机名。 使用主机名时, OpenText  建议使用完全
限定域名  (FQDN),
以便所有访问  Exstream  的客户端都可以解析

对于  OTDS  租户后端,
这还必须包括  OTDS  的名称
.

OTDS。  Exstream  应用程序使用此用户浏览  OTDS。

OTDS  资源  ID。

OpenText  Exstream  –  通信服务器管理指南 67
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

(可选)
指示使用不安全  HTTP  通信的标志
OTDS。
如果省略,
则使用  HTTPS。
要使用不安全的  HTTP  通信,
还必须在  OTDS  中禁用  HTTPS。

要在  OTDS  中禁用  HTTPS,
必须添加系统属性
directory.auth.EnforceSSL并在系统属性上将值设置为false
OTDS  Web  客户端中的页面。
有关禁用  HTTPS  的更多信息
OTDS  中的通信,
请参阅以下文档:

‧  OpenText  目录服务  ‑  安装中的第  12.1  节“系统属性”
和管理指南  (OTDS‑IWC)

‧  OpenText  目录服务  ‑  安装中的第  3.5.1.2  节“使用加密”
和管理指南  (OTDS‑IWC)

注意:
HTTP  通信只适用于开发和测试
环境。

个人资料将被保存。如果未指定,
则在目录中创建文件
命令以默认名称运行的位置。

(可选)
环境文件的路径和文件名。

有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

第  3  步(可选)–  创建一个租户存储库, 其中包含
create_tenant_repository  操作

句法

示例  6‑11:
create_tenant_repository

此示例根据中的连接配置文件创建租户存储库

命令:

68 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

6.3.添加租户

“C:\MyConnectionProfiles\tenant_respository_profile.xml”
‑dbadminusername  到  ‑dbadminpassword  Changeoninstall2000

参数说明:

‑mtauser <用户名>
多租户管理员用户名。
此用户必须是
多租户管理员组。

‑mtapassword多租 <密码>
户管理员用户的密码。

‑tenantdbprofile包含连接 <路径和文件>
配置文件的  XML  文件的路径和名称
租户存储库。
提示:
创建服务网关应用程序后,
您可以在
工作目录中的securityprofiles文件夹。
示例位置:  C:
\ManagementGateway\16.3.0\root\applications\servicegateway\wd
\securityprofiles\tenantser‑{5A8BD911‑281F  A64D‑9BEF‑5A3CFC9F9657}‑
securityprofile.xml

‑dbadmin  用户名 <用户名>
用于创建存储库的数据库管理用户。
为了
例如,
系统管理员sa。

‑dbadminpassword数据库 <密码>
管理用户的密码。

‑env <路径文件>
(可选)
环境文件的路径和文件名。

有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

步骤  4  –  创建一个使用连接配置文件的租户
create_tenant  操作

句法

ss_tenantadmin.exe  ‑action  create_tenant  ‑mtauser  mtapassword   <用户名>  <路径文件

<密码>  <路径文件‑tenantname
‑tenantdbprofile  tenantotdsprofile   >  <租户名>

>

示例  6‑12:
create_tenant

此示例使用连接配置文件添加租户:

‧  C:\MyConnectionProfiles\tenant_respository_profile.xml

OpenText  Exstream  –  通信服务器管理指南 69
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

命令:

参数说明

多租户管理员用户名。
此用户必须是
多租户管理员组。

租户存储库。

包含租户连接配置文件的文件的路径和名称
OTDS。

租户的名称。
租户管理员和租户需要此名称
用户等登录  Exstream  工具,
例如  Control  Center  和  Describer。

(可选)
环境文件的路径和文件名。

有关可用于的一般参数的信息
ss_tenantadmin,
请参阅“ss_tenantadmin  附加(可选)
参数”
在第  70  页。

ss_tenantadmin  附加(可选)
参数

70 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

提示:
有关默认值的信息,
请参阅  ss_tenantadmin  帮助( ‑h)。

6.4  添加管理网关
要将管理网关添加到  Exstream  环境,
您需要将管理网关连接到多租户存储库和多租户  OTDS。

为此,
您将带有连接配置文件的  XML  文件复制到多租户存储库,
并将多租户  OTDS  复制到具有要
添加到环境中的管理网关的计算机, 然后配置新的管理网关以使用该连接配置文件。

添加管理网关

1.  将带有连接配置文件的  XML  文件从现有位置复制到多租户存储库和多租户  OTDS 。

例如,
复制这些文件:

3.从您要添加的管理网关的计算机上, 运行
ss_tenantadmin.exe与configure_mgw操作。
在此命令中,
您指出两个连接配置文件的
位置。 示例命令:

有关此语法的说明, 请参阅第  63  页的“步骤  4  –  配置管理网关以使用连接配置文件
和  configure_mgw  操作”。

4.  启动管理网关服务或进程。

OpenText  Exstream  –  通信服务器管理指南 71
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

6.5  创建多租户或租户存储库
手动
如果您不想直接从
ss_tenantadmin.exe  实用程序,
您可以生成用于创建存储库的脚本
然后使用外部工具运行脚本。

要生成脚本, 您可以在  Windows  上使用create‑scripts.bat或在  UNIX上使用  create  
scripts.sh 。
该文件位于:

这将创建一个包含两个脚本的  ZIP  文件:

有关如何运行脚本的信息,
请参阅以下部分:

‧  “执行数据库脚本:
Microsoft  SQL  Server”
(第  131  页)
‧  “执行数据库脚本:
Oracle  数据库”
(第  131  页)
‧  “执行数据库脚本:
PostgreSQL”
(第  132  页)
‧  “执行数据库脚本:
SAP  HANA”
(第  133  页)

Windows  –  生成脚本的语法

UNIX  –  生成脚本的语法

示例  6‑13:
在  Windows  上生成脚本

参数说明

‑r  <repository_type>
存储库的类型。
这必须是以下之一:

72 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

6.6.为管理网关设置安全通道

‧  StrsMultiTenantModel  –  用于多租户存储库。

‧  StrsTenantModel  –  用于租户存储库。

‑s  <脚本目录>
包含数据库脚本的目录的路径:
窗户‑ <基本目录> \ <版本> \根\配置\数据库\

UNIX  ‑ <项目位置> /配置/数据库/

‑t  <respository_connection_profile>
多租户或租户存储库的连接配置文件。 更多
有关如何生成此连接配置文件的信息, 请参阅:

‧  “第  1  步  –  创建到多租户存储库的连接配置文件,
使用
configure_multitenant_repository  操作”
(第  58  页)

‧  “第  1  步  –  创建到租户存储库的连接配置文件,
使用
configure_tenant_repository  操作”
(第  65  页)

‑z  <ZIP_file_location>
将保存脚本的位置。

6.6  建立安全管理通道
网关
要设置或更改管理网关的安全通道, 您必须生成一个
管理网关使用的私有密钥库文件(*.pfx)和证书文件
(*.crt)供控制中心和所有命令行实用程序(ss_ )  使用。 <实用程序>

生成私钥库和证书后,
您必须更新
带有新私有的配置文件mgw‑trustedcommunicationchannel.xml
密钥库和相应的密码。
该文件位于以下目录中:

<Exstream_Installation_directory><版本> \ \服务器\解决方案
\管理

生成私钥库

1.  打开命令提示符并转到:

<Exstream_Installation_directory> \global\security\keystore
\私人的

2.  运行以下命令:

keytool  ‑genkey  ‑alias  tomcat  ‑storetype  PKCS12  ‑keyalg  RSA
‑keysize  2048  ‑keystore <密钥库> .pfx  ‑有效期  3650

这个在 <密钥库> 是私钥库的名称(您可以使用任何名称


哪里)。
提示:您可能需要输入  Java  keytool  的路径, 例如:  C:
\程序文件\Java\ <Java  版本> \垃圾桶

OpenText  Exstream  –  通信服务器管理指南 73
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

示例  6‑14:
命令示例(私钥库)

运行命令时,您必须回答几个问题,包括
用于私有密钥库的密码。记下密码(您
稍后将需要它)。

生成证书

1.  在命令提示符下,
转到:

2.  运行以下命令:

地点和 是证书的名称(您可以为此使用任何名称)
地点 是您之前创建的私钥库的名称。

示例  6‑15:
命令示例(证书)

更新配置文件

1.在文本编辑器中打开mgw‑trustedcommunicationchannel.xml 。

2.  向下滚动到<file>标签( <keystores>标签的子标签)
并编辑
属性:

私钥库。

生成了私钥库。

3.  保存mgw‑trustedcommunicationchannel.xml并关闭编辑器。

74 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

6.7  配置管理网关
虚拟主机

在虚拟主机上或在以下环境中运行管理网关时

mgmgateway.xml文件中的属性。

默认情况下(即不使用虚拟主机设置时), 管理网关
查询操作系统以获取主机名或  IP  地址,
然后使用它
在启动期间注册自身的信息。如果添加了虚拟主机设置, 则
管理网关不查询操作系统。相反, 它使用

为管理网关配置虚拟主机属性

1.  从以下位置打开mgmgateway.xml文件:

2.  添加元素<virtualhost  name=  <implementation  
module= mgmgateway >元素。
在哪里:

‧  <MyMGWMachine>是管理网关的  IP  地址或名称
主持人。您可以使用任何名称, 只要客户端可以解析  IP  地址
或名称。

示例  6‑16:
管理网关虚拟主机配置

3.  保存并关闭mgmgateway.xml文件。

4.  重启管理网关。

5.  如果运行  Web  应用程序,
请验证nslookup查询是否适用于
具有服务网关的计算机上的虚拟主机名和
带有网络浏览器的计算机。

OpenText  Exstream  –  通信服务器管理指南 75
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第七章
管理租户

7.1  列出租户
您使用get_all_tenants命令列出所有租户的名称和  ID
在环境中。

句法

示例  7‑1:
get_all_tenants

参数说明

多租户管理员用户名。
此用户必须是
多租户管理员组。

‑mtapassword多
租户管理员用户的密码。

(可选)
环境文件的路径和文件名。

有关‑mgwhost、  ‑mgwport和‑mgwtimeout参数的信息
可与此命令一起使用,
请参阅“ss_tenantadmin  附加(可选)
论点”
第  70  页。

OpenText  Exstream  –  通信服务器管理指南 77
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

7.2  获取租户ID
您可以使用get_tenant命令查找租户的  ID。

句法

示例  7‑2:
get_tenant

此示例在接收租户时返回租户的  ID(如果找到)
姓名。

命令:

参数说明

租户的名称。

多租户管理员用户名。
此用户必须是
多租户管理员组。

(可选)
环境文件的路径和文件名。

可与此命令一起使用,
请参阅“ss_tenantadmin  附加(可选)
论点”
第  70  页。

78 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

7.3  更改租户名称、
描述或
连接配置文件
您使用modify_tenant命令更改租户名称、
描述、
到租户存储库的连接配置文件, 或到租户的连接配置文件
OTDS。

要将连接配置文件更改为租户  OTDS或租户存储库, 您必须
在运行modify_tenant命令之前创建新的连接配置文件。
有关如何创建连接配置文件的信息, 请参阅以下内容
部分:

‧  “第  1  步  –  创建到租户存储库的连接配置文件,
使用
configure_tenant_repository  操作”
(第  65  页)。

‧  “第  2  步  –  创建与租户  OTDS  的连接配置文件,
使用
configure_tenant_otds  操作”
(第  66  页)

句法

示例  7‑3:  modify_tenant

此示例将连接配置文件更改为租户  OTDS,

到租户存储库的连接配置文件和租户名称。

命令:

参数说明

(条件) 您要修改的租户的  ID。
请参阅“获取
租户  ID ”。

‑tenantID或‑tenantname命令是必需的。

(条件)
您要修改的租户的名称。

OpenText  Exstream  –  通信服务器管理指南 79
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  7  章  管理租户

‑tenantID或‑tenantname命令是必需的。

‑mtauser <用户名>
多租户管理员用户名。 此用户必须是多租户管理员组的成员。

‑mtapassword多 <密码>
租户管理员用户的密码。

‑tenantdbprofile  (可 <路径文件>
选)
包含租户存储库的新连接配置文件的  XML  文件的路径和名称。

‑tenantotdsprofile <路径文件>
(可选)
包含租户  OTDS的新连接配置文件的文件的路径和名称。

‑newtenantname <租户名称>
(可选) 租户的新名称。 租户管理员和租户用户等需要此名称来登录  Exstream  工具,

如  Control  Center  和  Describer。

‑tenantdesc <说明>
(可选)
添加租户的描述。

‑env <路径文件>
(可选)环境文件的路径和文件名。

有关可用于此命令的‑mgwhost、  ‑mgwport和‑mgwtimeout参数的信息,
请参阅第  70  页的
“ss_tenantadmin  附加(可选)
参数”。

7.4  向租户添加  OTMM  或  Content  Server  连接配置文件

在这个部分

‧第  80  页上的“向租户添加连接配置文件”

‧  “从租户中删除连接配置文件”
(第  85  页)

向租户添加连接配置文件
要从租户连接到  OpenText™  媒体管理  (OTMM)  或  OpenText™  Content  Server,
您必须使用
add_connectionprofile命令将  OTMM/Content  Server  配置文件添加到租户。

对于每个租户,
您可以为  OTMM  添加一个连接配置文件,
为  Content  Server  添加一
个连接配置文件。

80 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

注意:
确保文件中指定的  API  版本

OTMM  服务器。

句法

示例  7‑4:
add_connectionprofile

此示例将  OTMM  连接配置文件添加到租户。

命令:

参数说明

(条件)
租户的  ID。
请参阅“获取租户  ID ”。
‑tenantID或‑tenantname命令是必需的。

(条件)
租户的名称。
‑tenantID或‑tenantname命令是必需的。

包含连接配置文件的文件的路径和名称。 请参阅“创建
OTMM  的不安全  XML  连接配置文件”
第  82  页。

每个租户的每种类型只能有一个连接配置文件。

OpenText  Exstream  –  通信服务器管理指南 81
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  7  章  管理租户

‑mtauser <用户名>
多租户管理员用户名。
此用户必须是
多租户管理员组。

‑mtapassword多租 <密码>
户管理员用户的密码。

‑env <路径文件>
(可选)
环境文件的路径和文件名。

有关‑mgwhost、  ‑mgwport和‑mgwtimeout参数的信息
可与此命令一起使用,
请参阅“ss_tenantadmin  附加(可选)
论点”
第  70  页。

为  OTMM  创建不安全的  XML  连接配置文件

1.  要使用连接配置文件创建文件,
请打开名为
otmmconnection_16.4.0.default从以下位置:
<Management_Gateway_root_directory><版本> \ \根\配置
\ <版本> \Otmm  连接。

2.  将文件的副本保存在任意目录中。
例如在C  下:
\MyConnectionProfiles\profile_configuration‑OTMM‑securityprofile。
xml。

3.  在副本中,
更新以下属性和元素:

租户  ID
租户的  GUID。
请参阅“获取租户  ID ”。

网址
媒体管理存储库  Web  服务的地址。

港口
用于与  OTMM  通信的端口。
默认的  HTTP  端口是
11090。

姓名
访问  OTMM  的用户名。

密码
访问  OTMM  的密码。

示例  7‑5:
OTMM  不安全连接配置文件示例

<securityprofiles  xmlns= ...   owner= Otmmconnection   guiroot= true >

<connectionprofile  type= ...   name= ...   


tenantID= tenantGUID >
<配置>
<ws  xmlns= ... >
<url>http://localhost</url>
<端口>11090</端口>
...

82 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

7.4.向租户添加  OTMM  或  Content  Server  连接配置文件

...
</ws>
</配置>
</connectionprofile>
<authenticationprofile  type= ...   name= ...   guiname= OTMM
用户 tenantID= ... >
<配置>
<简单的  xmlns= ... >
<name>strsOtmmUser</name>
<password>strsOtmmUserPass</password>
</简单>
</配置>
</authenticationprofile>  </
securityprofiles>

为  OTMM  创建安全  XML  连接配置文件

1.  要使用连接配置文件创建文件,
请打开名为
otmmconnection_16.4.0.secure从以下位置:
<Management_Gateway_root_directory><版本> \ \根\配置
\ <版本> \Otmm  连接。

2.  将文件的副本保存在任意目录中。
例如在C  下:
\MyConnectionProfiles\profile_configuration‑OTMM‑securityprofile。
xml。

3.  在副本中,
更新以下属性和元素:

租户  ID

租户的  GUID。
请参阅“获取租户  ID ”。
证书

指定设置安全连接时要使用的证书文件,
以及
适用的密码和别名。
网址

媒体管理存储库  Web  服务的地址。
港口
用于与  OTMM  通信的端口。
默认的  HTTPS  端口是
11443。

姓名

访问  OTMM  的用户名。

密码
访问  OTMM  的密码。

4.  将指定的证书文件添加到目录:
<Exstream  安装目录> \ <版本> \服务器\全局\安全
\certificatestore\trusted\authorities\。

OpenText  Exstream  –  通信服务器管理指南 83
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  7  章  管理租户

示例  7‑6:
OTMM  安全连接配置文件示例

<securityprofiles  xmlns= ...   owner= Otmmconnection   guiroot= true >  


<connectionprofile  type= ...   name= ...   tenantID= tenantGUID >  
<configuration>

...
...
<certificates>  
<certificate  ref= file://otmm.cer  pwd= PASSWORD   alias= otmm   
aliaspwd= PASSWORD />  </certificates>

...
...
</configuration>  </
connectionprofile>

<connectionprofile  type= ...   name= ...   


tenantID= tenantGUID >  <配置>

...
...
<安全通道>
<protocol>TLSv1</protocol>  
<authentication>Mandatory</authentication>  
<verification>Disabled</verification>  <certificatestoreprofile  
value= ... />  </securechannel>

...
...
</configuration>  </
connectionprofile>

<connectionprofile  type= ...   name= ...   


tenantID= tenantGUID >  <配置>

<ws  xmlns= ... >


<url>https://localhost</url>  
<port>11443</port>
...
...
</ws>  
</configuration>  </
connectionprofile>  
<authenticationprofile  type= ...   name= ...   guiname= OTMM
用户 tenantID= ... >  
<configuration>  <simple  
xmlns= ... >  
<name>strsOtmmUser</name>  
<password>strsOtmmUserPass</password>  </simple>  
</configuration>

84 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

从租户中删除连接配置文件
您可以使用以下命令从租户中删除  OTMM  或  Content  Server  连接配置文件
remove_connectionprofile命令。

句法

示例  7‑7:
remove_connectionprofile

此示例从租户中删除  OTMM  连接配置文件。

命令:

参数说明

(条件)
租户的  ID。
请参阅“获取租户  ID ”。

‑tenantID或‑tenantname命令是必需的。

‑tenantID或‑tenantname命令是必需的。

多租户管理员用户名。
此用户必须是
多租户管理员组。

OpenText  Exstream  –  通信服务器管理指南 85
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  7  章  管理租户

‑mtapassword <密码>
多租户管理员用户的密码。
‑env <路径文件>
(可选)
环境文件的路径和文件名。
有关‑mgwhost、  ‑mgwport和‑mgwtimeout参数的信息
可与此命令一起使用, 请参阅“ss_tenantadmin  附加(可选)
论点”第  70  页。

86 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  8  章

实现  OpenText  私人帮助服务器

8.1  为  Exstream  实现  OpenText  私人帮助服务器

Exstream  在线帮助使用  OpenText  Global  Help  Server  系统提供,
该系统为用户提供对
最新版本在线帮助的实时访问。
如果您不想使用  OpenText  Global  Help  Server  系统, 您可以选择下载在线帮助文件的副本并
通过部署  OpenText  Private  Help  Server  将它们托管在本地服务器上。

注意: 私人帮助服务器可以支持多个  OpenText  产品。 如果您的组织中已经安装了  Private  


Help  Server  以支持另一个  OpenText  产品,
您可以将  Exstream  在线帮助添加到该安装
中。

设置私人帮助服务器需要您完成以下一般任务:

1.  使用以下内容准备服务器:

‧  Apache  Tomcat  7  或  8  应用服务器。
‧  Java  1.6  或更高版本。
2.  从  OpenText  My  下载并提取产品帮助文件的副本
支持。
3.  部署  Private  Help  Server,
其中包含一个可以定位的  Web  应用程序
并返回本地部署的帮助文件。
4.  配置产品以将帮助请求定向到私人帮助服务器。

注意:  Exstream  在线帮助包含一个用于配置的帮助集和另一个用于管理的帮助集。

OpenText  Exstream  –  通信服务器管理指南 87
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  8  章  实现  OpenText  私人帮助服务器

8.1.1  下载  OpenText  Private  Help  Server  Kit  和产品在线帮助文件

设置  OpenText  Private  Help  Server  Kit  的第一步是收集所需的文件。
其中包括:

‧  OpenText  我的支持上提供了  OpenText  Private  Help  Server  Kit:
https://knowledge.opentext.com/go/62360624

‧私人帮助服务器将托管的产品在线帮助文件的副本。

8.1.2  部署私人帮助服务器

您可以通过完成下述任务来安装  Private  Help  Server  应用程序。

提取文件
将  Private  Help  Server  Kit  解压缩到一个临时目录。
您将修改此工作目录中的文件,
然后在后面的步骤中将它
们部署到您的站点。

笔记

‧  Private  Help  Server  Kit  包含两个类似名称的文件, 一个
与  Apache  Tomcat  7.x  兼容, 另一个与  Apache  Tomcat  8.x  兼容。
在设置过程中, 您需要通过删除与您的  Apache  Tomcat  版本兼容的文件的版本信息来重命名这些
文件。

‧  Private  Help  Server  Kit  支持两个帮助文件分支,
帮助和
pi_hosted,
并包含每个分支的支持文件。  Exstream  使用pi_hosted分支。

提取文件后,
您应该会看到包含以下内容的Private  Help  Server  Kit目录:

‧应用程序目录:
包含私人帮助服务器docsapimapper.war
Web  应用程序文件。
‧  help_support目录:
包含帮助分支的支持文件:

‧  docsapimapper.xml.tomcat <版本>

Web  应用程序描述符文件。

‧  docsapimapper.properties:
在帮助分支和安装路径下声明已安装产品帮助的配置属性文件。  ‧  
pi_hosted_support目录:
包含pi_hosted分支的支持文件:

‧  docsapimapper.xml.tomcat <版本>

Web  应用程序描述符文件。

‧  pidocsapimapper.properties:
在pi_hosted分支和安装路径下声明已安装产品帮助的配置属性文件。

88 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

8.1。
为  Exstream  实现  OpenText  私人帮助服务器

‧示例目录:
包含从每个分支的工作示例部署中获取的示例描述符和配置文件。
不要在部署中使用这些文件。

‧  _readme.txt:
文件的摘要描述,
供用户使用,
无需
访问本指南中的信息。  ‧  docs.zip:
用于验证

您的私人帮助服务器部署的示例帮助文件。  ‧测试帮助页面‑  OT  Private  Help  Server.zip:
可用于连接

到您的Private  Help  Server  部署的示例页面。

创建本地帮助目录
您必须创建<help_root>目录,
您将在该目录中部署您希望通过专用帮助服务器提供的帮助文件,

后添加用于验证您的部署的测试文件。

创建  <help_root>  目录:

1.  创建您将提取在线帮助文件的目录,
例如C:
\ot_docs。
<  help_root>目录可以存在于任何本地驱动器上,
但其路径不得包含任何带空格的名称。

2.  将docs.zip文件中的示例帮助文件解压到<help_root>目录中。

注意:
当您提取  OpenText  在线帮助文件时,
请始终使用提取全部选项。

3.解压文件后,
打开 <help_root> /docs/pi_hosted/test/
v160200/test‑h‑ugd/en/ofh目录并验证是否提取了以下文件:

‧  context.properties

‧  index.html

创建帮助文件夹别名
您需要定义专用帮助服务器应用程序可以用来定位在线帮助文件的别名。

创建帮助文件夹别名:

1.  在解压  zip  文件的pi_hosted_support文件夹中,
将您的  Tomcat  版本的文件重命名为
<版本>
docsmapperapi.xml.tomcatdocsmapperapi.xml。

2.  在文本编辑器中打开docsmapperapi.xml文件,
然后找到<Context>元素。

3.  将<help_root>替换为您创建的帮助文件目录的完整路径
在“创建  <help_root>  目录:”
中。

OpenText  Exstream  –  通信服务器管理指南 89
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  8  章  实现  OpenText  私人帮助服务器

例如,
使用上面创建的文件夹,
Apache  Tomcat  7.x  的设置
在  Windows  上是:

<?xml  版本= 1.0   编码= UTF‑8 ?>


<上下文别名= /docs/pi_hosted=C:\ot_docs\docs
\pi_hosted  </上
下文>

注意:在非  Windows  操作系统上,
使用适当的斜杠,
双引号和括号, 例如:

<上下文别名= /docs/pi_hosted=C:/ot_docs/docs/pi_hosted >

Apache  Tomcat  8.x  的相同示例是:

<?xml  版本= 1.0   编码= UTF‑8 ?>


<上下文>
<资源
className= org.apache.catalina.webresources.StandardRoot   >
<PreResources  webAppMount= /docs/pi_hosted   base= C:/
ot_docs   
className= org.apache.catalina.webresources.DirResourceSet  />  </Resources>  </Context>

创建配置属性目录
您必须创建一个属性文件,
其中包含查找您的
帮助文件。

要创建配置属性目录和文件:

1.  创建一个文件夹,将存储配置属性文件, 称为
属性根目录。
例如C:\ot_docsconfig\properties
\docsmapper。

注意:您可以在任何本地驱动器上创建属性根目录,
但是
目录路径必须:

‧不包含任何空格或特殊字符。

‧包含子目录\properties\docsmapper。
例如,
如果
属性根目录为C:\ot_docsconfig,
完整路径为C:
\ot_docsconfig\properties\docsmapper。

2.  在pi_hosted_support文件夹中,
复制pidocsapimapper.properties文件
从提取的文件到目录。 <properties_root> \properties\docsmapper

3.  在文本编辑器中打开pidocsapimapper.properties文件并定义
webserverHelpRoot和techDocs  Root设置如下:

90 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

8.1。
为  Exstream  实现  OpenText  私人帮助服务器

webserverHelpRoot本
地帮助的  Tomcat  根  URL。
该  URL  包含以下信息:

http:// :
<主机><端口> /docsapimapper/docs/pi_hosted

其中<host>是部署  Tomcat  的服务器,  <port>是  Tomcat  侦听的端口。
例如,
在名为host  
的服务器上。  mycompany.com监听8080  端口, 设置为:

http://host.mycompany.com:8080/docsapimapper/docs/pi_hosted

注意:
将完整的服务器名称或  IP  地址指定为<host>值。
不要使用本地主机。
此外,您使用的值必须用于所有<host>设置, 包括  URL。  IP  地
址不会解析为主机名,主机名也不会解析为  IP  地址。

techDocs  Root存
储帮助文件的目录的路径。
例如C:/ot_docs/docs/pi_hosted。

<product_code>
每个  OpenText  产品在线帮助都由一个特定的产品代码标识。
在文件的<PRODUCT  CODE>部分中, 创建一个新行并将您的产品代码指定为
<product_code>=<product_code>。

注意:  Exstream  帮助包括以下产品代码:

ccmprj

ccmevt

ccmpto

ccmst

ccmsys

示例  8‑1:
示例  pidocsapimapper.properties  文件

#  所有由  <  >  标记的值都必须更新。
#  这个文件应该在应用服务器类路径上。

#  URL  和目录映射  #  helproot  服务器必须匹配  JS  
设置  webserverHelpRoot=http://host.mycompany.com:8080/
docsapimapper/docs/pi_hosted

#帮助文件夹根目录的路径  techDocsRoot=C:/
ot_docs/docs/pi_hosted

#  <产品代码>

OpenText  Exstream  –  通信服务器管理指南 91
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  8  章  实现  OpenText  私人帮助服务器

#  产品目录映射  ‑  将与实时私人帮助服务器实现中的  OpenText  产品名称设置相同。

#  请参阅您的产品文档以了解您的产品的具体价值。

#  一些  OpenText  产品代码是:  #  媒体管理:
medmgt=medmgt  #  InfoFusion: inf=inf  #  Web  体验管理:
wcmgt=wcmgt  #  注意: test=test  是验证初始设置所必需的。
测试=测试

ccmprj=ccmprj

ccmevt=ccmevt

ccmpto=ccmpto

ccmstt=ccmstt

ccmsys=ccmsys

#  使用默认语言环境  defaultLocale=en

#  参数名称  ‑  除非有说明,
否则请勿修改  product=product  version=version  locale=locale  
context=context  module=module  type=type  securityKey=security

安装描述符和应用程序文件
测试私人帮助服务器之前的最后一步是部署应用程序文件。

要安装文件并启动应用程序:

重要完成这
些任务后,
确认  Tomcat  服务没有运行。

<Tomcat_home>
1.  将docsapimapper.war文件复制到\webapps目录中。
如果文件夹中有现有的docsapimapper目录或docsapimapper.war文件,请将其删除。

2.  将docsapimapper.xml文件从工作目录复制到
<Tomcat_home>\conf\Catalina\localhost目录。
如果Catalina\  localhost目录不存在,
请创建它。

92 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

8.1。
为  Exstream  实现  OpenText  私人帮助服务器

3.  将您在第  90  页的“创建配置属性目录和文件:”中创建的<properties_root>  (例如C:\ot_docsconfig)
添加到  Tomcat  Java  类路径。

例如, <x> 单击Java选项卡,


在  Windows  上运行\bin文件夹中的tomcatw.exe文件, 然 <Tomcat_home>
后将属性根路径附加到Java  类路径字段。 在非  Windows  上,
使用setenv.sh命令设置路径。

4.  启动Tomcat。

测试私人帮助服务器
Tomcat  启动后,
您可以通过  Private  Help  Server  Test  Page  向其提交  URL  请求来测试部署。
测试页面包含
一个简单的  JavaScript  函数,
该函数模拟一个在线帮助按钮, 该按钮可以调用私人帮助服务器中包含的测试帮
助页面。

注意:
测试页旨在验证您的私人帮助服务器是否已正确安装和配置。
该页面使用一种简单的方法来请
求可能不适用于所有在线帮助格式的帮助文件。
请勿尝试修改页面以访问其他在线帮助文件或超出以下
过程中描述的任务。

测试私人帮助服务器:

1.  将测试帮助页面  ‑  Private  Help  Server.zip文件提取到一个工作
目录。

注意:
当您提取  OpenText  在线帮助文件时,
请始终使用提取全部选项。

2.  在解压的Test  Help  Page  ‑  OT  Private  Help  Server文件夹中,
找到pi_hosted\TestPage.html文件,
然后
在文本编辑器中打开它。

3.  找到urlRoot:设置,
然后将<host>和<port>值替换为您的  Tomcat  服务器名称和它侦听的端口。

4.  保存文件,
然后在浏览器中打开它。

注意:
我们建议您使用最新版本的  Firefox  或  Chrome  浏览器。

5.  单击测试您的本地服务器以测试您的部署。

该页面将根据您对  HTML  文件所做的设置显示将尝试打开的  URL。

如果  Private  Help  Server  部署正确,
URL  将被处理并返回一个帮助页面,
确认部署工作正常。

OpenText  Exstream  –  通信服务器管理指南 93
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  8  章  实现  OpenText  私人帮助服务器

部署其他帮助文件
成功设置私人帮助服务器后,您可以部署其他
除了测试文件之外的产品帮助文件。

要部署其他帮助文件:

1.  停止  Tomcat。
2.  将附加帮助文件解压到您在“创建” 中创建的帮助根文件夹中
<help_root>  目录:
“。

注意:
在线提取  OpenText  时,
请始终使用“全部提取”
选项
帮助文件。

3.  通过执行以下命令更新  Private  Help  Server  帮助注册表
命令行提示符下的命令:
java  ‑jar <tomcat_home><版\webapps\OTHelpServer\WEB‑INF\lib
\HelpServer‑ 本> .jar  ‑d <帮助目录> ‑s

其中<tomcat_home>是  Tomcat  安装路径,  <version>是
jar文件名中的可选版本号,  <help_dir>是帮助根目录
文件夹。 例如,以下命令更新帮助注册表
帮助根文件夹C:\ot_docs\docs\pi_hosted:

java  ‑jar  C:\PROGRA~1\APACHE~1\TOMCAT~1.0\webapps\OTHelpServer
\WEB‑INF\lib\HelpServer‑16.0.0.jar  ‑d  C:\ot_docs\docs\pi_hosted  ‑s

4.  编辑pidocsapimapper.properties文件并为您的产品添加产品代码
在测试设置test=test下方的行上提供帮助。 有关详细信息,请参阅
“创建配置属性目录” (第  90  页)。

5.  重启Tomcat。

访问帮助文件可以使用TestPage.html文件,
只要修改
设置以反映您的帮助值。您可以从
将帮助文件解压缩到帮助文件夹后的文件路径。

帮助文件路径使用以下约定:

<帮助根><类型> /docs/pi_hosted/ /
<产品><版本><模块><语言> / / /

例如,  OpenText  Web  体验管理  ‑  内容工作区帮助
(WCMGT‑H‑UGD)  16.4版在线帮助解压到以下路径:

<帮助根> /docs/pi_hosted/wcmgt/v160400/wcmgt‑h‑ugd/en/ofh

因此,
要使用TestPage.html文件,
必须将  JavaScript  设置更新为
如下:

产品: wcmgt ,
版本: v160400 ,

94 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

8.1。
为  Exstream  实现  OpenText  私人帮助服务器

类型: ofh , 模
块: wcmgt‑h‑ugd

注意:  Exstream  有一个用于配置的帮助集和另一个用于管理的帮助集。
当您更新  
JavaScript  时,
您可以在每个帮助集中设置与一个模块的连接。

要测试配置帮助集,
请按如下方式更新  JavaScript:

产品: ccmprj ,

版本: v160200 ,

类型: ofh ,

模块: ccmprj‑h‑cgd

要测试管理帮助集,
请按如下方式更新  JavaScript:

产品: ccmsys ,

版本: v160200 ,

类型: ofh ,

模块: ccmsys‑h‑agd

修改您安装的产品以使用私人帮助服务器
在成功部署和测试专用帮助服务器并将产品联机帮助副本添加到其中后, 您就可以修改  Exstream  
的安装,
以将帮助请求从  OpenText  全局帮助服务器重定向到您的专用帮助服务器。有关详细信
息,
请参阅第  96  页的“将帮助调用重定向到专用帮助服务器”。

8.1.2.1  私人帮助服务器故障排除
如果您在尝试设置私人帮助服务器时遇到错误,
请检查以下常见问题:

‧确认您在必须在设置中指定的任何文件夹路径中使用了正确的斜杠。
文件夹路径中斜线的方向对
于某些操作系统可能很重要。

‧验证Tomcat  类路径设置是否正确。您指定的路径不应包含properties  \docsmapper文件夹;
它应该指定您创建这些子文件夹的文件夹的路径。 有关设置  Tomcat  类路径的更多信息, 请参
阅第  92  页的“安装描述符和应用程序文件”。

‧分析hosteddocslog中的日志文件。 <Tomcat_home> \logs文件夹,


包括该文件以获取更多信
<日期> 息。

OpenText  Exstream  –  通信服务器管理指南 95
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  8  章  实现  OpenText  私人帮助服务器

8.1.3  将帮助调用重定向到私人帮助服务器
默认帮助  URL  指向全局帮助服务器系统。
要使用私人帮助服务器系统,
您必须编辑
帮助服务器  URL。

Communications  Builder、
控制中心和工具的帮助在同一帮助服务器上运行并具有相
同的服务器  URL。 您可以在  Communications  Builder  或控制中心中编辑服务器  URL。
如果您在  Communications  Builder  中编辑  URL,
它将自动应用于控制中心和工具, 反
之亦然。

在  Communications  Builder  中编辑  URL

1.  在  Communications  Builder  中,
单击工具>  Communications  Builder  设置。
2.  在服务器  URL  中,
输入私人帮助服务器  URL(见下文)。
在控制中心编辑  URL

1.  在控制中心,
单击文件>设置。
2.  在服务器  URL  中,
输入私人帮助服务器  URL(见下文)。

全局帮助服务器  URL
http://docsapi.opentext.com/mapperpi

私人帮助服务器  URL
http:// <主机><端口>
: /docsapimappers/mapperpi

例如:
http://dochost:8080/docsapimapper/mapperpi

96 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第2部分
许可证管理
Machine Translated by Google
Machine Translated by Google

第  9  章

管理许可证文件

默认情况下, 未经许可的  Communications  Server  应用程序以演示模式运行。 在演示模式


下,输出中的文本被随机删除并替换为文本字符串“Demo”。 要许可  Communications  
Server  应用程序,
您必须获取许可文件并将许可文件连接到  Communications  Server  应
用程序。

过期、
无效、
损坏或删除的许可证文件

‧如果许可证文件过期、无效或损坏,Communications  Server  应用程序将不会启
动。

‧如果许可证文件被删除,Communications  Server  应用程序将恢复到演示模式。这意味
着输出中的文本被随机删除并替换为文本字符串“Demo”。

请求许可证文件
要获得许可证文件, 您必须填写许可证申请表。 这可以通过OpenText  我的支持来完成(https://
support.opentext.com/portal/site/css?customView=newTicketLicenseKey )。

上传许可证文件
要将许可证文件连接到您的  Communications  Server  应用程序,
您必须将许可证文件
(strs.lic)上载到主机的管理网关基目录,
或上载到  Communications  Server  应用程序的工作
目录。 如果您将许可证文件同时上载到管理网关基目录和  Communications  Server  应用程序
工作目录, 则工作目录中的许可证文件将覆盖管理网关基目录中的许可证文件。

您可以通过四种方式上传许可证文件:

‧在站点级别上传–  许可证文件被上传到站点上所有主机的管理基本目录。

‧在应用程序域级别上载–  许可证文件被上载到域中所有Communications  Server  应用程序
的工作目录。

‧在主机级别上载–  许可证文件被上载到选定主机的管理基目录。

‧在Communications  Server  应用程序级别上载–  许可证文件被上载到所选Communications  
Server  应用程序的工作目录。

OpenText  Exstream  –  通信服务器管理指南 99
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  9  章  管理许可文件

上传许可证文件

1.  在控制中心中,
右键单击相应的节点(站点、
域、主机或  Communications  Server  
应用程序节点)并选择上传许可证。

2.  浏览并打开许可证文件。

3.  要使应用程序可以使用许可文件,
您需要在控制中心重新启动应用程序。

查看许可证文件详细信息
要检查许可证文件,您可以右键单击  Communications  Server  应用程序节点并
选择查看许可证。

Exstream  生产引擎的许可文件
要运行  Exstream  生产引擎, 您需要一个单独的许可证文件(除了strs.lic)。 此许可证文件
或许可证密钥必须在Communications  Server  应用程序的Java/Server  配置中引用。

关详细信息, 请参阅第  143  页上的“设置  Exstream  生产引擎的启动参数” 。

100 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  10  章
出于许可目的测量交易和微消息

Supervisor  应用程序的“统计”
视图部分提供了分析  Exstream  在特定时间段内处理的事务
数量的功能, 直至一天和输出或输入连接器的级别。

事务是  Exstream  创建、
改编或处理的任何文档、
写作、
记录的单个实例。
典型示例包括但不限于发票、
对帐单或销售订单确认的处理。

小于  300  字节的交易将被标记为  MicroMessages,
并且与交易相比可能会受到不同的许可条款的
约束。 这些微消息也可以在统计视图中单独测量。

衡量交易
要衡量某个时间段(例如日历年)
内处理的交易数量,
您需要设置多个过滤器:

‧在开始和结束的触发日期列上设置日期范围过滤器
之间测量的日期。

‧根据您的配置方式选择类型事件或过程
Exstream  提供输出:
‧基于事件的事务计算传入数据记录的数量
处理,
例如,Exstream  处理引擎中的客户,
或通信服务器消息中的事件。

‧基于进程的事务计算用于生成输出的进程调用次数。
如果您已将流程配置为以作业模式
或使用文档代理输出,则一个流程事务可能包含多个输出文档。
在这种情况下,
您必须
使用基于事件的交易来衡量许可证。

‧通过汇总每日事务计数来计算处理的事务总数。 对于较大的数据集,
您通常使用导出功能
来获取可以在外部工具中进一步分析的*.csv文件提取。

测量微消息
要测量已处理的  MicroMessage  的数量,
请按照上面的事务处理, 但选择类型Custom而不
是Event或Process。
在Name上设置过滤器等于  MicroMessage。
汇总所选日期范围内条目
的交易计数。

对于较大的数据集, 您通常使用导出功能来获取可以在外部工具中进一步分析
的*.csv文件提取。

OpenText  Exstream  –  通信服务器管理指南 101
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  10  章为许可目的测量交易和微消息

更多信息有关如何使
用统计视图用户界面的更多详细信息, 请参阅OpenText  Exstream  ‑  Supervisor  用户指南  
(CCMWEBRETR‑UGD)中的第  8  节“监控统计” 。

102 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  3  部分

使用控制中心管理应用程序
Machine Translated by Google
Machine Translated by Google

第11章

控制中心入门

Control  Center  是一个管理工具, 用于在  Windows  和  UNIX  主机上部署、运
行和管理  Exstream  应用程序。 您可以从控制中心管理  Exstream  应用程序, 其中包括  
Communications  Server  应用程序、 服务网关和任务计划程序应用程序。 您还可以使
用  Control  Center  创建  Exstream  存储库。

11.1  控制中心的步骤清单
本节列出了在  Control  Center  中开始、
准备运行  Communications  Builder  
项目以及准备运行  Exstream  Web  应用程序所需的高级步骤。

开始: 看:

第  1  步  –  打开控制中心,
创建与租户环境的连接,
然后登录。 “从控制中心连接到租户环境”
(第  106  页)

步骤  2  –  如果需要,
切换到租户管理员角色。
第  107  页的“切换角色”

准备运行  Communications  Builder  项目: 看:

第  1  步  –  创建域。 “创建域”
(第  111  页)

步骤  2  –  配置存储库设置并创建域所需的存储库。 “配置存储库设置”
(第  125  页)

“在控制中心创建存储库”
(第  129  页)

“手动创建存储库”
(第  130  页)

第  3  步  –  将存储库链接到域。 “将存储库链接到域”
(第  134  页)

步骤  4  –  将一个或多个  Communications  Server   第  139  页的  “设置  Communications  Server  应
应用程序添加到域。 用程序”
步骤  5  –  将  Communications  Builder  项目部署到   “部署  Communications  Builder  项目”
(第  140  页)
Communications  Server  应用程序。

准备运行  Exstream  Web  应用程序: 看:

第  1  步  –  确认您拥有运行  Web  应用程序所需的存储库。 第  115  页的“域需要哪些存储库”


第  2  步  –  创建服务网关应用程序。 “设置服务网关 在第  151  页
第  3  步  ‑  部署  Web  应用程序 “部署  Web  应用程序”
(第  219  页)

OpenText  Exstream  –  通信服务器管理指南 105
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  11  章  控制中心入门

11.2  从  Control  连接到租户环境
中心
在您可以登录到控制中心之前,
您需要为您的租户设置到管理网关的连接。

您只需设置一个租户连接即可在您的环境中的其他管理网关上管理  Exstream  应用程序。
如果您与多个
租户合作,
则需要为每个租户设置一个连接。您可以使用相同的管理网关连接到每个租户, 但使用不同的
租户名称。

如果您连接的管理网关不再可用,
您可以在控制中心删除租户节点。
删除租户节点不会从整个  Exstream  
环境中删除租户或管理网关。

在你开始之前

‧您需要管理网关的地址和端口、
您的租户名称、
用户名和密码。

为租户设置连接

1.  打开控制中心。

2.  右键单击根节点,
然后单击新建租户连接。

3.  在选择管理网关对话框中,
单击添加。

注意:因为  Control  Center、
Communications  Builder  和  Describer  
使用相同的连接设置, 您可能已经有一个可用的连接。

4.  输入连接名称,
以及管理的主机和端口
网关:

‧主持人

要连接到的具有管理网关的计算机或主机的地址。
例如https://localhost

‧端口

用于与管理网关通信的端口。
默认端口为28700。

5. 可选更改默认超时设置:

‧连接超时(毫秒)
Communications  Builder、
Describer  和  Control  Center  在尝试与管理网关建立新连接时
等待的时间。
‧发送和接收超时(毫秒)

106 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

11.3.了解控制中心用户界面

建立初始连接后,
Communications  Builder、
Describer  和  Control  Center  等待管理网关响应的
时间。

6.  单击确定。

7. 如果登录对话框未自动显示,
请双击新租户连接将其打开。
然后输入租户名称、
用户名和密码。

租户的一个节点被添加到控制中心树视图中。
您不能更改节点名称。

提示:
您可以通过单击编辑或删除在选择管理网关对话框中更改或删除管理网关连接设置。

连接到租户环境

1.  右键单击租户节点,
单击连接。

2.  输入您的用户名和密码,
然后单击确定。

切换角色

在控制中心工作时,您只能访问活动角色可用的功能,
即租户管理员或租户用户。如果您有多个角色,
默认情况下您
以租户用户身份登录。然后,
您可以在租户管理员和租户用户角色之间进行切换。

1.  单击租户节点,
然后在“属性”
视图中,
双击
管理网关用户角色。

2.  单击相应的角色。

从树视图中删除租户节点

1.  右键单击租户节点并选择删除。

2.  单击是确认删除。

11.3  了解控制中心用户界面
控制中心用户界面中提供了以下视图:

‧树视图

这是控制中心左上角的框架。树视图按域和主机显示应用程序。
如果同一主机用于在多个域中运行应用程序,
则该主机显示在每个域下。
该视图还显示存储库文件夹中的可用存储库和连接配置文件。

‧属性视图

这将显示所选对象(域、
应用程序等)
的属性。

‧快速复制视图

OpenText  Exstream  –  通信服务器管理指南 107
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  11  章  控制中心入门

这显示了所选  Communications  Server  应用程序的  FastCopy  源和目标对。

要显示  FastCopy  视图,
请右键单击  Communications  Server  应用程序并选择FastCopy  视
图。
要返回“属性” 视图, 请右键单击  Communications  Server  应用程序并选择“属性” 视图。

‧服务视图

这将显示所选  Communications  Server  应用程序运行的服务的服务名称和服务版本号。

‧日志视图这显

示所选应用程序的日志。

要在控制中心显示/隐藏日志视图,
请右键单击应用程序并选择查看日志。

显示或隐藏控制中心窗口底部的状态栏

‧单击查看>状态栏。

显示或隐藏日志视图

‧单击查看>日志窗口。

显示或隐藏服务视图

‧右键单击  Communications  Server  应用程序,
然后单击服务视图。

在树视图中显示或隐藏管理网关

当主机节点被隐藏时,
应用程序按域排序。

‧单击查看>显示网关。

11.4  更改字体和语言选项
包装日志视图中显示的日志消息文本

‧单击格式>自动换行。

更改日志视图中的字体大小

‧单击格式>字体大小。

在控制中心树形视图中显示大图标或小图标

‧单击视图>大树图标。

指定控制中心用户界面的语言

‧单击语言>选择。

108 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

11.5。
租户和主机属性描述

11.5  租户和主机属性描述
这些属性可用于树视图中的租户节点和每个主机节点。

‧管理网关主机
具有管理网关的计算机的主机名或  IP  地址。
‧网关端口
用于与管理网关通信的端口。
默认端口为  28700。

‧管理网关发送和响应超时(毫秒)
与管理网关建立初始连接后,
控制中心等待管理网关响应的时间。
这是以毫秒为单位指
定的。

‧管理网关连接超时(毫秒)
尝试与管理网关建立新连接时控制中心等待的时间。
这是以毫秒为单位指定的。

‧管理网关用户名
连接到管理网关的用户。
‧管理网关用户角色
分配给用户的角色。
另请参见第  107  页的“切换角色”。
‧应用领域
主机上的应用程序所属的域。
‧操作系统平台(仅限主机级别)
运行  Exstream  应用程序的计算机的操作系统。
‧租户存储库供应商
主机上的应用程序所属的域。
‧租户存储库名称
租户存储库数据库的名称。
‧租户存储库主机
具有租户存储库的计算机的主机名。
‧租户存储库端口
用于与存储库通信的端口。

OpenText  Exstream  –  通信服务器管理指南 109
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第十二章

创建域

12.1  理解域
域是  Exstream  应用程序的逻辑分组。
使用多个域的常见场景是将用于开发、
测试和生产
的应用程序分开。 域还可用于分隔用于不同业务流程或地理区域的应用程序。
您的环境中
使用的域数量和应用程序的分组取决于租户、 公司或组织的个别要求。

为了帮助您决定如何设置域,
本节描述了域如何与存储库、
服务网关和  Exstream  Web  
应用程序一起使用。

在这个部分

‧  “存储库和域”
(第  111  页)
‧  “主机和域”
(第  113  页)
‧  “服务网关、
Web  应用程序和域”
(第  113  页)

存储库和域

一个域中的所有应用程序共享同一组统计信息、 队列、消息、
跟踪、
日志记录、
文档代理和临
时数据存储库。 您可以将每个应用程序域连接到每种类型的一个存储库。 域中所需的存储
库类型取决于域中的  Exstream  应用程序将运行哪种解决方案。
有关详细信息,
请参阅第  
115  页的“域需要哪些存储库”。

共享或单独的存储库

在具有多个域的环境中,
设置存储库有不同的选项。

您可以使用单独的存储库、
使用共享的存储库或使用共享和单独的存储库的组合。 因为存
储库中的所有信息都分配了一个域  ID,
所以即使在具有共享存储库的环境中,
也可以按域
过滤数据。

‧选项  1  –  单独的存储库
使用此选项,
每个域都有自己的一组存储库。
这种方法适用于需要更高级别的数据隔离
或您期望存储库负载高的环境。

OpenText  Exstream  –  通信服务器管理指南 111
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  12  章  创建域

‧选项  2  –  共享存储库
使用此选项,
多个域共享同一组存储库。

‧选项  3  –  共享和独立存储库的组合
每个域也可以有一些自己的存储库并共享一些存储库。
例如,
两个域可能共
享一个中央跟踪存储库和一个中央统计存储库,
但使用单独的队列存储库。

112 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

12.1.了解域

也可以有一个环境,
其中一些域共享存储库,
而其他域使用单独的存储库。

逻辑数据库

每个存储库(统计信息、
队列、
消息等)
都是一个逻辑数据库。
这意味着您可以通过以下方
式设置存储库:

‧在单个Oracle  模式或SQL  Server  数据库中创建所有存储库。  ‧在单独的模式或数据
库中创建每个存储库。  ‧在单独的模式或数据库中创建一些存储库,
并在一个

单一模式或数据库。

主机和域

域独立于主机。
这意味着您可以使用不同的主机在同一个域中运行应用程序,
也可以使用同一
台主机在不同的域中运行应用程序。

服务网关、
Web  应用程序和域

Exstream  Web  应用程序使用服务网关应用程序来访问存储库、
公共资产服务和元数据
模型。

每个域都需要具有唯一端口号的自己的服务网关。 对于负载平衡和故障转移,
可以在一个域中
设置多个服务网关。
访问时,
Web  客户端向管理网关发送请求,
请求服务网关端点。
该请求包括有关租户和要
使用的域的信息。

在具有多个应用程序域的环境中,使用的服务网关控制访问哪些域的数据、
设计资源和
服务。
下图提供了一些示例,说明用户可以从每个域访问哪些数据。

OpenText  Exstream  –  通信服务器管理指南 113
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  12  章  创建域

图  12‑1:
车间和域

在  WorkShop  中,
用户只能访问他们登录的域中的模板、
主题、
图像、
文本和规则。

图  12‑2:
StoryBoard、
ReTouch  和域

114 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

12.2.域需要哪些存储库

在  StoryBoard  和  ReTouch  中,
用户只能访问他们登录的域中的图像、
文本和规则资源。

图  12‑3:
主管和域

在  Supervisor  中,
用户只能访问他们登录的域中的作业和文档。

在控制中心,
您可以为每个存储库分配不同的域。
在所有视图中可用的域列的主管中,
您可以找到列出的所有已分配域,
并可以执行跨域过滤,
例如查看所选域的文档、统计信息、
消息。

12.2  域需要哪些存储库
本节介绍需要每个存储库时的场景以及存储库中存储的信息。

存储库类型:
在以下情况下需要: 商店:

统计数据 对于运行  Communications  Server  应用程序的每个域。 处理有关  Communications  Server  应用程序使用


情况的统计信息。 参见第  117  页的“关于处理统计信

息”。
统计信息使用计数器显示,
可以在  Supervisor  的统计
视图中进行监控。

OpenText  Exstream  –  通信服务器管理指南 115
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  12  章  创建域

队列 如果在域中运行的任何  Communications   在  Communications  BuilderProject  
Builder  项目中使用队列。 配置中指定的队列中的输入作业、 输出作业和作业信
息。

可以在  Supervisor  的队列视图中管理作业。

追踪 如果您的公司或组织想要使用  Supervisor  中的“跟踪” 视图 跟踪器  ID  和状态信息
或实施另一种方法来跟踪域中  Communications  Server  应 最高职位。
用程序的顶级作业。

另请参阅第  117  页的“跟踪存储库使用说明”
和第  118  
页的“关于作业跟踪”。

信息 如果域中的任何应用程序将运行带有服务启用消息的   在  ReTouch  中创建的文档、
被例外规则暂
Communications  Builder  项目。
示例包括:  ‧与   停的消息以及消息或文档属性。
Supervisor(审阅视图)、 ReTouch  或  StoryBoard  一起

使用的  Communications  Server  应用程序

‧具有模板引擎进程的通信服务器应用程序‧存储消息属性的
通信服务器应用程序

日志记录 如果您想对域中的任何应用程序使用数据库日志记录。 记录消息等。另请参见第  179  页的“使用数据


库记录”。

可以在  Supervisor  的  Log  视图中监控日志。

Document  Broker  运行作为  Document  Broker  Plus  解决方案 文件经纪人文件。 另请参见OpenText  Exstream  ‑  


一部分的  Communications  Server  应用程 Communications  Builder  配置指南  (CCMPRJ  
序。 CGD)  中的第  35  节“文档代理”。

可以在  Supervisor  的  Produce  视图中管理文档。

临时数据存储库 可选的。
如果要临时缓存预览中使用的图像。 StoryBoard  和  ReTouch  预览中使用的图像。

收集器存档存储库 如果您想将文档存储在  Collector  Archive  存储库中,
并能 Archiver  应用程序存储的文档
够在  Supervisor  Web  应用程序中查看和删除这些文档。

注意:
多租户、
租户和文档跟踪存储库不在域范围内。

116 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

12.2.域需要哪些存储库

12.2.1  关于处理统计
要在多个域中合并来自  Communications  Server  应用程序的处理统计信息,
您可以将所有这
些域链接到同一个统计信息库。

处理统计
处理统计信息包含有关使用通信的信息
服务器和关键对象上的数据,
例如:

‧连接器,
例如电子邮件、
假脱机、
FTP。  ‧进程,
例如

PageOUT。  ‧驱动程序,
例如  PDF、
PCL、
AFP。  ‧作为

输出生成的物理页总数。

定义自定义计数器
除了上述对象之外,
您还可以在  Communications  Builder  项目的脚本中使用自定义计数
器来计算对您的解决方案很重要的其他对象和事务。 您可以使用IncProcStatCounter脚本函数
来定义对象的计数器并增加计数器的值。

例如,
您可以计算特定的  XML  元素、
特定的  StreamOUT  字段以及从数据库中检索的信息。

使用自定义计数器时,
要计数的对象名称不得超过  255  个字符。

12.2.2  跟踪存储库使用说明
在使用中央  Document  Broker  存储库和跟踪存储库的场景中,
链接到中央  Document  Broker  存储
库的所有应用程序域也必须链接到中央跟踪存储库。

在没有跟踪存储库的环境中,
与顶级作业相关的通知、
脚本函数和日志消息不可用或返回意外结果。

例如:

‧与最高职位相关的Java  通知不可用。

‧与顶级作业完成相关的日志消息不可用。  ‧与顶级作业相关的脚本函数,

如GetTopJobID,
返回0值。  ‧内部作业ID,
例如从GetIntJobID()返回的ID,
仅在一个

Communications  Server  应用程序和工作目录中是唯一的。
每个应用程序的  ID  从1重新开始。
如果
工作目录被删除, 那么  ID  也会从1  重新开始。

‧  HTTP  响应和Java  响应连接器不提供响应。  ‧服务请求输入连接器不提供响应。
这意

味着作业提交Web  服务仅在使用FireAndForget并且没有任何WSDocument预览方法
(getDocumentsContent等)
起作用时才起作用。预览

OpenText  Exstream  –  通信服务器管理指南 117
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  12  章  创建域

在  ReTouch  中,
Supervisor(来自  Review  视图)
和  StoryBoard  也不起作用。

12.2.3  关于工作跟踪
本节介绍使用跟踪存储库时顶级作业跟踪的工作方式。

输入和输出作业当  
Communications  Server  应用程序接收到输入(例如来自  ERP  系统)
时,它会创
建一个输入作业。 处理输入作业时, 可以生成多个输出项。
输出项目可能包括:

‧输出连接器传递的文档‧暂停并存储在消息存储库
中的消息
‧存储在  Document  Broker  存储库中的文档‧通过资源
过滤器或存储在公共资产服务中的资源
资源输出连接器

顶级作业
使用跟踪存储库时,
还会在  Communications  Server  应用程序接收
到输入时创建顶级作业。
顶部作业被分配一个跟踪器  ID, 并连接到输入作业和每
个输出项。

顶级职位的状态跟踪如何工作
每个顶级作业都有一个跟踪作业状态的计数器。 每次将输出项添加到顶部作业时,
计数器都会增加  1。
当每个输出项完成时,
无论成功或错误,
计数器都会减  1。

当计数器返回  0  时,
顶部作业被标记为:

‧成功完成–  如果所有输出项目均已成功完成。  ‧已完成但有错误 如果完成了一
项或多项输出项
有错误。

118 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

12.3.创建域

当连接到消息存储库中的  Document  Broker  文档或消息的顶级作业被标记为已完成(成功
或有错误)
时,将生成一个新的顶级作业。 如果  Document  broker  再次需要该文档或消息再次
从消息存储库中释放,则可以使用新的  top  作业。 在存储库维护期间, 可以从存储库中删除初始
顶级作业。

12.3  创建域
域的命名要求

‧名称只能包含  ASCII  字符(az、  AZ、  0‑9)。  ‧名称不得包含任何空格。

将物理层与域相关联(可选)
您可以将物理平台层绑定到域。
例如,
如果您有物理层  Dev、
Test  和  Prod,
并将应用程序域绑定到物理层  
Prod,
则您只能将  Prod  层部署到域。
这将防止用户错误地部署错误的层。

创建域

1.  右键单击租户节点并选择新建应用程序域。

2.  单击确定。
新建应用程序域对话框打开。

3.  输入域的名称。

4.  选择域的版本。

5. 可选输入要绑定到域的物理层的名称。

物理层的名称必须与  Communications  Builder  中指定的物理层的名称相同。

6.  单击确定。

下一步

‧创建域后,
您必须创建并链接适当的
存储库到域。

OpenText  Exstream  –  通信服务器管理指南 119
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  12  章  创建域

12.3.1  更新存储库连接配置文件
如果更改链接到域的存储库连接配置文件,
则必须手动更新应用程序的域信息。
重新启动应用程序时应用更改。

要更新应用程序的域信息,
请右键单击该应用程序,
然后单击更新应用程序域信息。

您还可以通过右键单击域或主机,
然后单击更新应用程序域文件来更新域中的所有应用程序或主机上的所有
应用程序的域信息。

12.3.2  删除域
在删除域之前,您必须从域中删除所有应用程序。
如果您无权访问创建应用程序的计算机(主机), 则无法删除
该应用程序。
然后,您必须从域中删除该应用程序。请参阅第  163  页的“删除应用程序”。

删除域时,
连接到该域的存储库不会被删除。

删除域

1.  右键单击域并选择删除应用程序域。

2.  单击确定确认。

12.4  主题资源的审批选项
在  WorkShop  中可以通过两种方式批准主题中使用的设计资源:

‧  (默认)
资源的级联审批

使用此选项,
当有人批准主题时,
主题中使用的设计资源会自动设置为已批准状态。  ‧每个资源的单独
批准使用此选项,
主题中的每个资源必须先获得州批准,
然后才能批准主题。这要求有人将主题中使用的

每个资源发送给审查,
并且具有必要权限的人批准每个资源。
如果有人尝试批准包含未批准资源的主题,

们将收到错误消息并且无法批准主题。

配置审批方式
在不同的域中使用不同的审批方法WorkShop  默认设置为在所有应用程序
域中使用级联审批。您可以关闭所有域的级联批准, 包括现有域和您将来创建的任何域。
也是

120 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

12.4.主题资源的审批选项

可以对特定域进行例外处理。例如,
您可能想要
在开发域中使用级联批准,
但在测试中不使用
领域。

在哪里配置批准选项
在cascadeapprovestate元素中配置批准选项
mgmgateway.xml文件。

句法

<cascadeapprovestate  defaultEnabled= <真/假><域名/ >

<applicationdomainexception  name= </ GUID> />


cascadeapprovestate>

在哪里:

‧默认启用=“ <真/假>

指示级联审批是打开(true)还是关闭(false)。
这适用于所有域,
除非您在
应用程序域异常元素。

‧  <applicationdomainexception  name= <域名/GUID> />

允许您在单个域中打开/关闭级联审批。
如果
defaultEnabled= false ,
此元素在一个
单域。 如果defaultEnabled= true ,
则此元素关闭
在单个域中进行级联审批。
您可以使用域名或  GUID  来标识域。
我们
建议您使用  GUID,
因此即使
域名变更。

示例  12‑1:
关闭每个域的级联审批

在此示例中,
级联审批在所有域中均已关闭。

<cascadeapprovestate  defaultEnabled= false >  </


级联批准状态>

示例  12‑2:
级联审批在两个域中关闭

在此示例中,
级联批准用于除
暂存和生产域。

<cascadeapprovestate  defaultEnabled= true >


<applicationdomainexception  name= staging />
<applicationdomainexception  name= 生产 />
</cascadeapprovestate>

OpenText  Exstream  –  通信服务器管理指南 121
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  12  章  创建域

示例  12‑3:
级联批准用于除一个之外的所有域

在此示例中,
级联审批仅用于开发域。

<cascadeapprovestate  defaultEnabled= false >


<applicationdomainexception  name= development />  </
cascadeapprovestate>

具有多个管理网关的环境
如果您的环境中有多个管理网关,
则必须同时为所有管理网关配置审批设置

时间。

配置级联审批

1.  从以下位置打开mgmgateway.xml文件:
<Exstream_Installation_directory><版本> \ \服务器\解决方案
\管理

2.  根据需要编辑cascadeapprovestate元素。

3.  保存并关闭mgmgateway.xml文件。

4.  重新启动管理网关。
5.  从控制中心,
重新启动受影响域的服务网关。

12.5  控制对域的访问
您可以控制哪些角色可以通过  Web  应用程序访问每个域,
例如  WorkShop、
StoryBoard  和  
Supervisor。

可以控制每个内置  Exstream  角色(租户管理员、
租户用户等)
可以访问哪些域。
您还可
以创建自定义角色并授予或拒绝这些角色访问特定域的权限。

示例  12‑4:
配置角色访问域

此示例显示了一个可以访问开发域但不能访问测试和生产域的自定义角色。

122 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

12.5。
控制对域的访问

图  12‑4:
配置角色访问域

表  12‑1:
在哪里设置角色和访问域
至 看

‧设置自定义角色 OpenText中的第  10  节“管理角色”
Exstream  ‑  主管用户指南
(CCMWEBRETR‑UGD)

‧配置每个角色可以使用的域 OpenText  Exstream  ‑  WorkShop  用户指南  (CCMWEBRMG‑
使用权 UGD)中的第  3.10  节“控制对资源的访问”

OpenText  Exstream  –  通信服务器管理指南 123
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第十三章
创建存储库

您可以直接在  Control  Center  中创建  Exstream  存储库,
也可以在  Control  
Center  中生成数据库脚本, 然后使用外部工具运行这些脚本。 例如,
如果公司安全策略
阻止控制中心连接到数据库, 或者如果您希望对存储库的创建具有完全的可追溯性。

如果控制中心不可用,
您可以使用命令行实用程序执行相应的过程。
有关详细信息,
请参阅第  183  页的“使用命
令行实用程序管理应用程序”。

对于生产或测试环境,
您应该查看第  134  页的“调整存储库”
中的信息,
并在必要时调整创建的存储库。

提示: 在处理  Exstream  存储库时, OpenText  建议您使用  OpenText  提供的工具、 应用


程序和脚本。 例如, Communications  Builder、
控制中心(或命令行实用程序) 和  
Exstream  Web  应用程序。

仅对无法使用  OpenText  提供的工具执行的任务使用来自数据库供应商的适当工具。
运行外部工具时,
应主
要使用  OpenText  提供的数据库脚本。

13.1  配置存储库设置
所有  Exstream  存储库(队列、
跟踪等)
必须使用相同的数据库供应商。

建议

‧  OpenText  建议您更改默认的存储库用户,
这些用户是
建议在控制中心。

‧在生产和测试环境中,
创建存储库后,
您应该查看第  134  页的“调整存储库”
中的信息并对存储库进行任何
必要的更改。

配置存储库的设置

1.  在控制中心,
右键单击存储库节点,
单击新建存储库,
然后单击存储库类型:

‧收藏家档案

‧内容服务器

OpenText  Exstream  –  通信服务器管理指南 125
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  13  章  创建存储库

‧文档代理存储库‧  EasyLink  报告‧日志存

储库

‧消息存储库‧队列存储库‧统计存储库‧

临时数据存储库‧跟踪存储库

2.  输入存储库的名称和描述,
然后单击确定。

3.配置数据库设置,
见:

‧  “数据库设置:
Microsoft  SQL  Server/PostgreSQL/SAP  HANA”
在第  126  页
‧  “数据库设置:
Oracle  数据库”
(第  127  页)

4.  单击确定。

5.  如果需要,指定附加参数以发送到数据库驱动程序。
请参见第  129  页的“为数据库驱动程序指定自定义
参数”。

数据库设置:
Microsoft  SQL  Server/PostgreSQL/SAP  HANA

注意:
数据库名称、
用户名和密码设置必须遵循数据库服务器的命名标准。

‧数据库供应商

SQL  Server、  Postgres或HANA。
‧主机名

数据库服务器的  IP  地址或主机名。

如果使用  SQL  Server  的命名实例,
则必须使用语法gbg5000\instance1指定主机名和实例名
<主机名> \ <实例名称> .例如:

‧端口

用于与数据库服务器通信的端口。

‧对于  SQL  Server,
默认值为  1433。

‧对于  Postgres,
默认值为  5432。
‧对于  SAP  HANA,
默认值为  30015。

‧数据库名称

存储库的名称。

126 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

13.1.配置存储库设置

‧如果  SAP  HANA  以单容器模式安装,则必须将此字段留空。
‧如果  SAP  HANA  以多容器模式安装,则必须在创建存储库之前在数据库系统中设置分配的  SAP  
HANA  租户数据库。

‧恢复设置  >  丢失存储库连接

指定在连接丢失的情况下应用程序应如何重新连接到存储库。

‧尝试恢复有限次数–  应用程序尝试多次尝试重新连接到存储库。  ‧无限次尝试恢复–  应用程序尝试重新
<x> 连接到存储库,直到成功建立连接。

‧不要尝试恢复 应用程序不会尝试重新连接到
存储库。

‧恢复设置  >  如果重新连接尝试失败
重新连接失败时要执行的操作。

‧在受影响的存储库上停止处理 当前作业被中止并且
应用程序已停止。

‧忽略故障并继续处理–  应用程序继续处理当前作业。  ‧恢复设置  >  重新连接尝试

应用程序尝试重新连接存储库的次数。

‧恢复设置  >  尝试间隔时间

重新连接尝试之间的时间(以秒为单位)。
‧用户名

访问存储库的用户名。
例如,管理网关用于连接到存储库的数据管理用户。
创建存储库时会自动创建用户。
您不能使用系统管理员作为用户名(例如,  sa)。

在  SAP  HANA  上,
这将是架构所有者。
‧密码

访问存储库的密码。

数据库设置:
Oracle  数据库

注意:
用户名和密码设置必须遵循数据库服务器的命名标准。

‧数据库供应商

OpenText  Exstream  –  通信服务器管理指南 127
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  13  章  创建存储库

甲骨文

‧主机名

数据库服务器的  IP  地址或主机名。

‧端口

用于与数据库服务器通信的端口(默认为  1521)。

‧服务名称  (SID)

要连接的  Oracle  服务的名称。

‧恢复设置  >  丢失存储库连接

指定在连接丢失的情况下应用程序应如何重新连接到存储库。

‧尝试恢复有限次数–  应用程序尝试多次尝试重新连接到存储库。
<x>

‧无限次尝试恢复–  应用程序尝试重新连接到存储库,
直到成功建立连接。

‧不要尝试恢复 应用程序不会尝试重新连接到
存储库。

‧恢复设置  >  如果重新连接尝试失败
重新连接失败时要执行的操作。

‧在受影响的存储库上停止处理 当前作业被中止并且
应用程序已停止。

‧忽略故障并继续处理–  应用程序继续处理当前作业。

‧恢复设置  >  重新连接尝试

应用程序尝试重新连接存储库的次数。

‧恢复设置  >  尝试间隔时间

重新连接尝试之间的时间(以秒为单位)。

‧用户名

访问存储库的用户名。
例如,
管理网关用于连接到租户存储库的数据管理用户。
这也用作模式所有者。
创建存
储库时会自动创建用户。
您不能使用系统管理员作为用户名。

‧密码

访问存储库的密码。

128 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

13.2.在控制中心创建存储库

13.1.1  为数据库驱动程序指定自定义参数
您可以通过在名为cl.properties  的文件中将这些选项配置为参数来向数据库驱动程序发送其他选项。

此文件必须保存在C:\Users\ <用户名> \dbadmintool  文件。

论据

后缀登
录时添加到身份验证配置文件用户名的后缀。

options
自定义  JDBC  连接字符串选项。

示例  13‑1:
cl.properties

此示例显示  DataDirect  JDBC  驱动程序的参数。

选项=加密方法=SSL;
VALIDATESERVERCERTIFICATE=false;

后缀=u7zaf2wibw

示例  13‑2:
cl.properties

此示例显示名为  streamserve.database.windows.net  的  Microsoft  
ODBC  驱动程序和  Microsoft  SQL  Server  的参数

选项=加密=真;
hostNameInCertificate=*.database.windows。
净;登录超时=30;
后缀=流服务

13.2  在控制中心创建存储库
先决条件  (SQL  Server)

‧系统管理用户(sa)的登录详细信息可用。

注意:如果密码包含某些字符, 则无法直接从控制中心创建存储库。 例如:  []  {}() , ; ?  * !  


@更多信息,请参见http://msdn.microsoft.com/en‑us/library/ms161962.aspx

‧如果您使用  SQL  Server  的命名实例,则必须在创建存储库之前启动  SQL  Server  Browser  服务。
先决条件(甲骨文)

‧数据库管理用户的登录详细信息可用。

OpenText  Exstream  –  通信服务器管理指南 129
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  13  章  创建存储库

先决条件  (SAP  HANA)

‧  SAP  HANA  租户数据库的SYSTEM用户的登录详细信息
(多容器模式) 或SYSTEMDB数据库(单容器模式)
可用的。

在控制中心创建存储库

1.  在控制中心,
右键单击存储库的节点并选择创建
数据库。

2.  在操作区域,
选择立即创建。

3.  从下拉列表中选择存储库。

4.  单击开始运行脚本。

5.  在“连接”
对话框中,
输入管理用户的登录详细信息。

6.  单击确定。

7. 可选单击打开日志文件以在默认文本编辑器中打开完整日志。
岗位要求

‧进行完整性检查以确保存储库是根据您的
配置。

13.3  手动创建仓库
要手动创建存储库,
您必须首先为
控制中心中的存储库,然后在外部工具中执行脚本。

生成数据库脚本时,
脚本会保存为  ZIP,
如下所示
目录:

<基本目录> \ <版本> \根\配置\数据库\ <名称> ‑ <GUID> 。


压缩

在哪里:

‧ <基本目录> –  是在运行期间为  Exstream  Projects  指定的路径
通信服务器安装。
例如:  C:\ManagementGateway

‧ <名称>
–  是存储库的名称。

‧<GUID> –  是  zip  文件的全局唯一标识符。
生成数据库脚本

1.  在控制中心,
右键单击存储库的节点并选择创建
数据库。

2.  在操作区域,
选择创建脚本供以后使用。

3.  从下拉列表中选择存储库。

130 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

13.3.手动创建存储库

4.  单击开始生成脚本。
生成脚本后,
您可以保存
脚本的本地副本。

ZIP  文件包含两个脚本:

‧  load_as_sys.sql脚本创建数据库。  ‧  load.sql脚本为
存储库创建表等。

有关如何运行脚本的信息,
请参阅以下部分:

‧第  131  页的“执行数据库脚本:
Microsoft  SQL  Server”  ‧第  131  页的“执
行数据库脚本:
Oracle  数据库”  ‧第  132  页的“执行数据库脚本:
PostgreSQL”  ‧第  133  页的“执行数据库脚本:
SAP  HANA”

执行数据库脚本:
Microsoft  SQL  Server

先决条件

‧系统管理员用户的登录详细信息可用。
例如  SQL  Server  的sa用户。

‧包含数据库脚本的  ZIP  文件在控制中心生成并使用归档应用程序(如  WinZip)
解压缩。

执行脚本

1.  打开相应的  SQL  Server  工具。
例如,
Microsoft  SQL  Server  Management  Studio  或  
SQLCMD。

2.  以系统管理员用户身份登录。
例如对于  SQL  Server  sa。

3.  运行load_as_sys.sql脚本。

4.在上面第  3  步创建的数据库中运行load.sql脚本。

岗位要求

‧进行完整性检查以确保存储库是根据您的配置创建的。

‧由于脚本包含密码,
我们建议您在创建存储库后删除脚本。

执行数据库脚本:
Oracle  数据库

先决条件

‧  SYSDBA用户和模式所有者的登录详细信息可用。  ‧包含数据库脚本的  ZIP  文件在控
制中心生成并使用归档应用程序(如  WinZip)
解压缩。

OpenText  Exstream  –  通信服务器管理指南 131
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  13  章  创建存储库

执行脚本

1、
由于schema  owner的密码和schema  owner用户名相同,
建议在load_as_sys.sql脚本中修改密码。

2.  打开相应的  Oracle  工具。
例如,
Oracle  SQL  Developer  或
SQL*Plus。

3.  以SYSDBA用户身份登录。
4.  运行load_as_sys.sql脚本。

5.  以为存储库配置的架构所有者身份登录。

6.  运行load.sql脚本。

岗位要求

‧进行完整性检查以确保存储库是根据您的配置创建的。

‧由于脚本包含密码,
我们建议您在创建存储库后删除脚本。

执行数据库脚本:
PostgreSQL

先决条件

‧登录详细信息可供具有ADMIN和SUPERUSER的用户使用
特权。

‧包含数据库脚本的  ZIP  文件在控制中心生成并使用归档应用程序(如  WinZip)
解压缩。

执行脚本

1.  使用ADMIN和SUPERUSER以用户身份连接到数据库服务器
特权。

2.  运行load_as_sys.sql脚本来创建数据库。

3.  创建一个对数据库具有适当权限的新用户。

4.  更改新用户以赋予SUPERUSER权限。

5.  以新用户身份连接。

6.  运行load.sql脚本来创建模式。

7.  创建“uuid‑ossp”
扩展,例如使用命令CREATE
扩展“uuid‑ossp”。

8.  更改新用户以删除SUPERUSER权限。

132 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

岗位要求

‧进行完整性检查以确保存储库是根据您的
配置。
‧由于脚本包含密码,我们建议您删除脚本
创建存储库后。

执行数据库脚本:
SAP  HANA
先决条件

‧  SAP  HANA  租户数据库的SYSTEM用户的登录详细信息
(多容器模式)
或SYSTEMDB数据库(单容器模式)
可用的。

‧架构所有者的登录详细信息可用。
‧包含数据库脚本的  ZIP  文件在控制中心生成,
并且
使用归档应用程序(如  WinZip)
解压缩。

执行脚本

1.  打开相应的  SAP  HANA  工具。
例如,
SAP  HANA  HDBSQL。

2.以SYSTEM用户身份运行load_as_sys.sql脚本。
例如:

3.  以模式所有者身份运行load.sql脚本。
例如:

岗位要求

‧进行完整性检查以确保存储库是根据您的
配置。
‧由于脚本包含密码,我们建议您删除脚本
创建存储库后。

OpenText  Exstream  –  通信服务器管理指南 133
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  13  章  创建存储库

13.4  将存储库链接到域
本节介绍如何将  Exstream  存储库链接到域。

先决条件

‧必须在Repositories文件夹中创建存储库。

将存储库连接到域

1.  在存储库文件夹中,
右键单击存储库并选择链接
应用领域。

2.  在“链接应用程序域”
对话框的“可用应用程序域”
区域中,
选择要将存储库连接到的域。

3.  单击箭头按钮将存储库连接到域。
4.  单击确定。

岗位要求

‧将存储库连接到域后,
您必须重新启动  Exstream
域中的应用程序(通信服务器应用程序、 服务网关等)。

13.5  调整存储库
在测试或生产环境中使用  Exstream  存储库之前,
您应该查看本节中的信息并对存储库进行
任何必要的调整。没有描述如何在第三方产品中进行调整。 有关此类信息,请参阅数据库供应商提
供的用户文档。

哪些调整是必要的,
取决于存储库中的数据量。
队列存储库、
消息存储库和文档代理存储库是通常包含大量数据的存储库示例。

如果公司对存储库有任何性能要求,
这也会影响调整。
例如,
如果租户存储库有特定的性能要求。

提示:  Oracle  数据库上的  Exstream  存储库默认使用  SecureFiles  LOB。
使用  
SecureFiles  功能时,
您可以使用许多  Oracle  选项来提高数据库服务器的性能。 例
如,LOB  重复数据删除和  LOB  压缩。 有关详细信息, 请参阅  Oracle  用户文档。

在这个部分

‧第  135  页上的“索引”  ‧
第  135  页上的“分区”

134 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

13.5。
调整存储库

‧  “估计数据库和事务日志的大小”
(第  135  页)

‧  “编辑表空间(Oracle  数据库)”
(第  136  页)

索引
对于大多数表,
如果您索引一个或多个数据库列,
性能会提高。

如果  Exstream  存储库包含动态创建的数据库列, 并且在  Describer  中配置了用户定义的属性, 则
这些列通常适合索引。 租户存储库、消息存储库和  Document  Broker  Plus  存储库是包含动态创
建的数据库列的存储库示例。

提示: 在数据库中, 包含动态创建的列的表的名称以cx  开头。您可以通过


relDocumentTypeMetaDataName表找到列名。

您还应该根据正在使用的查询调整索引。
例如,
如果某个列经常从  Exstream  Web  应用程序
访问,
您应该考虑为该列编制索引。

您可以使用来自数据库供应商的适当工具来索引列。 例如,
SQL  Server  Management  
Studio  或  Oracle  SQL  Developer。

注意:索引列提高了数据检索操作的速度,
但代价是增加了存储空间并可能降低了插入性
能。

分区
如果  Exstream  存储库包含大型表,
则对表和索引进行分区可能会提高性能。
然后将表和索引拆
分为更小的组件, 其中每个组件都可以单独管理和操作。

您可以使用数据库供应商提供的适当工具对表和索引进行分区。
有关哪些数据库版本支持
分区的信息,
请参阅数据库供应商提供的用户文档。

注意:如果表包含数据,
则转换为分区是一项需要重新创建数据并将数据重新加载到
表中的扩展操作。

估计数据库和事务日志的大小
为防止磁盘空间不足,
您应该为数据库文件和  Exstream  存储库的事务日志指定最大大小。

‧数据库文件

OpenText  Exstream  –  通信服务器管理指南 135
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  13  章  创建存储库

您可以根据包含的大小估计数据库文件的大小
数据库表。如果数据库供应商提供具有报告功能的工具,
您可以使用此工具找出每个表的实际大小。

‧交易日志

事务日志大小应为数据库大小的  20‑25%。但是,那
数据库的大小越小, 事务日志的大小就越大, 并且
反之亦然。例如,
如果估计的数据库大小为  10  MB,则设置大小
事务日志的大小为  4‑5  MB。
如果估计的数据库大小超过  500  MB,
您将事务日志的大小设置为  50  MB。

OpenText  建议您将事务日志存储在单独的物理
磁盘。

注意:
低估数据库文件和事务日志的大小
可能会导致文件自动增长和性能下降。

编辑表空间(Oracle  数据库)
创建  Exstream  存储库时,
所有段(表、
索引等)
都由
默认在名为USERS  的表空间中创建。

在运行时,
任何动态创建的表和索引都会在第一个找到的地方创建
表空间称为_DATA  <名称>
(用于表) <名称>其中
和_INDEX  (用于索引),
存储库所有者有配额。
如果没有找到这样的表空间,
这些段是
在存储库所有者的默认表空间中创建。

您应该编辑默认表空间以适应实际情况。通过使用不同的
表空间可以控制磁盘布局。例如,
您可以放置一个重
在快速磁盘上使用索引,
在较便宜的磁盘上使用很少访问的数据库表,
但较慢的磁盘。

OpenText  提供了一个数据库脚本, 您可以使用它来编辑表空间。 你
使用适当的  Oracle  工具运行脚本,
例如  Oracle  Enterprise
管理器或  Oracle  SQL*Plus。

编辑表空间

1.创建需要的表空间(本地管理,
自动段空间
管理)。
例如:

‧ <名称> _DATA用于数据。

‧ <名称> _INDEX用于索引。

‧ <名称> _LOB用于  blob。

2.  在创建的表空间中为存储库所有者提供配额。

3.  打开build_move_segments.sql脚本,
位于:

<基本目录> \ <版本> \根\配置\数据库\ <版本> \甲骨文

136 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

13.5。
调整存储库

<基本目录> 是在运行期间为  Exstream  项目指定的路径
Communications  Server  安装位置。
例如:  C:\ManagementGateway

4.  以模式所有者身份运行build_move_segments.sql脚本。
剧本
将  DDL(数据定义语言)
移动命令假脱机到文本文件。

5.  检查/验证创建的文本文件move_streamserve_segments_TEMP.sql和
运行脚本。

例如:
运行build_move_segments.sql:

‧输入当前索引表空间:  USERS

‧输入当前  LOB  表空间:  USERS

‧输入新的数据表空间:  ‧输入新 <名称> _数据

的索引表空间:  ‧输入新的  LOB  表 <名称> _指数

空间: <名称> _高球

6.验证日志文件中没有错误
move_streamserve_segments_TEMP.log。

OpenText  Exstream  –  通信服务器管理指南 137
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第十四章

设置  Communications  Server  应用程序

14.1  设置  Communications  Server  应用程序
Communications  Server  应用程序运行导出的  Communications  Builder  项目。
每个项目都部署到单独
的  Communications  Server  应用程序并由其运行。您可以在同一个域中使用多个运行不同已部署项目的  
Communications  Server  应用程序。

出于故障转移的原因, 您可以将项目部署到多个  Communications  Server  应用程序并让  
Communications  Server  应用程序共享队列。
这意味着, 如果处理作业的  Communications  Server  应用程序出现故障或失去与存储库的连接, 则可以重
新分配作业。

如果您运行一个项目的多个版本,
则每个项目版本都需要一个单独的  Communications  Server  应用程
序。

逻辑名称您可以为  
Communications  Server  应用程序分配逻辑名称。 例如, 您可以使用相应的  Communications  Builder  
项目的名称作为逻辑名称。 将项目部署到  Communications  Server  应用程序时,
逻辑名称用作标识符。
例如,如果域包含两个具有相同逻辑名称的  Communications  Server  应用程序(例如, 用于负载平衡),
则在部署时可以选择是部署到这两个应用程序还是仅部署到一个  Communications  Server  应用程序。

添加  Communications  Server  应用程序

您可以在本地主机或远程主机上添加应用程序
地点。

1.  右键单击域并选择新建应用程序。

2.  在应用程序类型列表中,
单击通信服务器。

3.  输入应用程序的名称和描述(可选)。

4. 可选输入应用程序逻辑名称。

5. 可选要在远程主机上添加应用程序,
请选择显示所有主机,
然后单击应用程序主机列表中的主机。

6. 可选更改启动类型和用于运行应用程序的帐户。
请参见第  168  页的“应用程序的启动选项和
帐户”。

7.  单击确定。

OpenText  Exstream  –  通信服务器管理指南 139
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  14  章  设置  Communications  Server  应用程序

14.2  部署  Communications  Builder  项目
要运行  Communications  Server  应用程序,
您必须为
项目到应用程序。 每次您将项目的新版本导出到
Communications  Builder,
您必须在控制中心重新部署导出文件。

可以从文件系统部署导出文件或从  CAS  部署导出文件。

部署导出文件时,
文件的内容将被提取到工作
应用程序的目录。
该目录的路径是:

<基本目录> \ <版本> \根\应用程序\ <应用程序名称>

在哪里:

‧<基本目录> –  是在运行期间为  Exstream  Projects  指定的路径
通信服务器安装。
例如:  C:\ManagementGateway

‧<应用程序名称> –  是  Communications  Server  应用程序的名称。

部署时清除数据文件夹
您可以在部署时从工作目录中删除数据文件夹
项目:
<基本目录> \ <版本> \根\应用程序\ <应用程序名称>
\数据

如果您在此文件夹中存储了与项目无关的数据,
请不要清除此文件夹。

在这个部分

‧  “从文件系统部署项目”
(第  140  页)

‧  “从  CAS  部署项目”
(第  141  页)

‧  “将导出文件与部署的导出文件进行比较”
(第  141  页)

‧  “重新部署项目”
(第  142  页)

从文件系统部署项目
1.  右键单击项目的域并选择部署导出文件。

2.  在所有主机列表中,
选择具有  Communications  Server  的主机
要将项目部署到的应用程序。

3.  在可用应用程序区域中, 选择  Communications  Server
将导出文件部署到的应用程序, 或通过以下方式创建新应用程序
单击新建应用程序...,
然后单击下一步。

4.  选择从文件系统部署导出文件,
浏览到导出文件
项目,然后单击下一步。

5.  点击物理层进行部署。

6. 可选禁用部署时清除数据文件夹。

140 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

14.2.部署  Communications  Builder  项目

7. 可选选择在部署时比较导出包,
这将创建一个比较报告,
显示您选择的导出文件和部署的导出文件之间的
差异。

8.  单击完成。

也可以看看

‧第  157  页的“启动、
停止和重新启动应用程序”

从  CAS  部署项目
您可以在  Communications  Builder  中部署已签入到  CAS  的导出文件。
每次在  
Communications  Builder  中创建版本时, 都会将一个新的项目导出文件添加到  CAS。 从控制中心的  CAS  部署
时,
您必须选择要部署的项目版本。

1.  右键单击项目的域,
然后单击部署导出文件。

2.  在部署向导中,
选择要将导出文件部署到的  Communications  Server  应用程序,
然后单击下一步。

3.  在部署向导中,
单击从  CAS  部署导出文件,
然后单击
浏览。

4.  在选择版本对话框中,
执行以下操作:

‧在选择项目区域中,
单击要部署的项目。  ‧在选定项目的可用版本区域中,
单击要部署

的版本,
然后单击确定和下一步。

5.  点击物理层进行部署。

6. 可选禁用部署时清除数据文件夹。

7. 可选在部署时启用比较导出包,
这将创建一个比较报告,
显示您选择的导出文件和部署的导
出文件之间的差异。

8.  单击完成。

将导出文件与部署的导出文件进行比较
在重新部署导出文件之前,
您可以将该文件与已部署的导出文件进行比较,
以了解部署将产生什么影响。
例如,

可以查看脚本、
字体或其他资源是否已更改。

比较导出文件时,
会显示比较报告,
其中显示以下内容:

‧已添加到新导出文件的文件。  ‧已部署的导出文件中存在但新导出

文件中不存在的文件。

OpenText  Exstream  –  通信服务器管理指南 141
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  14  章  设置  Communications  Server  应用程序

‧两个导出文件中都存在但有区别的文件。
比较导出文件(不重新部署)

1.  右键单击  Communications  Server  应用程序,
然后单击比较导出...。

2.  浏览并选择导出文件。
打开比较报告。

3. 可选单击保存将报告保存到磁盘。

比较导出文件(重新部署时)

1.  右键单击域,
然后单击部署导出文件。

2.  单击  Communications  Server  应用程序将导出文件部署到并
单击下一步。

3.  单击从文件系统部署导出文件,
浏览到导出文件,
然后
单击下一步。

4.  点击要部署的物理层,
点击Compare  export  packages  on  deploy,
点击下一步。

5.  查看比较报告并执行以下操作之一:

‧单击取消取消部署。

‧单击完成以继续并部署导出文件。

重新部署项目
以下场景需要重新部署导出文件或发布包:

‧如果您更改了  Communications  Builder  项目并希望  Communications  
Server  应用程序使用新配置。

‧如果您已将新存储库链接到应用程序所在的域。
如果重新部署失败, 则不会部署任何项目更新, 并且在重新部署失败之前使用的导出文件仍保留
在  Communications  Server  应用程序上。

将导出文件从文件系统重新部署到应用程序

‧右键单击  Communications  Server  应用程序并选择重新部署。

将发布包从  CAS  重新部署到应用程序

1.  右键单击  Communications  Server  应用程序并选择单击部署
导出文件。
2.  按照向导。
请参阅第  141  页的“从  CAS  部署项目”。

142 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

14.3.为  Exstream  生产引擎设置启动参数

14.3  设置  Exstream  的启动参数
生产引擎
您在控制中心中为  Communications  Server  应用程序设置的启动参数将用于应用程序
中的所有  Exstream  引擎插件。

Exstream  引擎版本
Exstream  生产引擎的可执行文件的路径和名称。
出于性能原因, 我们建议生产引擎与  Communications  Server  应用程序位于同一主机
或计算机上。

提示:
如果您在  Communications  Builder  中为  Exstream  引擎指
定自定义可执行文件, 它将覆盖控制中心中的参数。

Exstream  引擎许可证文件
Exstream  生产引擎的许可证文件的路径和名称。
您必须指定许可证文件或许可证密钥。

Exstream  引擎许可证密钥
Exstream  生产引擎的许可证密钥。
您必须指定许可证文件或许可证密钥。

Exstream  引擎消息源文件
Exstream  生产引擎的消息资源文件的路径和名称。

设置  Exstream  生产引擎的启动参数

1.  右键单击应用程序并选择Java/Server  配置。

2.  单击(项目列表)
字段,
然后单击字段右侧的按钮。

3.  在下拉列表中,
单击相应的参数:

‧  Exstream  引擎版本

‧  Exstream  引擎许可证文件
‧  Exstream  引擎许可证密钥
‧  Exstream  引擎消息源文件
4.  单击添加。

5.  在值字段中,
输入参数值。

6.  单击“确定”
完成配置并退出对话框。

OpenText  Exstream  –  通信服务器管理指南 143
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  14  章  设置  Communications  Server  应用程序

14.4  使用  FastCopy  测试  Communications  Server  应用程序

您可以使用  FastCopy  测试具有一个或多个目录输入连接器的  Communications  Server  应用
程序。  FastCopy  将文件从源目录复制到目标目录。
源目录和目标目录可以位于本地驱动器或远程
主机上。

打开  FastCopy  视图

‧右键单击应用程序并选择FastCopy  视图。

创建新的源/目标对

1.  右键单击  FastCopy  视图并选择创建对。

2.  在“源和目标”
对话框中,
指定源目录和目标目录的路径,
然后单击“确定”。

复制现有的源/目标对

‧右键单击源/目标对并选择复制。

编辑源/目标对

1.  右键单击源/目标对并选择编辑对。

2.  在源和目标对话框中,
指定源目录和目标目录的路径,
然后单击确定。

使用  FastCopy

1.  确保  Communications  Server  应用程序已启动。

2.  右键单击源/目标对并选择传输文件。

编辑源文件

1.  右键单击源/目标对并选择编辑源。
源文件
在编辑器中打开。
2.  编辑并保存源文件。

删除源/目标对

1.  右键单击源/目标对并选择删除对。

2.  单击确定保存更改。

144 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

14.5。  Communications  Server  应用程序中的服务版本控制

14.5  Communications  Server  应用程序中的服务版
本控制
Communications  Server  应用程序可以出于多种原因公开服务,
例如:

‧接收来自  Exstream  Web  应用程序的预览或发布请求
文件。

‧接收来自jobsubmit  Web  服务的请求。

要公开服务,
必须满足以下条件之一:

‧您在Communications  Builder  中配置的消息必须启用服务‧必须使用服务请求输入连接器。

如果要对已部署到  Communications  Server  应用程序的项目进行更改,
可以让单独的  
Communications  Server  应用程序运行不同版本的项目, 其中每个应用程序公开的服务具有与项目相同的
版本。这意味着:

‧  Web  应用程序(或使用jobsubmit  Web  服务的应用程序) 可以向公开服务的正确版本发送请求,
并使
用Communications  Server  应用程序的正确版本呈现文档。

‧即使您更改并重新部署了项目,
也可以预览和发布消息存储库中的暂停消息并以正确的输出发布, 因为存
储消息时使用的特定服务版本仍由一个版本的  Communications  Server  应用程序公开。

要部署同一项目的新版本, 请在导出项目时增加版本号, 然后部署新的导出文件。 请参阅OpenText  Exstream  ‑  


Communications  Builder  配置指南  (CCMPRJ‑CGD)中的第  2.7  节“增加项目版本号” 。

查看部署到
通信服务器应用程序
您可以查看部署到特定  Communications  Server  应用程序的  Project  版本。

注意:
应用程序公开的服务与项目具有相同的版本号。

查看项目版本

1.  在控制中心中,
选择一个  Communications  Server  应用程序。
2、
选择Application  >  Properties视图,  Project版本号为
显示。

OpenText  Exstream  –  通信服务器管理指南 145
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  14  章  设置  Communications  Server  应用程序

查看公开的服务
对于每个  Communications  Server  应用程序,
您可以查看应用程序公开了哪些服务,
包括相应的版本号。

注意:
服务版本与导出项目时指定的项目版本相同。

查看项目版本

1.  在控制中心中,
选择一个  Communications  Server  应用程序。
2.  选择应用程序>服务视图。

3.  在服务视图中,
应用程序的服务与它们的版本一起列出
数字。

14.5.1  搜索服务
您可以搜索由  Communications  Server  应用程序公开的服务。

注意:
服务版本与部署到  Communications  Server  应用程序的项目版本相同。

搜索条件

您可以根据名称或版本进行搜索,
也可以默认搜索所有服务和服务版本。

‧名称–  要搜索的服务的名称。 如果您知道服务名称的一部分,您可以将其与通配符组合, 例如myservices_*或


*invoice以搜索以invoice结尾的所有服务要搜索所有服务,请输入通配符  *  符号(默认)。

‧版本–  要搜索的服务版本号,或留下通配符以搜索所有版本。
您可以将数字与通配符结合使用,
例如  2*  以搜索以  
2  开头的所有服务版本。

搜索服务

1.  在控制中心中,
右键单击要放置的租户节点或域
搜索服务,然后选择搜索。

2.  在  Search  对话框中,
在Criteria表中输入搜索条件,
或保留为
默认搜索所有服务和服务版本。

3.  如果要在另一个范围内搜索,
请参见第  147  页的“选择搜索范围”。

4.  单击搜索以搜索符合条件的可用服务。

146 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

14.6。
为队列配置线程池

注意:
目前搜索列表仅显示服务。

选择搜索范围

1.  在“搜索”
对话框中,
单击“范围”
字段右侧的按钮。

2.  在  Select  Scope  对话框中,
选择要在其中执行
搜索。

3.  关闭选择范围对话框。

转到公开找到的服务的应用程序

1.  在“搜索”
对话框中,
选择一个搜索结果。

2.  单击转到。

3.  在  Control  Center  中,
Communications  Server  应用程序公开服务
突出显示。

14.6  为队列配置线程池
单个通信服务器的所有输入和输出队列共享同一个线程池。
线程池仅供一个通信应用程序使用,
不在应用程序
之间共享。

您可以在threadmanager.xml  的jobdispatchqueue元素中配置线程池。

中央或应用程序特定的  threadmanager.xml  配置

有两种方法可以配置threadmanager.xml:

‧中央线程管理器.xml
您可以更新以下公共threadmanager.xml文件:  \\Server\global
<ExstreamRuntime_installation_folder><版本>
\threadmanager.xml。
在此文件中所做的更改将应用于工作目录中没有特定于应用程序的threadmanager.xml的所有通信
服务器。

‧特定于应用程序的threadmanager.xml
您可以将threadmanager.xml复制到特定  Communications  Server  的工作目录并更新该文
件。
这会将配置应用于单个应用程序。

线程池的工作原理
默认情况下, 线程池分配了  4  个线程,
在高负载时可以增长到  32  个线程,
在低负载时可以收缩到最少  
4  个线程。
每隔几秒钟,一个临时调度程序会根据当前负载检查线程池是否需要增长或缩小。

OpenText  Exstream  –  通信服务器管理指南 147
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  14  章  设置  Communications  Server  应用程序

运行自动假脱机时, 池队列中最多允许  2000  个工作项, 以避免内存耗尽。 当队列中有超过  


2,000  个工作项时, 多余的队列项将被丢弃。 有关自动假脱机的更多信息, 请参阅OpenText  
Exstream  ‑  Communications  Builder  配置指南  (CCMPRJ‑CGD)  中的第  11.6  节“设置队
列假脱机选项”。

配置文件计数器

您可以使用以下配置文件计数器来查找队列中活动线程和工作项的数量:

‧  streamserve.notification.profiler.profilerevent.threadpool。
threadcount     上下文显示线程池的名称。
计数表示池中当前活动线程的数量。

‧  streamserve.notification.profiler.profilerevent.threadpool。  queuesize  –  上下文显示线程
池的名称。
计数表示队列中当前工作项的数量。

建议

‧  threadmanager.xml文件中的默认设置应该适合大多数环境。
因为线程池会适应
负载, 所以将<maxthreads>设置保留为相对较高的值以允许线程池增长。

也可以通过增加<minthreads>元素的值在启动时分配更多线程。  OpenText  不建议将<minthreads>元
素减小到默认设置  4  以下。

‧升级  5.x  项目时,
您应该考虑到  16.x  版中的线程池为所有队列共享, 这意味着作业必须在
连接器之间适当地分配。 运行所有作业而不进行排序时可实现最佳性能。 但是, 如果您需
要启用排序, 您还应该设置连接器的优先级。 有关如何启用/禁用排序和设置连接器优先
级的更多信息, 请参阅OpenText  Exstream  ‑  Communications  Builder  配置指南  
(CCMPRJ‑CGD)中的第  8  节“输入连接器管理” 和  OpenText  Exstream  ‑通信中的第  9  节
“输出连接器管理” 生成器配置指南  (CCMPRJ‑CGD)。

示例  14‑1:
队列的线程池设置

这个例子展示了如何配置一个线程池,
它至少分配了  20  个线程,
而不是默认的  4  个。

<dispatchqueue  type= http://schemas.streamserve.com/uid/component/
dispatchqueueex/1.0   name= http://schemas.streamserve.com/uid/resource/
jobdispatchqueue/1.0 >

<配置>  <threadpoolex>  
<属性>  
<minthreads>20</
minthreads>

148 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

14.6。
为队列配置线程池

<maxthreads>32</maxthreads>  
<queuelimit>2000</queuelimit>  
<minqueuethreshold>4</minqueuethreshold>  
<maxqueuethreshold>16</
最大队列阈值>
<queuethresholdcheckinterval>1000</
queuethresholdcheckinterval>  </
properties>  </
threadpoolex>  </
configuration>
</dispatchqueue>

注意:  <maxqueuethreshold>的大小必须相同或大于<minthreads>。

OpenText  Exstream  –  通信服务器管理指南 149
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第15章
设置服务网关

要使用  Exstream  Web  应用程序,
您必须添加服务网关。
出于故障转移和负载平衡的原因,
您可以添加更多服务
网关。

访问时,
Web  客户端向管理网关发送请求,
请求服务网关端点。 管理网关检查租户存储库中是否有可用的服
务网关,
然后返回服务网关之一的连接信息。  Web  客户端使用返回的服务网关来访问  Exstream  存储库、

共资产服务和元数据模型。

在这个部分

‧第  151  页的“添加服务网关”  ‧第  151  页的“更新服务

网关端口”  ‧第  152  页的“更改服务网关的域”

添加服务网关
您可以将服务网关添加到本地主机或远程主机
网站。

1.  右键单击域并选择新建应用程序。

2.  在应用类型列表中,
单击服务网关。

3.  输入服务网关的名称。

4. 可选输入应用程序的描述。

5. 可选要在远程主机上添加应用程序,
请选择显示所有主机,
然后单击应用程序主机列表中的主机。

6. 可选更改启动类型和用于运行应用程序的帐户。
请参见第  168  页的“应用程序的启动选项和
帐户”。

7.  单击确定。

相关章节

‧  “启动、
停止和重新启动应用程序”
(第  157  页)  ‧  “服务网关安全模式”
(第  

223  页)

更新服务网关端口
每个服务网关都有两个端口,
一个用于通过  Web  服务  API  进行通信,
一个用于通过  REST  API  进行通
信。
在控制中心,

OpenText  Exstream  –  通信服务器管理指南 151
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  15  章  设置服务网关

端口号设置为一个范围, 其中端口范围开始由  Web  服务使用,
端口范围开始增加  1  
由  REST  服务使用。
默认情况下,2718  用作端口范围开始。

每个应用程序主机上的端口号必须是唯一的。
这意味着如果向同一主机添加多个服务
网关,
则必须更新端口范围开始。

更新服务网关端口范围

1.  在控制中心,
选择服务网关。
2.  在属性视图中,
右键单击服务网关端口范围开始。
3.  在“编辑值”
对话框中,
更新端口范围开始,
然后单击“确定”。
4.  重新启动服务网关以使更改生效。

更改服务网关的域
您可以更改服务网关使用的域。

更改域

1.  右键单击服务网关,
然后单击更改应用程序域。
2.  重启新域中的服务网关。

152 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第十六章
归档文件

您可以将文档归档到  Collector  Archive  或  Content  Server。

‧  Collector  Archive  –  您必须设置  Archiver  应用程序以将文档存储在  Collector  Archive  存储库中。
然后,
您可以使用  Supervisor  Web  应用程序查看和删除文档。

你必须:

‧添加  Archiver  应用程序‧为  Archiver  应用程

序配置任务

有关使用  Archiver  应用程序和  Collector  Archive  存储库通过  Supervisor  查看和删除文档所需的更
多信息,
请参阅OpenText  Exstream  ‑  Communications  Builder  配置指南  (CCMPRJ‑  CGD)

‧  Content  Server  –  您必须设置  Content  Server  存储库。
你必须:

‧添加  Content  Server  存储库‧配置  Content  

Server  存储库

有关归档文档和通过  Supervisor  查看和删除文档的  Content  Server  存储库的更多信息, 请参阅OpenText  
Exstream  ‑  Communications  Builder  配置指南  (CCMPRJ‑CGD)  中的第  9.9  节“在  Collector  Archive  
数据库或  Content  Server  中存储文档”。

16.1  添加归档应用程序
您可以将  Archiver  应用程序添加到本地主机或作为站点一部分的远程主机。

1.  右键单击域并选择新建应用程序。

2.  在应用程序类型列表中,
单击存档程序。

3.  输入存档器的名称。

4. 可选输入应用程序的描述。

5. 可选要在远程主机上添加应用程序,
请选择显示所有主机,
然后单击应用程序主机列表中的主机。

6. 可选更改启动类型和用于运行应用程序的帐户。
请参见第  168  页的“应用程序的启动选项和
帐户”。

OpenText  Exstream  –  通信服务器管理指南 153
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  16  章  归档文件

7.  单击确定。

16.2  为  Archiver  配置任务
1.  右键单击  Archiver  应用程序并选择配置。

2.  单击任务属性和右侧的浏览按钮。

3.  在“服务配置”
对话框中,选择“连续” 并单击“添加”。 这个
意味着文档在准备好传输到  Collector  Archive  存储库后立即被连续存档。

4.  将其他属性保留为默认值或选择存档器存档文档的其他时间间隔。 有关详细信息, 请参阅OpenText  


Exstream  ‑  Communications  Builder  配置指南  (CCMPRJ‑CGD)中的第  3.5  节“调度”

16.3  添加内容服务器存储库
您可以将文档归档到  Content  Server。
为此,
您必须创建一个内容服务器类型的存储库。

1.  右键单击存储库并选择新建存储库...。

2.  从类型列表中选择内容服务器。

3.  输入存储库的名称。

4. 可选输入描述。

5.  单击确定。

16.4  配置  Content  Server  存储库
在  Content  Server  存储库的配置文件配置编辑器中,
可以进行以下设置。

‧姓名–  此字段自动填写。  ‧  URI  –  此字段自动填写。  

‧  Profile  sup‑type  –  该字段自动填写。  ‧内容服务器  

URL  –  输入您的内容服务器  IP  地址。  ‧端口–  输入内容服务器IP  地址

的端口号。  ‧尝试恢复‑  可以将恢复设置设置为从不、
有限时间或永远。
默认为限时

‧重试次数–  此字段仅在选择了有限时间时可用。
在这里,
您可以设置重试的值。
默认值为1。

‧重试间隔–  以秒为单位的值。
默认值为1。

154 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

16.4.配置  Content  Server  存储库

‧恢复操作–  可以设置为中止或忽略。
默认为中止。  ‧身份验证配置文件–  提供的身份验证配

置文件必须包含  Content  Server  的用户名和密码。

‧安全通道配置文件–  提供的安全通道配置文件必须包含通道类型和内容服务器证书文件。

‧辅助连接配置文件–  空。
‧  Content  Server  文件夹–  无。
文件夹的路径和文件夹名称
应存档的文件已添加到此处。

‧启用文件夹创建–  空。
如果提供的文件夹在  Content  Server  上尚不存在,
则激活此复选框会创建此文件夹。

‧文档名称–  空。
要归档的文档的名称。  ‧说明–  空。
文件的描述。  ‧内容类型–  空。
信息要么

手动输入,
要么派生

从文档流中。

‧允许多个版本–  空。
允许创建指定文档的多个版本。

‧映射文件–  空。
提供的映射文件将元数据从Describer  映射到Content  Server。

‧缓存大小–  默认设置为0。  ‧  CS  虚拟路径–  附加

到内容服务器URL  的路径。

OpenText  Exstream  –  通信服务器管理指南 155
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第十七章
管理应用程序

17.1  启动、
停止和重新启动应用程序
您可以通过右键单击主机或域并选择适当的选项来启动、停止、
重新启动或刷新域或主机的所有应用程序。
您还可以单独启动、
停止、重新启动或刷新每个应用程序。

Communications  Server  应用程序的热启动:  ‑  停止的  Communications  Server  应用程序将自动
启动,例如, 当应用程序在  ReTouch、 StoryBoard  或其他  Web  应用程序中接收到作业或预览请求时。 只
要有活动(例如进一步的预览请求), 自动启动的应用程序就会继续运行。 在没有活动的  5  分钟后, 应用程序再
次停止。

启动应用程序

‧右键单击应用程序并选择开始。

停止应用程序

‧右键单击应用程序并选择停止。

重新启动应用程序

‧右键单击应用程序并选择重新启动。

更新为应用程序显示的状态信息

‧右键单击应用程序并选择刷新。

为所有应用程序指定刷新间隔

1.  选择文件>设置。

2.  在以秒为单位的刷新率文本框中,
输入刷新应用程序状态的时间间隔。
例如,
如果输入  5,
则状态信息每  5  秒更
新一次。

3.  选择要更改刷新间隔的节点:

‧仅选定节点和可见子节点–  刷新选定节点和该节点的子节点中的应用程序的状态信息。

‧所有可见节点 刷新所有节点的状态信息。
主持人。

4.  单击确定。

OpenText  Exstream  –  通信服务器管理指南 157
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

17.2  管理远程主机上的应用程序
在主机上创建应用程序后,
远程主机会显示在控制中心树视图中。

要管理远程主机上的应用程序,
主机上的管理网关必须连接到  Exstream  环境。
有关详细信息,
请参阅第  71  页的
“添加管理网关”。

连接到远程主机

1.  在控制中心的树形视图中,
右键单击主机节点并选择
连接。

2.  如果出现提示,
请输入用户名和密码,
然后单击确定。

连接到主机后,
主机上配置的  Exstream  应用程序在控制中心中可见。

17.3  探索管理网关基目录

您可以使用MGW  Explorer对话框来管理文件和目录。
文件和目录可以位于本地主机或任何具有连接到同一环境的
管理网关的远程主机上,
包括  Windows  和  UNIX。

例如,
您可以:

‧创建和删除目录。

‧将单个文件从一个位置剪切、
复制和粘贴到另一个位置。

当您选择主机>探索时,
将打开MGW  Explorer对话框。

要直接访问  Communications  Server  应用程序的工作目录,
请右键单击该应用程序并选择浏览。

17.4  在域中调度任务
您可以将任务计划程序应用程序添加到域并安排存储库维护任务,
例如每晚凌晨  1:00  从  Exstream  存储库
中删除过期内容

每个任务计划程序可以运行多个任务。
为确保即使  Task  Scheduler  应用程序出现故障也能执行任务,
您可以
添加多个  Task  Scheduler  应用程序。

任务

您可以在每个任务计划程序应用程序中设置以下类型的任务:

158 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.4.在域中调度任务

‧运行系统命令

根据指定创建系统命令任务执行
日程。

‧运行数据库维护

有关更多信息,
请参阅“计划索引维护或通过任务合并
调度程序”,
第  319  页。
‧删除过期内容

有关详细信息,
请参阅“删除过期内容 在第  305  页。
‧删除过期的追踪信息

有关详细信息,
请参阅“删除过期内容 在第  305  页。
‧过期内容

有关详细信息,
请参阅“删除过期内容 在第  305  页。
‧  EasyLink  报告
有关详细信息, 请参阅OpenText中的第  10.5  节“EasyLink  连接器”
Exstream  ‑  通信生成器配置指南  (CCMPRJ‑CGD)。

设置任务计划程序
添加任务计划程序

您可以在本地主机或远程主机上添加任务计划程序应用程序
是网站的一部分。

1.  右键单击域并选择新建应用程序。

2.  在应用程序类型列表中,
单击任务调度器。

3.  输入任务计划程序的名称。

注意: 如果您运行应用程序, 则不能使用名称任务计划程序


在  Windows  主机上,
因为此名称由  Windows  服务使用。

4. 可选输入描述。

5. 可选要在远程主机上添加应用程序,请选择显示所有主机,
然后
单击应用程序主机列表中的主机。

6. 可选更改启动类型和用于运行的帐户
应用。
请参见第  168  页的“应用程序的启动选项和帐户”。

7.  单击确定。

为任务计划程序设置日志级别和任务

1.  输入应用程序的日志级别。
请参阅第  174  页的日志级别。

2.  在任务框中,
单击...。

OpenText  Exstream  –  通信服务器管理指南 159
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

3.  在服务配置对话框中,
添加任务,
请参阅第  159  页的任务。
4.  输入任务的设置:

‧姓名

任务的名称。

‧说明

任务描述(可选)。
‧时间表

应用程序执行任务的时间间隔。

请参阅第  161  页的“设置计划”。

运行系统命令任务的附加设置

‧逻辑任务名称

系统命令的逻辑名称,
将在日志文件中使用。
这个
参数是可选的。
‧命令

应用程序要执行的系统命令,
包括参数。
该命令必须遵循操作系统的语法,
其中
应用程序运行。
例如,
在  Windows  上,
使用反斜杠(\)作为目录
包含空格的参数的分隔符和引号( ) 。
例如,
以下命令运行一个批处理文件,该文件根据
指定时间表:
“c:\My  Reports\TriggerReport.bat  ‑type  ReportType  ‑SortOrder  Alpabethical”

‧工作目录

系统命令任务的工作目录的名称和路径。
为了
例如,
对于上面的命令,您可以指定以下工作
报告目录:
c:\我的维护报告

如果将此选项留空,
则使用应用程序的工作目录:
<基本目录> \ <版本> \根\应用程序\ <任务计划程序名称>
\wd

在哪里:

‧<基本目录> –  是在运行期间为  Exstream  Projects  指定的路径
通信服务器安装。
例如:  C:\ManagementGateway

‧<任务计划程序名称> –  是任务计划程序应用程序的名称。

相关章节

‧第  157  页的“启动、
停止和重新启动应用程序”

160 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.4.在域中调度任务

17.4.1  设置时间表
本节介绍如何设置计划,
例如为任务计划程序应用程序设置计划。
您可以设置单个时间间隔或创建更复杂的时
间表。

打开调度程序配置对话框

1.  右键单击应用程序并选择配置。
配置对话框
框打开。

2.  如果没有配置任务,
选择(项目列表)
字段并单击字段右侧的按钮。
服务配置对话框打开。

注意:
您可以直接在“配置”
对话框中编辑现有任务的计划。

3.  创建一个新任务。

4.  选择计划字段并单击该字段右侧的按钮。

调度程序配置对话框打开。

添加间隔

1.  在调度程序配置对话框中,
单击新建(间隔区域)。
一个新的
项目被添加到列表中。

2.  在定义间隔中,
选择时间单位(年、
月等)
和频率
行动。

例如,
通过添加时间间隔并在定义时间间隔区域中选择秒和30 ,
您可以指定应每  30  秒触发一次操作。

提示:
您可以通过单击上移或下移在列表中上移或下移间隔。

单击删除以删除间隔。

为特定间隔设置时间范围(可选)

您可以为时间范围选择时间单位(年、
月、周等)、
起始值和终止值。
例如,
通过添加时间范围并选择星期几,

指定开始值1和停止值3,
您可以指定每周星期一到星期三应应用选定的时间间隔。

1.  选择间隔。

2.  单击新建(应用选定的区间区域)。
一个新项目被添加到该区域。

3.  为项目选择一个单位(年、月等)
并输入开始,
也可以选择输入
时间范围的结束值。

OpenText  Exstream  –  通信服务器管理指南 161
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

提示:
如果要在特定时间触发操作, 则必须同时设置Start和End值。
如果将End值留空,
则调度程
序可以在Start值之后的任何时间启动。

您可以通过单击上移或下移在列表中上移或下移时间范围。

单击删除以删除时间范围。

为所有间隔设置时间范围(可选)

您可以为配置中的所有计划间隔添加开始日期和时间以及停止日期和时间。例如,
通过选择开始并指定当前日期
和时间并选择停止并指定下一年的日期和时间,您可以指定所有列出的时间间隔应从今天开始运行到指定的停
止日期和时间。

‧您可以设置应用列表中所有时间间隔的时间范围。
在应用所有间隔区域中,
使用开始和停止的日期和时间来设
置所有间隔的框架。

示例  17‑1:
安排轮询间隔

在此示例中,
配置了一个计划,
该计划每周一到周三触发一次操作,
周四到周日每小时触发一次。

162 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.5。
删除应用程序

图  17‑1:
计划示例

17.5  删除应用程序
您可以从控制中心的树状视图中删除应用程序。
这不会从工作目录中删除配置文件。
您必
须手动删除这些文件。

删除应用程序

1.  右键单击应用程序并选择删除。
2.  单击确定。

OpenText  Exstream  –  通信服务器管理指南 163
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

17.6  更新和导出应用程序属性
您可以更新应用程序的属性,
例如名称、
描述和启动选项。

可以在应用程序运行时更新某些属性,
例如应用程序描述和启动类型。
要更新其他属性,
您必须停止应用程
序。

更新应用程序属性

1.  选择应用程序。

2.  在属性视图中,
右键单击属性并选择编辑属性。  “编辑值”
对话框打开。

3.  输入新的属性值并单击确定。

将应用程序的属性信息保存为文本文件

您可以将应用程序的属性(名称、
描述、
版本等)
保存为文本文件。

1.  选择应用程序。

2.  选择文件>导出列表。  “另存为”
对话框打开。
3.  浏览到保存文件的位置,
然后输入文件名。

重命名应用程序

1.  右键单击应用程序,
然后单击重命名。

2.  输入新名称。

17.6.1  Communications  Server  应用程序属性
‧姓名

Communications  Server  应用程序的名称。  ‧逻辑名称

Communications  Server  应用程序的逻辑名称(例如, 相应的  Communications  Builder  项目的名
称)。 部署到  Communications  Server  应用程序时,
逻辑名称用作标识符。 域中具有相同逻辑名称的所
有  Communications  Server  应用程序都被视为相同的  Communications  Server  应用程序。

‧描述

Communications  Server  应用程序的描述。

‧应用类型

应用程序的类型,
即  Communications  Server。

164 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.6。
更新和导出应用程序属性

‧状态

应用程序的状态,
例如运行或停止。
‧应用领域

Communications  Server  应用程序的域和域配置的状态。

‧当前–  域配置的最新版本用于
应用。
‧过期–  域配置已更新,
但新配置尚未应用于应用程序。

‧通信服务器版本

用于运行应用程序的  Communications  Server  的版本。
‧启动类型
Communications  Server  应用程序的启动方式。
例如,
自动、
手动或禁用。

‧登录

用于运行  Communications  Server  应用程序的帐户。
‧导出文件  部
署到  Communications  Server  应用程序的导出文件的名称。
‧工作目录
Communications  Server  应用程序工作目录的路径。
‧日志文件
Communications  Server  应用程序的日志文件的名称。
‧管理网关主机

用于运行  Communications  Server  应用程序的计算机。
‧部署时间戳  部署导出文件
的日期和时间。
‧项目名称部署到
应用程序的项目名称。
‧项目导出时间戳上次在
Communications  Builder  中导出的日期和时间。  ‧项目标签如果项目是
从文件系统部署的,
则这是导出文件的创建日期和时间。

如果项目是从版本控制系统部署的,
则这是导出文件的标签。

‧物理层

OpenText  Exstream  –  通信服务器管理指南 165
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

部署到  Communications  Server  应用程序的平台物理层。

‧临时目录

包含  Communications  Server  应用程序和平台的临时文件的目录(相对于工作目录)。

‧调试模式启用或禁

用  Communications  Server  应用程序的调试模式。
例如,
禁用、
启用或启用详细。

‧缓存大小  (KB)

不适用。
‧探查器

启用或禁用  Profiler  服务,
用于调查  Exstream  软件在处理过程中的行为。
有关详细信息,
请参阅第  
351  页的“分析和调整您的环境”。

‧项目版本号

部署到应用程序的导出项目的版本号。
从  Communications  Builder  导出项目时会指定版本号。

从旧版本的  Communications  Builder  导出的已部署项目的应用程序没有版本属性,
版本号为  1。

‧输入连接器

启用或禁用  Communications  Server  应用程序下次启动时使用的输入连接器。 如果您并行运行同
一项目的多个版本, 并且它们使用共享资源来输入数据(文件夹、 HTTP  端口、
电子邮件帐户等),则
禁用旧  Communications  Server  应用程序版本的输入连接器会很有用。 旧的应用程序版本仍在运
行,
使存储在消息存储中的文档能够被提交。 但是,
这些应用程序不会拾取输入数据, 这可能会导致错
误输出。

此外,
无论您是否对服务进行版本控制, 都可以暂时禁用特定  Communications  Server  应用程序的输
入连接器。
例如,
如果您想提高其他  Communications  Server  应用程序的性能。

注意:
不能禁用服务请求连接器。

‧小型转储请参
阅第  171  页的“为  Windows  上的应用程序生成转储文件”。

166 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.6。
更新和导出应用程序属性

17.6.2  服务网关和任务调度器应用程序属性

‧姓名

应用程序的名称。
‧描述应用程序
的描述。
‧应用程序类型应用
程序的类型。
‧状态

应用程序的状态,
例如运行或停止。
‧应用领域

应用程序的域和域配置的状态。

‧当前–  域配置的最新版本用于
应用。
‧过期–  域配置已更新,
但新配置尚未应用于应用程序。

‧服务网关版本

仅适用于服务网关  用于运行应
用程序的服务网关版本。
‧启动类型

应用程序是如何启动的。
例如,
自动、
手动或禁用。
‧登录

用于运行应用程序的帐户。
‧工作目录

应用程序的工作目录。  ‧日志文件应用程序
的日志文件。

‧服务网关安全模式仅适用于服务
网关指示服务网关是否在安全
模式下运行。
‧服务网关端口范围开始仅适用于服
务网关服务网关的端口范围的开
始。
‧服务网关端口(Web  服务)

OpenText  Exstream  –  通信服务器管理指南 167
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

仅适用于服务网关用于通过  Web  服务

与服务网关通信的端口。

‧服务网关端口(Web  服务)

仅适用于服务网关用于通过  REST  接口

与服务网关通信的端口。

‧临时目录

包含平台临时文件的目录(相对于工作目录)。

‧调试模式启用或禁用

应用程序的调试模式。
例如,
禁用、
启用或启用详细。

‧探查器

启用或禁用  Profiler  服务,
用于调查  Exstream  软件在处理过程中的行为。
有关详细信息,
请参阅第  
351  页的“分析和调整您的环境”。

‧小型转储请参
阅第  171  页的“为  Windows  上的应用程序生成转储文件”。

17.7  应用程序的启动选项和帐户
本节介绍  Communications  Server、
服务网关和任务计划程序应用程序的启动选项和帐户设置。

启动类型

这指定了应用程序的启动方式。

‧自动

管理网关启动时自动启动应用程序。
您必须在启动管理网关之前启动数据库服务器。

‧手动

手动启动应用程序。
‧禁用

禁用应用程序。

在  Windows  上运行应用程序的帐户

在  Windows  上,
您可以指定用于运行应用程序的帐户:

‧登录为:
本地系统帐户

在本地系统帐户下运行应用程序。
这是默认选项。

168 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.8。
为应用程序配置  Java  参数

‧登录为:
此帐户
指定另一个帐户的用户名和密码,
并在该帐户下运行应用程序。

17.8  为应用程序配置  Java  参数
您可以为每个  Exstream  应用程序(通信服务器应用程序或服务网关) 配置  Java  参
数,
例如目标  JRE(Java  运行时环境)供应商和  Java  类路径。

名称/值对

您将参数配置为名称/值对。 名称/值对必须遵循  Java  属性(namevalue)  的标准语法。
例如,对于  Java  系统属性‑
Djava.library.path=c:\mylibs: <分隔符>

‧名称:  java.library.path

‧值:  c:\mylibs

要使用非标准语法配置参数,
您必须在名称字段中输入完整参数并将值字段留空。
例如,
对于  Java  选项‑Xdebug:

‧名称:  Xdebug

‧值:
(空)

配置  Java  参数

1.  右键单击应用程序并选择Java/Server  配置。

2.  如果需要,
直接在列表中编辑默认参数。

3.  要添加新参数或配置参数,请选择(项目列表)
字段并
单击字段右侧的按钮。

4.  添加并配置所需的Java  参数。

5.  单击确定以更新  Java  配置对话框中的列表。

6.  单击“确定”
完成配置并退出对话框。

Java  参数

‧  Java  供应商
JRE(Java  运行时环境)
供应商。

‧名称:  Java  供应商‧值:  
none  (默认)、  Oracle或IBM选项none表示
禁用  Java  支持。
不会加载  JVM(Java  虚拟机)。

OpenText  Exstream  –  通信服务器管理指南 169
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  17  章  管理应用程序

‧文件编码
仅用于服务网关应用程序

JVM(Java  虚拟机)
加载时使用的字符编码。

‧名称:  file.encoding
‧值:  UTF‑8

‧  Java  类路径
以分号分隔的目录、
JAR  (Java  ARchive)  文件和  ZIP  归档列表,
用于搜索类文件。

如果所有类文件都位于以下目录之一,
则不必指定  Java  类路径:

‧ <工作目录> \java
‧ <工作目录> \..\data\java  (仅适用于  Communications  Server
应用程序)

例如:

‧名称:  Java  类路径
‧值:  c:\jndi.jar;  c:\myjava类

‧  Java  选项
Java  选项。

注意:
名称中不要包含“‑” 。

例如:

‧名称:
详细

‧值:  jni

‧  Java  系统属性
Java  系统属性。

注意:
不要在名称中包含“D” 。

例如:

‧名称:  java.library.path

‧值:  c:\mylibs

170 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

17.9。
为  Windows  上的应用程序生成转储文件

17.9  为应用程序生成转储文件
视窗

当通信服务器应用程序、
服务网关或任务计划程序
由于未处理的运行时错误而停止,
它会生成一个转储文件来帮助
您确定问题发生的位置。


<日期><时间> ‑
转储文件在工作目录中创建,
文件名为.mdmp,
其中<PID>是应用程序的进程  ID。
流服务‑ <PID>

注意:当为应用程序配置  Java  时(请参阅“配置  Java
应用程序参数”(第  169  页),  Java  运行时环境
控制运行时错误处理和转储文件的创建。

转储文件的类型

默认情况下,
Exstream  应用程序会生成一个完整的转储文件。
您可以将其更改为
迷你转储文件或禁用应用程序的转储文件。

‧  Mini  ‑  包含应用程序关闭时的堆栈信息。

‧完整(默认)  ‑  包含堆栈信息和内存内容
应用程序关闭时的应用程序。

更改转储文件的类型或禁用转储文件

1.  在控制中心树形视图中,
选择应用程序。

2.  在Property视图中,
双击Mini  Dump,
然后选择报告类型:

‧禁用

‧迷你

‧完整

3.  单击确定。

提示:
在命令行,
使用‑minidump参数设置 <报告类型>
报告类型。
其中<report  type>是mini、  full或disable。

OpenText  Exstream  –  通信服务器管理指南 171
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第十八章
登录控制中心

18.1  关于日志
从控制中心,您可以查看每个应用程序的日志并更改日志
水平。您还可以为每个应用程序启用数据库日志记录并存储日志
日志存储库中的信息。请参见第  179  页的“使用数据库日志记录”。

日志文件和路径
每个  Communications  Server、
服务网关和任务计划程序应用程序
有两个日志文件, 位于应用程序的工作目录中:

‧引导日志 包含早期启动消息。
文件名/strsboot.log <应用程序
wd>

‧应用程序日志 包含运行时日志消息。
文件名
<应用程序WD> /log.txt

除了启动和应用程序日志之外, 服务网关还有一个  Java  日志
文件(servicegateway_rest.log)。
有关日志文件条目的信息和
使用服务网关  Java  日志文件, 请参阅“服务网关  REST  日志”
第  275  页。

控制中心日志视图
控制中心的日志视图包含与
Communications  Server  的相应platform.txt日志文件,
任务
调度程序和服务网关应用程序。 如果你愿意, 你可以清除
为应用程序显示的信息(右键单击日志视图并选择
清除)。此操作会清除控制中心显示的日志, 但不影响
对应的日志文件。

日志文件条目
日志文件中的每个条目都包含以下内容:

<日期>  <时间> ( <logMessageID> ) <logLevel>  <logMessage>

在哪里:

‧<日期> –  是创建日志条目的日期。
‧<时间> –  是创建日志条目的时间。
‧<logMessageID> –  是日志消息  ID。每种类型的日志消息都有一个
唯一身份。
‧<日志级别> –  是日志消息的严重级别。

‧<日志消息> –  是日志消息。

OpenText  Exstream  –  通信服务器管理指南 173
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第十八章  登录控制中心

示例  18‑1:
日志条目
0309  033344  (0260)  3  SCF  启动。

18.2  指定日志级别
日志级别确定要在日志中包含哪种类型的消息。
日志级别从0到4。
数字越大,
日志中添加的详
细信息就越多。

您分别为每个应用程序指定日志级别。

日志级别

‧  0  –  仅严重错误。

‧1  –  作为级别  0  加上所有其他类型的错误。  ‧  2  –  作为级
别  1  加上警告。  ‧  3  –  作为级别  2  加信息消息。  ‧  4  –  作为

级别  3  加上扩展信息消息。

指定应用程序的日志级别
更改应用程序的日志级别

1.  停止应用程序。
2.  在控制中心树形视图中,
右键单击应用程序并选择日志配置。
日志配置对话框打开。

3.将日志级别更改为适当的级别,
然后单击确定。
4.  启动应用程序。

注意:
任务计划程序应用程序的配置对话框中的日志级别选项不适用。

18.3  在启动时创建一个新的日志文件
Communications  Server  应用程序通常会在重新启动后将日志消息附加到同一日志
文件中。您可以指定每次重新启动  Communications  Server  应用程序时都创建一个新
的日志文件。 旧的日志文件被删除, 并且没有存储在任何地方。

在启动时删除旧的日志文件

1.  停止应用程序。
2.  在控制中心树形视图中,
右键单击应用程序并选择日志配置。
日志配置对话框打开。

174 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

18.4.日志文件截断

3.  展开Type=File提供程序

4.  单击删除选项并从下拉列表中选择是。

18.4  日志文件截断
Communications  Server  应用程序通常会将日志消息附加到同一日志文件中。 这意味着越
来越多的消息将附加到日志文件中。
为防止日志文件变大, 您可以使用时间和文件大小作为触发器截断日志文件。 然后关闭并保存旧
的日志文件, Communications  Server  应用程序开始写入新的日志文件。

使用时间作为触发器

1.  停止应用程序。

2.  在控制中心树形视图中,
右键单击应用程序并选择日志配置。
日志配置对话框打开。

3.  展开Type=File提供程序。

4.  单击时间限制选项并从下拉列表中选择是。

5.  单击时间限制选项并输入天数。

6.  单击移动时间选项并输入日志文件应在一天中的什么时间关闭和移动。

7.  单击保存路径选项并输入日志文件所在文件夹的路径
感动。

18.5  编辑日志提供者 参考
您可以配置三个日志提供程序:

‧日志控制台
‧日志文件
‧日志数据库

配置日志提供程序

1.  停止应用程序。

2.  在控制中心树形视图中,
右键单击应用程序并选择日志配置。
日志配置对话框打开。

3.  展开您要配置的提供者的提供者设置。

4.  编辑提供程序并单击确定。

5.  启动应用程序。

OpenText  Exstream  –  通信服务器管理指南 175
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第十八章  登录控制中心

18.5.1  一般提供者设置
以下设置适用于所有提供商:

提供者

默认情况下,
提供程序具有以下名称:

控制台类型=控制台

文件 类型=文件

数据库类型=数据库

启用

‧是–  启用提供程序。
‧否–  禁用提供程序。

类型

‧提供者类型(只读)

18.5.2  控制台提供程序特定设置
留言信息

‧表示日志中显示的信息量的值。
该值是以下列表中从顶部开始的值的总和:
(默认值为  7,
将显示时间、
消息  ID  和日志级别。)

001 时间

002 消息  ID

004 日志级别

008 应用程序  ID

010 用户身份

020 线程  ID

040 作业编号

080 源代码信息

100 顶级(仅在存在日志级别时有效)

200 年(仅在存在时间时有效)

400 外部作业  ID

800 接收者

1000 租户编号

176 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

18.5。
编辑日志提供程序  ‑  参考

2000 应用程序域  ID
4000 毫秒(仅在时间存在时有效)

示例  18‑2:
消息信息值

考虑您希望在日志消息中显示时间、
消息  ID、
日志级别和应用程序  ID。
然后将  001  +  002  +004  
+008  =  15  相加,
这是您为此选项指定的值。

18.5.3  日志文件提供程序特定设置
留言信息

‧请参阅第  176  页的“控制台提供程序特定设置”
删除

‧是–  重新启动应用程序后删除日志文件。  ‧否–  重新启动应用程序后不删除日

志文件。

尺寸限制

‧是–  选择以指定最大日志文件大小。  ‧否–  没有日志文件大小限

制。

大小限制  (MB)

‧如果  Size  Restrictions  已设置为  Yes,请指定日志文件的最大大小(以  MB  为单位)
时间限制

‧是–  选择以指定使用日志文件的最大天数。  ‧否–  没有日志文件时间限制。

时限

‧如果时间限制已设置为是,请指定日志消息在日志存储库中保留的天数。
移动时间

‧应该在一天中的哪个时间移动日志。

保存路径

‧保存日志的文件夹的路径。
如果没有创建文件夹
存在。

OpenText  Exstream  –  通信服务器管理指南 177
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第十八章  登录控制中心

18.5.4  日志数据库提供程序特定设置
时限

‧日志消息在日志存储库中保留的天数。

18.6  调试应用程序
您可以启用调试以在日志中包含更多日志信息。

可以使用以下选项:

‧  Disabled  –  禁用调试。  ‧已启用–  
启用调试以包括扩展日志信息。 例如,
对于  ODBC  调用,
SQL  语句包含在日志中。
‧启用详细–  启用详细调试以包括所有可用日志
信息。
例如, 对于  ODBC  调用,
日志中包含  SQL  语句和参数。

注意:日志中显示的参数格式可能与SQL语句中实际使用的格式不对应。

如,
时间戳在日志中的显示方式不同。

配置的选项适用于所选应用程序的所有日志(启动日志、
平台日志和应用程序日
志)。

启用调试

1.  在树形视图中选择应用程序节点。

2.  停止应用程序。

3.  在属性视图中,
双击调试模式。
编辑调试模式对话框
框打开。

4.  选择适当的调试选项并单击确定。

5.  启动应用程序。

178 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

18.7.使用数据库日志记录

18.7  使用数据库日志
您可以为每个应用程序启用数据库日志记录(通信服务器、
服务网关和任务计划程序)
并存储日志信息(platform.txt)
在日志存储库中。

数据库日志包含与日志文件相同的信息(请参阅日志文件条目
第  173  页),
还有其他信息, 例如  和 。
使用数据库日志记录使您能 , <工作  ID><外部  
, <年份>
工作 身份证>, 够检查日志
<线程  ID>

从多个应用程序中使用,
例如,
作为搜索 <日期> <作业  ID>
标准。

提示:
要检查数据库日志,
可以使用命令行工具
LogWebServiceClient.exe位于:

<Exstream_Installation_directory> \平台\核心\ <版本> \垃圾桶\

有关如何使用此工具的信息,
请参阅工具帮助文本(输入
LogWebServiceClient.exe  ‑h在命令提示符下)。

启用数据库日志记录
您为每个应用程序单独启用数据库日志记录。

启用数据库日志记录

1.  停止应用程序。

2.  在控制中心树形视图中,
右键单击应用程序,
然后选择日志
配置。

3.  在Log  Configuration对话框中,
将Database  logging更改为Enabled,
然后
然后单击确定。

4.  启动应用程序。

设置日志存储库
您必须创建一个日志存储库,并将该存储库链接到
包含启用了数据库日志记录的应用程序。几个域可以
链接到同一个日志存储库。

日志存储库的默认数据库名称是StrsDataBaseLog。

创建日志存储库的步骤
按照这些部分中的步骤创建日志存储库:
1.  “配置存储库设置”
(第  125  页)。
2.  “在控制中心创建存储库” (第  129  页)
或“创建一个
手动存储库”
(第  130  页)。
3.  “将存储库链接到域”
(第  134  页)。

OpenText  Exstream  –  通信服务器管理指南 179
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第十八章  登录控制中心

从日志存储库中删除旧的日志消息
默认情况下,日志消息在日志存储库中保留一天,
然后删除。
您可以单独更改每个应
用程序的此时间限制。

设置日志消息的时间限制

1.  停止应用程序。
2.  在控制中心树形视图中,
右键单击应用程序,
然后选择日志配置。

3.  在日志配置对话框中,
将时间限制更改为适当的天数,
然后单击确定。

4.  启动应用程序。

180 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第十九章
维护  Exstream  组件

19.1  查找已安装的组件
您可以查看计算机上安装的组件和版本信息。
向  OpenText  支持报告事件时需要此信息。

OpenText  支持可能还需要应用于  Exstream  存储库的架构版本和修补程序。
在控制中心中,
您可以列出属于某个站点的所有存储库及其当前架构版本。

查找计算机上安装的组件

‧ 在控制中心树视图中,右键单击主机并选择查看已安装的版本。

OpenText  Exstream  –  通信服务器管理指南 181
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第  4  部分

使用命令行实用程序管理应用程序
Machine Translated by Google
Machine Translated by Google

第20章
关于命令行实用程序

命令行实用程序可用于  UNIX  环境或无法从运行  Microsoft  Windows  的计算机连接到  Exstream  
组件的环境。
命令行实用程序还提供了对某些任务进行自动化或编写脚本的可能性。

您可以从命令行实用程序管理  Exstream  应用程序、
创建存储库并将新租户添加到  Exstream。

命令行实用程序的访问控制由  OTDS  提供。

关于实用程序

ss_tenantadmin
用于为  OTDS  和多租户存储库创建连接配置文件。
此实用程序还可用于添加租户、 更新租户详细信息等。请参阅第  57  页的“设置  Exstream  环
境”。

ss_territory用
于创建和管理域、 存储库和应用程序(例如服务网关、
通信服务器和任务计划程序)。

ss_scm
用于管理(启动、 停止、
设置启动参数等)
和为应用程序创建服务,
包括  Communications  
Server  应用程序、
服务网关和任务计划程序。

ss_deploy
用于将  Communications  Builder  导出文件部署到  Communications  Server  应用程序。

ss_rcp
远程复制工具,
用于将文件或文件夹复制到远程主机或从远程主机复制,
或用于复制远程
主机上的文件夹。

OpenText  Exstream  –  通信服务器管理指南 185
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  20  章  关于命令行实用程序

20.1  命令行实用程序入门
命令行实用程序必须从具有  Communications
已安装服务器。

在  UNIX  上使用命令行实用程序

1.  将$STRS_LOCATION环境变量设置为您安装
Exstream  软件,
例如:

STRS_LOCATION=/usr/Exstream/Exstream‑16.3.0.GA。 <构建>

导出  STRS_LOCATION

2.  运行实用程序:
./启动器解决方案/sstools/start <实用程序>  <参数>

在  Windows  上使用命令行实用程序

1.  在命令行窗口中,
浏览到以下目录:

<Exstream_Installation_directory><版本> \ \服务器\bin

2.  运行以下命令:

<实用程序> 。
可执行程序
<参数>

有关示例,
请参见第  209  页的“示例”。

20.2  命令行实用程序的场景

场景  –  创建域并运行  Communications  Server  应用程序

1.  使用ss_territory创建域。

2.  使用ss_territory创建一个  Communications  Server  应用程序并将其链接到
域。

3.  使用ss_scm创建  Communications  Server  服务。

4.  使用ss_deploy部署导出包。

5.  使用ss_scm启动  Communications  Server  服务。

方案  –  重新部署  Communications  Server  服务

1.  使用ss_scm停止  Communications  Server  服务

2.  使用ss_deploy部署导出包。

3.  使用ss_scm启动  Communications  Server  服务。

186 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

20.2.命令行实用程序的场景

场景  –  创建任务计划程序

1.  使用ss_territory添加应用程序。

2.  使用ss_territory为应用程序创建资源。

3.  使用ss_territory将应用程序资源分配给应用程序。

4.  使用ss_scm为应用程序创建服务。

场景  –  创建跟踪存储库、
队列存储库、
文档代理存储库、
消息存储库、
统计存储库或日志存储库

1.  使用ss_territory为存储库创建资源。

2.  使用ss_territory为存储库创建数据库。

3.  使用ss_territory将存储库资源分配给域。

OpenText  Exstream  –  通信服务器管理指南 187
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
Machine Translated by Google

第21章

参数和描述

21.1  ss_scm  实用程序参数和描述
必需的参数

在哪里 是服务名称。

注意:  ‑servicename参数是‑ 如果‑action则不需要参数
action  uninstall或‑action  printservices。

在哪里 是下面列出的操作之一。

用于身份验证的用户名。
要使用此实用程序,
您必须拥有租户
管理员角色。
如果不使用–tenant参数,
则将–user传递为
”。

争论。

‑pass验
证密码。

动作和所需的动作相关参数

启动一个服务,
它可以是一个  Communications  Server  应用程序,
服务
网关或任务计划程序。

停止服务。

检查服务是否正在运行。

暂停服务。

恢复服务。

重命名服务。

OpenText  Exstream  –  通信服务器管理指南 189
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  21  章  论证和描述

需要额外的参数:
‑新名字 <名称>

设置启动类型
更改服务的启动类型。
需要额外的参数:
‑启动类型 <启动类型>

设置开始时间
更改服务器登录用户名。

注意:
提示“服务的新密码”
指定‑uid的密码 <用户名>

需要额外的参数:
‑uid <用户名>

设置服务类型
设置服务类型。
需要额外的参数:
‑服务类型 <类型>

设置描述
设置服务描述。
需要额外的参数:
‑描述 <说明>

创造
创建一个新的服务实例。

需要额外的参数:
‑binpath   <路径>
‑description   <说明>
‑servicetype   <服务类型>
‑startuptype <启动类型>

设置binpath
设置服务可执行文件的路径。
需要额外的参数:
‑binpath <路径>

获取bin路径
获取服务可执行文件的路径。
删除
删除服务。

注意:
如果删除重要服务,
这可能会损坏系统。

190 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

21.1。  ss_scm  实用程序参数和描述

setarg设
置启动参数。

注意:
参数必须存在。

需要额外的参数:
‑argname   <参数名称>
‑argvalue <参数值>

newarg
为指定的服务创建一个新的启动参数。

需要额外的参数:
‑argname   <参数名称>
‑argvalue <参数值>

argexist检
查启动参数是否存在并返回参数的值(如果存在)。

需要额外的参数:
‑argname <参数名称>

delsinglearg删除
单个启动参数,
例如‑demo。  (单个参数是没有值的参数)。

需要额外的参数:
‑argname <参数名称>

德尔二进制参数
删除二进制参数,
例如‑wd /home/user/projects/myproject/wd

需要额外的参数:
‑argname <参数名称>

getstartuptype获取
服务启动类型。

getstartupuid获取
服务启动  uid/用户名。

getservicetype获取服
务类型。

getdescription获取服
务描述。

printservices获取已
安装的服务。 如果返回该类型的‑servicetype服务。 <服务类型> 已指定,

OpenText  Exstream  –  通信服务器管理指南 191
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  21  章  论证和描述

注意:
名称列在第  20  个字符处被截断。

打印参数
打印服务的启动参数值。
需要额外的参数:
‑argname <参数名称>

格塔格
获取启动参数值。
需要额外的参数:
‑argname <参数名称>

卸载

卸载指定类型的所有应用程序。
同时注销应用程序
从应用程序域。
需要额外的参数:
‑applicationtype   <类型>
‑applicationversion <版本> (如果操作是卸载,
则可选)

更新appbinpath
更新所有应用程序的可执行路径以匹配在
‑binpath参数。

动作相关参数
‑新名字 <名称>
服务的新名称。

‑启动类型 <类型>
启动类型可以是以下之一:
‧自动

‧手册

‧禁用

‑uid用 <用户名>
于服务的用户名。

‑服务类型 <类型>
类型可以是以下之一:
‧  STRSCS  –  通信服务器服务

‧  STRSSG  –  服务网关服务。

‧  STRSCI  –  一个存档应用程序。

‧  STRSTS  –  任务计划程序应用程序

192 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

21.1。  ss_scm  实用程序参数和描述

‑description服务的 <说明>
描述。

‑binpath应用 <路径>
程序可执行文件的路径。

UNIX  示例:

‧ /var/streamserve/streamserve‑ <版本> /应用程序/


流服务/开始

窗口示例:

‧归档应用程序  –  bin\ss_storage.exe <Exstream  安装目录> \ <版本> \服务器\

‧任务计划程序应用程序  – <Exstream  安装目录> \ <版本>


\Server\bin\TSApplication.exe

‧通信服务器应用程序  – <Exstream  安装目录>
\ <版本> \Server\bin\CommunicationServer.exe

‑argname启 <名称>
动参数的名称。

‑argvalue启动 <值>
参数的值。

‑申请类型 <类型>
类型可以是以下之一:

‧  STRSCS  –  一个通信服务器应用程序。

‧  STRSSG  –  服务网关应用程序。

‧  STRSCI  –  一个存档应用程序。

‧  STRSTS  –  任务计划程序应用程序

‑applicationversion应用程序版 <版本>

本号。

‑repeat <编号>
重复命令的次数。 默认值为1。 仅在其产生的地方使用
有意义, 例如使用action  ‑getarg  ‑argname参数。 <参数名称>

可选参数

有关所有实用程序中可用的更多可选参数,请参阅“可选参数
(所有实用程序)”
第  207  页。

OpenText  Exstream  –  通信服务器管理指南 193
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

21.2  ss_territory  实用程序参数和描述
必需的参数

在哪里 是下面列出的操作之一。

用于身份验证的用户名。
要使用此实用程序, 您必须拥有租户
管理员角色。
如果不使用–tenant参数,
则将–user传递为
”。

争论。

动作和所需的动作相关参数

删除域。

需要额外的参数:

创建域。

需要额外的参数:

将应用程序添加到域。

需要额外的参数:

检索属性的值。

必需的附加参数:

在第  203  页。

194 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

21.2.  ss_territory  实用程序参数和描述

设置应用程序属性
设置属性的值。
例如通信的逻辑名称
服务器应用程序或服务网关的端口范围。
必需的附加参数:
‑应用名称 <应用程序名称>

‑propertyid属性id <属性名称> –  有关您可以设置的属性列表,


请参阅–
<属性名称> 在第  203  页。
‑价值 <属性值>

list_applications
列出域中的应用程序。
需要额外的参数:
‑领土ID <领土ID> 或‑  领土名称 <领土名称>

del_application
如果应用程序与管理程序驻留在同一台机器上,
则删除该应用程序
网关。
如果您指定
存储在存储库中的应用程序  ID。
需要额外的参数:
‑应用名称 <名称>

重命名应用程序
重命名与管理网关相同的计算机上的应用程序。
您还必须使用服务名称运行ss_scm  ‑action   <名称> 同步
newname  application  name。
需要额外的参数:
‑应用名称 <名称>

显示节点信息
显示当前主机的信息。
display_all_info
显示在环境中注册的所有主机的信息。
display_all_domain_names
显示主机上的所有域。
可选参数:
‑领土版本 <版本>

加入
在域之间移动应用程序。
需要额外的参数:
‑applicationid   <id>
‑territoryid <id>

OpenText  Exstream  –  通信服务器管理指南 195
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  21  章  论证和描述

get_db_scripts
生成用于创建存储库的数据库脚本。
脚本已压缩
在一个文件中并存储在:

‧ <项目位置>位置> /config/database在  UNIX/Linux  上,
其中 <项目
是通信期间指定的项目位置
服务器安装。

‧ <基本目录> \ <版本> \root\config\database在  Windows  上,


期间为  <基本目录>
Exstream  项目指定的路径在哪里
通信服务器安装。
例如:  C:
\管理网关

需要额外的参数:
‑territoryid安全配置 <资源  ID> 创建存储库时给出的  ID
文件资源。
‑db_type  <dbrokerplus|tracker|queue|messagestore|statistics|
数据库日志|临时存储|归档>

get_job_status
显示作业状态,
例如,
如果数据库是用
create_appdomain_db。

当客户端检索到日志中的所有内容时,
此操作与
相同的作业  ID  将失败。
需要额外的参数:
‑jobid   <工作>
‑frompos   <位置>
‑maxlen <最大字节数>

重命名领土
重命名域。

需要额外的参数:
‑领土名称 <领土名称>

部署域信息
将域配置导出到指定的应用程序。
你只能
指定管理网关机器上的应用程序。
需要额外的参数:
‑应用名称 <名称>

create_appdomain_db
创建一个存储库。
要检查数据库是否已创建,
您必须运行get_job_status
具有create_appdomain_db操作返回的作业  ID  的操作。
需要额外的参数:
‑db_user   <用户>
‑db_pass <通过>

196 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

21.2.  ss_territory  实用程序参数和描述

‑db_type  <dbrokerplus|tracker|queue|messagestore|statistics|
databaselog|tempstorage|archive>如果您指定跟踪器,
则为
如果您指定队列, 则创建跟踪存储库, 用于排队的脚本
创建存储库等。
‑territoryid安全配置 <资源  ID> 创建存储库时给出的  ID
文件资源。

创建资源
在租户存储库中创建资源。
例如,跟踪存储库,
队列存储库、文档代理存储库、
统计存储库、日志记录
存储库或任务计划程序资源。
需要额外的参数:
‑resource_version  ‑文件名 <版本>
<路径资源文件>到<

‑resource_name 姓名> –  对于存储库节点,


这是资源的名称。
对于任务计划程序应用程序,
这是taskscheduler.config.xml。
对于  Archiver  应用程序,
这是archiver.config.xml
‑content_type   <类型>
‑strs_type <类型>

可选参数:
‑resource_description  ‑territoryid   <说明>
<ID>
‑nodeid  ‑content_encoding
<ID>
<编码>

更新资源
更新现有资源的属性。
您可以更新以下内容
特性:

‧区域  ID
‧节点  ID

‧资源名称

‧资源描述
‧内容编码
‧资源数据

需要额外的参数:
‑resource_id <ID>

assign_resource_to_territory_relation
将资源链接到域。通过使用此操作,
您可以分配相同的
资源到多个应用程序域。
需要额外的参数:
‑ID <resource_id>
‑  它 <domain_id>

OpenText  Exstream  –  通信服务器管理指南 197
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  21  章  论证和描述

remove_resource_to_territory_relation
删除从域到资源的链接。

需要额外的参数:
‑  身 <resource_id>
份证  ‑  它 <domain_id>

移除资源
从存储库中删除资源。
需要额外的参数:
‑resource_id <ID>

获取资源数据
检索资源数据。

需要额外的参数:
‑resource_id  ‑文件 <ID>
名 <名称>

assign_resource_to_application_relation
将资源链接到应用程序。
例如,
链接任务计划程序
应用到资源。
需要额外的参数:
‑  身 <resource_id>
份证  ‑  它 <domain_id>

remove_resource_to_application_relation
从应用程序中删除到资源的链接。
需要额外的参数:
‑  身 <resource_id>
份证  ‑  它 <domain_id>

list_hotfixes
列出为‑db_type参数指定的存储库安装的修补程序。
需要额外的参数:
‑db_user   <用户>

‑db_pass   <通过>
‑db_type  <dbrokerplus|tracker|queue|messagestore|statistics|
数据库日志|临时存储|归档>

db_apply_hotfixes
将可用的修补程序应用于指定的存储库。
需要额外的参数:
‑db_user   <用户>

‑db_pass   <通过>
‑db_type  <dbrokerplus|tracker|queue|messagestore|statistics|
数据库日志|临时存储|归档>

198 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

21.2.  ss_territory  实用程序参数和描述

‑领土ID 资源> ID  < (存储库的  ID)

设置物理层
选择物理层。

获取物理层
检索物理层。

输入连接器
暂停或恢复指定应用程序的输入连接器。
需要额外的参数:
‑appname  ‑数 <应用>
据 <暂停|继续>

注意:
如果省略‑data参数,
则连接器的当前状态为
只显示。

设置配置文件
将文件复制到应用程序工作目录。
这样你就可以更新任何
应用程序中的配置文件,
例如任务计划程序配置文件
工作目录。
要将其用于任务调度,
必须有一个taskscheduler.config.xml文件
首先在本地创建。
需要额外的参数:
‑appname  ‑文 <应用>
件名 <路径>

动作相关参数
‑territoryid应用程序 <id>
域  ID,
或存储库的资源  ID。
可选择使用
‑领土名称。
您可以使用display_all_info操作来查找  ID
域或存储库。

‑territoryname域名。
可 <名称>

选择使用‑territoryid。

‑领土版本 <版本>
域版本。

‑territorydescription域描述。 <说明>

‑力量
仅当上次修改时间不同步时,
更新操作才需要。
‑  计数器时间 <柜台时间>
get操作返回的最后修改时间。

‑applicationid应用程序   <id>
ID。

OpenText  Exstream  –  通信服务器管理指南 199
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google

第  21  章  论证和描述

‑文件名 <文件名>

对于create_resource 、  get_resource_data和get_resource_data
操作,
这是包含资源数据的文件的路径。
资源文件
在目录\root\config\version\中找到 <ManagementGateway_root_directory><版本> \
\
<type_of_resource><file_name>

其中<file_name>是以下之一:

‧跟踪存储库  (SQL  Server)  –  tracker_  ‧队列存储库  (SQL  Server)  –   <版本> .default.xml

queue_ <版本> .default.xml

‧消息存储库  (SQL  Server)  –  messagestore_ <版本> .default.xml

‧文档代理存储库  (SQL  Server)  –
docbrokerplus_ <版本> .default.xml

‧统计资料库  (SQL  Server)  –
统计资料库_ <版本> .default.xml

‧日志存储库  (SQL  Server)  –  DataBaseLog_ <版本> .default.xml

‧临时数据存储库  (SQL  Server)  –
临时存储_ <版本> .default.xml

‧任务计划程序  –  taskscheduler_ <版本> .default.xml

‧归档应用程序  –  archiver_ <版本> .default.xml

注意: 这个目录下找到的repository资源文件只适合
对于  SQL  服务器。要在  Oracle  中为存储库创建资源文件,

可以在控制中心创建存储库并将其链接到域。 这
然后在应用程序的工作目录中创建资源文件
应用程序域。 该文件的前缀与
控制中心中的存储库节点。

‑appname应 <应用程序名称>
用程序名称。

‑appvers应用 <版本>
程序版本。

‑apptype应 <类型>
用程序类型。
类型可以是以下之一:

‧  STRSCS  –  通信服务器应用程序

‧  STRSSG  –  服务网关应用程序。

‧  STRSCI  –  一个存档应用程序。

‧  STRSTS  –  一个任务调度程序应用程序。

‑jobid作 <工作>
业  ID。

200 OpenText  Exstream  –  通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01

You might also like