Professional Documents
Culture Documents
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 组件。
该公司开发和管理自己的通信服务器和存储库。
每个租户在 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 环境中的每个租户都有自己的元数据模型, 其中包含租户的 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 应用程序。 ‧用户在每个应用程序中拥
有哪些权限。
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 文档。
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
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 客户端:
第 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. 单击组选项卡,
然后单击添加>新组。
其中<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
第 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. 单击保存。
第 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安装
目录>
命令:
笔记
‧ < 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. 单击组选项卡,
然后单击添加>新组。
其中<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 。
第 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和sga_target的关系取决于
关于用户数量。 从sga_target = pga_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。
‧然后必须从 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.
罐”
打开每个脚本并更新以下行中的路径:
classPath= lib/repoadm.jar:/usr/sap/hdbclient/ngdbc.jar
打开脚本并更新以下行中的路径:
驱动程序=/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 <脚本目录>
包含数据库脚本的目录的路径:
窗户‑ <基本目录> \ <版本> \根\配置\数据库\
‑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
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 不安全连接配置文件示例
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 安全连接配置文件示例
...
...
<certificates>
<certificate ref= file://otmm.cer pwd= PASSWORD alias= otmm
aliaspwd= PASSWORD /> </certificates>
...
...
</configuration> </
connectionprofile>
...
...
<安全通道>
<protocol>TLSv1</protocol>
<authentication>Mandatory</authentication>
<verification>Disabled</verification> <certificatestoreprofile
value= ... /> </securechannel>
...
...
</configuration> </
connectionprofile>
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 将它们托管在本地服务器上。
设置私人帮助服务器需要您完成以下一般任务:
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 上是:
注意:在非 Windows 操作系统上,
使用适当的斜杠,
双引号和括号, 例如:
Apache Tomcat 8.x 的相同示例是:
创建配置属性目录
您必须创建一个属性文件,
其中包含查找您的
帮助文件。
要创建配置属性目录和文件:
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 类路径。
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 页的“安装描述符和应用程序文件”。
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 应用程序将不会启
动。
‧如果许可证文件被删除,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 域需要哪些存储库
本节介绍需要每个存储库时的场景以及存储库中存储的信息。
存储库类型:
在以下情况下需要: 商店:
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 应用程序
‧具有模板引擎进程的通信服务器应用程序‧存储消息属性的
通信服务器应用程序
可以在 Supervisor 的 Log 视图中监控日志。
可以在 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文件。
句法
在哪里:
‧默认启用=“ <真/假>
指示级联审批是打开(true)还是关闭(false)。
这适用于所有域,
除非您在
应用程序域异常元素。
允许您在单个域中打开/关闭级联审批。
如果
defaultEnabled= false ,
此元素在一个
单域。 如果defaultEnabled= true ,
则此元素关闭
在单个域中进行级联审批。
您可以使用域名或 GUID 来标识域。
我们
建议您使用 GUID,
因此即使
域名变更。
示例 12‑1:
关闭每个域的级联审批
在此示例中,
级联审批在所有域中均已关闭。
示例 12‑2:
级联审批在两个域中关闭
在此示例中,
级联批准用于除
暂存和生产域。
OpenText Exstream – 通信服务器管理指南 121
CCMSYS160400‑AGD‑EN‑01
Machine Translated by Google
第 12 章 创建域
示例 12‑3:
级联批准用于除一个之外的所有域
在此示例中,
级联审批仅用于开发域。
具有多个管理网关的环境
如果您的环境中有多个管理网关,
则必须同时为所有管理网关配置审批设置
时间。
配置级联审批
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 页的“调整存储库”
中的信息,
并在必要时调整创建的存储库。
仅对无法使用 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 的文件中将这些选项配置为参数来向数据库驱动程序发送其他选项。
论据
后缀登
录时添加到身份验证配置文件用户名的后缀。
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)的登录详细信息可用。
‧如果您使用 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,
如下所示
目录:
在哪里:
‧ <基本目录> – 是在运行期间为 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 存储库是包含动态创
建的数据库列的存储库示例。
您还应该根据正在使用的查询调整索引。
例如,
如果某个列经常从 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
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 应用程序公开。
查看部署到
通信服务器应用程序
您可以查看部署到特定 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 应用程序的项目版本相同。
搜索条件
您可以根据名称或版本进行搜索,
也可以默认搜索所有服务和服务版本。
‧版本– 要搜索的服务版本号,或留下通配符以搜索所有版本。
您可以将数字与通配符结合使用,
例如 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 应用程序
配置文件计数器
您可以使用以下配置文件计数器来查找队列中活动线程和工作项的数量:
‧ 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 存储库后立即被连续存档。
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. 输入任务计划程序的名称。
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> – 是日志消息 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位于:
有关如何使用此工具的信息,
请参阅工具帮助文本(输入
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 示例:
窗口示例:
‧通信服务器应用程序 – <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 实用程序参数和描述
设置应用程序属性
设置属性的值。
例如通信的逻辑名称
服务器应用程序或服务网关的端口范围。
必需的附加参数:
‑应用名称 <应用程序名称>
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 上,
其中 <项目
是通信期间指定的项目位置
服务器安装。
需要额外的参数:
‑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_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 实用程序参数和描述
设置物理层
选择物理层。
获取物理层
检索物理层。
输入连接器
暂停或恢复指定应用程序的输入连接器。
需要额外的参数:
‑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) –
docbrokerplus_ <版本> .default.xml
‧统计资料库 (SQL Server) –
统计资料库_ <版本> .default.xml
‧临时数据存储库 (SQL Server) –
临时存储_ <版本> .default.xml
注意: 这个目录下找到的repository资源文件只适合
对于 SQL 服务器。要在 Oracle 中为存储库创建资源文件,
您
可以在控制中心创建存储库并将其链接到域。 这
然后在应用程序的工作目录中创建资源文件
应用程序域。 该文件的前缀与
控制中心中的存储库节点。
‑appname应 <应用程序名称>
用程序名称。
‑appvers应用 <版本>
程序版本。
‑apptype应 <类型>
用程序类型。
类型可以是以下之一:
‧ STRSCS – 通信服务器应用程序
‧ STRSSG – 服务网关应用程序。
‧ STRSCI – 一个存档应用程序。
‧ STRSTS – 一个任务调度程序应用程序。
‑jobid作 <工作>
业 ID。
200 OpenText Exstream – 通信服务器管理指南
CCMSYS160400‑AGD‑EN‑01